###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###
If successful, 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)

###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 <b>active</b> window created by a GUICreate.


###Related###
GUICreate, GUIGetMsg


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