Texas Instruments TI-89 - Varnew

358
Appendix A: System Routines — Dialog
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
VarNew
Declaration:
HSYM
VarNew
(BYTE *
Types
{, BYTE *
subTypeList
[ ]})
Category(ies):
Dialog
Description:
Creates a standard NEW dialog box (go to the Program Editor and do a F1,
3 (New . . . ) as an example). The user may select from a list of types to
create as well as the folder to create it in and then may type in a variable
name.
Inputs:
Types
— An array, terminated by zero, of the following types:
GDB_VAR_TAG, PIC_VAR_TAG, TEXT_VAR_TAG,
DATA_VAR_TAG, MATRIX_TAG, LIST_TAG,
FUNC_BEGIN_TAG, PRGM_TAG, STR_DATA_TAG,
EQUATION_TAG, GEN_DATA_TAG. Each value in the
Types
list will be presented to the user in a drop-down
(unless there is only one value in the list then it will be a
static field).
subTypeList
(optional)
—
For each GEN_DATA_TAG byte in the
Types
list, there
must be a string pointer in the
subTypeList
that points to
the text to display in the drop down. This parameter may
be left off if there are no GEN_DATA_TAGs in the
Types
list.
Outputs:
The HSYM of the newly created symbol or H_NULL if the user presses
N
or there is an error creating the symbol.
Assumptions:
None
Side Effects:
May cause heap compression.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: VarOpen, VarSaveAs
(continued)