 |
FolderCur |
Function (ROM Call 0x65) |
Sets the currently active folder.
FolderCur sets the currently active folder to SymName (see
SYMSTR for rules about SymName). It
returns TRUE if the operation was
successful, else returns FALSE (e.g. if
the folder name is invalid).
nonSys is a boolean flag which normally needs to be
TRUE. If it is set to
TRUE, FolderCur calls
SymFindNext repeatedly until the
first non-system variable in this folder is reached. This is necessary, else
the current graph may become invalid. In particular, if the graph references
a variable defined in a folder which previously was the current folder, it is
not redrawn if nonSys is set to
FALSE.
Note: The folder name in the status line will not be changed
automatically using this command. You must change it manually using the
function ST_folder from
statline.h.
This routine may cause heap compression.
Uses: CheckSysFunc, SymCmp, SymCpy, SymCpy0, SymFindFirst, SymFindNext, TokToStrN, gr_active, gr_other, strcmp, statFree, _mu16u16
Used by: cmd_newfold, push_setfold, MO_digestOptions
See also: FolderGetCur, FolderCurTemp