RadEditor for ASP.NET

Introduction Send comments on this topic.
See Also
Toolbars > Introduction

Glossary Item Box

The main elements of the Telerik RadEditor are the Toolbars. They are in fact containers, which accommodate the buttons and dropdown lists of the various tools.

Developers can group buttons in a number of toolbars according to the specific purpose of the Telerik RadEditor implementation. The screenshot below shows an editor with its full set of tools, distributed in 6 toolbars. Simpler configurations are of course possible.

 

 

 

 The toolbar is configured using an XML ToolsFile, which defines:

  • the number of toolbars (and system modules)
  • the collection of buttons in each toolbar and their order
  • the specific options (if any) for the respective tools (i.e. Fonts collections, Colors collection, etc.)
  • the dockability of each toolbar
  • the default docking zone for each toolbar 

 

A Closer look at the the full Telerik RadEditor toolset :

 

GENERAL BUTTONS

Icon                           Description  ToolsFile Declaration
Convert the text of the current selection to upper case, preserving the non-text elements such as images and tables. <tool  name="ConvertToUpper" />
Convert the text of the current selection to lower case, preserving the non-text elements such as images and tables. <tool name="ConvertToLower" />
Allows the user to apply to the current selection font size measured in pixels (px) or points (pt), rather than a fixed-size 1 to 7 (as does the FontSize tool). <tool name="RealFontSize"/>
Toggle Screen Mode - Switches Telerik RadEditor into Full Screen Mode. <tool name="ToggleScreenMode" shortcut="F11"/>
Show/Hide Border - Shows or hides borders around tables in the content area. <tool name="ToggleTableBorder" />
Zoom - Changes the level of text magnification. <tool name="Zoom" />
Module Manager - Activates /Deactivates modules from a drop-down list of available modules. <tool name="ModuleManager" />
Toggle Docking - Docks all floating toolbars to their respective docking areas. <tool name="ToggleDocking" />
Repeat Last Command - A short-cut to repeat the last action performed. <tool name="RepeatLastCommand" shortcut="F4"/>
Find and Replace - Find (and replaces) text in the editor's content area. <tool name="FindAndReplace" shortcut="CTRL+F"/>
Print button - Prints the contents of the Telerik RadEditor or the whole web page. <tool name="Print" shortcut="CTRL+P"/>
Spell button - Launches the spell checker. <tool name="SpellCheck" shortcut="F7"/>
Cut button - Cuts the selected content and copies it to the clipboard. <tool name="Cut" shortcut="CTRL+X"/>
Copy button - Copies the selected content to the clipboard. <tool name="Copy" shortcut="CTRL+C"/>
Paste button - Pastes the copied content from the clipboard into the editor. <tool name="Paste" shortcut="CTRL+V"/>
Paste from Word button - Pastes content copied from Word and removes the web-unfriendly tags. <tool name="PasteFromWord" />
Paste from Word cleaning fonts and sizes button - cleans all Word-specific tags and removes font names and text sizes. <tool name="PasteFromWordNoFontsNoSizes" />
Paste Plain Text button - Pastes plain text (no formatting) into the editor. <tool name="PastePlainText" />
Paste as HTML button - Pastes HTML code in the content area and keeps all the HTML tags. <tool name="PasteAsHtml"  />
Undo button - undoes the last action. <tool name="Undo" shortcut="CTRL+Z"/>
Redo button - Redoes/Repeats the last action, which has been undone. <tool name="Redo" shortcut="CTRL+Y"/>
Format Stripper button - Removes custom or all formatting from selected text. <tool name="FormatStripper"/>
Quick Help - Launches the Quick Help you are currently viewing. <tool name="Help" shortcut="F1"/>
About Dialog - Shows the current version and credentials of Telerik RadEditor. <tool name="AboutDialog" />
INSERT AND MANAGE LINKS, TABLES, SPECIAL CHARACTERS, IMAGES and MEDIA
Image Manager button - Inserts an image from a predefined image folder(s). <tool name="ImageManager" shortcut="CTRL+G"/>
Image map - Allows users to define clickable areas within image. <tool name="ImageMapDialog"/>
Absolute Object Position button - Sets an absolute position of an object (free move). <tool name="AbsolutePosition" />
Insert Table button - Inserts a table in the Telerik RadEditor. <tool name="InsertTable" />
Toggle Table Borders - Toggles borders of all tables within the editor. <tool name="ToggleTableBorder" />
Insert Snippet - Inserts pre-defined code snippets. <tool name="InsertSnippet" />
Insert Form Element - Inserts a form element from a drop-down list with available elements. <tool name="InsertFormElement" />
Insert Date button - Inserts current date. <tool name="InsertDate" />
Insert Time button - Inserts current time. <tool name="InsertTime" /> 
Flash Manager button - Inserts a Flash animation and lets you set its properties. <tool name="FlashManager" />
Windows Media Manager button - Inserts a Windows media object (AVI, MPEG, WAV, etc.) and lets you set its properties. <tool name="MediaManager" />
Document Manager - Inserts a link to a document on the server (PDF, DOC, etc.) <tool name="DocumentManager" />
Hyperlink Manager button - Makes the selected text or image a hyperlink. <tool name="LinkManager" shortcut="CTRL+K"/>
Remove Hyperlink button - Removes the hyperlink from the selected text or image. <tool name="Unlink" shortcut="CTRL+SHIFT+K"/>
Insert Special Character dropdown - Inserts a special character (€ ®, ©, ±, etc.) <tool name="InsertSymbol" />
Insert Custom Link dropdown - Inserts an internal or external link from a predefined list. <tool name="InsertCustomLink"/>
Choose HTML Template - Applies and HTML template from a predefined list of templates. <tool name="TemplateManager" />

