The INI File: 2.33 Categories in the INI File: [ui features]

The ui features category defines the UI configuration used by the environment application (e.g. Welcome) and all applications on the execOnStartup list in the ui category. On systems with no environment application, this category defines the UI configuration for all applications.

Related categories, uiFeatures - intro , uiFeatures - beginner , and uiFeatures - advanced , support the same keys. Each of these categories defines the configuration for a specific "room" of the Welcome application. Other environment applications will also use these keys for different "rooms."

backupDir

backupDir = <relative path>

This key defines the directory in which the document control object will place quick-backup copies of document files. The default is PRIVDATA\BACKUP.

backupDir = DOCUMENT\BACKUP

defaultLauncher

defaultLauncher = <relative path>

This key defines the directory and application that acts as the default application launcher. This key should always have some application specified; otherwise, no application will start when GEOS loads. The path specified should be relative to the WORLD directory.

defaultLauncher = Utilities\GeoManager

docControlFSLevel

docControlFSLevel = <number>

This key specifies the document control's file selector user level. The file selector box has three different configurations; set the appropriate number (below) to determine which configuration is used.

0	No directories
1	Directories shown, simple UI configuration
2,3	Directories shown, complete UI configuration

An example of setting the file selector level is shown below.

docControlFSLevel = 2

docControlOptions

docControlOptions = <number>

This key turns on or off a number of other features in the document control object. The features are controlled by the bits set or clear in the number given. The five most significant bits of a 16-bit integer are used and have the following meanings, listed from most significant bit:

DCO_BYPASS_BIG_DIALOG (0x8000): If set, this indicates that the big dialog box normally presented for New File/Open File/Use Template operations should be bypassed (not used). For advanced users, this bit should be clear. For novice users, this bit should be set.
DCO_TRANSPARENT_DOC (0x4000): If set, this indicates that a "Switch Document" metaphor should be used in place of the New/Open/Close metaphor for document management. This will allow only a single document open at a time and will immediately prompt if no document is open. For introductory and novice users, this bit should be set.
DCO_HAVE_FILE_OPEN (0x2000): If set, this indicates that there is an Open button in the File menu (subject to specific UI rules). This is typically not set.
DCO_FS_CANNOT_CHANGE (0x1000): If set, this indicates that the file selector used by the document control object can not change configuration; that is, the file selector will not offer the option of switching between full and simple configurations.
DCO_NAVIGATE_ABOVE_DOC (0x0800): If set, this indicates that the document control object's file selector will allow the user to navigate directories. If cleared, the user may not navigate above the default document directory.

expressOptions

expressOptions = <number>

This key defines the configuration of the express menu. It sets and clears features based on the least significant 11 bits of a 16-bit number. Each bit, from the most significant used (bit 10) down to the least significant, is detailed below.

UIEO_GEOS_TASKS_LIST: If set, this indicates that the express menu should contain a list of currently-running applications.
UIEO_DESK_ACCESSORY_LIST: If set, this indicates that the express menu should contain a list of applications in the World\Desk Accessories directory.
UIEO_MAIN_APPS_LIST: If set, this indicates that the express menu should contain a list of applications in the World directory.
UIEO_OTHER_APPS_LIST: If set, this indicates that the express menu should contain a hierarchical list of applications in subdirectories of the World directory.
UIEO_CONTROL_PANEL: If set, this indicates that the express menu should contain a control panel area.
UIEO_DOS_TASKS_LIST: If set, this indicates that the express menu should contain a list of available DOS tasks accessible by a task switcher.
UIEO_UTILITIES_PANEL: If set, this indicates that the express menu should contain a utilities panel area.
UIEO_EXIT_TO_DOS: If set, this indicates that the express menu should contain an "Exit to DOS" type of trigger.
UIEO_POSITION: This is a three-bit field indicating where the express menu should appear. Three different values are allowed:

Some examples of this key are shown below.

expressOptions = 617					; Introductory
	;  617 = 0x0269 = 0000 0010 0110 1001
	; The bits turned on are listed below:
	; UIEO_DESK_ACCESSORY_LIST
	; UIEO_CONTROL_PANEL
	; UIEO_DOS_TASKS_LIST
	; UIEO_EXIT_TO_DOS
	; UIEO_POSITION = 1, upper left of window
