Component Converters

DispatchingComponentConverter can create almost all of the Swing components.
When "Component" is listed as the property type for a property, the default instance of DispatchingComponentConverter is used to convert the resource bundle key or string.

The following is a list of component converters / configurers, and their helper classes, installed in the default instance of DispatchingComponentConverter. Unless a syntax is given, all converters are composite converters with the braced property syntax. Helper converter classes are used to create instances used for property values of components, but do not create components themselves. Unless otherwise stated (in particular, Separator), converters marked "not a Component" are not installed in
DispatchingComponentConverter; they are only used to create property values of components.

Base


Component (component)

Property Type
Map Consistency
Note
This class cannot create anything; it can only be used for configuration.
Creation Properties


<None>



Properties



name
Quoted String
No

background
Color
Yes

foreground
Color
Yes

componentListeners
Instance Collection No
Each element should be an instance of ComponentListener.
componentOrientation
String
Yes
One of "leftToRight", "rightToLeft", or  "unknown". May also be set with an instance of ComponentOrientation.
cursor
Cursor
No

dropTarget
Instance
No
Must be an instance of DropTarget.
enableInputMethods
Boolean No

enabled
Boolean No

focusable
Boolean Yes

focusListeners
Instance Collection No
Each element must be an instance of FocusListener.
focusTraversalKeysEnabled
Boolean
Yes

font
Font
Yes

hierarchyBoundsListeners
Instance Collection No
Each element must be an instance of HierarchyBoundsListener.
hierarchyListeners
Instance Collection No
Each element must be an instance of HierarchyListener.
ignoreRepaint
Boolean No

inputMethodListeners
Instance Collection No
Each element must be an instance of InputMethodListener.
keyListeners
Instance Collection No
Each element must be an instance of KeyListener.
locale
Locale
Yes

location
Point
No

mouseListeners
Instance Collection No
Each element must be an instance of MouseListener.
mouseMotionListeners
Instance Collection No
Each element must be an instance of MouseMotionListener.
mouseWheelListeners
Instance Collection
No
Each element must be an instance of MouseWheelListener.
propertyChangeListeners
Property Name / Listener Pair Collection
No

size
Dimension
No


PropertyNameListenerPair (not a Component)
Property Type
Map Consistency
Note
String syntax:

{ propertyName , listenerInstanceString }

or

listenerInstanceString

where propertyName is converted by the Quoted String converter, and listenerInstanceString is converted by the instance converter. propertyName should be convertible to the name of the property to listen for changes to, and listenerInstanceString should be convertible to an instance of  PropertyChangeListener.

If the second syntax is used, the listener will receive notifications to all property changes.
Creation Properties


name
Quoted String
No
The name of the property to listen for changes to. If missing, the listener is will receive property change events for all property names.
listener Instance
No
Must be an instance of PropertyChangeListener.
Properties



<None>



Container (container)

Property Type
Map Consistency
Note
This class is a base class for converters that create instances of Container which are not instances of JComponent.
It cannot create anything; it can only be used for configuration.
Creation Properties


<None>


Properties


<Inherits Component properties>



layout
Layout
No

contents ComponentConstraintPair Collection
No
May be also set with collection of instances of Component.
containerListeners
Instance Collection
No
Each element must be an instance of ContainerListener.
focusCycleRoot
Boolean
Yes

focusTraversalPolicy
Instance
Yes
Must be an instance of FocusTraversalPolicy.

JComponent (jcomponent)
Property Type
Map Consistency
Note
This class cannot create anything; it can only be used for configuration.
Creation Properties



<None>



Properties



<Inherits Component properties>



actionMap
Instance
No
Must be instance of ActionMap.
autoscrolls
Boolean
No

alignX
Float
No

alignY
Float
No

ancestorListeners
Instance Collection
No
Each element must be an instance of AncestorListener.
border
Border
Yes

clientProperties
Instance Key / Instance Value Map
No
Existing client properties will not be cleared unless explicitly done so with a mapping like {"key", null}.
enabled
Boolean
Yes

inputVerifier
Instance
Yes
Must be an instance of InputVerifier.
minSize
Dimension Yes
Minimum size
maxSize
Dimension Yes
Maximum size
opaque
Boolean
Yes

prefSize
Dimension
Yes
Preferred size
tooltip
Quoted String
Yes

transferHandler
Instance
Yes
Must be an instance of TransferHandler.
verifyInputWhenFocusTarget
Boolean
Yes


JContainer (jcontainer)

Property Type
Map Consistency
Note
This class is a base class for converters that create instances of JComponent that act as containers.
It cannot create anything; it can only be used for configuration.
Creation Properties


<None>


Properties


<Inherits JComponent properties>



layout
Layout
Yes

contents ComponentConstraintPair Collection
No
May be also set with collection of instances of Component.
containerListeners
Instance Collection
No
Each element must be an instance of ContainerListener.
focusCycleRoot
Boolean
Yes

focusTraversalPolicy
Instance
Yes
Must be an instance of FocusTraversalPolicy.

ComponentConstraintPair
(not a Component)
Property Type Map Consistency Note
String syntax:
{
componentString [, constraintString] }
or
componentString

If either the component or constraint is a literal, it must be braced. Examples:
{ {jlabel text="hi"}, {north} }

{ %alabel, {gbc ipadx=4} }

%button
has no constraint
Creation Properties



component
Component
No

constraint
<Varies>
No
The constraint is parsed differently depending on the layout of the parent container. For example, if the parent container has a layout which is an instance of BorderLayout, "north" as a constraint would be converted to BorderLayout.NORTH. See Component Constraint Converters.
Properties



<None>




Containers

