Texas Instruments TI-89 - Oo_Getattr

314
Appendix A: System Routines — Apps
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
OO_GetAttr
Declaration:
void *
OO_GetAttr
(pFrame
obj
, ULONG
selector
)
Category(ies):
Apps
Description:
Retrieves an attribute of an object frame.
The prototype chain of each frame in the parent hierarchy beginning with
obj
is searched until attribute
selector
is found.
Throws ER_ATTRIBUTE_NOT_FOUND error if the attribute
selector
cannot be found.
Global variable
OO_SuperFrame
is updated with the parent of the frame
where the attribute was located or NULL if the attribute was not found.
Inputs:
obj
— Object frame pointer.
selector
— Attribute selector number.
Outputs:
See description.
Assumptions:
Rarely would you call
OO_GetAttr
directly. The FDL compiler (see section
7.3.3.3. Frame Description Language
) compiles attribute declarations
into access macros with the call to
OO_GetAttr
containing the proper
selector number and return type cast. You would call the macro instead of
OO_GetAttr
.
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: OO_CondGetAttr, OO_GetAppAttr, OO_HasAttr, OO_SetAppAttr,
OO_SetAttr
Example:
char const *dateFormat;
dateFormat = (char const *)OO_GetAttr(MyAppObj, OO_DATE_FORMAT);
/* Better yet, call the macro generated by FDL: */
dateFormat = GetDateFormat(MyAppObj);