The FileSelector Object: 3.1 File Selector Instance Data: The GFSI_attrs Field

| Up: GEOS SDK TechDocs | Up | Prev: 3 File Selector Instance Data | Next: 3.2 The GFSI_fileCriteria Field 
GFSI_attrs, MSG_GEN_FILE_SELECTOR_GET_ATTRS, MSG_GEN_FILE_SELECTOR_SET_ATTRS

The GenFileSelector has ten attributes in GFSI_attrs , shown below. They are stored as a word-sized record of type FileSelectorAttrs ; they may be retrieved with MSG_GEN_FILE_SELECTOR_GET_ATTRS and set with MSG_GEN_FILE_SELECTOR_SET_ATTRS .

FSA_ALLOW_CHANGE_DIRS
This flag allows the user to change directories by double clicking; it is set by default.
FSA_SHOW_FIXED_DISKS_ONLY
This flag does not allow removable volumes (e.g. floppy disks) to be shown in the File Selector volume list. By default, this flag is off.
FSA_SHOW_FILES_DISABLED
This flag instructs the File Selector to display files as disabled. This is useful for SaveAs operations, for example, when files must be displayed but should not be selectable by the user. By default, this flag is off. Setting this flag will turn all other search criteria off, so all filenames will be displayed.
FSA_HAS_CLOSE_DIR_BUTTON
This flag causes the File Selector to include a "Close Directory" button.
FSA_HAS_OPEN_DIR_BUTTON
This flag causes the File Selector to include an "Open Directory" button.
FSA_HAS_DOCUMENT_BUTTON
This flag causes the File Selector to include a "Go to Document" button that displays the DOCUMENT directory.
FSA_HAS_CHANGE_DIRECTORY_LIST
This flag causes the File Selector to include a list that allows the user to change directories.
FSA_HAS_CHANGE_DRIVE_LIST
This flag causes the File Selector to include a list that allows the user to change drives.
FSA_HAS_FILE_LIST
This flag causes the File Selector to include a file list.
FSA_USE_VIRTUAL_ROOT
This flag causes the File Selector to use the information in the ATTR_GEN_FILE_SELECTOR_VIRTUAL_ROOT attribute. This allows changing the File Selector without altering the vardata.

MSG_GEN_FILE_SELECTOR_SET_ATTRS

void	MSG_GEN_FILE_SELECTOR_SET_ATTRS(
        FileSelectorAttrs attributes);

This message sets the File Selector's GFSI_attrs record to a new set of attributes. The File Selector will rescan the current directory using the new attributes. If the File Selector is not visible when it receives this message, it will set the attributes but will not rescan the directory.

Source: Unrestricted.

Destination: Any GenFileSelector object.

Parameters: attributes A record of FileSelectorAttrs to set into the File Selector's GFSI_attrs record.

Return: Nothing.

Interception: Generally not intercepted.

MSG_GEN_FILE_SELECTOR_GET_ATTRS

FileSelectorAttrs MSG_GEN_FILE_SELECTOR_GET_ATTRS();

This message returns the current attributes set in the File Selector's GFSI_attrs instance data.

Source: Unrestricted.

Destination: Any GenFileSelector object.

Parameters: None.

Return: A record of FileSelectorAttrs representing the flags set in the File Selector's GFSI_attrs field.

Interception: Generally not intercepted.

| Up: GEOS SDK TechDocs | Up | Prev: 3 File Selector Instance Data | Next: 3.2 The GFSI_fileCriteria Field