JApplet (japplet)

Property Type
Map Consistency
Note
This class will most likely be used for configuration only, since a proper instance of JApplet does nothing.
Creation Properties


<None>


Properties


<Inherits JComponent properties>


contentPane
Component
No
Must be an instance of Container.
glassPane
Component
No
Must be an instance of Container.
layeredPane
Component
No
Must be an instance of JLayeredPane.
JMenuBar
Component
No
Must be an instance of JMenuBar.
status
Quoted String
No
Sets the status message.

Window (window)

Property Type
Map Consistency
Note
Serves only as a base for Dialog, Frame and Window; not installed in DispatchingComponentConverter.
Creation Properties


owner
Instance
No
Must be an instance of Frame or Window.
graphicsConfig
Instance
No
Must be an instance of GraphicsConfiguration.
Properties


<Inherits ContainerProperties>



focusableWindowState
Boolean
Yes

locationRelativeTo
Instance
No
Probably should be set to a reference to an existing component.
location
Point
Yes
Overridden from Component to be after locationRelativeTo, so that the parent is set before moving the component.
windowListeners
Instance Collection
No
Each element must be an instance of WindowListener.
windowFocusListeners
Instance Collection
No
Each element must be an instance of WindowFocusListener.
windowStateListeners
Instance Collection
No
Each element must be an instance of WindowStateListener.

JWindow (jwindow)
Property Type Map Consistency Note
Creation Properties


<Inherits Window creation properties>



Properties


<Inherits Window properties>


contentPane
Component
No
Must be an instance of Container.
glassPane
Component No
Must be an instance of Container.
layeredPane
Component
No
Must be an instance of JLayeredPane.

Dialog (dialog)

Property Type
Map Consistency
Note
Serves only as a base for JDialog; not installed in DispatchingComponentConverter.
Creation Properties


<Inherits Window creation properties>


Properties



<Inherits Window properties>


modal
Boolean
No

title
Quoted String
Yes

resizable
Boolean
No

undecorated
Boolean
No


JDialog (jdialog)
Property Type Map Consistency Note
Creation Properties


<Inherits Dialog creation properties>



optionPane
Component

Must be an instance of JOptionPane. A dialog is created that wraps the option pane. The graphicsConfig property is ignored.
colorChooser
Component

Must be an instance of JColorChooser. A dialog is created that wraps the color chooser. The graphicsConfig property is ignored.
okListener



cancelListener



Properties


<Inherits Dialog creation properties>


JMenuBar
Component
No
Must be an instance of JMenuBar.
contentPane
Component
No
Must be an instance of Container.
glassPane
Component No
Must be an instance of Container.
layeredPane Component
No
Must be an instance of JLayeredPane.
defaultCloseOperation
String
No
One of "doNothing", "hide", or "dispose". May also be set with an Integer wrapping one of the WindowConstants.XXX_ON_CLOSE constants.
defaultLookAndFeelDecorated
Boolean
No


Frame (frame)

Property Type Map Consistency Note
Serves only as a base for JFrame; not installed in DispatchingComponentConverter.
Creation Properties


graphicsConfig Instance No
Must be an instance of GraphicsConfiguration.
Properties


<Inherits Window properties>


icon
ImageIcon
No
May also be set with an instance of Icon.
resizable
Boolean Yes

title
Quoted String
Yes

extendedState
String
No
One of "normal", "iconified", "maximizedHoriz", "maximizedVert", or "maximimzedBoth".
May also be set with an Integer wrapping the appropriate Frame member.
maximizedBounds
Rectangle
No

undecorated
Boolean
No

pack
Boolean
No
If the size is not specified, this must be set to a true Boolean so that the frame is visible. Doing so will invalidate any size set previously.

JFrame (jframe)
Property Type Map Consistency Note
Creation Properties


<Inherits Frame creation properties>



Properties


<Inherits Frame properties>


JMenuBar Component
No
Must be an instance of JMenuBar.
contentPane
Component
No
Must be an instance of Container.
glassPane
Component No
Must be an instance of Container.
layeredPane
Component
No
Must be an instance of JLayeredPane.
defaultCloseOperation
String
Yes
One of "doNothing", "hide", or "dispose". May also be set with an Integer wrapping one of the WindowConstants.XXX_ON_CLOSE constants, which is what the map consistency listener puts as the map value.
defaultLookAndFeelDecorated
Boolean
No


JInternalFrame (jinternalframe)
Property Type Map Consistency Note
Creation Properties


<None>


Properties


<Inherits JComponent properties>


desktopIcon
Instance Yes
Must be an instance of JInternalFrame.JDesktopIcon.
frameIcon
ImageIcon
Yes
May also be set with an instance of Icon.
JMenuBar
JMenuBar
Yes

contentPane
Component
Yes
Must be an instance of Container.
glassPane
Component Yes
Must be an instance of Container.
layeredPane
JLayeredPane Yes

iconifiable
Boolean
Yes
If a PropertyVetoException is thrown while setting this property, it will be ignored.
isIcon
Boolean
Yes

closable
Boolean
Yes
If a PropertyVetoException is thrown while setting this property, it will be ignored.
isClosed
Boolean
Yes
maximizable
Boolean
Yes
If a PropertyVetoException is thrown while setting this property, it will be ignored.
isMaximum Boolean Yes If a PropertyVetoException is thrown while setting this property, it will be ignored.
resizable
Boolean Yes
If a PropertyVetoException is thrown while setting this property, it will be ignored.
selected
Boolean Yes
If a PropertyVetoException is thrown while setting this property, it will be ignored.
layer
Layer
No

title
Quoted String
Yes

