Skip to content
This repository has been archived by the owner on Nov 19, 2024. It is now read-only.

Latest commit

 

History

History
52 lines (35 loc) · 1.37 KB

GadgetMouse.md

File metadata and controls

52 lines (35 loc) · 1.37 KB

NAME

GadgetMouse -- Calculate gadget-relative mouse position. (V36)

SYNOPSIS

    GadgetMouse( Gadget, GInfo, MousePoint )
                 A0      A1     A2

    VOID GadgetMouse( struct GadgetInfo *, WORD * );

Links: Gadget GadgetInfo

FUNCTION

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.

INPUTS

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.

RESULT Returns nothing. Fills in the two words pointed to by MousePoint with the gadget-relative mouse position.

BUGS Useless, since equivalent information is now passed to every function that might have a use for this.

SEE ALSO