Foldercur - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Symbol Table Utilities

FolderCur

Declaration:
BOOL FolderCur (const BYTE * FolderName , BOOL CheckGraphDirty )
Category(ies):
Symbol Table Utilities
Description:
Make the given folder the default folder. Return TRUE if folder is valid, FALSE
otherwise. CheckGraphDirty should always be set to TRUE.
FolderName
Inputs:
CheckGraphDirty — Set to TRUE (if FALSE, the current graph can
Outputs: TRUE
FALSE
Assumptions:
push_setfold is similar except that push_setfold throws any errors and returns
the current previous default folder on the estack as well as updating the status line
with ST_folder.
NOTE: Caller must call ST_folder to update the status line unless this is a temporary
Side Effects:
Status line is NOT updated to reflect current folder.
Availability:
All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also:
push_setfold, push_getfold, FolderGetCur
Example:
WORD TokenizeFoldName( const char *strFileName, BYTE *TokFName );
DWORD NoCallBack( WORD DlgId, DWORD Value ) { return TRUE; }
/* Prompt the user for a folder name and set that to the current default folder.
If the user enters nothing or an invalid name, reprompt this time with the
current folder. Return TRUE if valid name entered, FALSE otherwise
*/
BOOL tFolderGetSet( void )
{ HANDLE dH = H_NULL;
BYTE szBuf[SYM_LEN+1], TokFName[MAX_SYM_LEN], *StrPtr;
TI-89 / TI-92 Plus Developer Guide
— EStackIndex of folder name.
become invalid).
— If successful.
— Invalid folder name.
folder.
(continued)
Not for Distribution
1015
Beta Version January 26, 2001