defaultCloseOperation
String
No
One of "doNothing", "hide", or "dispose". May also be set with an Integer wrapping one of the WindowConstants.XXX_ON_CLOSE constants, which is what the map consistency listener puts as the map value.
internalFrameListeners
Instance Collection
No
Each element must be an instance of InternalFrameListener.
pack
Boolean
No
If the size is not specified, this must be set to a true Boolean so that the frame is visible. Doing so will invalidate any size set previously.
ui
Instance
Yes
Must be an instance of InternalFrameUI.

JLayeredPane (jlayeredpane)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JContainer properties>



contents
ComponentLayerPair Collection
No
Collection elements may also be instances of Component, in which case they are added to the default layer.

ComponentLayerPair (not a Component)
Property Type
Map Consistency
Note
String syntax:
{
componentString [, layerString] }

or

componentString  (must be a variable reference)

If a string literal used for the component or layer, it must be enclosed in '{' and '}'. Example:
{{jlabel text="HI"}, {palette}}.

As a shorthand, a variable or a braced component string by itself can be used; it will be put in the default layer. Example:
{jbutton text="argh"}
is equivalent to:
{{jbutton text="argh"}, {default}}

%menu 
is equivalent to
{%menu, {default}}
Creation Properties


component
Component
No

layer
Layer
No

Properties



<None>




Layer (not a Component) -- Represents a layer identifier for use by JLayeredPane
The object created is an instance of Integer, which can be used directly as a layer identifier.
String syntax: One of "default", "palette", "modal", "popup", "drag", or "frameContent", or a literal integer string.

JDesktopPane (jdesktoppane)
Property Type Map Consistency Note
Creation Properties


<None>


Properties


<Inherits JLayeredPane properties>


desktopManager
Instance
No
Must be an instance of DesktopManager.
dragMode
String
Yes
Either "live" or "outline". May also be set with an Integer wrapping JDesktopPane.LIVE_DRAG_MODE or JDesktopPane.OUTLINE_DRAG_MODE, which is what the map consistency listener puts as the map value.
selectedFrame Instance
No
Must be an instance of JInternalFrame which is in the contents of the JDesktopPane.
ui
Instance
Yes
Must be an instance of DesktopPaneUI.

Box (box)
Property Type
Map Consistency
Note
Creation Properties



axis
String
No
Must be either "x" or "y".
Properties



<Inherits JContainer properties>



JMenuBar (jmenubar)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JContainer properties>



contents
Component Collection
No
Put literal component strings inside '{' and '}'. Example:
jmenubar contents=[{jbutton text="A"}, {jbutton text="B"}]
borderPainted
Boolean
Yes

margin
Insets
Yes

selectionModel
Instance
Yes
Must be an instance of SingleSelectionModel.
ui
Instance
Yes
Must be an instance of MenuBarUI.

JPopupMenu (jpopupmenu)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>



borderPainted
Boolean
No

label
Quoted String
Yes

location
Point
No
The x and y components of the Point are passed to JPopupMenu.setLocation(x, y).
invoker
Instance
No
Probably should be set to an existing instance of Component.
lightweightPopupEnabled
Boolean
No

popupSize
Dimension
No

selectionModel
Instance
No

menuItems
Component Collection No
Each instance may be an instance of JMenuItem, Action, JSeparator, or the default separator (see Separator).
popupMenuListeners
Instance Collection
No
Each element must be an instance of PopupMenuListener,
ui
Instance
Yes
Must be an instance of PopupMenuUI.

JPanel (jpanel)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JContainer properties>



JOptionPane (joptionpane)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


message
Quoted String
Yes
May also be set with an Object. Note: if set to a component, the component will be displayed in the center of the pane.
messageType
String
Yes
One of "error", "information", "plain", "question", or "warning". May also be set with an Integer which wraps one of the JOptionPane.XXX_MESSAGE constants, which is what the map consistency listener puts as the map value.
options
Quoted String Collection
Yes
May also be set with an instance of Object[], which is what the map consistency listener puts as the map value.
optionType
String Yes
One of "default", "okCancel", "yesNo", or "yesNoCancel". May also be set with an Integer which wraps one of the JOptionPane.XXX_OPTION constants, which is what the map consistency listener puts as the map value.
icon
ImageIcon
Yes
May also be set with an instance of Icon.
initialValue
Instance
Yes

value
Instance
Yes

ui
Instance
Yes
Must be an instance of OptionPaneUI.

JScrollPane (jscrollpane)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JContainer properties>


hsbPolicy
String
Yes
One of "asNeeded", "never",  or "always". May also be set with an Integer which wraps one of the ScrollBarConstants.HORIZONTAL_SCROLLBAR_XXX  constants, which is what the map consistency listener puts as the map value.
vsbPolicy
String
Yes
One of "asNeeded", "never",  or "always". May also be set with an Integer which wraps one of the ScrollBarConstants.VERTICAL_SCROLLBAR_XXX  constants, which is what the map consistency listener puts as the map value.
viewport
JViewport
Yes

viewportView
Component
No

rowHeaderView
Component
No

columnHeaderView
Component
No

corners
ComponentConstraintPair Collection Yes
The constraint of each pair must be one of
one of the ScrollBarConstants members which denote a corner.
viewportBorder
Border
Yes

wheelScrollingEnabled
Boolean
Yes


JViewport (jviewport)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


extentSize
Dimension
Yes

scrollMode
String
No
One of "blit", "backingStore",  or "simple". May also be set with an Integer which wraps one of the JViewport.SCROLL_MODE_XXX  constants, which is what the map consistency listener puts as the map value.
view
Component
No

viewPosition
Point
Yes

