ToolTip

Shows an always-on-top window anywhere on the screen.

ToolTip , Text, X, Y, WhichToolTip

Parameters

Text

If blank or omitted, the existing tooltip (if any) will be hidden. Otherwise, specify the text to display in the tooltip. To create a multi-line tooltip, use the linefeed character (`n) in between each line, e.g. Line1`nLine2.

If Text is long, it can be broken up into several shorter lines by means of a continuation section, which might improve readability and maintainability.

X, Y

If blank or omitted, the tooltip will be shown near the mouse cursor. Otherwise, specify the X and Y position of the tooltip relative to the active window (use CoordMode, ToolTip to change to screen coordinates). These parameters can be expressions.

WhichToolTip

If blank or omitted, it defaults to 1 (the first tooltip). Otherwise, specify a number between 1 and 20 to indicate which tooltip to operate upon when using multiple tooltips simultaneously. This parameter can be an expression.

Remarks

A tooltip usually looks like this: ToolTip

If the X and Y coordinates caused the tooltip to run off-screen, or outside the monitor's working area on Windows 8 or later, it is repositioned to be entirely visible.

The tooltip is displayed until one of the following occurs:

A GUI window may be made the owner of a tooltip by means of Gui +OwnDialogs. Such a tooltip is automatically destroyed when its owner is destroyed.

CoordMode, TrayTip, GUI, Progress, SplashTextOn, MsgBox, InputBox, FileSelectFile, FileSelectFolder

Examples

Shows a multiline tooltip at a specific position in the active window.

ToolTip, Multiline`nTooltip, 100, 150

Hides a tooltip after a certain amount of time without having to use Sleep (which would stop the current thread).

#Persistent
ToolTip, Timed ToolTip`nThis will be displayed for 5 seconds.
SetTimer, RemoveToolTip, -5000
return

RemoveToolTip:
ToolTip
return