--- old/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html 2017-10-23 13:51:16.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html 2017-10-23 13:51:16.000000000 -0700 @@ -1,8 +1,11 @@ - - + + + + Component Specific Properties + - +

Component Specific Properties

The look, and to some degree the feel of Synth -can be customized by way of component specific properties. -These properties are accessed from SynthStyle#get. Refer to synth file format for examples of how to specify these properties in a synth configuration file.

-

+ can be customized by way of component specific properties. + These properties are accessed from SynthStyle#get. Refer to synth file format for examples + of how to specify these properties in a synth configuration file.

+

This file specifies the expected class type each of the values are to take. The behavior of supplying the wrong type is unspecified: typically a ClassCastException is @@ -66,7 +70,7 @@
-

JButton

+

JButton

JButton paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JButton supports the following property:

@@ -89,7 +93,7 @@
-

JCheckBox

+

JCheckBox

JCheckBox paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JCheckBox supports the following property:

@@ -111,7 +115,7 @@
-

JComboBox

+

JComboBox

JComboBox is a composite component that consists of the following child Components:

@@ -144,7 +148,7 @@ - @@ -279,7 +283,7 @@ - + @@ -301,7 +305,7 @@ - + @@ -312,7 +316,7 @@ - + @@ -324,7 +328,7 @@ regular files list view, showing only an icon and the name of each file and directory. - + @@ -339,7 +343,7 @@
ComboBox.renderer Component The renderer used for the JComboBox. This is ONLY set if + The renderer used for the JComboBox. This is ONLY set if the renderer is a UIResource.
Icon used by the button that creates a new folder.
FileChooser.upFolderIcon
Icon used by the button that navigates to the current user's home directory.
FileChooser.detailsViewIcon
Icon used by the button that toggles the detailed files list view.
FileChooser.listViewIcon
FileChooser.viewMenuIcon

-

JInternalFrame

+

JInternalFrame

JInternalFrame Specific Properties
@@ -369,7 +373,7 @@

-

JInternalFrameTitlePane

+

JInternalFrameTitlePane

JInternalFrameTitlePane is the control bar located at the top of the internal frame similar to that found in a frame.

@@ -469,7 +473,7 @@
-

JList

+

JList

JList's sets the name of the renderer to List.renderer. JList supports the following properties:

JList Specific Properties
@@ -486,7 +490,7 @@ Boolean true If true the renderers state is not updated, and the text -colors come from JList's getSelectionBackground and +colors come from JList's getSelectionBackground and getSelectionForeground methods. If false, the renderer's state is updated and the colors will instead come from the Style. @@ -508,7 +512,7 @@
-

Menu Properties

+

Menu Properties

