Customize
The tables below contain useful UI-defaults which can be set by the UIManager for customizing a
Synthetica look and feel programmatically. Use
UIManager#put(Object key, Object value)
for changing values.
The example below disables Synthetica's window decoration. Another more powerful, but more complex, method for
customizing is the use of separate configuration files - see also Customization FAQ 1.
UIManager.put("Synthetica.window.decoration", Boolean.FALSE);
try
{
UIManager.setLookAndFeel(new SyntheticaStandardLookAndFeel());
}
catch (Exception e)
{
e.printStackTrace();
}
General UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.window.decoration | Boolean | Enable/disable window decoration. Default value is true. Note: To take effect the value has to be set before activating the Look and Feel. |
| Synthetica.text.antialias | Boolean | Paint all labels/text with or without antialias. Default value is false. |
| Synthetica.font.disabled Synthetica.font.disabled[.componentName] |
Boolean | Disables Synthetica's default font generally used for each component. If disabled the configured synth font will be used. Default value is false. |
| Synthetica.animation.enabled | Boolean | Disable animation and all animation threads. Optional value. Default value is true. Since V2.7.0. |
| Synthetica.activateMenuByAltKey | Boolean | Enable/disable menu activation by pressing the ALT-key. Optional value. Default value is true. Since V2.8.0. |
| Synthetica.window.opaque | Boolean | Enable/disable window opacity on Java 6u10 and above. A value of 'false' disables window opacity which means that the window corner background which is visible for non-rectangular windows disappear. Furthermore the shadow for popupMenus makes use of real translucent window. Some themes like SyntheticaSimple2D support translucent titlePanes if opacity is disabled. The property is ignored on JRE's below 6u10. Note: It is recommended to activate this feature only if your graphics hardware acceleration is supported by the JVM - a value of 'false' can affect application performance. Default value is true which means the translucency feature is disabled. Since V2.8.0. |
| Synthetica.translucency4DisabledIcons.enabled | Boolean | Enables usage of translucent icons for disabled components. Default value is false. Since V2.9.0. |
| Synthetica.translucency4DisabledIcons.alpha | Integer | Specifies the used alpha value (percentage) for disabled icons. Default value is 50. Since V2.9.0. |
| Synthetica.window.shape | idref | Defines the window shape on Java 6u10 and above. Supported values: "ROUND_RECT". The property is ignored on JRE's below 6u10. Note: Compared to the opacity property the shape property doesn't affect application performance but the shape isn't anti-aliased. There's no default value which means if not specified a recangle shape is used. Since V2.9.0. |
| Synthetica.window.arcW | Integer | Specifies the width arc for round rectangle shapes. Default value is 18. Since V2.9.0. |
| Synthetica.window.arcH | Integer | Specifies the height arc for round rectangle shapes. Default value is 18. Since V2.9.0. |
| Synthetica.window.contentPane.opaque | Boolean | Enable/disable content pane opacity. The content pane opacity is affected by the window opacity. Swing disables content pane opacity in case that windows opacity will be disabled. To keep opacity for content Synthetica introduces this property. Default value is true. See also property "Synthetica.window.opaque". Since V2.9.0. |
| Synthetica.font.resource |
idref | Path to TTF file which will be used to create a general default font. Enables you to deploy your LAF including font resource. Optional value. Since V2.10.0. |
ArrowButton UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.arrowButton.animation.cycles | Integer | Number of animation cycles. Optional value. Default value is 1. Since V2.4.0. |
| Synthetica.arrowButton.animation.delay | Integer | Delay between images when mouse is moved out of component. Optional value. Default value is 50. Since V2.4.0. |
| Synthetica.arrowButton.animation.type | Integer | Animation type when mouse is moved out of component. Optional value. Default value is 2 (HOVER_OUT). Since V2.4.0. |
| Synthetica.arrowButton.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the component. Optional value. Default value is 1. Since V2.4.0. |
| Synthetica.arrowButton.hover.animation.delay | Integer | Delay between images when mouse is moved over the component. Optional value. Default value is 50. Since V2.4.0. |
| Synthetica.arrowButton.hover.animation.type | Integer | Animation type when mouse is moved over the component. Optional value. Default value is 1 (HOVER_IN). Since V2.4.0. |
Button UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.button.textBackground | idref | Imagepath for image used as text-background for buttons to improve readability. Optional value. Since V2.0.0. |
| Synthetica.button.textBackground.insets | Insets | Insets for the button-text background image. Required if imagepath is specified. Since V2.0.0. |
| Synthetica.button.animation.cycles | Integer | Number of animation cycles when mouse is moved out of component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.button.animation.delay | Integer | Delay between images when mouse is moved out of component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.button.animation.type | Integer | Animation type when mouse is moved out of component. Optional value. Default value is 2 (HOVER_OUT). Since V2.2.0. |
| Synthetica.button.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.button.hover.animation.delay | Integer | Delay between images when mouse is moved over the component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.button.hover.animation.type | Integer | Animation type when mouse is moved over the component. Optional value. Default value is 1 (HOVER_IN). Since V2.2.0. |
| Synthetica.button.default.animation.cycles | Integer | Number of animation cycles for the default button. Optional value. Default value is -1 which means infinite. Since V2.2.0. |
| Synthetica.button.default.animation.delay | Integer | Delay between images for the default button. Optional value. Default value is 70. Since V2.2.0. |
| Synthetica.button.default.animation.type | Integer | Animation type for the default button. Optional value. Default value is 0 (DEFAULT). Since V2.2.0. |
CellRenderer UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.cellRenderer.selectionBackground.enabled | Boolean | Enable/disabled general background painting support for cell renderers. Optional value - default is false. Since V2.10.0. |
| Synthetica.cellRenderer.respectFocus | Boolean | True means the cell renderer selection background appears only when the component has the focus. Optional value - default is false. Since V2.10.0. |
CheckBox UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.checkBox.image | idref | Path for CheckBox image - default state. Optional value. Since V2.5.0. |
| Synthetica.checkBox.selected.image | idref | Path for CheckBox image - selected state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.pressed.image | idref | Path for CheckBox image - pressed state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.pressed.selected.image | idref | Path for CheckBox image - pressed and selected state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.hover.image | idref | Path for CheckBox image - hover state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.hover.selected.image | idref | Path for CheckBox image - hover and selected state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.disabled.image | idref | Path for CheckBox image - disabled state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.disabled.selected.image | idref | Path for CheckBox image - disabled and selected state. Optional value - mandatory if "Synthetica.checkBox.image" is specified. Since V2.5.0. |
| Synthetica.checkBox.animation.cycles | Integer | Number of animation cycles when mouse is moved out of the CheckBox. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.checkBox.animation.delay | Integer | Delay between images when mouse is moved out of the CheckBox. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.checkBox.animation.type | Integer | Animation type when mouse is moved out of the CheckBox. Optional value. Default value is 2 (HOVER_OUT). Since V2.5.0. |
| Synthetica.checkBox.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the CheckBox. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.checkBox.hover.animation.delay | Integer | Delay between images when mouse is moved over the CheckBox. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.checkBox.hover.animation.type | Integer | Animation type when mouse is moved over the CheckBox. Optional value. Default value is 1 (HOVER_IN). Since V2.5.0. |
| Synthetica.checkBox.emulatedPressedState.enabled | Boolean | Enable pressed state emulation. Optional value. Default value is False. Since V2.9.3. |
| Synthetica.checkBox.emulatedPressedState.color | idref | Color used for pressed state emulation. Optional value. Default value is the Panel.background color. Since V2.9.3. |
| Synthetica.checkBox.emulatedPressedState.alpha | Integer | Percent alpha value used to colorize icon. Optional value. Default value is 25. Since V2.9.3. |
ComboBox UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.comboBox.hoverAndPressed.enabled | Boolean | Optional hint to recognize hover and pressed state not only for arrow button. Default is false. Since V2.5.0. |
| Synthetica.comboBox.stateChange4ButtonOnly | Boolean | Hover and pressed state will be painted only for the button area. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.comboBox.border | idref | Imagepath for comboBox border/background - normal state. |
| Synthetica.comboBox.border.disabled | idref | Imagepath for comboBox border/background - disabled state. |
| Synthetica.comboBox.border.locked | idref | Imagepath for comboBox border/background - non editable state. |
| Synthetica.comboBox.border.hover | idref | Imagepath for comboBox border/background - hover state. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.comboBox.border.pressed | idref | Imagepath for comboBox border/background - pressed state. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.comboBox.border.hover.locked | idref | Imagepath for comboBox border/background - hover state for non editiable comboBoxes. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.comboBox.border.pressed.locked | idref | Imagepath for comboBox border/background - pressed state for non editiable comboBoxes. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.comboBox.animation.cycles | Integer | Number of animation cycles when mouse is moved out of comboBox. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.comboBox.animation.delay | Integer | Delay between images when mouse is moved out of comboBox. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.comboBox.animation.type | Integer | Animation type when mouse is moved out of comboBox. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value. Default value is 2 (HOVER_OUT). Since V2.5.0. |
| Synthetica.comboBox.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the comboBox. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.comboBox.hover.animation.delay | Integer | Delay between images when mouse is moved over the comboBox. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.comboBox.hover.animation.type | Integer | Animation type when mouse is moved over the comboBox. "Synthetica.comboBox.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1 (HOVER_IN). Since V2.5.0. |
| Synthetica.comboBox.border.arcWidth | Integer | Defines the horizontal diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.comboBox.border.arcHeight | Integer | Defines the vertical diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.comboBox.border.fillInsets | Insets | Defines the insets used for background filling so you are able to define an empty area. Optional value - default value is 0 0 0 0. Since V2.9.0. |
| Synthetica.comboBox.border.dInsets | Insets | Defines the destination insets for the border image. Set to "0 0 0 0" for cutting off the border. Optional value - default value is null. Since V2.6.0. |
| Synthetica.comboBox.layoutManager.className | idref | Reference to a custom layout manager class name. Optional value. Since V2.7.0. |
| Synthetica.comboPopup.insets | insets | Border insets for comboBox popups. Optional value. Since V2.7.0. |
| Synthetica.popupMenu.background.ComboPopup.popup | idref | Background imagepath for comboBox popups by named default property. Optional value. |
| Synthetica.popupMenu.background.insets.ComboPopup.popup | insets | Background image insets for comboBox popups by named default property. Optional value. |
| Synthetica.comboBox.defaultRenderer.className | idref | Default comboBox list cell renderer derived from DefaultListCellRenderer. Optional value. Since V2.7.0. |
| Synthetica.comboPopup.border.color | idref | Border color for comboBox popup menus. Appears only if "Synthetica.comboPopup.insets" is specified. Optional value. Since V2.7.3. |
| Synthetica.comboBox.[locked | hover | disabled].fillBackground | Boolean | Fill combo background with specified color before border image is painted. Default is true. Since V2.8.0. |
| Synthetica.comboBox.listSelectionBackground | idref | Background image for selected item. Optional value. Since V2.10.0. |
| Synthetica.comboBox.listSelectionBackground.insets | Insets | Background image insets for selected item. Optional value. Default is 0 0 0 0.Since V2.10.0. |
Dialog UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.dialog.icon.enabled | Boolean | Optional value to enable icon painting and system menu for JDialogs. Default is false. Since V2.4.0. The optional client property "Synthetica.dialog.iconImage" can be applied to the dialog rootPane to specify an image which is different from the owner frame. Example: JDialog#getRootPane.putClientProperty("Synthetica.dialog.iconImage", myImage); |
EditorPane UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.editorPane.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.editorPane.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
FileChooser UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.extendedFileChooser.enabled | Boolean | Enable/disable the extended FileChooserUI. Default value is true. |
| Synthetica.extendedFileChooser.rememberPreferences | Boolean | Extended FileChooser remembers dialogs size, position and last directory. Default value is true. |
| Synthetica.extendedFileChooser.rememberLastDirectory | Boolean | Enable/disable remember last directory. Only valid if the rememberPreferences property is true. Default value is true. Since V2.8.1. |
| Synthetica.extendedFileChooser.sortEnabled | Boolean | Enable/disable file sorting. Optional value. Default value is true. Since V2.7.0. |
| Synthetica.extendedFileChooser.useSystemFileIcons | Boolean | Extended FileChooser uses file system icons if available (depends on used Operating System). Default value is true. |
| Synthetica.extendedFileChooser.actionButtons.paintBorder | Boolean | The action buttons of the extended FileChooser will be painted with or without a button border. Default value is false. |
| Synthetica.fileChooser.tableView.sortColumnColor | Color | Background color for the sorted column. |
| Synthetica.fileChooser.comboListBackground | Color | Background color for comboBox list. Optional value. Default is list background. Since V2.8.0. |
| FileChooser.newFolderIcon [.pressed | .disabled] | idref | Reference to an ImageIcon element which represents the pressed/disabled button state. Optional value - since V2.5.0. |
| FileChooser.upFolderIcon [.pressed | .disabled] | idref | Reference to an ImageIcon element which represents the pressed/disabled button state. Optional value - since V2.5.0. |
| FileChooser.homeFolderIcon [.pressed | .disabled] | idref | Reference to an ImageIcon element which represents the pressed/disabled button state. Optional value - since V2.5.0. |
| Synthetica.filePropertiesDialog.iconImage | image | Image which will be used as icon for the file properties dialog. The "Synthetica.dialog.icon.enabled" property has to be set to "true" (see JDialog). Optional value - since V2.6.0. |
| Synthetica.fileOperationDialog.copy.iconImage | image | Image which will be used as icon for the copy file operation dialog. The "Synthetica.dialog.icon.enabled" property has to be set to "true" (see JDialog). Optional value - since V2.6.0. |
| Synthetica.fileOperationDialog.move.iconImage | image | Image which will be used as icon for the move file operation dialog. The "Synthetica.dialog.icon.enabled" property has to be set to "true" (see JDialog). Optional value - since V2.6.0. |
| Synthetica.fileOperationDialog.delete.iconImage | image | Image which will be used as icon for the delete file operation dialog. The "Synthetica.dialog.icon.enabled" property has to be set to "true" (see JDialog). Optional value - since V2.6.0. |
Focus UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.focus[.{componentKey}] | idref | Focus image path for the specified component or default focus if no componentKey is specified. Valid keys are button, checkBox, formattedTextField, passwordField, radioButton, scrollPane, slider, tabbedPane.tab, tabbedPane.tab.top, tabbedPane.tab.left, tabbedPane.tab.bottom, tabbedPane.tab.right, textField, toggleButton. Since V2.2.0. |
| Synthetica.focus[.{componentKey}].insets | Insets | Focus image insets for the specified component. Valid keys see above. Since V2.2.0. |
| Synthetica.focus[.{componentKey}].animation.cycles | Integer | Focus animation cycles for the specified component. Optional value. Default value is -1 which means infinite. Since V2.2.0. |
| Synthetica.focus[.{componentKey}].animation.delay | Integer | Focus animation delay between images for the specified component. Optional value. Default value is 60 which means 60ms. Since V2.2.0. |
| Synthetica.focus[.{componentKey}].animation.type | Integer | Focus animation type for the specified component. Optional value. Default value is 3 which means focus type. Since V2.2.0. |
| Synthetica.focus.scrollPane.animation.maxWidth | Integer | Animation appears as long as current scrollPane width is smaller than maxWidth. Used to avoid heavy CPU usage. Optional value. Default value is 400. Since V2.2.0. |
| Synthetica.focus.scrollPane.animation.maxHeight | Integer | Animation appears as long as current scrollPane height is smaller than maxHeight. Used to avoid heavy CPU usage. Optional value. Default value is 200. Since V2.2.0. |
| Synthetica.focus.textComponents.enabled | Boolean | Enable/disable focus painting for text components. Optional value. Default value is true. Since V2.5.0. |
| Synthetica.focus.scrollPane.enabled | Boolean | Enable/disable focus painting for scrollPanes. Optional value. Default value is true. Since V2.5.0. |
| Synthetica.focus.slider.thumb | idref | Focus image path for slider thumb. Optional value. Since V2.9.0. |
FormattedTextField UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.formattedTextField.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.formattedTextField.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
| Synthetica.formattedTextField.border.arcWidth | Integer | Defines the horizontal diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.formattedTextField.border.arcHeight | Integer | Defines the vertical diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.formattedTextField.border.fillInsets | Insets | Defines the insets used for background filling so you are able to define an empty area. Optional value - default value is 0 0 0 0. Since V2.9.0. |
InternalFrame UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.internalFrame.titlePane.buttons.paintBorder | Boolean | Enable/disable button border painting for internal frame buttons (iconify, maximize, minimize). Default value is false. |
| Synthetica.internalFrame.titlePane.dropShadow | Boolean | Enable/disable drop shadow painting for internal frame titles. Default value is false. |
| Synthetica.internalFrame.titlePane.dropShadow.distance | Integer | Shadow distance. Optional value, default is -5. Since V2.3.0. |
| Synthetica.internalFrame.titlePane.dropShadow.highQualitiy | Boolean | Enables high-quality shadow. Optional value, default is true. Since V2.3.0. |
| Synthetica.internalFrame.titlePane.dropShadow.color | ColorUIResource | Drop shadow color. Optional value, default is BLACK. For colorizing the high-quality switch has to be disabled (false). Since V2.3.0. |
| Synthetica.internalFrame.titlePane.background.horizontalTiled | Boolean | Enable/disable horizontal stretching of title pane background image. Default value is false. Since V2.2.0. |
| Synthetica.internalFrame.titlePane.background.verticalTiled | Boolean | Enable/disable vertical stretching of title pane background image. Default value is false. Since V2.2.0. |
| Synthetica.internalFrame.titlePane.title.center | Boolean | Enable center aligned title text. Optional value, default is "false" which means title is left aligned. Since V2.5.0. |
| Synthetica.internalFrameTitlePane.background.light | idref | An optional value for a light image which will be painted on top of the regular background image (inactive state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.2.0. |
| Synthetica.internalFrameTitlePane.background.light.selected | idref | An optional value for a light image which will be painted on top of the regular background image (active state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.2.0. |
List UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.list.defaultCellRenderer.className | idref | The specified renderer will be used as default cell renderer. Non existing entry means the Synth renderer will be used. Since V2.9.0. |
| Synthetica.list.selectionBackground | idref | Background image for selected item. Optional value. Since V2.10.0. |
| Synthetica.list.selectionBackground.insets | Insets | Background image insets for selected item. Optional value. Default is 0 0 0 0.Since V2.10.0. |
Menu UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.menu.animation.cycles | Integer | Number of animation cycles when mouse is moved out of component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.menu.animation.delay | Integer | Delay between images when mouse is moved out of component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.menu.animation.type | Integer | Animation type when mouse is moved out of component. Optional value. Default value is 2 (HOVER_OUT). Since V2.2.0. |
| Synthetica.menu.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.menu.hover.animation.delay | Integer | Delay between images when mouse is moved over the component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.menu.hover.animation.type | Integer | Animation type when mouse is moved over the component. Optional value. Default value is 1 (HOVER_IN). Since V2.2.0. |
| Synthetica.menu.iconGap | Integer | Deprecated since V2.2.0. |
| Synthetica.menu.toplevel.textColor | Color | Text color for top level menus. Optional value. |
| Synthetica.menu.toplevel.textColor.inactive | Color | Text color for top level menus if window is inactive. Optional value. Since V2.5.0. |
| Synthetica.menu.toplevel.fontSize | Integer | Defines font size for toplevel menus. Optional value. Since V2.10.0. |
MenuBar UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.menuBar.background.active | idref | An optional menuBar background image (active state). |
| Synthetica.menuBar.background.inactive | idref | An optional menuBar background image (inactive state). |
| Synthetica.menuBar.background.insets | Insets | Optional menuBar background image insets. |
| Synthetica.menuBar.background.light.active | idref | An optional value for a light image which will be painted on top of the regular background image (active state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.1.0. |
| Synthetica.menuBar.background.light.inactive | idref | An optional value for a light image which will be painted on top of the regular background image (inactive state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.1.0. |
| Synthetica.menuBar.background.horizontalTiled | Boolean | Enable/disable stretching of the menuBar background image. Default value is false which means horizontal stretching is enabled. Since V2.1.0. |
| Synthetica.menuBar.background.verticalTiled | Boolean | Enable/disable stretching of the menuBar backkground image. Default value is false which means vertical stretching is enabled. Since V2.1.0. |
MenuItem UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.menuItem.icon.width | Integer | Optional value for the icon width of menuItems. The name of the popupMenu is relevant for customizations. Default value is 16. Since V2.2.0. |
| Synthetica.menuItem.checkRadioIcon.width | Integer | Optional value for the (check/radio)icon width of checkBox and radioButton menuItems. The name of the popupMenu is relevant for customizations. Default value is 14. Since V2.2.0. |
| Synthetica.menuItem.animation.cycles | Integer | Number of animation cycles when mouse is moved out of component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.menuItem.animation.delay | Integer | Delay between images when mouse is moved out of component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.menuItem.animation.type | Integer | Animation type when mouse is moved out of component. Optional value. Default value is 2 (HOVER_OUT). Since V2.2.0. |
| Synthetica.menuItem.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.menuItem.hover.animation.delay | Integer | Delay between images when mouse is moved over the component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.menuItem.hover.animation.type | Integer | Animation type when mouse is moved over the component. Optional value. Default value is 1 (HOVER_IN). Since V2.2.0. |
Panel UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.panel#8203;.background.image | idref | Defines the path to the background image for opaque JPanels. In case that a custom background color (non-UIResource) is set the image isn't painted. Since V2.9.0. |
| Synthetica.panel#8203;.background.image.insets | Insets | The background image insets. Optional value, default is 0 0 0 0. Since V2.9.0. |
| Synthetica.panel#8203;.background.image.origin | idref | Defines if the background image origin is relative to the panel, content pane or root pane. Optional value, default is ROOT_PANE. Supported values are PANEL, CONTENT_PANE, ROOT_PANE. Since V2.9.0. |
PasswordField UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.passwordField.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.passwordField.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
| Synthetica.passwordField.border.arcWidth | Integer | Defines the horizontal diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.passwordField.border.arcHeight | Integer | Defines the vertical diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.passwordField.border.fillInsets | Insets | Defines the insets used for background filling so you are able to define an empty area. Optional value - default value is 0 0 0 0. Since V2.9.0. |
PopupMenu UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.popupMenu.iconSeparator | idref | Optional imagepath for an image used as icon separator. Since V2.2.0. |
| Synthetica.popupMenu.iconSeparator.gap | Integer | Optional value defines gap between popup border and iconSeparator. Default is 24. Since V2.2.0. |
| Synthetica.popupMenu.iconSeparator.width | Integer | Optional width of the icon separator. Default is 1. Since V2.2.0. |
| Synthetica.popupMenu.iconSeparatorGap | Integer | Optional, additional gap between icons and text of menuItems. Default is 0. Since V2.2.0. |
| Synthetica.popupMenu.blur.enabled | Boolean | Enables blur support for popupMenus. Optional value, default is false. Since V2.3.0. |
| Synthetica.popupMenu.blur.insets | Insets | Insets for blured area (useful to exclude shadow). Required if blur is enabled. Since V2.3.0. |
| Synthetica.popupMenu.blur.size | Integer | Blur size blur. Optional value, default is 5. Since V2.3.0. |
| Synthetica.popupMenu.blur.background | idref | Translucent background image which will be used for blured popupMenus. Optional value - if not configured 'Synthetica.popupMenu.background' will be used. Since V2.3.0. |
| Synthetica.comboPopup.insets | insets | Insets for comboBox popups. Optional value. Since V2.7.0. |
| Synthetica.comboPopup.border.color | idref | Border color for comboBox popup menus. Appears only if "Synthetica.comboPopup.insets" is specified. Optional value. Since V2.7.3. |
| Synthetica.popupRobot.enabled | insets | Enable/disable popup robot (screen capture) for popups. Optional value - deault is true. Since V2.9.0. |
| Menu.submenuPopupOffsetX | Integer | X-Offset for sub-popupMenus. Not a Synthetica specific value - support is provided by JMenu class. Optional value. |
| Menu.submenuPopupOffsetY | Integer | Y-Offset for sub-popupMenus. Not a Synthetica specific value - support is provided by JMenu class. Optional value. |
PopupMenuSeparator UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.popupMenuSeparator.iconSeparatorGap | Integer | Optional space between popupMenuSeparator and popupMenuIconSeparator. Default is 0. Since V2.2.0. |
ProgressBar UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.progressBar.x.background | idref | Imagepath to horizontal progressBar background image - normal state. |
| Synthetica.progressBar.x.background.disabled | idref | Imagepath to horizontal progressBar background image - disabled state. |
| Synthetica.progressBar.x.background.active | idref | Imagepath to horizontal progressBar background image - applied for progressBar values > 0. Optional value. Since V2.5.0. |
| Synthetica.progressBar.y.background | idref | Imagepath to vertical progressBar background image - normal state. |
| Synthetica.progressBar.y.background.disabled | idref | Imagepath to vertical progressBar background image - disabled state. |
| Synthetica.progressBar.y.background.active | idref | Imagepath to vertical progressBar background image - is used for progressBar values > 0. Optional value. Since V2.5.0. |
| Synthetica.progressBar.x.animation.cycles | Integer | Number of animation cycles for horizontal progressBars. Optional value. Default value is -1 which means infinite. Since V2.2.0. |
| Synthetica.progressBar.x.animation.delay | Integer | Delay between images for horizontal progressBars. Optional value. Default value is 70. Since V2.2.0. |
| Synthetica.progressBar.x.animation.type | Integer | Animation type for horizontal progressBars. Optional value. Default value is 0 (DEFAULT). Since V2.2.0. |
| Synthetica.progressBar.y.animation.cycles | Integer | Number of animation cycles for vertical progressBars. Optional value. Default value is -1 which means infinite. Since V2.2.0. |
| Synthetica.progressBar.y.animation.delay | Integer | Delay between images for vertical progressBars. Optional value. Default value is 70. Since V2.2.0. |
| Synthetica.progressBar.y.animation.type | Integer | Animation type for vertical progressBars. Optional value. Default value is 0 (DEFAULT). Since V2.2.0. |
| Synthetica.progressBar.background.animation.cycles | Integer | Number of animation cycles for progressBar background. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.progressBar.background.animation.delay | Integer | Delay between images for progressBar background. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.progressBar.background.animation.type | Integer | Animation type for progressBar background. Optional value. Default value is 6 (INACTIVE). Since V2.5.0. |
| Synthetica.progressBar.background.active.animation.cycles | Integer | Number of animation cycles for progressBar background - applied for progressBar values > 0. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.progressBar.background.active.animation.delay | Integer | Delay between images for progressBar background - applied for progressBar values > 0. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.progressBar.background.active.animation.type | Integer | Animation type for progressBar background - applied for progressBar values > 0. Optional value. Default value is 5 (ACTIVE). Since V2.5.0. |
| Synthetica.progressBar.textBackground | idref | Imagepath for image used as text-background for progressBars to improve readability. Optional value. Since V2.5.0. |
| Synthetica.progressBar.textBackground.insets | Insets | Insets for the progressBar text-backgroundimage to specify border area. Required if imagepath is specified. Since V2.5.0. |
| ProgressBar.horizontalSize | idref | Default preferred size dimension (idref to java.awt.Dimension object). Optional value. Since V2.7.0. |
| ProgressBar.verticalSize | idref | Default preferred size dimension (idref to java.awt.Dimension object). Optional value. Since V2.7.0. |
| Synthetica.progressBar.x[.indeterminate] | idref | Imagepath to horizontal progressBar image. Indeterminate is optional and available since V2.10 |
| Synthetica.progressBar.y[.indeterminate] | idref | Imagepath to vertical progressBar image. Indeterminate is optional and available since V2.10 |
RootPane UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.rootPane.border.insets | Insets | Image insets of the background image. |
| Synthetica.rootPane.border.size | Insets | Frame border insets (without titlePane). |
| Synthetica.rootPane.titlePane.buttons.paintBorder | Boolean | Enable/disable button border painting for frame buttons (iconify, maximize, minimize). Default value is false. |
| Synthetica.rootPane.titlePane.dropShadow | Boolean | Enable/disable drop shadow painting for frame titles. Default value false. |
| Synthetica.rootPane.titlePane.dropShadow.distance | Integer | Shadow distance. Optional value, default is -5. Since V2.3.0. |
| Synthetica.rootPane.titlePane.dropShadow.highQualitiy | Boolean | Enables high-quality shadow. Optional value, default is true. Since V2.3.0. |
| Synthetica.rootPane.titlePane.dropShadow.color | ColorUIResource | Drop shadow color. Optional value, default is BLACK. For colorizing the high-quality switch has to be disabled (false). Since V2.3.0. |
| Synthetica.rootPane.titlePane.dropShadow.opacity | Integer | Drop shadow opacity in percent. Optional value, default is 80. Since V2.10.0. |
| Synthetica.rootPane.titlePane.dropShadow.size | Integer | Drop shadow size. Optional value, default is 5. Since V2.10.0. |
| Synthetica.rootPane.titlePane.dropShadow.xOffset | Integer | Drop shadow x-offset. Optional value, default is 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.dropShadow.yOffset | Integer | Drop shadow y-offset. Optional value, default is 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.menuButton.useOriginalImageSize | Boolean | Enable/disable sizing of menu button image to 16x16 pixels. Setting this this value to true can cause a larger title pane. Default value is false. |
| Synthetica.rootPane.titlePane.background.horizontalTiled | Boolean | Enable/disable horizontal stretching of title pane background image. Default value is false. Since V2.1.0. |
| Synthetica.rootPane.titlePane.background.verticalTiled | Boolean | Enable/disable vertical stretching of title pane background image. Default value is false. Since V2.1.0. |
| Synthetica.rootPane.titlePane.background.light | idref | An optional value for a light image which will be painted on top of the regular background image (inactive state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.1.0. |
| Synthetica.rootPane.titlePane.background.light.selected | idref | An optional value for a light image which will be painted on top of the regular background image (active state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.1.0. |
| Synthetica.rootPane.titlePane.opaque | Boolean | Enable/disable titlePane opacity. Optional value, default is "true". Since V2.3.0. |
| Synthetica.rootPane.titlePane.title.center | Boolean | Enable center aligned title text. Optional value, default is "false" which means title is left aligned. Since V2.5.0. |
| Synthetica.rootPane.titlePane.gap | Integer | Defines the default gap for the titlePane i.e. gap between frame border and buttons. Optional value, default is "4". Since V2.5.0. |
| Synthetica.rootPane.titlePane.iconifyButton.gap | Integer | Defines the gap between inconify button and the maximize/minimize button. Optional value, default is "0". Since V2.5.0. |
| Synthetica.rootPane.titlePane.toggleButton.gap | Integer | Defines the gap between maximize/minimize button and the close button. Optional value, default is "Synthetica.rootPane.titlePane.gap". Since V2.5.0. |
| Synthetica.rootPane.titlePane.buttonArea.insets | Insets | The insets between the buttons and the button area border. Optional value, if not defined no button area will be painted. Since V2.5.0. |
| Synthetica.rootPane.titlePane.buttonArea.background | idref | The path to the image which is used for button area painting. Optional value. Since V2.5.0. |
| Synthetica.rootPane.titlePane.buttonArea.background.selected | idref | The path to the image which is used for button area painting if window is active. Optional value. Since V2.5.0. |
| Synthetica.rootPane.titlePane.buttonArea.background.insets | Insets | The background image insets used for painting. Optional value. Since V2.5.0. |
| Synthetica.rootPane.titlePane.useMACStyleOnMAC | Boolean | Use MAC specific titlePane layout on MAC OS X - centered title and button group on the left side of the frame. Optional value. Default is true.Since V2.5.0. |
| Synthetica.rootPane.titlePane.titleInsets | Insets | Title insets. Optional value. Default is 3 0 4 0. Since V2.8.0. |
| Synthetica.rootPane.titlePane.fontSize | Integer | Optional title font size. Since V2.10.0. |
| Synthetica.rootPane.titlePane.showMenuBarInTitlePane | Boolean | Display menu bar within title panel. Optional value. Default is False. Since V2.10.0. |
| Synthetica.rootPane.titlePane.clipMenuBarWidth | Boolean | Clip menu bar width (respect controls) when displayed in title panel. Optional value. Default is False. Since V2.10.0. |
| Synthetica.rootPane.titlePane.title.visible | Boolean | Paint window title text. Optional value. Default is True. Since V2.10.0. |
| Synthetica.rootPane.titlePane.title.insets | Insets | Empty space around the title text area. Optional value. Default is 0 0 0 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.menuBar.insets | Insets | Empty space around the menuBar when displayed within title pane. Optional value. Default is 0 0 0 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.menuButton.insets | Insets | Empty space around the menuButton. Optional value. Default is 0 0 0 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.menuButton.alignment | Integer | GridBagLayout anchor for menuButton. Optional value. Default is 10 (CENTER). Since V2.10.0. |
| Synthetica.rootPane.titlePane.iconifyButton.insets | Insets | Empty space around the iconifyButton. Optional value. Default is 0 0 0 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.iconifyButton.alignment | Integer | GridBagLayout anchor for iconifyButton. Optional value. Default is 10 (CENTER). Since V2.10.0. |
| Synthetica.rootPane.titlePane.toggleButton.insets | Insets | Empty space around the toggleButton. Optional value. Default is 0 0 0 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.toggleButton.alignment | Integer | GridBagLayout anchor for toggleButton. Optional value. Default is 10 (CENTER). Since V2.10.0. |
| Synthetica.rootPane.titlePane.closeButton.insets | Insets | Empty space around the closeButton. Optional value. Default is 0 0 0 0. Since V2.10.0. |
| Synthetica.rootPane.titlePane.closeButton.alignment | Integer | GridBagLayout anchor for closeButton. Optional value. Default is 10 (CENTER). Since V2.10.0. |
| Synthetica.rootPane.minimumWindowSize | Dimension | By default a window can't be resized smaller than the minimum size of the child components. This property allows you to override the minimum size with a predefined dimension. Optional value. Default is null. Since V2.8.0. |
| Synthetica.rootPane.border.respectFill | Boolean | Hint to paint the center of the border image. Optional value useful for translucent windows. Default is false. Since V2.9.0. |
RadioButton UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.radioButton.image | idref | Path for RadioButton image - default state. Optional value. Since V2.5.0. |
| Synthetica.radioButton.selected.image | idref | Path for RadioButton image - selected state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.pressed.image | idref | Path for RadioButton image - pressed state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.pressed.selected.image | idref | Path for RadioButton image - pressed and selected state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.hover.image | idref | Path for RadioButton image - hover state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.hover.selected.image | idref | Path for RadioButton image - hover and selected state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.disabled.image | idref | Path for RadioButton image - disabled state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.disabled.selected.image | idref | Path for RadioButton image - disabled and selected state. Optional value - mandatory if "Synthetica.radioButton.image" is specified. Since V2.5.0. |
| Synthetica.radioButton.animation.cycles | Integer | Number of animation cycles when mouse is moved out of the RadioButton. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.radioButton.animation.delay | Integer | Delay between images when mouse is moved out of the RadioButton. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.radioButton.animation.type | Integer | Animation type when mouse is moved out of the RadioButton. Optional value. Default value is 2 (HOVER_OUT). Since V2.5.0. |
| Synthetica.radioButton.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the RadioButton. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.radioButton.hover.animation.delay | Integer | Delay between images when mouse is moved over the RadioButton. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.radioButton.hover.animation.type | Integer | Animation type when mouse is moved over the RadioButton. Optional value. Default value is 1 (HOVER_IN). Since V2.5.0. |
| Synthetica.radioButton.emulatedPressedState.enabled | Boolean | Enable pressed state emulation. Optional value. Default value is False. Since V2.9.3. |
| Synthetica.radioButton.emulatedPressedState.color | idref | Color used for pressed state emulation. Optional value. Default value is the Panel.background color. Since V2.9.3. |
| Synthetica.radioButton.emulatedPressedState.alpha | Integer | Percent alpha value used to colorize icon. Optional value. Default value is 25. Since V2.9.3. |
ScrollBar UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.scrollBar.horizontal.relativeBounds | idref | Reference to a rectangle with relative bounds for horizontal scrollbars. Only valid if SyntheticaScrollPaneLayoutMananger is set (see ScrollPane). Optional value. Since V2.7.0. |
| Synthetica.scrollBar.vertical.relativeBounds | idref | Reference to a rectangle with relative bounds for vertical scrollbars. Only valid if SyntheticaScrollPaneLayoutMananger is set (see ScrollPane). Optional value. Since V2.7.0. |
ScrollBarThumb UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.scrollBarThumb.animation.cycles | Integer | Number of animation cycles when mouse is moved out of component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.scrollBarThumb.animation.delay | Integer | Delay between images when mouse is moved out of component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.scrollBarThumb.animation.type | Integer | Animation type when mouse is moved out of component. Optional value. Default value is 2 (HOVER_OUT). Since V2.2.0. |
| Synthetica.scrollBarThumb.x.background | idref | Imagepath to horizontal scrollbarThumb image. |
| Synthetica.scrollBarThumb.y.background | idref | Imagepath to vertical scrollbarThumb image. |
| Synthetica.scrollBarThumb.x.background.hover | idref | Imagepath to hover state image of horizontal scrollbarThumb. |
| Synthetica.scrollBarThumb.y.background.hover | idref | Imagepath to hover state image of vertical scrollbarThumb. |
| Synthetica.scrollBarThumb.x.background.pressed | idref | Imagepath to pressed state image of horizontal scrollbarThumb. Optional value. Since V2.5.0. |
| Synthetica.scrollBarThumb.y.background.pressed | idref | Imagepath to pressed state image of vertical scrollbarThumb. Optional value. Since V2.5.0. |
| Synthetica.scrollBarThumb.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.scrollBarThumb.hover.animation.delay | Integer | Delay between images when mouse is moved over the component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.scrollBarThumb.hover.animation.type | Integer | Animation type when mouse is moved over the component. Optional value. Default value is 1 (HOVER_IN). Since V2.2.0. |
| Synthetica.scrollBarThumb.x.grip.hover | idref | Imagepath to hover grip image - used for horizontal scrollbars. Optional value. Since V2.5.0. |
| Synthetica.scrollBarThumb.y.grip.hover | idref | Imagepath to hover grip image - used for vertical scrollbars. Optional value. Since V2.5.0. |
| Synthetica.scrollBarThumb.x.grip.pressed | idref | Imagepath to pressed grip image - used for horizontal scrollbars. Optional value. Since V2.5.0. |
| Synthetica.scrollBarThumb.y.grip.pressed | idref | Imagepath to pressed grip image - used for vertical scrollbars. Optional value. Since V2.5.0. |
ScrollBarTreck UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.scrollBarTrack.hoverAndPressed.enabled | boolean | Enables hover support for scrollBarTracks. Optional value. Default value is false. Since V2.5.0. |
| Synthetica.scrollBarTrack.hoverOnButtons.enabled | boolean | Hover support for scrollBarTrack respects mouse over on arrow buttons. This means a mouse over on an arrow button is also interpreted as mouse over on a scrollBarTrack. Optional value. Default value is false. Since V2.5.0. |
ScrollPane UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.scrollPane.border.arcWidth | Integer | Defines the horizontal diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.scrollPane.border.arcHeight | Integer | Defines the vertical diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.scrollPane.border.fillInsets | Insets | Defines the insets used for background filling so you are able to define an empty area. Optional value - default value is 0 0 0 0. Since V2.9.0. |
| Synthetica.scrollPane.layoutManager.className | idref | Reference to a custom layout manager class. Optional value. Since V2.7.0. |
Slider UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.slider.hoverAndPressed.enabled | boolean | Enables enhanced hover support for sliders. Optional value. Default value is false. Since V2.5.0. |
| Synthetica.slider.track.x.[hover | pressed | disabled]image | idref | Imagepath to horizontal slider track. Optional value. Since V2.5.0. |
| Synthetica.slider.track.x.image.insets | Insets | Image insets for horizontal slider track image. Optional value. Since V2.5.0. |
| Synthetica.slider.track.y.[hover | pressed | disabled]image | idref | Imagepath to vertical slider track. Optional value. Since V2.5.0. |
| Synthetica.slider.track.y.image.insets | Insets | Image insets for vertical slider track image. Optional value. Since V2.5.0. |
| Synthetica.slider.track.animation.cycles | Integer | Number of animation cycles when mouse is moved out of the slider. "Synthetica.slider.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.slider.track.animation.delay | Integer | Delay between images when mouse is moved out of the slider. "Synthetica.slider.hoverAndPressed.enabled" has to be true. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.slider.track.animation.type | Integer | Animation type when mouse is moved out of the slider. "Synthetica.slider.hoverAndPressed.enabled" has to be true. Optional value. Default value is 2 (HOVER_OUT). Since V2.5.0. |
| Synthetica.slider.thumb.x.[hover]image | idref | Imagepath to horizontal slider thumb. Optional value. Since V2.5.0. |
| Synthetica.slider.thumb.x.image.insets | Insets | Image insets for horizontal slider thumb image. Optional value. Since V2.5.0. |
| Synthetica.slider.thumb.y.[hover]image | idref | Imagepath to vertical slider thumb. Optional value. Since V2.5.0. |
| Synthetica.slider.thumb.y.image.insets | Insets | Image insets for vertical slider thumb image. Optional value. Since V2.5.0. |
| Synthetica.slider.thumb.animation.cycles | Integer | Number of animation cycles when mouse is moved out of the slider thumb. "Synthetica.slider.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.slider.thumb.animation.delay | Integer | Delay between images when mouse is moved out of the slider thumb. "Synthetica.slider.hoverAndPressed.enabled" has to be true. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.slider.thumb.animation.type | Integer | Animation type when mouse is moved out of the slider thumb. "Synthetica.slider.hoverAndPressed.enabled" has to be true. Optional value. Default value is 2 (HOVER_OUT). Since V2.5.0. |
Spinner UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.spinner.hoverAndPressed.enabled | Boolean | Optional hint to recognize hover and pressed state not only for arrow buttons. Default value is false. Since V2.5.0. |
| Synthetica.spinner.stateChange4ButtonOnly | Boolean | Hover and pressed state will be painted only for the button area. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.spinner.border | idref | Imagepath for spinner border/background - normal state. |
| Synthetica.spinner.border.disabled | idref | Imagepath for spinner border/background - disabled state. |
| Synthetica.spinner.border.hover | idref | Imagepath for spinner border/background - hover state. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.spinner.border.pressed | idref | Imagepath for spinner border/background - pressed state. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value - default is false. Since V2.5.0. |
| Synthetica.spinner.animation.cycles | Integer | Number of animation cycles when mouse is moved out of spinner. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.spinner.animation.delay | Integer | Delay between images when mouse is moved out of spinner. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.spinner.animation.type | Integer | Animation type when mouse is moved out of spinner. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value. Default value is 2 (HOVER_OUT). Since V2.5.0. |
| Synthetica.spinner.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the spinner. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1. Since V2.5.0. |
| Synthetica.spinner.hover.animation.delay | Integer | Delay between images when mouse is moved over the spinner. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value. Default value is 50. Since V2.5.0. |
| Synthetica.spinner.hover.animation.type | Integer | Animation type when mouse is moved over the spinner. "Synthetica.spinner.hoverAndPressed.enabled" has to be true. Optional value. Default value is 1 (HOVER_IN). Since V2.5.0. |
| Synthetica.spinner.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.spinner.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
| Synthetica.spinner.border.arcWidth | Integer | Defines the horizontal diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.spinner.border.arcHeight | Integer | Defines the vertical diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.spinner.border.fillInsets | Insets | Defines the insets used for background filling so you are able to define an empty area. Optional value - default value is 0 0 0 0. Since V2.9.0. |
| Synthetica.spinner.border.dInsets | Insets | Defines the destination insets for the border image. Set to "0 0 0 0" for cutting off the border. Optional value - default value is null. Since V2.6.0. |
Table UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.table.focusCellHighlightBorder.color | Color | Defines the border color for focused cells. Default value depends on used Systhetica Look and Feel. |
| Synthetica.table.scrollPane.border.color | Color | Defines the scrollpane border color for tables which are embedded in a scrollpane. Default value depends on used Systhetica Look and Feel. |
| Synthetica.tableHeader.gridColor | Color | Defines the paint color for vertical table header grid. Default value depends on used Systhetica Look and Feel. |
| Synthetica.table.useSynthHeaderRenderer | Boolean | By default Synthetica installs an own renderer (SyntheticaHeaderRenderer) for table headers. If the value is set to 'true' the original SynthHeaderRenderer will be used. Optional value, default is false. Since V2.3.0. |
| Synthetica.table.columnMargin | Integer | Defines vertical space between cells. Optional value. Default value is 1. Since V2.7.0. |
| Synthetica.table.rowMargin | Integer | Defines horizontal space between cells. Optional value. Default value is 1. Since V2.7.0. |
| Synthetica.table.useScrollPaneBorder | Boolean | Use default scroll pane border instead of the default single line border. Optional value. Default value is false. Since V2.7.0. |
| Synthetica.table.defaultEditor.className | idref | Custom default table cell editor. Optional value. Since V2.7.0. |
| Synthetica.table.defaultRenderer.className | idref | Custom default table cell renderer. Optional value. Since V2.9.0. |
| Synthetica.table.selectionBackground | idref | Background image for selected cell. Optional value. Since V2.10.0. |
| Synthetica.table.selectionBackground.insets | Insets | Background image insets for selected cell. Optional value. Default is 0 0 0 0.Since V2.10.0. |
| Synthetica.table.cellEditor.focus.color | idref | Focus color for cell editor - supported by SyntheticaDefaultTableCellEditor. Optional value. Since V2.9.0. |
| Synthetica.table.cellEditor.focus.size | Integer | Focus border size for table cell editor - supported by SyntheticaDefaultTableCellEditor. Optional value. Default value is 2. Since V2.10.0. |
| Synthetica.table.cellEditor.opaque | Boolean | Specifies opacity of the table cell editor - supported by SyntheticaDefaultTableCellEditor. Optional value. Default is false. Since V2.10.0. |
TableHeader UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.tableHeader.horizontalAlignment | Integer | TableHeader text alignment. Optional value. Default value is 10 (LEADING). See Java API Doc JLabel for valid values. Since V2.7.0. |
| Synthetica.tableHeader.showVerticalGrid | Boolean | Enable/disabled grid line painting. Optional value. Default value is true. Since V2.10.0. |
| Synthetica.tableHeader.background.image | idref | Imagepath for tableHeader background image. Optional value. Since V2.10.0. |
| Synthetica.tableHeader.background.image.insets | Insets | Image insets for the tableHeader background image. Optional value - default is 0 0 0 0. Since V2.10.0. |
| Synthetica.tableHeader.cell.background.image | idref | Imagepath for tableHeader cell background image i.e. useful to paint header grid. Optional value. Since V2.10.0. |
| Synthetica.tableHeader.cell.background.image.insets | Insets | Image insets for the tableHeader cell background image. Optional value - default is 0 0 0 0. Since V2.10.0. |
| Synthetica.tableHeader.ascendingSort.background.image | idref | Imagepath for cell background image in ascending sort state (supports Java 6 RowSorter). Optional value. Since V2.10.0. |
| Synthetica.tableHeader.ascendingSort.background.image.insets | Insets | Image insets for cell background image in ascending sort state. Optional value - default is 0 0 0 0. Since V2.10.0. |
| Synthetica.tableHeader.descendingSort.background.image | idref | Imagepath for cell background image in descending sort state (supports Java 6 RowSorter). Optional value. Since V2.10.0. |
| Synthetica.tableHeader.descendingSort.background.image.insets | Insets | Image insets for cell background image in descending sort state. Optional value - default is 0 0 0 0. Since V2.10.0. |
| Synthetica.tableHeader.ascendingSort.icon | idref | Imagepath to ascending sort icon. Optional value - default is 'Synthetica.arrow.up'. Since V2.10.0. |
| Synthetica.tableHeader.descendingSort.icon | idref | Imagepath to descending sort icon. Optional value - default is 'Synthetica.arrow.down'. Since V2.10.0. |
| Synthetica.tableHeader.cellBorder.className | idref | ClassName of custom border used for tableHeader cells. Optional value. Since V2.10.0. |
TabbedPane UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.tabbedPane.tabArea.background.image.[top | left | bottom | right] | idref | Imagepath of TabArea background image. Optional value. Since V2.5.0. |
| Synthetica.tabbedPane.tabArea.background.image.[top | left | bottom | right].insets | Insets | TabArea background image insets. Optional value. Since V2.5.0. |
| Synthetica.tabbedPane.tab.[selected | hover | disabled] [top | left | bottom | right] | idref | Tab image depending on tab placement and state. Since V2.2.0. |
| Synthetica.tabbedPane.tab.[selected | hover | disabled] [top | left | bottom | right].insets | Insets | Tab image insets depending on tab placement and state. Since V2.2.0. |
| Synthetica.tabbedPane.tab.selected.[top | left | bottom | right].text.insets | Insets | Optional value to adjust text within the selected tab. Since V2.2.0. |
| Synthetica.tabbedPane.tab.[top | left | bottom | right].text.insets | Insets | Optional value to adjust text within unselected tabs. Since V2.2.0. |
| Synthetica.tabbedPane.tab.selected.[top | left | bottom | right].icon.insets | Insets | Optional value to adjust icon within the selected tab. Since V2.2.0. |
| Synthetica.tabbedPane.tab.[top | left | bottom | right].icon.insets | Insets | Optional value to adjust icon within unselected tabs. Since V2.2.0. |
| Synthetica.tabbedPane.tab.selected.bold | Boolean | Enable/Disable bold font for the selected tab. Since V2.0.0. |
| Synthetica.tabbedPane.tab.text.position.leading | Boolean | Paint tab text on the left and tab icon on the right side. Optional value, default value is false. Since V2.1.0. |
| Synthetica.tabbedPane.tab.hover.insets | Insets | Optional value to restrict colorized hover area. Since V2.1.0. |
| Synthetica.tabbedPane.tab.animation.cycles | Integer | Number of animation cycles when mouse is moved out of tab. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.tabbedPane.tab.animation.delay | Integer | Delay between images when mouse is moved out of tab. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.tabbedPane.tab.animation.type | Integer | Animation type when mouse is moved out of tab. Optional value. Default value is 2. Since V2.2.0. |
| Synthetica.tabbedPane.tab.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over a tab. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.tabbedPane.tab.hover.animation.delay | Integer | Delay between images when mouse is moved over a tab. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.tabbedPane.tab.hover.animation.type | Integer | Animation type when mouse is moved over a tab. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.tabbedPane.tab.styleIsRotated | Boolean | Hint for tabbed panes with left/right tab placement and rotated tabs (not supported by the Swing's core JTabbedPane). A value of 'true' means that the defined tab styles already cover rotation, so the renderer doesn't have to rotate the tabs programatically. Optional value. Default value is false. Since V2.8.2. |
| Synthetica.tabbedPane.rotateTabRuns | Boolean | In the case that multiple tab rows appear the rows will be rotated for the selected tab. This property can be used to enable/disable tab row rotation. Optional value. Default value is true. Since V2.7.0. |
| Synthetica.tabbedPane.tabs.stretch | Boolean | Optional value to stretch tabs across the whole width. Currently only wrap layout policy is supported. Optional value. Default value is false. Since V2.7.0. |
| Synthetica.tabbedPane.tabs.maxStretchFactor | Integer | Tabs will be stretched to a maximum of the regular width multiplied by maxStretchFactor. If additional space is available tabs appear centered. Optional value. Default value is 3. Since V2.7.0. |
| Synthetica.tabbedPane.keepOpacity | Boolean | Hint to leave child opacity unchanged. Optional value. Default is false which means that opacity of child components will be set to non-opaque. Since V2.7.0. |
TextArea UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.textArea.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.textArea.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
TextField UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.textField.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.textField.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
| Synthetica.textField.border.arcWidth | Integer | Defines the horizontal diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.textField.border.arcHeight | Integer | Defines the vertical diameter of the arc at the four corners (used for background filling). Optional value - default value is 8. Since V2.2.0. |
| Synthetica.textField.border.fillInsets | Insets | Defines the insets used for background filling so you are able to define an empty area. Optional value - default value is 0 0 0 0. Since V2.9.0. |
TextPane UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.textPane.border.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image. Default is false. Since V2.2.0. |
| Synthetica.textPane.border.disabled.opaqueBackground | Boolean | Obsolete since V2.8.0. Optional hint to paint the background of the specified border image (disabled state). Default is false. Since V2.2.0. |
TitledBorder UI-Properties
| Key | Type | Description |
|---|---|---|
| TitledBorder.titleColor | Color | The text color used for painting the title of a titled border. Optional value. Default color is label default color. |
| Synthetica.titledBorder.title.position | Integer | Relative text position to border. Optional value. Default value is 2 which means TitledPanel#TOP - see API of TitledPanel. Since V2.7.0. |
| Synthetica.titledBorder.title.fontName | idref | The font name used for title painting. Optional value. Default font is the panel font. Since V2.7.0. |
| Synthetica.titledBorder.title.fontStyle | Integer | The font style used for title painting. Optional value. Default value is the style of the panel font. Since V2.7.0. |
| Synthetica.titledBorder.title.fontSize | idref | The font size used for title painting. Optional value. Default value is the size of the panel font. Since V2.7.0. |
ToggleButton UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.toggleButton.animation.cycles | Integer | Number of animation cycles when mouse is moved out of component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.toggleButton.animation.delay | Integer | Delay between images when mouse is moved out of component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.toggleButton.animation.type | Integer | Animation type when mouse is moved out of component. Optional value. Default value is 2 (HOVER_OUT). Since V2.2.0. |
| Synthetica.toggleButton.hover.animation.cycles | Integer | Number of animation cycles when mouse is moved over the component. Optional value. Default value is 1. Since V2.2.0. |
| Synthetica.toggleButton.hover.animation.delay | Integer | Delay between images when mouse is moved over the component. Optional value. Default value is 50. Since V2.2.0. |
| Synthetica.toggleButton.hover.animation.type | Integer | Animation type when mouse is moved over the component. Optional value. Default value is 1 (HOVER_IN). Since V2.2.0. |
ToolBar UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.toolBar.button.pressed.paintBorder | Boolean | Enable/disable painting of button border for pressed state. Default value false. |
| Synthetica.toolBar.buttons.paintBorder | Boolean | Enable/disable border painting of all toolbar buttons. Default value is false. |
| Synthetica.toolBar.background | idref | Path to the toolBar background image. Optional value. Since V2.0.0. |
| Synthetica.toolBar.background.insets | Insets | Image insets for toolBar image. Optional value. Since V2.0.0. |
| Synthetica.toolbar.background.horizontalTiled | Boolean | Enable/disable horizontal stretching of the toolBar background image. Default value is false. Since V2.3.0. |
| Synthetica.toolbar.background.verticalTiled | Boolean | Enable/disable vertical stretching of the toolBar background image. Default value is false. Since V2.3.0. |
| Synthetica.toolBar.background.light | idref | An optional value for a light image which will be painted on top of the regular background image (inactive state). The image will be stretched horizontal. The verticalTiled and insets settings for the background image will be used. Since V2.2.0. |
| Synthetica.toolBar.background.light2 | idref | An optional value for a light image which will be painted on top of the regular background image and the first light image. The image will be stretched horizontal and vertical. Since V2.3.0. |
| Synthetica.toolBar.button.border | idref | Path for a background image which is only used for buttons placed on a ToolBar. The image-insets for a regular button will be used. |
| Synthetica.toolBar.button.border.hover | idref | Path for button background image which represents the hover state. The image-insets for a regular button will be used. |
| Synthetica.toolBar.button.border.pressed | idref | Optional path for button background image which represents the pressed state. The image-insets for a regular button will be used. Since V2.3.0. |
| Synthetica.toolBar.toggleButton.border.selected | idref | Optional path for toggleButton background image which represents the selected state. The image-insets for a regular toggleButton will be used. Since V2.3.0. |
| Synthetica.toolBar.toggleButton.border.selectedAndHover | idref | Optional path for toggleButton background image which represents the selectedAndHover state. The image-insets for a regular toggleButton will be used. Since V2.3.0. |
| Synthetica.toolBar.button.font.style | idref | Optional font style for toolBar buttons. Valid values are PLAIN, BOLD and ITALIC. Since V2.5.0. |
| Synthetica.toolBar.button.font.size | Integer | Optional font size for toolBar buttons. Since V2.5.0. |
| Synthetica.toolBar.handle.image.x | idref | Handle image for vertical toolBars. Since V2.6.0. |
| Synthetica.toolBar.handle.image.y | idref | Handle image for horizontal toolBars. Since V2.6.0. |
| Synthetica.toolBar.handle.image[.x|.y].insets | Insets | Image insets of toolBar handle. Since V2.6.0. |
| Synthetica.toolBar.handle.size | Integer | Gap size reserved for toolBar handle. A zero value disables the toolBar handle. Since V2.6.0. |
| Synthetica.toolBar.handle.image[.x|.y].tiled | Boolean | Paint image streched or tiled. Optional value. Default is false. Since V2.7.0. |
| Synthetica.toolBar.opaque | Boolean | Specifies default opacity. Optional value. Default is true. Since V2.10.0. |
ToolTip UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.toolTip.background | idref | Path of background image which will be used for ToolTips. |
| Synthetica.toolTip.background.insets | Insets | Image insets for the background-image. |
| Synthetica.toolTip.animation.cycles | Integer | Number of animation cycles when ToolTip will become visible. Optional value. Default value is 1. Since V2.3.0. |
| Synthetica.toolTip.animation.delay | Integer | Delay between image sequence. Optional value. Default value is 50. Since V2.3.0. |
| Synthetica.toolTip.animation.type | Integer | Animation type. Optional value. Default value is 4 (DISPOSABLE). Since V2.3.0. |
Tree UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.tree.line.type | idref | Defines type of used tree line. Valid values are "NONE", "SOLID", "DASHED". Default value is generally DASHED. |
| Synthetica.tree.line.dashed.line | Integer | Defines length of dashes in pixels. Default value is 2. |
| Synthetica.tree.line.dashed.space | Integer | Defines length of space between dashes in pixels. Default value is 1. |
| Synthetica.tree.line.color.horizontal | Color | Defines the paint color for horizontal treelines. Default value depends on used Systhetica Look and Feel. |
| Synthetica.tree.line.color.vertical | Color | Defines the paint color for vertical treelines. Default value depends on used Systhetica Look and Feel. |
| Synthetica.tree.defaultCellRenderer.enabled | Boolean | Defines if Synthetica's DefaultTreeCellRenderer or your custom CellRenderer should by used for cell rendering. False means the Synth renderer will be used. Default is true. Since V2.9.0. |
| Synthetica.tree.defaultCellRenderer.className | idref | The specified renderer will be used as default cell renderer. The UI-property "Synthetica.tree.defaultCellRenderer.enabled" has to be 'true'. Since V2.9.0. |
| Synthetica.tree.selectionBackground | idref | Background image for selected item. Optional value. Since V2.10.0. |
| Synthetica.tree.selectionBackground.insets | Insets | Background image insets for selected item. Optional value. Default is 0 0 0 0.Since V2.10.0. |
Viewport UI-Properties
| Key | Type | Description |
|---|---|---|
| Synthetica.viewport.dynamicBackgroundColorEnabled | boolean | Enable/disable dynamic background color for viewports. True (enabled) means the background color of the view will be used for viewport painting - usefull feature for tables, so you don't have to separately set a background-color for the viewport. Optional value. Default value is false. Since V2.7.0. |