Texas Instruments TI89 Developer Guide - Page 404

362 Appendix A: System Routines - Dialog VarSaveAs Declaration: HSYM VarSaveAs (BYTE * Types, BYTE * Current, {, BYTE * subTypeList [ ]}) Category(ies): Dialog, Variables Description: Creates a standard SAVE COPY OF [Current] AS dialog box (go to the Program Editor and do a F1, 2 (Save Copy As . . . ) as an example). The user may select from a list of types to save as well as the folder to save the symbol in and finally is presented with an edit box to enter the symbol 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). Current - A string pointer to a string that will be placed in the title of the dialog box (NULL if no title wanted). subTypeList - For each GEN_DATA_TAG byte in the Types list, there (optional) 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. The first WORD in the global array, VarOptList, is set to the index of the type selected when Types contains multiple values. It will be one if the first entry was selected, two for the second entry, and so on. See the example below. VarOptList is available on AMS 2.00 and higher. Availability: All versions of the TI-89 / TI-92 Plus. TI-89 / TI-92 Plus Differences: None See Also: VarNew, VarOpen Example: See VarNew. TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001