The LoadFileName Plugin is used to load a file name into a variable by displaying a dialog window for the user to browse the operating system.
Syntax:
PLUGIN LoadFileName VarName|<options>
Options:
Option |
Value |
Description |
FULLPATH |
ON/OFF |
Determines if the full path for the selected file is returned with the file name |
TITLE |
value |
Specifies the title caption |
FILTER |
value |
Filters the display files (Example: Text Files (*.txt)#*.txt) |
INITIAL_DIR |
value |
Specifies the initial directory when launched |
NO_CHANGE_DIR |
ON/OFF |
Determines if the directory changes when the file is selected |
MULTISELECT |
ON/OFF |
Determines if multiple files can be selected |
SHOW_HIDDEN |
ON/OFF |
Determines if hidden files can be seen |
NO_LONG_NAMES |
ON/OFF |
Determines if files not using the 8.3 naming convention are displayed. This is only supported with the OLD_STYLE parameter. |
NO_NETWORK_BUTTON |
ON/OFF |
Determines if the network button is displayed. This is only supported with the OLD_STYLE parameter. |
HIDE_READ_ONLY |
ON/OFF |
Determines if the "Open as Read Only" check box is displayed |
NO_DEREFERENCE_LINKS |
ON/OFF |
Determines if shortcut links are valid or are de-referenced |
DONT_ADD_TO_RECENT |
ON/OFF |
Determines if file selection is added to recently opened documents |
ENABLE_SIZING |
ON/OFF |
Determines if the dialog window can be resized |
OLD_STYLE |
ON/OFF |
Determines if the "old style" window is displayed |
NO_VALIDATE |
ON/OFF |
Determines if validation for invalid characters is used |
Where:
VarName is the variable name to return the text value of the selected file
Notes:
•Each option must be separated by pipe "|" character.
•A value of '[Esc]' will be returned if the [Cancel] button or Close Window [x] button of the folder selection dialog is selected.
•Use the pound character for multiple file type filters e.g. BMP Files (*.bmp)#*.bmp#JPEG Files (*.jpg)#*.jpg
Example:
PLUGIN LoadFileName vFileName+
|INITIAL_DIR C:\RBTI\ +
|TITLE 'Select file to load' +
|FULLPATH ON+
|NO_CHANGE_DIR ON+
|FILTER JPG Files (*.jpg)#*.jpg+
|HIDE_READ_ONLY ON+
|MULTISELECT ON+
|SHOW_HIDDEN OFF+
|ENABLE_SIZING ON