viewSize
Dimension
Yes

changeListeners
Instance Collection
No
Each element must be an instance of ChangeListener.
ui
Instance
Yes
Must be an instance of ViewportUI.

JSplitPane (jsplitpane)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JContainer properties>


continuousLayout
Boolean
Yes

left
Component
No

right
Component
No

dividerLocation
Integer
Yes
Corresponds to setDividerLocation(int).
dividerLocationRatio
Double
No *
Corresponds to setDividerLocation(double).
* If this property is changed, the map consistency listener for the dividerLocation property is notified.
dividerSize
Integer
Yes

oneTouchExpandable
Boolean
Yes

orientation
String
Yes
Either "h" for horizontal, "v" for vertical.
May also be set with an Integer wrapping JSplitPane.HORIZONTAL_SPLIT or JSplitPane.VERTICAL_SPLIT, which is what the map consistency listener puts as the map value.
resizeWeight
Double
Yes

ui
Instance
Yes
Must be an instance of SplitPaneUI.

JTabbedPane (jtabbedpane)
Property type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JContainer properties>



tabPlacement
String
Yes
One of "top", "bottom", "left", or "right". May also be set with an Integer wrapping SwingConstants.TOPSwingConstants.BOTTOMSwingConstants.LEFT, or SwingConstants.RIGHT, which is what the map consistency listener puts as the map value.
tabLayoutPolicy
String
Yes
Either "wrap" or "scroll". May also be set with an Integer wrapping JTabbedPane.WRAP_TAB_LAYOUT,  or JTabbedPane.SCROLL_TAB_LAYOUT, which is what the map consistency listener puts as the map value.
tabs
Tab Collection
No

selectedIndex Integer Yes
ui
Instance
Yes
Must be an instance of TabbedPaneUI.

Tab (not a Component)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties


enabled
Boolean
No

title
Quoted String
No

component
Component
No
Required
mnemonic
Key Code
No

mnemonicIndex
Integer
No

icon
ImageIcon
No
May also be set with an instance of Icon.
disabledIcon
ImageIcon
No
May also be set with an instance of Icon.
tooltip
Quoted String
No

background
Color
No

foreground
Color
No


JToolBar (jtoolbar)
Property type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JContainer properties>



borderPainted
Boolean
Yes

contents
Component Collection
No
Collection may also contain separators.
floatable
Boolean
Yes

margin Insets
Yes

orientation
String
Yes
Either "h" for horizontal, "v" for vertical.
May also be set with an Integer wrapping  SwingConstants.HORIZONTAL or SwingConstants.VERTICAL, which is what the map consistency listener puts as the map value.
rollover
Boolean
Yes

ui
Instance
Yes
Must be an instance of ToolBarUI.

Decorations

JLabel (jlabel)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


text
Quoted String
Yes

icon
ImageIcon
Yes
May also be set with an instance of Icon.
disabledIcon
ImageIcon Yes
May also be set with an instance of Icon.
mnemonic
Character
Yes

mnemonicIndex Integer
Yes

iconTextGap
Integer
Yes

vTextPos
String
Yes
One of "center", "top", or "bottom".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
hTextPos
String Yes
One of "right", "left", "center", "leading", or "trailing".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
vAlign
String Yes
One of "center", "top", or "bottom".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
hAlign
String Yes
One of "right", "left", "center", "leading", or "trailing".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
labelFor
Component
Yes
You can define the component that the label is for here, and put it into a global. Then use the global later to avoid creating another copy of the component. For example:

panel.contents=[%nameLabel, &ntf]

nameLabel.text=Name:
nameLabel.labelFor=%nameTextField
# Hitting Alt-N will switch to the text field
nameLabel.mnemonic=n

nameTextField.globalName=ntf
nameTextField.text=$name:rw
ui
Instance
Yes
Must be an instance of LabelUI.

JProgressBar (jprogressbar)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


model
Instance No
Must be an instance of BoundedRangeModel.
max
Integer
No

min
Integer
No

borderPainted
Boolean
Yes

changeListeners
Instance Collection
No
Each element must be an instance of ChangeListener.
indeterminate
Boolean
Yes

orientation
String
Yes

text
Quoted String
Yes
Corresponds to the string property of JProgressBar.
textPainted
Boolean
Yes
Corresponds to the stringPainted property of JProgressBar.
value
Integer
Yes

ui
Instance
Yes
Must be an instance of ProgressBarUI,

Buttons


AbstractButton (abstractbutton)
Property Type
Map Consistency
Note
This class cannot create anything; it can only be used for configuration.
Creation Properties



<None>



Properties



<Inherits JComponent properties>


action
Instance
No
Must be an instance of Action.
actionCommand
Quoted String
No

actionListeners
Instance Collection
No
Each element must be an instance of ActionListener.
borderPainted
Boolean
Yes

buttonGroup
Instance
No
The button is added to the instance of ButtonGroup. Should only be set once, or else a button will belong to multiple groups. There is no way to clear this property.
changeListeners
Instance Collection
No
Each element must be an instance of ChangeListener.
contentAreaFilled
Boolean
Yes

disabledIcon
ImageIcon
Yes
May also be set with an instance of Icon.
disabledSelectedIcon
ImageIcon
Yes
May also be set with an instance of Icon.
focusPainted
Boolean
Yes

hAlign
String
Yes
One of "right", "left", "center", "leading", or "trailing".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
hTextPos
String
Yes
One of "right", "left", "center", "leading", or "trailing".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
icon
ImageIcon
Yes
May also be set with an instance of Icon.
iconTextGap
Integer
Yes

itemListeners
Instance
No

margin
Insets
Yes

