The FileSelector Object: 4.4 File Selector Use: Setting Scalable UI Data

HINT_FILE_SELECTOR_SCALABLE_UI_DATA

The File Selector lets you set which features you want based on the current application features, using HINT_FILE_SELECTOR_SCALABLE_UI_DATA . This hint will query the application object to get the current application features set, and it will set the File Selector's feature set (GFSI_attrs ) accordingly.

The hint takes an array of GenFileSelectorScalableUIEntry structures, each of which has three fields:

GFSSUIE_command: This field is a GenFileSelectorScalableUICommand , which is an enumerated type describing the effect of this particular entry. The five commands are detailed below.
GFSSUIE_appFeature: This word represents the application's feature set or user level. The hint, when processed, will query the GenApplication object (the GAI_appFeatures value) and check those features against the features in this field. If they match, the hint will cause the features in GFSSUIE_fsFeatures to be set or cleared as appropriate.
GFSSUIE_fsFeatures: This field represents the File Selector attributes that should be turned on or off depending on the command and the application features (see both fields above). The commands are defined below.

Following are the GenFileSelectorScalableUICommand s. Each queries the GFSSUIE_appFeature field and then acts appropriately.

GFSSUIC_SET_FEATURES_IF_APP_FEATURE_ON: This command will set the features in GFSSUIE_fsFeatures if the feature(s) in GFSSUIE_appFeature are turned on.
GFSSUIC_SET_FEATURES_IF_APP_FEATURE_OFF: This command will set the features in GFSSUIE_fsFeatures if the feature(s) in GFSSUIE_appFeature are off.
GFSSUIC_ADD_FEATURES_IF_APP_FEATURE_ON: This command will turn on the additional features in GFSSUIE_fsFeatures if the features in GFSSUIE_appFeature are turned on.
GFSSUIC_SET_FEATURES_IF_APP_LEVEL: This command will set the features in GFSSUIE_fsFeatures if the application is at the user level specified in GFSSUIE_appFeature .
GFSSUIC_ADD_FEATURES_IF_APP_LEVEL: This command will add the additional features in GFSSUIE_fsFeatures if the application is at the user level specified in GFSSUIE_appFeature .

GEOS SDK TechDocs |

4.3 Rescanning Directories