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


NAME
    SetGadgetAttrsA -- Specify attribute values for a boopsi gadget. (V36)
    SetGadgetAttrs -- Varargs stub for SetGadgetAttrsA(). (V36)

SYNOPSIS
    result = SetGadgetAttrsA( gadget, window, requester, taglist )
    D0                        A0      A1      A2         A3

    ULONG SetGadgetAttrsA( struct gadget *, struct window *,
            struct requester *, struct tagitem * );

    result = SetGadgetAttrs( gadget, window, requester, tag1, ...)

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

FUNCTION
    Same as SetAttrs(), but provides context information and
    arbitration for classes which implement custom Intuition gadgets.

    You should use this function for boopsi gadget objects which have
    already been added to a requester or a window, or for "models" which
    propagate information to gadget already added.

    Typically, the gadgets will refresh their visuals to reflect
    changes to visible attributes, such as the value of a slider,
    the text in a string-type gadget, the selected state of a button.

    You can use this as a replacement for SetAttrs(), too, if you
    specify NULL for the 'Window' and 'Requester' parameters.

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
    TagList = array of tagitem structures with attribute/value pairs.

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

    The return value tends to be non-zero if the changes would require
    refreshing gadget imagery, if the object is a gadget.

NOTES
    This function invokes the OM_SET method with a gadgetinfo
    derived from the 'Window' and 'Requester' pointers.

BUGS
    There should be more arbitration between this function and
    the calls that Intuition's input task will make to the
    gadgets.  In the meantime, this function, input processing,
    and refreshing must be mutually re-entrant.

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