s = pathname(path_type ‖ dictionary_name ‖ file_handler);
The following path_type arguments return the folder name associated with a special directory on your device:
|Application||The folder where the application file (.ent or .bch) is located.|
|CSPro||The folder where the CSPro executable files are located.|
|InputFile||The folder where the main data file (associated with the primary dictionary) is located.|
|Temp||The operating system's temporary directory.|
There are some options specific to Windows:
|CSEntry||If the Universal Windows CSEntry mobile application has been installed on the system, this will return the "Entry Apps" folder where data entry applications for the mobile application are stored. All program and data files used by the Universal Windows mobile application must be stored in this folder. Desktop applications can access files in this folder to share data between mobile and desktop applications.|
|Documents||The current user's Documents folder.|
|Desktop||The current user's Desktop folder.|
|ProgramFiles32||The folder containing installed 32-bit applications.|
|ProgramFiles64||The folder containing installed 64-bit applications. If the computer has only a 32-bit processor, this returns the same value as ProgramFiles32.|
|Windows||The folder contains the Windows operating system.|
There are some options specific to mobile devices:
|CSEntry||The folder from which CSPro applications are run.|
|CSEntryExternal||On devices with removable storage (e.g., an SD card), the folder on removable storage to which CSPro applications can write.|
If supplying a dictionary_name, the function returns the folder name of the dictionary file (.dcf) itself, not of the data file associated with the dictionary. On mobile devices, the function returns the folder name of the .pen file because dictionary files (.dcf) are not used directly when running .pen applications.
If providing a file_handler
(declared in a file
statement in PROC GLOBAL
), the function returns the folder name containing the text file associated with the file handler.
The function returns a string containing the fully qualified folder name.