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


    NAME
        DoGadgetMethodA -- Invoke method on a boopsi gadget. (V39)
        DoGadgetMethod -- Varargs stub for DoGadgetMethodA(). (V39)

    SYNOPSIS
        result = DoGadgetMethodA( gadget, window, requester, message )
        D0                        A0      A1      A2         A3

        ULONG DoGadgetMethodA( struct gadget *, struct window *,
                struct requester *, msg );

        result = DoGadgetMethod( gadget, window, requester, methodid, ...)

        ULONG DoGadgetMethod( struct gadget *, struct window *,
                struct requester *, ulong, ... );

    FUNCTION
        Same as the domethod() function of amiga.lib, but provides context
        information and arbitration for classes which implement custom
        Intuition gadgets.

        You should use this function for boopsi gadget objects,
        or for "models" which propagate information to gadgets.

        Unlike domethod(), this function provides a gadgetinfo pointer
        (if possible) when invoking the method.  Some classes may
        require or benefit from this.

    INPUTS
        gadget = abstract pointer to a boopsi gadget
        window = window gadget has been added to using addglist() or addgadget()
        requester = for reqgadgets, requester containing the gadget
        msg = the boopsi message to send

    RESULT
        The object does whatever it wants with the message you sent,
        which might include updating its gadget visuals.

        The return value is defined per-method.

    NOTES
        This function invokes the specified method with a gadgetinfo
        derived from the 'Window' and 'Requester' pointers.  The gadgetinfo
        is passed as the second parameter of the message, except for
        OM_NEW, OM_SET, OM_NOTIFY, and OM_UPDATE, where the gadgetinfo
        is passed as the third parameter.

        Implementers of new gadget methods should ensure that the
        gadgetinfo is the second long-word of their message!

    SEE ALSO
        newobject(), disposeobject(), getattr(), makeclass(),
        Document "Basic Object-Oriented Programming System for Intuition"
        and the "boopsi Class Reference" document.