text
Quoted String
Yes
Must be set before mnemonic, mnemonicIndex.
mnemonic
Character
Yes

mnemonicIndex
Integer
Yes

model
Instance
Yes
Must be an instance of ButtonModel.
multiClickThreshold
Long
No

pressedIcon
ImageIcon
Yes
May also be set with an instance of Icon.
rolloverEnabled
Boolean
Yes

selected
Boolean
Yes
Not appropriate for instances of JButton or JMenuItem. Use pressed instead.
selectedIcon
ImageIcon
Yes
May also be set with an instance of Icon.
ui
Instance
Yes
Must be an instance of ButtonUI.
vAlign
String
Yes
One of "center", "top", or "bottom".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
vTextPos
String
Yes
One of "center", "top", or "bottom".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
pressed
Boolean
Yes
For map consistency only -- used to detect when a JButton or JMenuItem is pushed.

JButton (jbutton)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits AbstractButton properties>


defaultCapable
Boolean
Yes


JCheckBox (jcheckbox)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits AbstractButton properties>


borderPaintedFlat
Boolean
Yes


JRadioButton (jradiobutton)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits AbstractButton properties>



JMenuItem (jmenuitem)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits AbstractButton properties>


menuDragMouseListeners
Instance Collection No

menuKeyListeners
Instance Collection
No

accelerator
KeyStroke
Yes


JMenu (jmenu)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JMenuItem properties>


contents Component Collection No Collection may also contain separators.
delay
Integer
No


JCheckBoxMenuItem (jcheckboxmenuitem)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JMenuItem properties>



JRadioButtonMenuItem (jradiobuttonmenuitem)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JMenuItem properties>



Selectors


JColorChooser (jcolorchooser)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


chooserPanels
Instance Collection
Yes
May also be set with an instance of AbstractColorChooserPanel[], which is what the map consistency listeners uses as the property value.
If set with a component, each element must be an instance of AbstractColorChooserPanel.
color
Color
Yes

selectionModel
Instance
Yes
Must be an instance of ColorSelectionModel.
dragEnabled
Boolean
No

colorChangeListeners
Instance Collection
No
Each element must be an instance of ChangeListener. These listeners are added to the selection model.
If the selection model is not an instance of DefaultColorSelectionModel, existing listeners will not be removed.
previewPanel
Component
Yes
Must be an instance of JComponent.
ui
Instance
Yes
Must be an instance of ColorChooserUI.

JComboBox (jcombobox) Property Type Map Consistency Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


action
Instance
Yes

actionCommand
Quoted String
No

editable
Boolean
Yes

editor
Instance
Yes
Must be an instance of ComboBoxEditor.
keySelectionManager
Instance
No
Must be an instance of KeySelectionManager.
items
Quoted String Collection
Yes
Each item may be any instance of Object. May be set with a instance of Object[].
lightweightPopupEnabled
Boolean
Yes

maxRowCount
Integer
Yes

model
Instance
Yes
Must be an instance of ComboBoxModel.
popupVisible
Boolean
No

prototypeDisplayValue
Quoted String
Yes
May be set with any Object.
renderer
Instance
Yes
Must be an instance of ListCellRenderer.
selectedIndex
Integer
Yes

selectedItem
Quoted String
Yes
May be set with any Object.
actionListeners
Instance Collection
No
Each element must be an instance of ActionListener.
itemListeners
Instance Collection No
Each element must be an instance of ItemListener.
popupMenuListeners
Instance Collection No
Each element must be an instance of PopupMenuListener.

JFileChooser (jfilechooser)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


dialogType
String
Yes
One of "open", "save", or "custom".
May also be set with an Integer wrapping the appropriate JFileChooser.XXX_DIALOG member, which is what the map consistency listener puts as the map value.
approveButtonText
Quoted String
Yes

approveButtonMnemonic
Key Code
Yes

approveButtonTooltip
Quoted String
Yes

controlButtonsAreShown
Boolean
Yes

currentDirectory
Quoted String Yes
May also be set with an instance of File, which is what the map consistency listener puts as the property value.
dialogTitle
Quoted String Yes

dragEnabled
Boolean
No

acceptAllFileFilterUsed
Boolean
Yes

allChoosableFileFilters
Extension File Filter Collection
No
Removes all existing file filters, including the AcceptAll filter, before adding the filters in the collection. Each element of the collection needs only to be an instance of FileFilter. May also be set with an instance of FileFilter[]
choosableFileFilters
Extension File Filter Collection Yes
Resets the file filter list before adding the filters in the collection. Typically, this will not remove the AcceptAll filter.
Each element of the collection needs only to be an instance of FileFilter. May also be set with an instance of FileFilter[], which is what the map consistency listener uses as the property value.
fileFilter
Extension File Filter
Yes
May also be set with any instance of FileFilter.
fileHidingEnabled
Boolean
Yes

fileSelectionMode
String
Yes
One of "filesOnly", "dirsOnly", or "both".
May also be set with an Integer wrapping the appropriate JFileChooser member, which is what the map consistency listener puts as the map value.
fileSystemView
Instance Yes
Must be an instance of FileSystemView.
fileView
Instance
Yes
Must be an instance of FileView.
multiSelectionEnabled
Boolean
Yes

selectedFile
Quoted String Yes
May also be set with an instance of File, which is what the map consistency listener puts as the property value.
selectedFiles
Quoted String Collection
Yes
May also be set with an instance of File[].
If set with a collection, each element may either be a String or a File.
The map consistency listener will put an instance of File[] as the property value.
actionListeners
Instance Collection
No
Each element must be an instance of ActionListener.
accessory
Component
Yes
Must be an instance of JComponent.
ui
Instance
Yes
Must be an instance of FileChooserUI.

