BaseLayoutItemOptionsToolTip.IconAllowHtmlString Property
Gets or sets whether HTML tags can be used to format the tooltip text displayed for the item’s icon.
Namespace: DevExpress.XtraLayout
Assembly: DevExpress.XtraLayout.v19.1.dll
Declaration
[XtraSerializableProperty]
[DefaultValue(DefaultBoolean.Default)]
public DefaultBoolean IconAllowHtmlString { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| DefaultBoolean | **Default** | True if HTML tags can be used to format the tooltip text; False if not; Default uses the ToolTipController.AllowHtmlText global setting. |
Available values:
| Name | Description |
|---|---|
| True | Corresponds to a Boolean value of true. |
| False | Corresponds to a Boolean value of false. |
| Default | The value is determined by the current object’s parent object setting (e.g., a control setting). |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to IconAllowHtmlString |
|---|---|
| LayoutViewCard |
|
| LayoutViewField |
|
| BaseLayoutItem |
|
| EmptySpaceItem |
|
| LayoutControlGroup |
|
| LayoutControlItem |
|
| LayoutGroup |
|
| LayoutItem |
|
| LayoutItemContainer |
|
| LayoutRepositoryItem |
|
| SplitterItem |
|
| TabbedControlGroup |
|
| TabbedGroup |
|
Remarks
Use the BaseLayoutItemOptionsToolTip.IconToolTip property to provide a tool tip shown when the item’s icon is hovered with the mouse pointer. The IconAllowHtmlString setting enables HTML formatting in the tooltip. If this property is set to Default, the feature is controlled by the ToolTipController.AllowHtmlText global setting.
The code below shows how to enable HTML tags for a particular item, and provide a formatted tool tip. For the complete list of supported HTML tags, see HTML Text Formatting.
layoutControlGroup2.OptionsToolTip.IconAllowHtmlString = DevExpress.Utils.DefaultBoolean.True;
layoutControlGroup2.OptionsToolTip.IconToolTip = "Enter a <b>valid</b> address";
The figure below shows the result.
You can also override the HTML formatting setting for a particular item when handling the ToolTipController.BeforeShow event. For this purpose, use the ToolTipControllerShowEventArgs.AllowHtmlText property of the ToolTipControllerShowEventArgs object passed as a parameter to the event handler.