[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
        Prior to V39, this function ran with inadequate locking against
        the calls that Intuition's input task makes to the gadgets.
        To run properly prior to V39, this function, input processing,
        and and the gadget's dispatcher 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.