 |
VarSaveAs |
Function (ROM Call 0x28D) |
Displays the standard "Save Copy As" dialog.
VarSaveAs implements the standard "Save Copy As" dialog. The user may select
a type as well as the folder to save the symbol in, and finally has to enter
the symbol name.
FileTypes is a pointer to a zero-terminated array of types that are
supported (see VarOpen for more info).
TitleSym is a string that will be placed in the title of the dialog
box (the title will have the form "SAVE COPY OF TitleSym AS").
Alternatively, TitleSym may be NULL
if no such title is wanted.
VarSaveAs returns the HSym descriptor of the
newly created symbol, or H_NULL if the
user pressed 'ESC' or in case of an error. This function is essentially the
same as VarNew, only the different dialog type
is used.
This function may cause heap compression.
Uses: DialogAdd, DialogDo, DialogNew, HeapFree, ER_catch, ER_success, ERD_dialog, TokenizeSymName, top_estack, memset, PopupAddText, PopupNew, PopupText, VarCreateFolderPopup, strcat, strlen, XR_stringPtr, DataTypeNames, FirstNonblank, VarOptList, VarSaveTitle, FindSymInFolder, StrToTokN, SymSysVar, VarStore
Used by: GT_SaveAs
See also: VarNew, VarOpen