- 3 minutes to read
You can display regular tooltips or SuperToolTips for controls using a ToolTipController Component. A regular tooltip has two regions (title and content), while a SuperToolTip object provides a flexible way to create tooltips consisting of multiple text regions. This topic describes these tooltips and shows how to choose a specific tooltip type.
Choosing Tooltip Type
You can assign a regular tooltip or a SuperToolTip to a control, and this will be displayed when the control is hovered over. If both a regular tooltip and a SuperToolTip are assigned to a control, the SuperToolTip will be displayed by default.
The appearance of SuperToolTips is determined by the current paint scheme, while regular tooltips look the same in all paint schemes.
If you want regular tooltips in your existing applications to become consistent with a current paint scheme, you do not need to modify the applications and replace your regular tooltips with SuperToolTips (you may, however, do this to extend tooltip display information). Instead, you can set the ToolTipController.ToolTipType property to SuperTip. In this mode, if a regular tooltip is about to be displayed, it is automatically transformed to a new SuperToolTip, which is then displayed onscreen. As a result, all your regular tooltips will have the same look and feel as SuperToolTips.
A regular tooltip consists of title and content regions. The title region can be omitted, if necessary. In addition, it is possible to display one of the predefined icons or a custom image within a regular tooltip. The following image shows sample regular tooltips.
By default, the tooltip's title is painted in bold. If you need to customize the appearance settings used to paint the title and content regions, use the ToolTipController.Appearance and ToolTipController.AppearanceTitle properties respectively.
Regular tooltips support text wrapping. To enable this feature, you can insert line break characters to the text where necessary.
SuperToolTip is an expandable tooltip that supports multiple regions. Tooltip regions are arranged one under another, and each can display specific text and graphics. The following image shows a sample SuperToolTip consisting of two regions.
You can also create SuperToolTips consisting of more than two regions, and add line separators if necessary. For example:
By default, SuperToolTips appearance is controlled by the current paint scheme. However, the Appearance property allows for the customizing of font settings and foreground color for each region. When a non-skinning paint scheme is applied, you can customize the tooltip's background and the default foreground color for all regions. To do this, use the DevExpress.Utils.BaseToolTipObject.Appearance property.
See the Creating SuperToolTips topic for information on creating SuperToolTip objects at design time and runtime.