RadEditor for ASP.NET AJAX
Contents
RadControls for ASP.NET AJAX

RadEditor Toolbars are containers that 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 RadEditor implementation. The screenshot below shows an editor with its full set of tools, distributed in 5 toolbars. You can configure the toolbar with as few or as many tools as your application requires.

 

You can learn how to add standard or custom tools in the following help articles:

The toolbar can be also 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

You can group tools with similar logic in ToolStrips. You can find more information in the following article: How to create a ToolStrip.

RadEditor Toolset Reference The lists below show the icon image, the name of the tool, a description of what the tool does and tag format used to declare that tool in the ToolsFile xml file.

General Buttons

 

Icon

Tool Name

Description

ToolsFile Declaration

 

ConvertToUpper

Convert the text of the current selection to upper case, preserving the non-text elements such as images and tables.

<tool name="ConvertToUpper" />

 

ConvertToLower

Convert the text of the current selection to lower case, preserving the non-text elements such as images and tables.

<tool name="ConvertToLower" />

 

RealFontSize

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"/>

 

ToggleScreenMode

Toggle Screen Mode - Switches Telerik RadEditor into Full Screen Mode.

<tool name="ToggleScreenMode" shortcut="F11"/>

 

ToggleTableBorder

Show/Hide Border - Shows or hides borders around tables in the content area.

<tool name="ToggleTableBorder" />

 

Zoom

Zoom - Changes the level of text magnification.

<tool name="Zoom" />

 

ModuleManager

Module Manager - Activates /Deactivates modules from a drop-down list of available modules.

<tool name="ModuleManager" />

 

ToggleDocking

Toggle Docking - Docks all floating toolbars to their respective docking areas.

<tool name="ToggleDocking" />

 

FindAndReplace

Find and Replace - Find (and replaces) text in the editor's content area.

<tool name="FindAndReplace" shortcut="CTRL+F"/>

 

Print

Print button - Prints the contents of the Telerik RadEditor or the whole web page.

<tool name="Print" shortcut="CTRL+P"/>

 

AjaxSpellCheck

Spell button - Launches the spell checker.

<tool name="AjaxSpellCheck" shortcut="F7"/>

 

Cut

Cut button - Cuts the selected content and copies it to the clipboard.

<tool name="Cut" shortcut="CTRL+X"/>

 

Copy

Copy button - Copies the selected content to the clipboard.

<tool name="Copy" shortcut="CTRL+C"/>

 

Paste

Paste button - Pastes the copied content from the clipboard into the editor.

<tool name="Paste" shortcut="CTRL+V"/>

 
editor-paste-strip

PasteStrip

PasteStrip dropdown - contains advanced paste options (Paste, PasteFromWord, PasteFromWordNoFontsNoSizes, PastePlainText, PasteAsHtml, PasteHtml)

<tool name="PasteStrip" />

 

PasteFromWord

Paste from Word button - Pastes content copied from Word and removes the web-unfriendly tags.

<tool name="PasteFromWord" />

 

PasteFromWordNoFontsNoSizes

Paste from Word cleaning fonts and sizes button - cleans all Word-specific tags and removes font names and text sizes.

<tool name="PasteFromWordNoFontsNoSizes" />

 

PastePlainText

Paste Plain Text button - Pastes plain text (no formatting) into the editor.

<tool name="PastePlainText" />

 

PasteHtml

Paste HTML button - Pastes HTML code in to the current selection and renders it. It is helpful when needed to enter predefined HTML code such as media embed source.

<tool name="PasteHtml" />

 

PasteAsHtml

Paste as HTML button - Pastes HTML code in the content area and keeps all the HTML tags.

<tool name="PasteAsHtml" />

 

Undo

Undo button - undoes the last action.

<tool name="Undo" shortcut="CTRL+Z"/>

 

Redo

Redo button - Redoes/Repeats the last action, which has been undone.

<tool name="Redo" shortcut="CTRL+Y"/>

 

FormatStripper

Format Stripper button - Removes custom or all formatting from selected text.

<tool name="FormatStripper"/>

 

Help

Quick Help - Launches the Quick Help you are currently viewing.

<tool name="Help" shortcut="F1"/>

 

AboutDialog

About Dialog - Shows the current version and credentials of Telerik RadEditor.

<tool name="AboutDialog" />

 

XhtmlValidator

XhtmlValidator - dialog uses the W3C XHTML Validator Page to perform validation of the current editor content.

<tool name="XhtmlValidator" />

 
TrackChanges

TrackChangesDialog

Track Changes dialog - provides a comparison between two contents.

<tool name="TrackChangesDialog" />

 
StyleBuilder

StyleBuilder

StyleBuilder - provides options to define cascading style sheet (CSS) style attributes.

<tool name="StyleBuilder" />

Insert and Manage Links, Tables, Special Characters, Images and Media

 

Icon

Tool Name

Description

ToolsFile Declaration

 

ImageManager

Image Manager button - Inserts an image from a predefined image folder(s).

<tool name="ImageManager" shortcut="CTRL+G"/>

 

InsertImage

Insert Image button - A lite version of the Set Image Properties (Properties...) dialog.

<tool name="InsertImage"/>

 

ImageMapDialog

Image map - Allows users to define clickable areas within image.

<tool name="ImageMapDialog"/>

 

AbsolutePosition

Absolute Object Position button - Sets an absolute position of an object (free move).

<tool name="AbsolutePosition" />

 

InsertTable

