Aide:GUIGetCursorInfo.txt

De Wiki AutoIt Français
Aller à : navigation, rechercher

Document original V3.3.6.1 :

###Function###
GUIGetCursorInfo

###Description###
Gets the mouse cursor position relative to GUI window.

###Syntax###
GUIGetCursorInfo ( [winhandle] )


###Parameters###
@@ParamTable@@
winhandle
	[optional] The handle of the window to use.  If omitted the "current" window will be used.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	returns a five-element array that containing the mouse cursor information:
	$array[0] = X coord (horizontal)
	$array[1] = Y coord (vertical)
	$array[2] = Primary down (1 if pressed, 0 if not pressed)
	$array[3] = Secondary down (1 if pressed, 0 if not pressed)
	$array[4] = ID of the control that the mouse cursor is hovering over (or 0 if none)
Failure:	0 and set @error to 1
@@End@@


###Remarks###
The coordinates given are relative to the GUI window (known as client coords).

If the "winhandle" parameter is used then the specified window becomes the new "current" window.

The mouse cursor position is successful only on an window created by a GUICreate. When no winhandle it will be successful if the GUI Windows is <b>active</b>.

ListViewItem or TreeViewItem controlID will never be returned, only the parent Listview or TreeView control ID is.

###Related###
GUICreate, GUIGetMsg


###Example###
@@IncludeExample@@


Document traduit V3.3.6.1 :

Texte en Français


Traducteur :

Contributeurs (pour les modifications avant le Wiki) :