ToolTip (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Special features
Tooltip of a Tab control
Tooltip of a Radio Button and/or Check Box control
Tooltip associated with row of a TreeView control
Tooltip associated with a Table control and its columns
Tooltip associated with an element of a Breadcrumb control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ToolTip (Property)

In french: Bulle

The property tooltip property lets you view and modify the text displayed in a tooltip. This tooltip can be linked to:

to a window field,
to a page control,
New in SaaS
to a state field. In this case, the tooltip will only be visible in the report viewer.
Note: This feature is only available from WINDEV Suite SaaS 2025 - Update 3.
For more details, see Using new features exclusive to WINDEV Suite SaaS 2025.

Reminder To enter the message displayed in the tooltip of a field in the window or page editor:

Open the control description window (select "Description" in the context menu).
On the "Help" tab, in the "Tooltip" area, type the text of the tooltip.
Remarks:
- In a multilingual application, the text of the tooltip can be typed in several languages.
- If the "RTF" option is checked, the text can be formatted via the options of the RTF toolbar. The formatting will be maintained at runtime.

Example

// Changer le texte de la bulle d'aide en fonction du type d'utilisateur
IF Type_Util = 0 THEN
	SAI_Nom.Bulle = "Saisissez le nom du client"
ELSE
	SAI_Nom.Bulle = "Nom du client"
END

// Changer le texte de la bulle d'aide de l'élément en cours 
// dans un champ Arbre
ARBRE_ArbreRépertoire[ARBRE_ArbreRépertoire].Bulle = "Nouvelle bulle d'aide"

// Changer le texte de la bulle d'aide en utilisant les fonctions gXXX
// dans un champ de saisie 
SAI_SaisieTxt.Bulle = gPen(LightRed) + ...
	gFont("Comic sans MS") + ...
	gFontUnderlined(True) + ...
	"Test des bulles d'aide avec les fonctions gXXX" + ...
	CR + gImage("petit chien.gif") + "TEST" + gFontBold(True) + "TEST"

// Changer le texte de la bulle d'aide en utilisant un fichier au format RTF
SAI_SaisieTxt.Bulle = fLoadText("C:\Temp\MonFichier.RTF")

// Changer le texte de la bulle d'aide de l'élément 2
// dans un champ Chemin de Navigation
SMP_CheminNavigation[2].Bulle = "Nouvelle bulle d'aide"

Syntax

Getting the tooltip text Hide the details

<Tooltip text> = <Control used>.ToolTip

<Tooltip text>: Character string

Current text of the tooltip associated with the control.
Note If the bubble text is in RTF, the returned text will contain the RTF tags.

<Control used>: Control name

Name of the control for which you want to get the tooltip text.

Changing the tooltip text Hide the details

<Control used>.ToolTip = <New tooltip text>

<Control used>: Control name

Name of the control for which you want to change the tooltip text.

<New tooltip text>: Character string

New tooltip text associated with the control. If this text is an empty string (""), no tooltip will be displayed.
This text can contain images and be formatted using the gXXX WLanguage functions.
This text can be in RTF (RTF file or text with RTF tags).

Remarks

Special features

The ToolTip property can be used to insert images and colored text into the tooltip via the gXXX functions.
The ToolTip property allows you to insert RTF content in tooltips.
End users can modify the tooltips in their applications. For more details, see Control tooltips (AAF).
The tooltip text can be displayed in a standard or custom tooltip. For more details, see Custom tooltips.

Tooltip of a Tab control

You can define a tooltip for each tab of a Tab control.

Tooltip of a Radio Button and/or Check Box control

You can define a tooltip for the control and for each of its options. For example:

SEL_MonSelecteur[1].Bulle = "Option Numéro 1"

Tooltip associated with row of a TreeView control

You can define a tooltip for each element o a TreeView control (TreeAdd, TreeInsert and TreeModify).

Tooltip associated with a Table control and its columns

You can define a tooltip for a Table control and for each of its columns. The tooltip of the Table control is displayed if you hover over a column that doesn't have a tooltip.

Tooltip associated with an element of a Breadcrumb control

For Breadcrumb controls, the tooltip of each path element is defined:

in the page editor, in the control description.
when adding, inserting or changing an element programmatically (with BreadcrumbAddLink, BreadcrumbInsertLink or BreadcrumbModifyLink).

The ToolTip property gets and changes the tooltip of each element of the breadcrumb. For example:

SMP_MonChemin[1].Bulle = "Bulle élément 1"

Limitations

The ToolTip property applies only to windows and controls (including columns and cells of a table). This property cannot be used with menus.

The ToolTip property must be modified before the control hover event to take advantage of the "Tooltip (CSS)" format.

The ToolTip property can only be used in the following controls:

Button control.
Static Text control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
TreeView control.
Tab control.
Table control.
Table control columns (Text, Combo Box or Check Box type).