CREATE, FORMAT AND EDIT PARAGRAPHS and LINES

Insert New Paragraph button - Inserts new paragraph. <tool name="InsertParagraph" />
Paragraph Style Dropdown button - Applies standard text styles to selected text. <tool name="FormatBlock"/>
Indent button - Indents paragraphs to the right. <tool name="Indent" />
Outdent button - Indents paragraphs to the left. <tool name="Outdent" />
Align Left button - Aligns the selected paragraph to the left. <tool name="JustifyLeft" />
Center button - Aligns the selected paragraph to the center. <tool name="JustifyCenter" />
Align Right button - Aligns the selected paragraph to the right. <tool name="JustifyRight" />
Justify button - Justifies the selected paragraph. <tool name="JustifyFull" />

Justify None Button - Removes the alignment <tool name="JustifyNone" />
Bulleted List button - Creates a bulleted list from the selection. <tool name="InsertUnorderedList" />
Numbered List button - Creates a numbered list from the selection. <tool name="InsertOrderedList" />
Insert horizontal line (e.g. horizontal ruler) button - Inserts a horizontal line at the cursor position. <tool name="InsertHorizontalRule" />
CREATE, FORMAT AND EDIT TEXT, FONT and LISTS
Bold button - Applies bold formatting to selected text. <tool name="Bold" shortcut="CTRL+B"/>
Italic button - Applies italic formatting to selected text. <tool name="Italic" shortcut="CTRL+I"/>
Underline button - Applies underline formatting to selected text. <tool name="Underline" shortcut="CTRL+U"/>
Strikethrough button - Applies strikethrough formatting to selected text. <tool name="StrikeThrough" />
Superscript button - Makes a text superscript. <tool name="Superscript" />
Subscript button - Makes a text subscript. <tool name="Subscript" />
Font Select button - Sets the font typeface. <tool name="FontName"/>
Font Size button - Sets the font size. <tool name="FontSize"/>
Text Color (foreground) button - Changes the foreground color of the selected text. <tool name="ForeColor"/>
Text Color (background) button - Changes the background color of the selected text. <tool name="BackColor"/>
           Format code block dialog tool. <tool name="FormatCodeBlock" />
Custom Styles drop down - Applies custom, predefined styles to the selected text. <tool name="ApplyClass"/>
Custom Links drop down - Inserts custom, predefined link. <tool name="InsertCustomLink"/>
Separate the tools icons on the toolbar <tool separator="true" />


Below is an example of a ToolsFile with one dockable toolbar:

 

ToolsFile.xml Copy Code
<root>
  
<tools name="MainToolbar" dockable="true" dockingZone="Top" enabled="true">
     
<tool name="SpellCheck" />
     
<tool name="Print" />
     
<tool name="FindAndReplace" />  
     
<tool separator="true"/>
     
<tool name="Cut" />  
     
<tool name="Copy" />
     
<tool name="Paste" />
     
<tool name="PasteFromWord" />
     
<tool name="PastePlainText" />
     
<tool name="PasteAsHtml"  />
     
<tool separator="true"/>
     
<tool name="Undo" />
     
<tool name="Redo" />
  
</tools>
<
root>

 

Apart from using the static file (ToolsFile.xml), the toolbars can also be generated dynamically. This allows developers to facilitate a roles mechanism and load different Toolbars with different settings for the different users of the web-application.

 

See Also