ExtensionFileFilter (not a Component)
Property Type
Map Consistency
Note
Creates a FileFilter that only accepts files with names that end with certain extensions.
Creation Properties



<None>



Properties



extensions
Quoted String Collection
No
Can also be set with an instance of String[]. Each element should be a file extension, including the dot, e.g. ".txt".
acceptsDirs
Boolean
No
Set to a true Boolean if the filter should allow directories to be viewed by the file chooser. Defaults to Boolean.TRUE.
description
Quoted String
No
Optional; if omitted, a default description will be generated (in English).

JList (jlist)
Property Type
Map Consistency
Note
Creation Properties


<None>



Properties



<Inherits JComponent properties>


model
Instance
Yes
Must be an instance of ListModel.
listData
Instance Collection
No
May also be set with an instance of Object[].
selectionModel
Instance
Yes
Must be an instance of ListSelectionModel.
listSelectionListeners
Instance Collection
No
Each element must be an instance of ListSelectionListener.
selectedIndex
Integer
Yes

selectedIndices
Integer Collection
Yes
May also be set with an instance of int[], which is what the map consistency listener puts as the property value.
selectionIntervals
Range Collection
Yes

dragEnabled
Boolean
No

cellRenderer
Instance
Yes
Must be an instance of ListCellRenderer.
cellHeight
Integer
Yes
Corresponds to fixedCellHeight property of JList.
cellWidth
Integer
Yes
Corresponds to fixedCellWidth property of JList.
layoutOrientation
String
Yes
One of "hw" (horizontal wrap), "vw" (vertical wrap), or "v" (vertical).
May also be set with an Integer wrapping the appropriate JList.XXX_WRAP member, which is what the map consistency listener puts as the map value.
prototypeCellValue
Instance
Yes

selectionBackground
Color
Yes

selectionForeground
Color
Yes

selectionMode
String
Yes
One of  "multipleInterval", "singleInterval", or "single".
May also be set with an Integer wrapping the appropriate ListSelectionModel.XXX_SELECTION member, which is what the map consistency listener puts as the map value.
visibleRowCount
Integer
Yes

ui
Instance
Yes
Must be an instance of ListUI.

JScrollBar (jscrollbar)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



model
Instance
Yes
Must be an instance of BoundedRangeModel.
max
Integer No

min
Integer No

value
Integer Yes

blockIncrement
Integer Yes

unitIncrement
Integer Yes

visibleAmount
Integer
No

adjustmentListeners
Instance Collection
No
Each element must be an instance of AdjustmentListener.
orientation
String
Yes
Either "h" for horizontal, "v" for vertical.
May also be set with an Integer wrapping  Adjustable.HORIZONTAL or Adjustable.VERTICAL, which is what the map consistency listener puts as the map value.
ui
Instance
Yes
Must be an instance of ScrollBarUI.

JSlider (jslider)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


model
Instance
Yes
Must be instance of BoundedRangeModel.
max
Integer
Yes

min
Integer Yes

extent
Integer No

changeListeners
Instance Collection
No
Each element must be an instance of ChangeListener.
inverted
Boolean Yes

labelTable
Map from Integer to Component
Yes

majorTickSpacing
Integer
Yes

minorTickSpacing
Integer
Yes

orientation
String
Yes
Either "h" for horizontal or "v" for vertical.
May also be set with an Integer wrapping SwingConstants.HORIZONTAL or SwingConstants.VERTICAL, which is what the map consistency listener puts as the map value.
paintLabels
Boolean Yes

paintTicks
Boolean Yes

paintTrack
Boolean Yes

snapToTicks
Boolean
Yes

value
Integer
Yes
Argument map is updated as the user drags the slider.
ui
Instance
Yes
Must be an instance of SliderUI.

JSpinner (jspinner)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


model
Instance
Yes
Must be an instance of SpinnerModel.
value
Instance
Yes

editor
Component
Yes
Must be an instance of JComponent.
changeListeners
Instance Collection
No
Each element must be an instance of ChangeListener.
ui
Instance
Yes
Must be an instance of SpinnerUI.

JTable (jtable)
Property Type
Map Consistency
Note
Creation Properties



rowCount
Integer
No
Optional; creates an empty table with rowCount rows if columnCount is also set.
columnCount
Integer No
Optional; creates an empty table with columnCount columns if rowCount is also set.
Properties



<Inherits JComponent properties>


model
Instance
Yes
Must be an instance of TableModel.
By default, the table is created with
its model set to an instance of FastTableModel, which avoids the synchronization delays associated with DefaultTableModel.
Do not use this property in conjunction with the values property.
values
Instance Vector Vector
Yes
Should be set with an instance of  Vector, with each element also being a Vector representing each row. (For speed, consider using an instance of ListToVectorAdapter) May also be set with an instance of Object[][], but this requires copying.
Setting this property only has an effect if the table model is an instance of DefaultTableModel (which includes instances of FastTableModel).
If the model is not an instance of FastTableModel, setting this property will have the unfortunate effect of setting all column identifiers of the model to null.
The map consistency listener will put an instance of Vector, formatted as above, as the argument map property value if the model changes. Property change listeners must NOT modify this Vector!
tableHeader
JTableHeader
Yes

columnModel
TableColumnModel
Yes

columns
TableColumn Collection
No

