40
Chapter 7: Flash Application Layout
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
•
value
— the value of a frame attribute. This can be a number, a pointer to a
string, a method entry point, or pointer to an application-defined structure —
anything which can fit in 32 bits.
The frame ends with an
ENDFRAME
macro.
The
FRAME
and
ATTR
macros create
const
data structures which reside in Flash
memory in the .text section of the application. For this reason, the
FRAME
macro
also sets the read-only flag in the object frame header.
7.3.1.2. Pointer to FRAME
The OS must be able to find the object frame in the application. The OS expects
the first initialized variable in an application to be a pointer to the application’s
object frame.
For example, say an application has an object frame named
myAppFrame
. Declare
an initialized frame pointer:
pFrame pAppFrame = (pFrame)&myAppFrame;
By declaring
pAppFrame
before any other initialized static variables, the first
variable in the .data section will be a pointer to the app frame — just where the
OS expects to find it.
7.3.1.3. Object Frame Attributes
Application object frames can contain many attributes and method entry points.
This section discusses the attributes and methods reserved by the OS.
Each attribute and method name is a C macro which defines a numeric selector
number. In addition, there are macros in tiams.h which fetch and set application
attributes and call application methods. The following slot descriptions state the
attribute or method name (slot number) and accessor prototypes.
Many application attributes are hard-coded in the source and are not meant to be
changed at run-time. The description of read-only attributes shows only the
macros to fetch their values.
7.3.1.3.1. Attribute OO_APP_FLAGS (0x1)
APP_Flags GetAppFlags(AppID)
0x0001 APP_INTERACTIVE
Application has an interactive interface. Its name
appears on the app’s menu. This flag is zero for
libraries and language localization apps.
0x0002 APP_CON
Attach Current/Open/New submenu to application
name on the app’s pop-up menu. This flag is ignored if
the app’s APP_INTERACTIVE flag is off.
To Next Page
Loading...
Need help?
General
