[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Collapse]Common Features
  [Expand]Data Binding Common Concepts
  [Expand]Data Source Wizard
  [Expand]Application Appearance and Skin Colors
  [Expand]Filtering UI Context
  [Expand]High DPI Support
  [Expand]Scaffolding Wizard
  [Expand]Formatting Values
   HTML Text Formatting
  [Expand]Tooltip Management
  [Expand]Saving and Restoring Layouts
   Clipboard - Copy and Paste Operations. Data Formatting
   Version Compatibility: Default Property Values
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[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]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

HTML Text Formatting

Certain controls allow you to format display text using HyperText Markup Language (HTML). HTML formatted text contains markup tags, which define text appearance. This document lists the controls that support HTML text formatting, describes the available HTML formatting tags, and provides an example of this feature.


When the HTML Text Formatting feature is enabled for a certain control or its visual element, its text is painted in left-to-right mode, regardless of the RightToLeft option.

Expanded Supported Controls

Currently, HTML formatting is supported by the controls listed in the table below. Note that in order for some controls to allow HTML formatting, a corresponding Boolean property must be enabled.

Suite/Controls HTML formatting is supported for... Property that enables HTML formatting
ChartControl text in a Title (Title.Text) and TextAnnotation (TextAnnotation.Text and TextAnnotation.Lines). n/a
Editors Library text in a LabelControl (LabelControl.Text). LabelControl.AllowHtmlString
text in the CheckEdit and ToggleSwitch controls. RepositoryItem.AllowHtmlDraw
text in the SimpleButton control (SimpleButton.Text). SimpleButton.AllowHtmlDraw
text in ButtonEdit descendants (when RepositoryItemButtonEdit.TextEditStyle is set to TextEditStyles.DisableTextEditor). RepositoryItem.AllowHtmlDraw
text displayed in embedded buttons within ButtonEdit descendants. RepositoryItem.AllowHtmlDraw
items in the ListBoxControl and CheckedListBoxControl controls. BaseListBoxControl.AllowHtmlDraw
items in the ComboBoxEdit, ImageComboBoxEdit and CheckedComboBoxEdit controls. RepositoryItem.AllowHtmlDraw
the GroupControl's text (GroupControl.Text). GroupControl.AllowHtmlText
the RatingControl's text (RatingControl.Text) RepositoryItemRatingControl.AllowHtmlDraw
GridControl column captions (GridColumn.Caption). GridOptionsView.AllowHtmlDrawHeaders
band captions (GridBand.Caption). GridOptionsView.AllowHtmlDrawHeaders
text within cells.
HTML tags can be incorporated into cells in the following ways.
- directly into edit values in the underlying data source.
- by creating an unbound column and handling the ColumnView.CustomUnboundColumnData event.
- via the ColumnView.CustomColumnDisplayText event.
- via the GridView.CustomDrawCell event.
Use RepositoryItemHypertextLabel as an in-place editor. This editor has the HTML text formatting feature enabled by default (see RepositoryItem.AllowHtmlDraw). Text editing is disabled.
text within group rows.
HTML tags can be incorporated into group rows via the GridView.CustomDrawGroupRow event.
column captions in the TileView's Edit Form (GridColumn.Caption) TileViewOptionsEditForm.AllowHtmlCaptions
text of items in the WinExplorerView WinExplorerViewOptionsView.AllowHtmlText
TreeList column and band captions (TreeListColumn.Caption, TreeListBand.Caption). TreeListOptionsView.AllowHtmlDrawHeaders
text within cells.
HTML tags can be incorporated into cells in the following ways.
- directly into edit values in the underlying data source.
- by creating an unbound column and handling the TreeList.CustomUnboundColumnData event.
- via the TreeList.CustomColumnDisplayText event.
- via the TreeList.CustomDrawNodeCell event.
Use RepositoryItemHypertextLabel as an in-place editor. This editor has the HTML text formatting feature enabled by default (see RepositoryItem.AllowHtmlDraw). Text editing is disabled.
VGridControl, PropertyGridControl row captions. BaseOptionsView.AllowHtmlText, VGridOptionsRow.AllowHtmlText, CustomDrawRowHeaderCellEventArgs.AllowHtmlText
text within cells.
HTML tags can be incorporated into cells in the following ways.
- directly into edit values in the underlying data source..
- by creating an unbound row and handling the VGridControl.CustomUnboundData event.
- via the VGridControl.CustomColumnDisplayText event.
- via the VGridControlBase.CustomDrawRowValueCell event.
Use RepositoryItemHypertextLabel as an in-place editor. This editor has the HTML text formatting feature enabled by default (see RepositoryItem.AllowHtmlDraw). Text editing is disabled.
LayoutControl item captions (BaseLayoutItem.Text). LayoutControlItem.AllowHtmlStringInCaption


