Appendix A: System Routines — Apps
313
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
OO_GetAppAttr
Declaration:
void *
OO_GetAppAttr
(AppID
app
, ULONG
selector
)
Category(ies):
Apps
Description:
Retrieves an attribute of an app’s object frame.
The prototype chain of each frame in the parent hierarchy beginning with
the object frame of application
app
is searched until attribute
selector
is
found.
Throws ER_ATTRIBUTE_NOT_FOUND error if 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:
app
— ID of application containing object frame where attribute
search should begin.
selector
— Attribute selector number.
Outputs:
See description.
Assumptions:
Rarely would you call
OO_GetAppAttr
directly. The FDL compiler (see
section
7.3.3.3. Frame Description Language
) compiles attribute
declarations into access macros with the call to
OO_GetAppAttr
containing the proper selector number and return type cast. You would call
the macro instead of
OO_GetAppAttr
.
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: OO_CondGetAttr, OO_GetAttr, OO_HasAttr, OO_SetAppAttr,
OO_SetAttr
Example:
int version;
version = (int const)OO_GetAppAttr(theApp, OO_APP_VERSION);
/* Better yet, call the macro generated by FDL: */
version = GetAppVersion(theApp);
To Next Page
Loading...
Need help?
General
