Varnew - Texas Instruments TI-89 Developer's Manual

358

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
subTypeList
(optional)
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
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Dialog
— 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).
— 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.
(continued)
Not for Distribution Beta Version January 26, 2001