###Function###
WinSetOnTop

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

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


###Parameters###
@@ParamTable@@
title
	The title of the window to affect. See <a href="../intro/windowsadvanced.htm">Title special definition</a>.
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
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1. 
Failure:	Returns 0 if window is not found. 
@@End@@


###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###
@@IncludeExample@@
