ToolTipItem Class

A regular tooltip item in a SuperToolTip that displays text and/or an image.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v18.1.dll

Declaration

C#

[TypeConverter(typeof(ToolTipTypeConverter))]
public class ToolTipItem :
    BaseToolTipItem,
    ISerializable,
    IDisposable

VB.NET

<TypeConverter(GetType(ToolTipTypeConverter))>
Public Class ToolTipItem
    Inherits BaseToolTipItem
    Implements ISerializable,
               IDisposable

Remarks

Along with the ToolTipTitleItem and ToolTipSeparatorItems, the ToolTipItem can be used to construct a SuperToolTip object. A ToolTipItem object is a regular item, while the ToolTipTitleItem and ToolTipSeparatorItem items represent a title item and a separator, respectively.

A ToolTipItem displays text and/or graphic information. To display text information, use the ToolTipItem.Text property. It is possible to use HTML tags to format the text. To enable HTML formatting, use the ToolTipItem.AllowHtmlText property.

To display graphic information within a ToolTipItem, you can use the following properties:

• ToolTipItem.Icon - Allows you to display a System.Drawing.Icon object.
• ToolTipItem.Image - Allows you to display a System.Drawing.Image object.
• ToolTipItem.ImageIndex - Allows you to display a System.Drawing.Image object from the ToolTipItem.Images collection.

The ToolTipItem class provides properties for content formatting:

• text font (ToolTipItem.Font),
• image alignment (ToolTipItem.ImageAlign),
• left indentation (ToolTipItem.LeftIndent),
• spacing between the image and text (ToolTipItem.ImageToTextDistance).

Example

The following example demonstrates how to create a SuperToolTip object with a ToolTipItem object inside and assign it to a button.

C#

using DevExpress.Utils;
//...
//Create a new instance of the SuperToolTip object.
SuperToolTip sTooltip1 = new SuperToolTip();

//Create a new instance of the ToolTipItem object.
ToolTipItem item1 = new ToolTipItem();
//Specify the properties.
item1.Image = System.Drawing.Image.FromFile("d:\\image.bmp");
item1.Text = "This is <i>the text</i> in <b>the tooltip</b>";
item1.ImageToTextDistance = 50;
item1.AllowHtmlText = DefaultBoolean.True;

// Add the tooltip item to the SuperTooltip.
sTooltip1.Items.Add(item1);

// Assign the created SuperToolTip to a Button.
simpleButton1.SuperTip = sTooltip1;

VB.NET

Imports DevExpress.Utils
'...
'Create a new instance of the SuperToolTip object.
Dim sTooltip1 As New SuperToolTip()

'Create a new instance of the ToolTipItem object.
Dim item1 As New ToolTipItem()
'Specify the properties.
item1.Image = System.Drawing.Image.FromFile("d:\image.bmp")
item1.Text = "This is <i>the text</i> in <b>the tooltip</b>"
item1.ImageToTextDistance = 50
item1.AllowHtmlText = DefaultBoolean.[True]

' Add the tooltip item to the SuperTooltip.
sTooltip1.Items.Add(item1)

' Assign the created SuperToolTip to a Button.
simpleButton1.SuperTip = sTooltip1

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ToolTipItem class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-show-separate-tool-tips-for-values-shown-in-the-checkedcomboboxedits-edit-box-e2637/CS/WindowsApplication3/Form1.cs#L86

SuperToolTip superToolTip = new SuperToolTip();
ToolTipItem itemDecsr = new ToolTipItem();
itemDecsr.Text = row[edit.Properties.DisplayMember].ToString();

vote-app-t445500/CS/VoteApp/Map.cs#L520

if(votes.Count == 0) {
    superTip.Items.Add(new ToolTipItem() { Text = "No information available yet" });
    return true;

vote-applications-t446758/CS/VoteApp/Map.cs#L519

if(votes.Count == 0) {
    superTip.Items.Add(new ToolTipItem() { Text = "No information available yet" });
    return true;

how-to-display-custom-tooltips-for-appointments-resource-headers-and-day-headers-e4137/CS/Form1.cs#L28

ToolTipTitleItem ttiTitle = new ToolTipTitleItem();
ToolTipItem ttiBody = new ToolTipItem();
ToolTipItem ttiFooter = new ToolTipItem();

xtratabbedmdimanager-how-to-display-thumbnails-for-mdi-child-forms-e2581/CS/WindowsApplication1/Helper/ThumbnailHintHelper.cs#L41

superTip.Items.AddSeparator();
ToolTipItem item1 = new ToolTipItem();
item1.Image = ThumbnailHelper.FormToBitmap((page as XtraMdiTabPage).MdiChild, new Size(200, 200));

VB.NET

how-to-show-separate-tool-tips-for-values-shown-in-the-checkedcomboboxedits-edit-box-e2637/VB/WindowsApplication3/Form1.vb#L77

Dim superToolTip As New SuperToolTip()
Dim itemDecsr As New ToolTipItem()
itemDecsr.Text = row(edit.Properties.DisplayMember).ToString()

how-to-display-custom-tooltips-for-appointments-resource-headers-and-day-headers-e4137/VB/Form1.vb#L30

Dim ttiTitle As New ToolTipTitleItem()
Dim ttiBody As New ToolTipItem()
Dim ttiFooter As New ToolTipItem()

xtratabbedmdimanager-how-to-display-thumbnails-for-mdi-child-forms-e2581/VB/WindowsApplication1/Helper/ThumbnailHintHelper.vb#L38

superTip.Items.AddSeparator()
Dim item1 As New ToolTipItem()
item1.Image = ThumbnailHelper.FormToBitmap((TryCast(page, XtraMdiTabPage)).MdiChild, New Size(200, 200))

popup-images-for-grid-rows-e301/VB/Form1.vb#L43

Dim im As Image = TryCast(view.GetRowCellValue(hi.RowHandle, "Picture"), Image)
Dim item1 As New ToolTipItem()
item1.Image = im

how-to-show-a-tooltip-in-the-datenavigator-control-e471/VB/Form1.vb#L54

' Create a tooltip item that represents the SuperTooltip's contents.
Dim item1 As New ToolTipItem()

Inheritance

Object

DevExpress.Utils.BaseToolTipObject

DevExpress.Utils.BaseToolTipItem

ToolTipItem