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


   NAME
       LibDoGadgetMethodA -- dogadgetmethoda for v37 machines
       LibDoGadgetMethod -- Varargs stub for LibDoGadgetMethodA

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

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

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

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


   FUNCTION
       Same as the DoGadgetMethod() function of intuition.library V39,
       this function invokes a BOOPSI method and provides context
       information 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.

       On a V39 machine, this function calls the Intuition function.

   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.