[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Forms' (#lcl)

# TApplication.ShowHintWindow

Shows or hides the hint window for a control in the application.

## Declaration

Source position: forms.pp line 1581

`protected procedure TApplication.ShowHintWindow(`
`const Info: THintInfoAtMouse`
`);`

## Arguments

`Info` |  | Contains information about the hint control, its mouse coordinates, and the hint text used in the method.

## Description

ShowHintWindow performs actions needed to display hint text in a pop-up window for the control represented by the mouse coordinates in the Info argument. No actions are performed in the method if ShowHint has not been enabled, or a valid hint control cannot be determined for the application.

ShowHintWindow maintains an internal THintInfo structure used to store information with the text for the hint, configuration information about its display window, and the control for the hint.

For a valid parented hint control, handler routines are signalled to check whether the hint can be displayed for the application. The OnShowHint event handler(s) are signalled first (when assigned) to determine the hint text or hint data. Additional OnShowHint handlers assigned using AddOnShowHintHandler are signalled next.

If the hint text or hint data was not assigned in the event handlers, the hint text for the hovered control is used. Only the first "|"-delimited line of text in TControl.Hint is used for the hint.

The hint window for the application is created (or re-created) and configured as needed, and the show hint command is performed for the hint control. The ActivateHintData method in the hint window is called to display (or hide) the hint window and activate (or reset) the auto-hide timer.

If the hint control is no longer valid or the hint text is empty, the HideHint method is called to hide an existing hint window.

## See also

TApplication.ShowHint |  | Indicates if Hints are displayed for the application.
TApplication.HideHint |  | Hides the Hint window.
TApplication.OnShowHint |  | Event handler signalled prior to displaying a hint window.
TApplication.StartHintTimer |  | Starts the timer for display of a hint message.
THintWindow.ActivateHintData |  | An alternate version of ActivateHint with additional data used for the hint display.
THintWindow.ActivateHint |  | Shows the hint window with the specified hint text.
HintWindowClass |  | The class type used to create hint window instances for an application.
TControl.Hint |  | The text to show in the Hint window for the control.
THintInfo |  | Contains content and state information for Hints displayed for a window or control.