(getValueAt("errorBackgroundColor")))
A file named SETTINGS.PROPERTIES is distributed as part of the toolkit. It contains an entry for each of the color and key settings (these are listed in the table below) and its default value. A setting for the DSEINIDevelopmentPath is also included. You can customize any default value as necessary. This file is used during development and at runtime. If it is not found, the toolkit default values are used.
After the com.ibm.dse.guibeans plug-in has been installed, the settings.properties file is located in the installation directory of com.ibm.dse.guibeans inside the bin/dsegb.jar file. You must change this file to modify any of the default attributes.
Colors are specified as constants of the java.awt.Color object or as RGB values. Each of the following settings applies to all visual beans unless otherwise specified:
Setting | Description |
---|---|
backTabKeyCode | Defines the code for the key which, when clicked, acts as the Back Tab key in any component of the view. The default value is VK_TAB (the TAB key). |
backTabMask | Defines the mask (such as ALT or CTRL) that must be taken into account for the Back Tab key. The default value is SHIFT_MASK. |
caretColor | Defines the caret color in SpTextField bean. The default value is black. |
DSEINIDevelopmentPath | Indicates the path to search for the DSE.INI during development. This file provides the available operations and available dataNames. The default value is C:\\DSE\\DSE.INI. |
errorBackgroundColor | Defines the background color for the SpTextField and SpTable bean when data is not valid. The default value is white. |
errorForegroundColor | Defines the foreground color for the SpTextField and SpTable bean when data is not valid. The default value is red. |
helpKeyCode | Defines the code for the key to activate the online help system. The default value is VK_F1 (the F1 key). |
labelForeground. | Defines the color for the SpLabel text. However, if it is necessary to have one or more beans with a different foreground color, the color can be specified in the foreground property of each bean. The default value is black. |
mandatoryBackgroundColor | Defines the background color for the SpTextField, SpComboBox, SpList, and SpTable mandatory beans. The default value is yellow. |
mandatoryForegroundColor | Defines the foreground color for the SpTextField, SpComboBox, SpList, and SpTable mandatory beans. The default value is black. |
nonEditableBackgroundColor | Defines the background color for non-editable SpTextField, SpComboBox, and SpTable beans. The default value is lightGray. |
nonEditableForegroundColor | Defines the foreground color for non-editable SpTextField, SpComboBox, and SpTable beans. The default value is black. |
nonEnabledBackgroundColor | Defines the background color for non-enabled SpTextField, SpComboBox, SpList, and SpTable beans. The default value is gray. |
nonEnabledForegroundColor | Defines the foreground color for non-enabled SpTextField, SpComboBox, SpList, and SpTable beans. The default value is black. |
okKeyCode | Defines the code for the key which, when clicked in any component of the view (except for SpButtons), executes the operation (if the OK button is enabled). The default value is VK_ENTER (the ENTER key) |
okKeyMask | Defines the mask (ALT, CTRL, etc.) that must be taken into account for the OK key. The default value is NO_MASK. |
optionalBackgroundColor | Defines the background color for the SpTextField, SpComboBox, SpList, and SpTable beans. The default value is white. |
optionalForegroundColor | Defines the foreground color for the SpTextField, SpComboBox, SpList, and SpTable beans. The default value is black. |
selectionBackgroundColor | Defines the background color in the selected text in SpTextField, SpComboBox, SpList, and SpTable beans. The default RGB value is (204, 204, 255). |
selectionForegroundColor | Defines the foreground color in the selected text in SpTextField, SpComboBox, SpList, and SpTable beans. The default value is black. |
selectionBackgroundColor | Defines the background color in the selected text in an SpTextField bean. The default RGB value is (204, 204, 255). |
selectionForegroundColor | Defines the foreground color in the selected text in an SpTextField bean. The default value is black. |
selectionMenuBackgroundColor | Defines the background color in the selected item in an SpMenu bean. The default RGB value is (204, 204, 255). |
selectionMenuForegroundColor | Defines the foreground color in the selected item in an SpMenu bean. The default value is black. |
settingClass | Indicates the class name (with path) that will retrieve the information needed by the visual beans at design and runtime. These values are the default values for the properties, types information, and externalized data. If this class is com.ibm.dse.gui.DefaultSettings, the default values will be in the path pointed to in the settings.properties file that is distributed as part of the toolkit. |
standardFont | Defines the font to be used by all the visual beans. However, if it is necessary to have one or more beans with a different font, the font can be specified in the font property of each bean. The default value is a font with the following properties: name=Dialog, style=Plain, size=11. |
tabKeyCode | Defines the code for the key which, when clicked in any component of the view, acts as the Tab key. The default value is VK_TAB (the Tab key). |
tabKeyMask | Defines the mask (such as ALT, CTRL, or SHIFT) that must be taken into account for the Tab key. The default value is NO_MASK. |
The SpTextField, SpComboBox, and SpList beans can be in a state where more than one color is appropriate, but only one color can be displayed. Each of these components has its own algorithm to determine which color takes priority. The following tables show the priority of the colors for each of the components. The state and color pair of the highest priority appear at the top of the table, and the remaining state and color pairs are listed in decreasing priority.
State | Color |
---|---|
Not enabled | nonEnabledxxxColor |
Not editable | nonEditablexxxColor |
In error | errorxxxColor |
Mandatory and empty | mandatoryxxxColor |
All other states | optionalxxxColor |
State | Color |
---|---|
Not enabled | nonEnabledxxxColor |
Mandatory and empty | mandatoryxxxColor |
Not editable | nonEditablexxxColor |
All other states | optionalxxxColor |
State | Color |
---|---|
Selected | selectionxxxColor |
Not enabled | nonEnabledxxxColor |
Mandatory and empty | mandatoryxxxColor |
Not editable | nonEditablexxxColor |
All other states | optionalxxxColor |