|
|
|
|
|
- Overview
- How to?
- Customizing tooltips
- Special case: Using an application window to customize tooltips
- WLanguage functions and properties
Tooltips are very useful for application users. From version 26 onwards, sad tooltips are a thing of the past: use customized tooltips to display your messages. Several types of tooltips are available: - Standard tooltips:
- Skin template tooltips:
- Custom style tooltips:
- Tooltips customized via an application window.
Reminder The text displayed in the tooltip can be: - Entered in the 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.
- Specified via the ToolTip property.
Remarks: - Custom tooltips are used for all tooltips in the application:
- Control tooltips.
- Automatic tooltips for Table and List controls (displayed if the text is not complete in the control, for example).
- Custom tooltips are not used in the following cases:
- Chart control tooltips.
- Scrollbar tooltips.
- If your users customize the tooltip text via the AAf, the custom text will be displayed in the custom tooltip.
Customizing tooltips To customize tooltips in your application: - Open the project description window. To do so, go to the "Project" tab, "Project" group, and click "Description".
- On the "Style" tab, specify the type of tooltip to be used in the project:
- Standard: tooltips are standard, displayed on a yellow bubble background.
- Defined by template: the tooltips used are those present in the skin template used by the project..
- Custom: the tooltip style editor is displayed to define customization options:
You can customize: - The label displayed: font, size, shadow, color, etc.
- Bubble frame: margins, background color, frame type, etc.
- Window: You can then select a window in your project to display help in the form of a tooltip.. This option allows you to create all possible UIs.
- Validate the project description window. All tooltips displayed by your application will use the selected look.
Note: The tooltips can be animated.. To activate this animation: - Display the project description window: under the "Project" pane, in the "Project" group, click on "Description"..
- On the "Advanced" tab, click "Control animations".
- In "Tooltip", select and configured the desired animation.
- Validate.
- Validate the project description window.
Special case: Using an application window to customize tooltips WINDEV allows using a window of the application to display the content of the tooltips. In this case: - Only the declaration code of global variables of the window is executed.
- The declaration code of global variables of a window must contain the following code:
PROCEDURE DeclarationWindowGlobalVariables(TooltipText, SourceControl) STC_TOOLTIP = TooltipText where: - TooltipText is the text to be displayed in the tooltip. This text must be displayed in a Static Text control in the window (for example, STC_TOOLTIP).
- SourceControl is an optional parameter that contains the name of the control for which the tooltip is displayed.
- The option "Adapt the size according to the content" ("General" tab of the description window) must be checked.
- The window must use a background image with the clipping option enabled ("Clip the window (uses the transparency mode of the background image)" in the "Image tab of the description window).
- To display text with effects in the tooltip, you can, for example: This information must be specified in the tooltip of the control (e.g., in the "Help" tab of the control description window, or via the ToolTip property of the control).
- The "Modifier" pane contains specific options for windows displayed in tooltip mode. These options are as follows:
- "Tooltip mode": Activates or deactivates the tooltip display mode.. If this mode is enabled, the other options of the tooltip mode will be taken into account.
- "Bubble mode: X offset": Sets the X offset of the window (displayed as a bubble) relative to the mouse cursor. The mouse cursor corresponds to the point (0,0).
- "Bubble mode: Y offset": Sets the Y offset of the window (displayed as a bubble) relative to the mouse cursor. The mouse cursor corresponds to the point (0,0).
- "Bubble mode: Hot spot": Defines the point in the window (displayed as a bubble) that will be displayed at the position of the mouse cursor. This option allows creating speech bubble-like tooltips.
WLanguage functions and properties Several WLanguage functions and properties can be used to configure tooltips. The following functions and properties can be used on custom tooltips: - WLanguage functions:
| | ShowToolTip | Enables or disables the mechanism for displaying the control tooltips. | ToolTipDelay | Used to modify:- the timeout before displaying the tooltips.
- the display duration of the tooltips.
| TooltipMaxWidth | Modifies the maximum width of tooltips. |
- WLanguage properties:
| | AutomaticTooltip | The AutomaticTooltip property enables or disables automatic tooltips on List Box, Table and TreeView Table controls. | ToolTip | The ToolTip property gets and sets the text displayed in a tooltip. This tooltip can be associated with: - a control in a window or page,
New in SaaSa control in a report. 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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|