columnNames
Instance Vector
Yes *
Can only be set if the table model is an instance of DefaultTableModel.
* Map consistency is only possible if the table model is an instance of FastTableModel.
selectionModel
Instance
Yes
Must be an instance of ListSelectionModel.
autoResizeMode
String
Yes
One of "nextColumn", "subsequent", "last", "all", or "off".
May also be set with an Integer wrapping the appropriate JTable.AUTO_RESIZE_XXX member, which is what the map consistency listener puts as the map value.
cellEditor
Instance
Yes
Must be an instance of TableCellEditor.
cellSelectionEnabled
Boolean
Yes

columnSelectionAllowed
Boolean
Yes

columnSelectionIntervals
Range Collection
Yes
A bit more expensive to use than selectedColumns.
defaultEditors
ClassInstancePair Collection
No
If set more than once, the existing associations between classes and cell editors are not cleared.
defaultRenderers
ClassInstancePair Collection No
If set more than once, the existing associations between classes and cell renderers are not cleared.
dragEnabled
Boolean
No

editingColumn
Integer
No

editingRow
Integer
No

gridColor
Color
Yes

intercellSpacing
Integer
No
Setting this property triggers a change to the rowMargin property.
preferredScrollableViewportSize
Dimension
No

rowHeight
Integer
Yes

rowHeights
RowHeightPair Collection
No
Sets a possibly different height for each row. When set more than once, the original sizes of rows are not restored.
rowMargin
Integer
Yes

rowSelectionAllowed
Boolean
Yes

rowSelectionIntervals
Range Collection
Yes
A bit more expensive to use than selectedRows.
selectedColumn
Integer
Yes

selectedColumns
Integer Collection
Yes

selectedRow
Integer
Yes

selectedRows
Integer Collection Yes

selectionBackground
Color
Yes

selectionForeground
Color
Yes

selectionMode
String
No
One of "multipleInterval", "multiple", or "single".
May also be set with an Integer wrapping the appropriate ListSelectionModel.XXX_SELECTION member, which is what the map consistency listener puts as the map value.
showGrid
Boolean
No
Setting this property triggers changes to both the showHorizontalLines and showVerticalLines properties.
showHorizontalLines
Boolean
Yes

showVerticalLines
Boolean Yes

surrendersFocusOnKeystroke
Boolean No

tableModelListeners
Instance Collection
No
Each element must be an instance of TableModelListener. If this property is set more than once, the existing listeners won't be removed unless the table model is an instance of AbstractTableModel.
listSelectionListeners
Instance Collection
No
Each element must be an instance of ListSelectionListener. If this property is set more than once, the existing listeners won't be removed unless the selection model model is an instance of DefaultListSelectionModel.
columnModelListeners
Instance Collection
No
Each element must be an instance of TableColumnModelListener. If this property is set more than once, the existing listeners won't be removed unless the table column model is an instance of DefaultTableColumnModel.
ui
Instance
Yes
Must be an instance of TableUI.

ClassInstancePair (not a Component)
Property Type
Map Consistency
Note
String syntax:
{
className , instanceString }, where instanceString is a string converted by InstanceConverter.
Example:
{ java.util.Date, { new TableCellRenderer() { ... } } }
Creation Properties



class
Class
No

instance
Instance
No

Properties



<None>




RowHeightPair (not a Component)
Property Type
Map Consistency
Note
String syntax:
{
rowIndexString , heightString }, where both strings are converted by IntegerConverter.
Example:
{ 2, 15 }
Sets the height of the 3rd row to 15.
Creation Properties



row
Integer
No

height
Integer
No

Properties



<None>




TableColumn (tc) (not a Component)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



cellEditor
Instance
Yes
Must be an instance of TableCellEditor.
cellRenderer
Instance Yes
Must be an instance of TableCellRenderer.
headerRenderer
Instance Yes
Must be an instance of TableCellRenderer.
headerValue
Instance Yes

identifier
Instance Yes

maxWidth
Integer
Yes

minWidth
Integer Yes

prefWidth
Integer Yes

width
Integer Yes

resizable
Boolean
Yes

modelIndex
Integer Yes

propertyChangeListeners
Instance Collection
No
Each element must be an instance of PropertyChangeListener.

TableColumnModel (tcm) (not a Component)
By default, creates an instance of DefaultTableColumnModel.
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



columns
TableColumn
Collection
No

columnMargin
Integer
Yes

columnSelectionAllowed
Boolean
No

selectionModel Instance
No
Must be an instance of ListSelectionModel.
columnModelListeners
Instance Collection
No
Each element must be an instance of TableColumnModelListener. If this property is set more than once, the existing listeners won't be removed unless the table column model is an instance of DefaultTableColumnModel.

JTableHeader (tableheader) Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


columnModel
TableColumnModel
Yes
Must be an instance of TableColumnModel.
defaultRenderer
Instance
No
Must be an instance of TableCellRenderer.
reorderingAllowed
Boolean
Yes

resizingAllowed
Boolean
Yes

table
Instance
Yes
Should be set with a reference to an existing JTable.
ui
Instance
Yes
Must be set with an instance of TableHeaderUI.

JTree (jtree)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>


model
Instance
Yes
Must be an instance of TreeModel.
selectionModel
Instance Yes
Must be an instance of TreeSelectionModel.
anchorSelectionPath
TreePath
Yes

leadSelectionPath
TreePath Yes

cellEditor
Instance Yes
Must be an instance of TreeCellEditor.
cellRenderer
Instance Yes
Must be an instance of TreeCellRenderer.
dragEnabled
Boolean
No

editable
Boolean
Yes

expandsSelectedPaths
Boolean
Yes

invokesStopCellEditing
Boolean Yes

largeModel
Boolean Yes

rootVisible
Boolean Yes

rowHeight
Integer Yes

scrollsOnExpand
Boolean Yes

selectionPath
TreePath Yes

