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

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

	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, ... );

	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.

	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.

	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.

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

	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.

	NewObject(), DisposeObject(), GetAttr(), MakeClass(),
	Document "Basic Object-Oriented Programming System for Intuition"
	and the "boopsi Class Reference" document.

[Back to Amiga Developer Docs]