[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


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

    SYNOPSIS
        GadgetMouse( gadget, ginfo, mousepoint )
                     A0      A1     A2

        VOID GadgetMouse( struct gadgetinfo *, word * );

    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