selectionPaths
TreePath Collection
Yes
May also be set with an instance of TreePath[], which is what the map consistency listeners uses as the property value.
selectionRow
Integer
Yes

selectionRows
Integer Collection
Yes
May also be set with an instance of int[], which is what the map consistency listeners uses as the property value.
showsRootHandles
Boolean Yes

toggleClickCount
Integer
Yes

visibleRowCount
Integer Yes

treeExpansionListeners
Instance Collection
No
Each element must be an instance of TreeExpansionListener.
treeSelectionListeners
Instance Collection
No
Each element must be an instance of TreeSelectionListener.
treeWillExpandListeners
Instance Collection No
Each element must be an instance of TreeWillExpandListener.
ui
Instance Yes
Must be an instance of TreeUI.

TreePath (not a Component)
Has same syntax as an Instance Collection.

Text


JTextComponent (jtextcomponent
Property Type
Map Consistency
Note
This class cannot create anything; it can only be used for configuration.
Creation Properties


<None>


Properties


<Inherits JComponent properties>


document
Instance
Yes
Must be an instance of Document.
text
Quoted String
Yes

caret
Instance
Yes
Must be an instance of Caret.
caretColor
Color
Yes

caretListeners
Instance Collection
No
Each element must be an instance of CaretListener.
caretPosition
Integer
Yes

disabledTextColor
Color
Yes

dragEnabled
Boolean
No

editable
Boolean
Yes

focusAccelerator
Character
Yes

highlighter
Instance
Yes
Must be an instance of Highlighter.
keymap
Instance
Yes
Must be an instance of KeyMap.
margin
Insets
Yes

navigationFilter
Instance
No
Must be an instance of NavigationFilter.
selectAll
Boolean
No

selection
Range
Yes
May be set to com.taco.data.MapUtilities.NULL_MAP_VALUE to clear the selection.
selectedTextColor
Color
Yes

selectionColor
Color
Yes

documentListeners
Instance Collection
No
Each element must be an instance of DocumentListener.
Adds the listeners to the current document of the component.
Only removes existing listeners if the document is an instance of AbstractDocument.
ui
Instance
Yes
Must be an instance of TextUI.

JTextField (jtextfield)
Property Value
Map Consistency
Note
Creation Properties


<None>



Properties



<Inherits JTextComponent properties>


action
Instance
Yes
Must be an instance of Action.
actionCommand
Quoted String
No

actionListeners
Instance Collection
No
Each element must be an instance of ActionListener.
columns
Integer
No

hAlign
String
Yes
One of "right", "left", "center", "leading", or "trailing".
May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
scrollOffset
Integer
No

enteredText
Quoted String
Yes
Similar to text, but the map consistency listener is triggered only when the user indicates that the text is acceptable, such as by hitting the ENTER key.

JFormattedTextField (jformattedtextfield)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JTextField properties>


focusLostBehavior
String
No
One of "commit", "commitOrRevert", "revert" or "persist".
May also be set with an Integer wrapping the appropriate JFormattedTextField member, which is what the map consistency listener puts as the map value.
formatterFactory
Instance
Yes
Must be an instance of JFormattedTextField.AbstractFormatterFactory.
value
Instance
Yes


JPasswordField (jpasswordfield)
Property Type
Map Consistency
Note
Creation Properties


<None>


Properties


<Inherits JTextField properties>



echoChar
Character
No


JTextArea (jtextarea)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JTextComponent properties>


lineWrap
Boolean
Yes

rows
Integer
No

columns
Integer
No

tabSize
Integer
Yes

wrapStyleWord
Boolean
Yes


JEditorPane (jeditorpane)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JTextComponent properties>


contentType
Quoted String
No

editorKit
Instance
Yes
Must be an instance of EditorKit.
page
Quoted String
Yes
May also be set with an instance of URL, which is what the map consistency listener puts as the map value.

JTextPane (jtextpane)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JEditorPane properties>

Use the document property instead of styledDocument.

Space Fillers

Glue (glue)
Property Type
Map Consistency
Note
Creation Properties



orientation
String
No
Either "h" for horizontal or "v" for vertical; defaults to horizontal.
Properties



<Inherits JComponent properties>



Strut (strut)
Property Type
Map Consistency
Note
Creation Properties



orientation
String
No
Either "h" for horizontal or "v" for vertical;
if omitted, defaults to horizontal.
length
Integer
No
The width for a horizontal strut, the height for a vertical strut. If omitted, defaults to 10.
Properties



<Inherits JComponent properties>



Rigid Area (rigidarea)
Property Type
Map Consistency
Note
Creation Properties



size
Dimension
No
Required
Properties



<Inherits JComponent properties>



Filler (filler)
Property Type
Map Consistency
Note
Creation Properties



minSize
Dimension
No
Defaults to {width = 0, height = 0} if omitted.
prefSize
Dimension No
Defaults to {width = 20, height = 20} if omitted.
maxSize
Dimension No
Defaults to {width = 100, height = 100} if omitted.
Properties



<Inherits JComponent properties>



Separator (sep) (not a Component, but installed in DispatchingComponentConverter)
Property Type Map Consistency Note
Creation Properties


size
Dimension
No
Optional; omit to get a default separator for menus and toolbars.
Properties


<None>




JSeparator (jseparator)
Property Type
Map Consistency
Note
Creation Properties



<None>



Properties



<Inherits JComponent properties>



orientation
String
Yes
Either of "h", for horizontal, or "v", for vertical. May also be set with an Integer wrapping the appropriate SwingConstant member, which is what the map consistency listener puts as the map value.
ui
Instance
Yes
Must be an instance of SeparatorUI.