tooltips for items in the Layout Control BaseLayoutItemOptionsToolTip.AllowHtmlString, BaseLayoutItemOptionsToolTip.IconAllowHtmlString, ToolTipController.AllowHtmlText
RibbonControl, Menus (BarManager) and Docking Library (DockManager) the captions of Bar, Menu and Ribbon elements (BarItem.Caption, BarItem.Description) BarItem.AllowHtmlText, BarItemLink.AllowHtmlText, BarManager.AllowHtmlText, RibbonControl.AllowHtmlText
the captions and text of alert windows implemented via the AlertControl component. AlertControl.AllowHtmlText
item captions in the BackstageViewControl (BackstageViewItem.Caption). BackstageViewItem.AllowHtmlString
item captions in the OfficeNavigationBar (NavigationBarItem.Text). OfficeNavigationBar.AllowHtmlDraw
text of gallery items and gallery item groups (GalleryItem.Caption, GalleryItemGroup.Caption) BaseGallery.AllowHtmlText
Windows UI and App UI Manager (DocumentManager) WindowsUIButton's caption (WindowsUIButton.Caption) WindowsUIButtonPanel.AllowHtmlDraw
Document headers (BaseDocument.Header). IDocumentSelectorDefaultProperties.AllowHtmlDrawHeaders
Document captions (BaseDocument.Caption). IDocumentGroupDefaultProperties.AllowHtmlDraw
A Flyout's caption and description (UIActionPropertiesCore.Caption, UIActionPropertiesCore.Description). IFlyoutDefaultProperties.AllowHtmlDraw, IFlyoutProperties.AllowHtmlDraw
Tile elements ITileContainerDefaultProperties.AllowHtmlDraw
Overview screens of content containers OverviewContainerDefaultProperties.AllowHtmlDraw
text in tiles TileControl.AllowHtmlText, TileItem.AllowHtmlText
NavBarControl text of items and groups (NavElement.Caption) NavBarControl.AllowHtmlString, NavElement.AllowHtmlString
Navigation Frame, Tab Pane
and Navigation Pane controls
NavigationPage captions (NavigationPageBase.Caption) and tab headers (NavigationPageBase.Text) NavigationPageDefaultProperties.AllowHtmlDraw
AccordionControl element header text (AccordionControlElementBase.Text). AccordionControl.AllowHtmlText
GaugeControl text of labels. Label.AllowHTMLString
MapControl text of MapCallout or MapCustomElement. MapCallout.AllowHtmlText, MapCustomElement.AllowHtmlText
XtraDialog and XtraMessageBox the captions of the XtraDialog and XtraMessageBox XtraDialog.AllowHtmlText, XtraMessageBox.AllowHtmlText
WizardControl text in the WizardControl's pages WizardControl.AllowHtmlText
All Controls regular tooltips and SuperToolTips for controls. ToolTipController.AllowHtmlText, SuperToolTip.AllowHtmlText, ToolTipItem.AllowHtmlText
regular tooltips (BaseControl.ToolTip) for BaseControl descendants. BaseControl.AllowHtmlTextInToolTip
the caption of an XtraForm. n/a

Use the XtraForm.HtmlText property to format a form's caption using HTML tags.

the ContextButton's text (ContextButtonBase.Caption). ContextButtonBase.AllowHtmlText
the ValidationHint's text (ValidationHintBaseDefaultProperties.Text, ValidationHintBaseProperties.Text). ValidationHintBaseDefaultProperties.AllowHtmlDrawText, ValidationHintBaseProperties.AllowHtmlDrawText