expressOptions = 889					; Beginner
	;  889 = 0x0379 = 0000 0011 0111 1001
expressOptions = 2041					; Advanced
	; 2041 = 0x07F9 = 0000 0111 1111 1001

helpOptions

helpOptions = <number>

This key defines the configuration used by the help controller object. Specifically, it determines whether the help controller will automatically provide help triggers in the GenPrimary and in dialog boxes. The default is to allow help triggers to be created and displayed. Only the least significant bit of a 16-bit number is used, and that bit's significance is shown below.

UIHO_HIDE_HELP_BUTTONS: If set, this indicates that the help controller should not display help triggers in the GenPrimary or in dialog boxes.

interfaceLevel

interfaceLevel = <number>

This key determines the interface level of applications that use the ui features category for their configurations. The four values allowed are shown in the examples below.

interfaceLevel = 0				; Introductory
interfaceLevel = 1				; Beginner
interfaceLevel = 2				; Intermediate
interfaceLevel = 3				; Advanced

interfaceOptions

interfaceOptions = <number>

This key determines two different features of the UI in general. It uses the two most significant bits of a 16-bit integer; the two bits have the following meanings.

UIIO_OPTIONS_MENU: If set, this indicates that an Options menu should exist.
UIIO_DISABLE_POPOUTS: If set, this indicates that the UI should not allow GIV_POPOUT GenInteraction objects to pop in an out.

launchLevel

launchLevel = <number>

This key controls the interface level of the applications allowed to be launched under the particular field ("room" of the environment application). It allows four values as shown in the examples below.

launchLevel = 0			; Introductory
launchLevel = 1			; Beginner
launchLevel = 2			; Intermediate
launchLevel = 3			; Advanced

launchModel

launchModel = <number>

This key controls how applications are started and exited. It allows four values, each of which defines a different level of user.

launchModel = 0			; Transparent (user does not
			; realize he is starting an
			; application
launchModel = 1			; Single instance only
launchModel = 2			; Multiple instances allowed
launchModel = 3			; Advanced features allowed

launchOptions

launchOptions = <number>

This key controls how applications are started and exited; specifically, it has a single flag which determines whether any applications are allowed to be in desk accessory mode. This defaults to true to allow desk accessories. The single flag is the most significant bit of a 16-bit integer.

UILO_DESK_ACCESSORIES: If set, this indicates that desk accessories should be allowed.

quitOnClose

quitOnClose = <Boolean>

If true, this key forces the closure of all applications in a room before that room may be exited. This will cause state saving to be turned off. The default for this flag is false. One note: setting quitOnClose = true and launchModel = 0 can result in undesirable behavior.

quitOnClose = true
quitOnClose = false

windowOptions

windowOptions = <number>

This key controls different window system options. The precise interpretation of each flag is up to the specific UI. The high 8 bits form a mask of the bits to affect. The low 8 bits indicated whether the masked bits should be turned on or off. Of the eight bits, the high one is meaningless; the seven flags are listed below. You should not set these, however, unless you are familiar with the workings of the UI and the specific UI.

UIWO_MAXIMIZE_ON_STARTUP: If true, application primary windows will come up maximized. Desk accessory applications may override this behavior.
UIWO_COMBINE_HEADER_AND_MENU_IN_MAXIMIZED_WINDOWS: If true, the title bar and menu bar areas of maximized windows will be combined to save screen space. Only the window gadgetry and menus are retained; title strings are eliminated.
UIWO_PRIMARY_MIN_MAX_RESTORE_CONTROLS: If true, window gadgetry for maximizing, minimizing, and restoring the window will be included on the screen.
UIWO_WINDOW_MENU: If true, a Window menu for keyboard control of minimize, maximize, restore, move, resize, and close operations will be provided. If false, only a "close" button will appear in the menu's place.
UIWO_PINNABLE_MENUS: If true, menus will be pinnable.
UIWO_KBD_NAVIGATION: If true, keyboard accelerators and keyboard navigation will be enabled.
UIWO_POPOUT_MENU_BAR: If true, menu bars will be allowed to pop out to be dialog boxes. This should be used in limited situations because specific UIs may not provide gadgetry to restore the menu bar if the dialog is closed.

GEOS SDK TechDocs |

2.32 [<specific ui name>] | Next:

2.34 [welcome]