Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Pivot Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Collapse]HTML Editor
    Deployment of ASPxHtmlEditor
    Main Features
    Getting Started
    ASPxHtmlEditor Designer
   [Collapse]Concepts
    [Expand]View Modes
    [Expand]Get and Set HTML
    [Collapse]Toolbars
     [Expand]Menu Toolbar
      Ribbon Toolbar
    [Expand]Dialogs
     Context Menu
     Placeholders
    [Expand]Content Filtering and Validation
    [Expand]Layout
     Searching Content
     Client-Side Commands
     Adaptivity
     Keyboard Shortcuts
     Import and Export
     Support for SharePoint
   [Expand]Visual Elements
   [Expand]Examples
  [Expand]Gauges
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Ribbon Toolbar

The ribbon toolbar is displayed in the ASPxHtmlEditor when the ASPxHtmlEditor.ToolbarMode property is set to Ribbon.

The ASPxHtmlEditor stores ribbon tabs in its ASPxHtmlEditor.RibbonTabs collection. This collection is represented by an instance of the HtmlEditorRibbonTabCollection class, and allows individual tabs (descendants of the RibbonTab class) to be added, deleted and accessed using indexer notation.

A ribbon tab displays ribbon items that are divided into logical groups. The RibbonTab object provides a collection of groups accessible by the RibbonTab.Groups property. An individual group is represented by the RibbonGroup class. A group provides a collection of items contained in the RibbonGroup.Items property. Ribbon items are represented by the RibbonItemBase class descendants.

Context Tabs

A context tab is a hidden ribbon tab that is displayed when a corresponding element (such as an image or a table) is selected. One element can correspond to several context tabs. Therefore, the tabs are combined into categories. The collection of categories is accessible by the ASPxHtmlEditor.RibbonContextTabCategories property. Every category provides the RibbonContextTabCategory.Tabs collection containing context tabs. You can specify a category color using the RibbonContextTabCategory.Color property. To manually change a category's visibility based on a selected element, use the ASPxClientHtmlEditor.SetRibbonContextTabCategoryVisible method.

Tip

You can modify ribbon tabs, groups and items at design time using the ASPxHtmlEditor Designer.

Expanded Default Ribbon Tabs

Default tabs contain predefined sets of ribbon items, grouped by functionality. The ASPxHtmlEditor provides the following default tabs - Home, Insert, and View.

  • Home tab - contains items that provide quick shortcuts to many frequently used operations (such as clipboard operations, undo/redo operations, changing the text's font and style, etc.)
  • Insert tab - contains items that provide access to the link dialogs, image dialogs, and Insert Table button.
  • View tab - contains an item allowing end-users to switch ASPxHtmlEditor to full-screen mode.

Default Context Tabs

By default, the ASPxHtmlEditor provides a Layout context tab that contains table-related commands and is displayed when a cursor is in a table.

To quickly add all default tabs to the editor at runtime, call the following methods.

Is this topic helpful?​​​​​​​