Expanded Supported Tags

Tags are enclosed with the '<' and '>' symbols, and typically have a corresponding end tag. If a tag is not matched by its ending counterpart, all text that follows the tag will be formatted accordingly.

The following tags are supported:

Tag End Tag Description
<br> - Inserts a single line break. To use this tag, you should enable word wrapping via the TextOptions.WordWrap option of a corresponding appearance object.

To use this tag in a GridControl, enable word wrapping via the GridViewAppearances.HeaderPanel object, GridColumn.AppearanceHeader object, BandedViewAppearances.BandPanel object or GridBand.AppearanceHeader object.

To use this tag in a TreeList, enable word wrapping via the TreeListAppearanceCollection.HeaderPanel object or TreeListColumn.AppearanceHeader object.

To use this tag in a LabelControl, enable word wrapping via the LabelControl.Appearance object.

To use this tag in a CheckEdit control, enable word wrapping via the CheckEdit.Properties.Appearance object (RepositoryItem.Appearance).

To use this tag in layout item captions, enable word wrapping via the item's or layout group's BaseLayoutItem.AppearanceItemCaption object.

</color> Specifies the text color.
</backcolor> Specifies the background color.
</size> Specifies the font size.
<b> </b> Defines bold text.
<i> </i> Defines italic text.
<s> </s> Defines strikethrough text.
<u> </u> Defines underlined text.
- Inserts an image from a bound image collection or from project resources. To insert an image from project resources, the image's name must be preceded with the '#' character. The image referenced from project resources will not appear at design time, but will appear at runtime.

Project resource images can only be loaded from the Entry Assembly (the startup executable). Thus, if you define images in the resources of your additional class library, these images cannot be loaded using the image tag, even from this library code.

If the image's name is not preceded with '#', it is implied that the image should be loaded by its name from a bound image collection. Use the control's HtmlImages property to provide an ImageCollection containing images to be inserted using the image tag.

The following attributes for the image tag are supported.

size - sets the display size of the image.
align - specifies the vertical alignment of the image relative to the text. Possible values: top, bottom and center.
Attributes must be specified after the tag's value, followed by the ";" character. They must be separated with ";", and specified without spaces.

Controls that accept the image tag and provide the HtmlImages property are listed below.

<href=www.devexpress.com>Our web site</href>
</href> Displays a hyperlink. The value string specifies the hyperlink source, and the string between the opening and closing tags is the text to be displayed. For controls capable of displaying hyperlinks via this tag, clicking a hyperlink fires the HyperlinkClick event.
<nbsp> - Inserts a non-breaking space character (0xA0).

Note that if you need to use angle brackets ('<' and '>') in the text of the controls that support HTML text formatting, you need to use an additional '<' bracket at the beginning. For example, to get "<some text>" you should assign "<<some text>" to the corresponding property.

Expanded Note on Printing and Exporting

HTML formatting is not supported when a control is printed or exported. HTML tags are not displayed in a printed document.

Expanded Example 1

The following example shows how to format a LabelControl's text using HTML tags. HTML formatting is enabled via the LabelControl.AllowHtmlString property. To respond to an end-user clicking the hyperlink, the LabelControl.HyperlinkClick event is handled. The image below shows the result:

Expanded Example 2

This example shows how to create a SuperToolTip containing a hyperlink for a SimpleButton.

The SimpleButton control provides the BaseControl.SuperTip inherited property that allows you to set a tooltip. To enable use of the <href> tag and other HTML text formatting tags in tooltips, activate the HTML Text Formatting feature (for instance, via the SuperToolTip.AllowHtmlText property). To respond to clicking a hyperlink, handle the ToolTipController.HyperlinkClick event.

The code that creates a SuperToolTip for a button is shown at the end of this section. At design time, you can create a SuperToolTip for a button as shown below. In this case, you still need to implement the HyperlinkClick event in code.

At design time, select the SimpleButton control and click the ellipses button within the SuperTip row in the Properties window:

This invokes the SuperToolTip Editor, which allows you to set the tooltip content and activate the HTML formatting feature:

When you run the application, the result will be as follows:

Expanded See Also

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