# Function Reference

WinSetOnTop

Change a window's "Always On Top" attribute.

WinSetOnTop ( "title", "text", flag )

Parameters

title | The title of the window to affect. See Title special definition.
text | The text of the window to affect.
flag | Determines whether the window should have the "TOPMOST" flag set. 1=set on top flag, 0 = remove on top flag

Return Value

Success: | Returns 1.
Failure: | Returns 0 if window is not found.

Remarks

Third-party programs which add an "Always On Top" context menu entry might not update their menu entry to reflect the AutoIt-induced change in TOPMOST status.

Related

WinSetState

Example

WinSetOnTop("Untitled -", "", 1)