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

The Intuition function GetAttr() asks an object what the value of a
specific attribute is:

    ULONG GetAttr(ULONG attrID, APTR myobject, ULONG *mydata);

where attrID is the attribute's ID number, myobject is the object to get
the attribute from, and mydata points to a data area that will hold the
attribute value.  This function returns a 0L if the object doesn't
recognize the attribute, otherwise it returns some non-zero value, the
meaning of which depends on the class.  In most cases, GetAttr() returns a
1 when it is successful.

Not all object attributes are obtainable using the GetAttr() function.
Some classes are set up so that applications cannot query the state of
certain attributes.  For example, using the GA_Image attribute, an
application can give a Boopsi prop gadget (propgclass) an Image structure
which the gadget uses as the imagery for its knob. This attribute is not
"gettable" as there is no need for an application to have to ask the
gadget for the structure that the application passed it in the first
place.  Whether or not a specific attribute is "gettable" is class
dependent.  For more information about the attributes of specific classes,
see the Boopsi Class Reference in the Appendix B of this manual.