Unit 'intuition'	Package
[Overview][Constants][Types][Procedures and functions][Variables][Index]	[#os4units]

GadgetMouse

Calculate gadget-relative mouse position.

Declaration

Source position: intuition.pas line 3897

procedure GadgetMouse(

Gadget: PGadget;

GInfo: PGadgetInfo;

MousePoint: PSmallInt

);

Arguments

`Gadget`		A pointer to the Gadget
`GInfo`		A pointer to a GadgetInfo structure as passed to the custom gadget hook routine.
`MousePoint`		Address of two Words, or a pointer to a structure of type Point.

Description

Determines the current location of the mouse pointer relative to the upper-left corner of a custom gadget. Typically used only in the GM_HANDLEINPUT and GM_GOACTIVE custom gadget hook routines.

News flash!!: These two hook routines are now passed the mouse coordinates, so this function has no known usefulness.

We recommend that you don't call it.

Note that this function calculates the mouse position taking "gadget relativity" (GFLG_RELRIGHT, GFLG_RELBOTTOM) into consideration. If your custom gadget intends to ignore these properties, then you should either enjoin or inhibit your users from setting those bits, since Intuition won't ask if you respect them.

Errors

This function is useless, because programs which need this information can get it in a cleaner way. It is recommended not to call this function!