Insert Table button - Inserts a table in the Telerik RadEditor.

<tool name="InsertTable" />

 

ToggleTableBorder

Toggle Table Borders - Toggles borders of all tables within the editor.

<tool name="ToggleTableBorder" />

 

InsertSnippet

Insert Snippet - Inserts pre-defined code snippets.

<tool name="InsertSnippet" />

 

InsertFormElement

Insert Form Element - Inserts a form element from a drop-down list with available elements.

<tool name="InsertFormElement" />

 

InsertDate

Insert Date button - Inserts current date.

<tool name="InsertDate" />

 

InsertTime

Insert Time button - Inserts current time.

<tool name="InsertTime" />

 

FlashManager

Flash Manager button - Inserts a Flash animation and lets you set its properties.

<tool name="FlashManager" />

 

MediaManager

Windows Media Manager button - Inserts a Windows media object (AVI, MPEG, WAV, etc.) and lets you set its properties.

<tool name="MediaManager" />

 

DocumentManager

Document Manager - Inserts a link to a document on the server (PDF, DOC, etc.)

<tool name="DocumentManager" />

 

LinkManager

Hyperlink Manager button - Makes the selected text or image a hyperlink.

<tool name="LinkManager" shortcut="CTRL+K"/>

 

InsertLink

Insert Link button - A light version of the Hyperlink Manager, whichmakes the selected text or image a hyperlink.

<tool name="InsertLink" />

 

Unlink

Remove Hyperlink button - Removes the hyperlink from the selected text or image.

<tool name="Unlink" shortcut="CTRL+SHIFT+K"/>

 

InsertSymbol

Insert Special Character dropdown - Inserts a special character (€ ®, ©, ±, etc.)

<tool name="InsertSymbol" />

 

InsertCustomLink

Insert Custom Link dropdown - Inserts an internal or external link from a predefined list.

<tool name="InsertCustomLink"/>

 

TemplateManager

Choose HTML Template - Applies and HTML template from a predefined list of templates.

<tool name="TemplateManager" />

Create, Format, Edit: Paragraphs and Lines

 

Icon

Tool Name

Description

ToolsFile Declaration

 

InsertParagraph

Insert New Paragraph button - Inserts new paragraph.

<tool name="InsertParagraph" />

 

FormatBlock

Paragraph Style Dropdown button - Applies standard text styles to selected text.

<tool name="FormatBlock"/>

 

Indent

Indent button - Indents paragraphs to the right.

<tool name="Indent" />

 

Outdent

Outdent button - Indents paragraphs to the left.

<tool name="Outdent" />

 

JustifyLeft

Align Left button - Aligns the selected paragraph to the left.

<tool name="JustifyLeft" />

 

JustifyCenter

Center button - Aligns the selected paragraph to the center.

<tool name="JustifyCenter" />

 

JustifyRight

Align Right button - Aligns the selected paragraph to the right.

<tool name="JustifyRight" />

 

JustifyFull

Justify button - Justifies the selected paragraph.

<tool name="JustifyFull" />

 

JustifyNone

Justify None Button - Removes the alignment

<tool name="JustifyNone" />

 

InsertUnorderedList

Bulleted List button - Creates a bulleted list from the selection.

<tool name="InsertUnorderedList" />

 

InsertOrderedList

Numbered List button - Creates a numbered list from the selection.

<tool name="InsertOrderedList" />

 

InsertHorizontalRule

Insert horizontal line (e.g. horizontal ruler) button - Inserts a horizontal line at the cursor position.

<tool name="InsertHorizontalRule" />

Create, Format, Edit: Text, Font and Lists

 

Icon

Tool Name

Description

ToolsFile Declaration

 

Bold

Bold button - Applies bold formatting to selected text.

<tool name="Bold" shortcut="CTRL+B"/>

 

Italic

Italic button - Applies italic formatting to selected text.

<tool name="Italic" shortcut="CTRL+I"/>

 

Underline

Underline button - Applies underline formatting to selected text.

<tool name="Underline" shortcut="CTRL+U"/>

 

StrikeThrough

Strikethrough button - Applies strikethrough formatting to selected text.

<tool name="StrikeThrough" />

 

Superscript

Superscript button - Makes a text superscript.

<tool name="Superscript" />

 

Subscript

Subscript button - Makes a text subscript.

<tool name="Subscript" />

 

FontName

Font Select dropdown - Sets the font typeface.

<tool name="FontName"/>

 

FontSize

Font Size dropdown - Sets the font size.

<tool name="FontSize"/>

 

ForeColor

Text Color (foreground) button - Changes the foreground color of the selected text.

<tool name="ForeColor"/>

 

BackColor

Text Color (background) button - Changes the background color of the selected text.

<tool name="BackColor"/>

 
radeditor formatcodeblock png

FormatCodeBlock

Format code block dialog tool.

<tool name="FormatCodeBlock" />

 

ApplyClass

Custom Styles dropdown - Applies custom, predefined styles to the selected text.

<tool name="ApplyClass"/>

 

InsertCustomLink

Custom Links drop down - Inserts custom, predefined link.

<tool name="InsertCustomLink"/>

 

<telerik:EditorSeparator />

Separate the tools icons on the toolbar

<tool separator="true" />

ToolsFile Example

Below is an example of a ToolsFile:

CopyXML
<root>
 <tools name="MainToolbar" enabled="true">
    <tool name="AjaxSpellCheck" />
    <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>

See Also