[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.