The INI File: 2.31 Categories in the INI File: [ui]

Up: GEOS SDK TechDocs | Up | Prev: 2.30 [text] | Next: 2.32 [<specific ui name>]

autosave

autosave = <Boolean>

If true, this key tells GEOS to turn on the automatic backup feature; this may be set in the Preferences manager application.

autosave = true
autosave = false

autosaveTime

autosaveTime = <number>

This key indicates the number of seconds between autosave operations, if the autosave keyword is set to true. This may be set with the Preferences manager application.

autosaveTime = 300

background

background = <filename>

This key defines the file containing the picture to use as the background graphic. This is normally set by the Preferences manager application.

background = Bricks

backgroundattr

backgroundattr = <t, c, or x>

This key defines how the background picture should be displayed; it is normally set by the Preferences manager application.

t
Tile the picture.
c
Center the picture on the screen.
x
Place picture in upper-left corner of the screen.
backgroundattr = c
backgroundattr = t

backgroundcolor

backgroundcolor = <number>

This key defines the color of the background graphic. This is normally set by the Preferences manager application. The number is the color index of the color to be used.

backgroundcolor = 0
backgroundcolor = 12

deleteStateFilesAfterCrash

deleteStateFilesAfterCrash = <Boolean>

If true, this key tells GEOS to delete state files after every non-clean shutdown. If you set this, you will probably want to set the doNotDisplayResetBox key true as well.

deleteStateFilesAfterCrash = true
deleteStateFilesAfterCrash = false

doNotDisplayResetBox

doNotDisplayResetBox = <Boolean>

If true, this key tells GEOS not to display the system dialog box asking whether the user wants to reset the system or not after a crash. If you set this true, you should also set deleteStateFilesAfterCrash true, or some crashes may allow bad state files to keep GEOS from restarting properly.

doNotDisplayResetBox = true
doNotDisplayResetBox = false

execOnStartup

execOnStartup = <program list>

This key defines applications to be run when the UI is loaded (when GEOS starts up), named for their GEOS long names. The default is not to execute any additional programs.

execOnStartup = {				Lights Out Launcher
				CD Player Application }

generic

generic = <file name>

This key defines the generic UI library that is to be used by GEOS. You will not need to set this; it will default to ui.geo.

generic = ui.geo
generic = uiec.geo

hardIconsLibrary

hardIconsLibrary = <string>

This is the long name of the library which provides the hard icon UI for a PC-based demo of a PDA device.

haveEnvironmentApp

haveEnvironmentApp = <Boolean>

If true, this key indicates that GEOS is using an environment application such as Welcome. If an environment application is being used, that application must be specified in the defaultLauncher key in the uiFeatures category. During debugging, you may set this key false and set the execOnStartup key to the application you're debugging to have GEOS come up directly into your application.

haveEnvironmentApp = true
haveEnvironmentApp = false

hwr

hwr = <file name>

This key indicates the handwriting recognition library to be loaded, if any. If GEOS is not on a pen-based system ( penBased = true in the system category), then no handwriting recognition library will be loaded.

hwr = palm.geo

kbdAcceleratorMode

kbdAcceleratorMode = <Boolean>

If false , this key tells GEOS to ignore keyboard accelerators. By default, this is true and keyboard accelerators are allowed; this is independent of whether the accelerators are drawn or not. See also the uiFeatures category's windowOptions key.

kbdAcceleratorMode = true
kbdAcceleratorMode = false

noClipboard

noClipboard = <Boolean>

If true, this key prevents the UI from opening the clipboard file on startup. This is an optimization used when we want to open the clipboard only later on in a particular application.

noSpooler

noSpooler = <Boolean>

If true, this key prevents the UI from launching the spooler. This can be used to improve startup time if the system running GEOS knows beforehand that the spooler is not required. Very few systems will set this true.

noSpooler = true
noSpooler = false

noTaskSwitcher

noTaskSwitcher = <Boolean>

If true, this key prevents the UI from loading a task switch driver. This may be used to improve startup time if the system running GEOS knows in advance it will never use a task switcher.

noTaskSwitcher = true
noTaskSwitcher = false

noTokenDatabase

noTokenDatabase = <Boolean>

If true, this key prevents the token database from being initialized. This is useful as an optimization when GEOS will not need icons--that is, when GEOS starts up and runs just a single application.

noTokenDatabase = true
noTokenDatabase = false

overstrikeMode

overstrikeMode = <Boolean>

If false , this key prefents the user from switching into overstrike mode; it defaults to true, and it is settable in the Preferences manager application.

overstrikeMode = true
overstrikeMode = false

password

password = <Boolean>

This field turns the system password on or off.

passwordText

passwordText = <string>

Encrypted text of the password string, if any.

penInputDisplayType

penInputDisplayType = <number>

This key defines the PenInputDisplayType to be shown when the PenInputControl object is brought up. The PenInputControl object displays the floating keyboard in one of several display types. See the PenInputDisplayType enumerated type for definitions of its values.

penInputDisplayType = 1					; floating keyboard
penInputDisplayType = 7					; handwriting area

productName

productName = <name>

This key holds the string displayed in the GEOS shutdown dialog box; for example, it will put up a string similar to "Are you sure you want to exit <productName>?"

productName = GEOS

screenBlanker

screenBlanker = <Boolean>

If this field true, then the user wishes to save the screen after an idle time period specified by means of the screenBlankerTimeout field.

screenBlankerTimeout

screenBlankerTimeout = <number of minutes>

If the user has turned on screen blanking, this is the number of minutes the system will stand idle before screen-saving turns on.

showTitleScreen

showTitleScreen = <Boolean>

If true, this key instructs GEOS to put up a title screen. This defaults to false.

showTitleScreen = true
showTitleScreen = false

sound

sound = <Boolean>

If true, this key instructs GEOS to turn sound on. If it's false, sound will be off. This is settable by the Preferences manager application.

sound = true
sound = false

specific

specific = <file name>

This key defines specific UI libraries to be loaded by GEOS. It defaults to motif.geo.

specific = motif.geo

tinyScreen

tinyScreen = <Boolean>

If true, this key tells GEOS that it's running on a small-screened device such as the Zoomer; it defaults to false. You can use this key during development if you're working on applications for a small-screen platform; it affects certain characteristics of the UI.

tinyScreen = true
tinyScreen = false

unbuildControllers

unbuildControllers = <Boolean>

If true, the UI will destroy the child blocks of controllers when the controller's menu/dialog box is closed. The child block will have to be regenerated every time the menu/dialog is openned--this is a memory for time tradeoff.

xScreenSize

xScreenSize = <number>

This key tells GEOS the screen width, in GEOS coordinates. If this key isn't set explicitly, the kernel will set it to the default screen size. This key is used primarily when developing for small-screen platforms such as Zoomer.

xScreenSize = 256

yScreenSize

yScreenSize = <number>

This key tells GEOS the screen height, in GEOS coordinates. If this key isn't set explicitly, the kernel will set it to the default screen size. This key is used primarily when developing for small-screen platforms such as Zoomer.

yScreenSize = 344

Up: GEOS SDK TechDocs | Up | Prev: 2.30 [text] | Next: 2.32 [<specific ui name>]