The Menu classes (JCheckBoxMenuItem, JMenu, JMenuItem, and JRadioButtonMenuItem) all support the same set of properties and behave similarly. Each component consists of two Regions: the region @@ -536,7 +540,7 @@ prefix.arrowIcon Icon null - Icon drawn to the right of the text (or left when the + Icon drawn to the right of the text (or left when the ComponentOrientation is right to left) of the text. This is typically only defined for JMenu. @@ -544,7 +548,7 @@ prefix.checkIcon Icon null - Icon drawn to the left of the text (or right when the + Icon drawn to the left of the text (or right when the ComponentOrientation is right to left) of the text. This is typically only defined for JCheckBoxMenuItem and JRadioButtonMenuItem to provide the check or radio button. @@ -561,7 +565,7 @@ prefix.textIconGap Integer 4 - Padding between the icon and text. Refer to the javadoc for + Padding between the icon and text. Refer to the javadoc for javax.swing.AbstractButton#setIconTextGap(int) for details of how this is used. @@ -593,7 +597,7 @@
-

JOptionPane

+

JOptionPane

JOptionPane is a composite component and may consist of numerous child components, they are: OptionPane.button, OptionPane.label, OptionPane.comboBox, OptionPane.scrollPane, OptionPane.list, @@ -623,7 +627,7 @@ OptionPane.buttonOrientation Integer SwingConstants.CENTER - How the buttons should be layed out, one of + How the buttons should be layed out, one of SwingConstants.LEFT, SwingConstants.RIGHT or SwingConstants.CENTER (this will be flipped when in a right to left locale). @@ -709,7 +713,7 @@
-

JProgressBar
+

JProgressBar

JProgressBar Specific Properties
@@ -749,7 +753,7 @@ -

JRadioButton

+

JRadioButton

JRadioButton paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JRadioButton supports the following property:

@@ -771,7 +775,7 @@
-

JScrollBar

+

JScrollBar

JScrollBar is a composite component that consists of the following child Components:

@@ -841,7 +845,7 @@

-

Separators

+

Separators

All of the separator classes, JSeparator, JPopupMenu.Separator and JToolBar.Separator use the same property:

@@ -856,7 +860,7 @@ - @@ -875,20 +879,21 @@ - - + +
Separator.thickness Integer 2 Preferred width, for vertically aligned separators, or + Preferred width, for vertically aligned separators, or preferred height for horizontally aligned separators. The resulting preferred size will include the Insets.
ToolBar.separatorSize Dimension null The value of this is passed to the javax.swing.JToolBar$Separator#setSeparatorSize(java.awt.Dimension) -method. If unspecified setSeparatorSize is not -invoked.
The value of this is passed to the + javax.swing.JToolBar$Separator#setSeparatorSize(java.awt.Dimension) + method. If unspecified setSeparatorSize is not invoked. +

-

JScrollPane

-

+

JScrollPane

+

JScrollPane is unique in that it provides a method for setting the Border around the JViewport with JViewport throwing an IllegalArgumentException from setBorder. To accommodate this a special border is installed on the - JScrollPane that uses the + JScrollPane that uses the insets from the key ScrollPane.viewportBorderInsets. The SynthPainter method @@ -913,7 +918,7 @@
-

JSplitPane

+

JSplitPane

JSplitPane is a composite component that will contain a divider and potentially two buttons, if setOneTouchExpandable(true) has been invoked. The two buttons will be named: @@ -950,7 +955,7 @@ SplitPane.oneTouchExpandable Boolean null - If non null, the value of this is passed to + If non null, the value of this is passed to setOneTouchExpandable. @@ -962,7 +967,7 @@
-

JSlider

+

JSlider

JSlider Specific Properties
@@ -1022,7 +1027,7 @@

-

JTabbedPane

+

JTabbedPane

JTabbedPane Specific Properties
@@ -1084,8 +1089,8 @@

-

JTable

-

JTable sets the name of the renderer to Table.cellRenderer. +

JTable

+

JTable sets the name of the renderer to Table.cellRenderer. JTable supports the following properties:

JTable Specific Properties
@@ -1108,7 +1113,7 @@ @@ -1116,7 +1121,7 @@ - @@ -1129,7 +1134,7 @@
Boolean true If true the renderers state is not updated, and the text -colors come from JTable's getSelectionBackground and +colors come from JTable's getSelectionBackground and getSelectionForeground methods. If false, the renderer's state is updated and the colors will instead come from the Style.
Table.rendererUseUIBorder Boolean true If true setBorder on the renderer will succeed + If true setBorder on the renderer will succeed regardless of the border passed in, otherwise setBorder on the renderer will only succeed if it is a Synth Border.

-

JTree

+

JTree

JTree sets the name of the renderer to Tree.renderer, the name of the editor is Tree.cellEditor.

JTree Specific Properties
@@ -1151,7 +1156,7 @@ Tree.drawHorizontalLines Boolean true - If true nodes have a horizontal connecting them to the + If true nodes have a horizontal connecting them to the leading edge of their parent. @@ -1198,7 +1203,7 @@ Tree.scrollsOnExpand Boolean true - Whether or not the JTree should scroll when a node is + Whether or not the JTree should scroll when a node is expanded. @@ -1212,7 +1217,7 @@ -

JToggleButton

+

JToggleButton

JToggleButton paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JToggleButton supports the following property:

@@ -1234,7 +1239,7 @@
-

Button Properties

+

Button Properties

Each of the Button classes (JButton, JCheckBox, JRadioButton, JToggleButton and SynthArrowButton) support a similar set of properties. These properties are:

@@ -1250,23 +1255,29 @@ prefix.contentAreaFilled Integer true - Refer to the javadoc of javax.swing.AbstractButton#contentAreaFilled(boolean) for details -of how this is used. It is up to the Painter to properly honor this -property. - + Refer to the javadoc of + javax.swing.AbstractButton#contentAreaFilled(boolean) + for details of how this is used. It is up to the Painter to properly honor + this property. + + prefix.iconTextGap Integer - If unspecified, JButton.setIconTextGap is not invoked. - Padding between the icon and text. Refer to the javadoc of javax.swing.AbstractButton#setIconTextGap(int) for details of how -this is used. + If unspecified, JButton.setIconTextGap is not invoked. + Padding between the icon and text. Refer to the javadoc of + javax.swing.AbstractButton#setIconTextGap(int) + for details of how this is used. + prefix.margin Insets Empty Insets (0, 0, 0, 0) - Margin for the JButton. Refer to the javadoc of javax.swing.AbstractButton#setMargin(java.awt.Insets) for details -of how the margin is used. + Margin for the JButton. Refer to the javadoc of + javax.swing.AbstractButton#setMargin(java.awt.Insets) for + details of how the margin is used. + prefix.textShiftOffset @@ -1281,7 +1292,7 @@

Prefix is one of: Button, CheckBox, RadioButton or JToggleButton.

-

Text Properties
+

Text Properties