javax.swing.plaf.synth

Class Region


public class Region
extends Object

A distinct rendering area of a Swing component. A component may support one or more regions. Specific component regions are defined by the typesafe enumeration in this class.

Regions are typically used as a way to identify the Components and areas a particular style is to apply to. Synth's file format allows you to bind styles based on the name of a Region. The name is derived from the field name of the constant:

  1. Map all characters to lowercase.
  2. Map the first character to uppercase.
  3. Map the first character after underscores to uppercase.
  4. Remove all underscores.
For example, to identify the SPLIT_PANE Region you would use SplitPane. The following shows a custom SynthStyleFactory that returns a specific style for split panes:
    public SynthStyle getStyle(JComponent c, Region id) {
        if (id == Region.SPLIT_PANE) {
            return splitPaneStyle;
        }
        ...
    }
 
The following xml accomplishes the same thing:
 <style id="splitPaneStyle">
   ...
 </style>
 <bind style="splitPaneStyle" type="region" key="SplitPane"/>
 
Since:
1.5

Field Summary

static Region
ARROW_BUTTON
ArrowButton's are special types of buttons that also render a directional indicator, typically an arrow.
static Region
BUTTON
Button region.
static Region
CHECK_BOX
CheckBox region.
static Region
CHECK_BOX_MENU_ITEM
CheckBoxMenuItem region.
static Region
COLOR_CHOOSER
ColorChooser region.
static Region
COMBO_BOX
ComboBox region.
static Region
DESKTOP_ICON
DesktopIcon region.
static Region
DESKTOP_PANE
DesktopPane region.
static Region
EDITOR_PANE
EditorPane region.
static Region
FILE_CHOOSER
FileChooser region.
static Region
FORMATTED_TEXT_FIELD
FormattedTextField region.
static Region
INTERNAL_FRAME
InternalFrame region.
static Region
INTERNAL_FRAME_TITLE_PANE
TitlePane of an InternalFrame.
static Region
LABEL
Label region.
static Region
LIST
List region.
static Region
MENU
Menu region.
static Region
MENU_BAR
MenuBar region.
static Region
MENU_ITEM
MenuItem region.
static Region
MENU_ITEM_ACCELERATOR
Accelerator region of a MenuItem.
static Region
OPTION_PANE
OptionPane region.
static Region
PANEL
Panel region.
static Region
PASSWORD_FIELD
PasswordField region.
static Region
POPUP_MENU
PopupMenu region.
static Region
POPUP_MENU_SEPARATOR
PopupMenuSeparator region.
static Region
PROGRESS_BAR
ProgressBar region.
static Region
RADIO_BUTTON
RadioButton region.
static Region
RADIO_BUTTON_MENU_ITEM
RegionButtonMenuItem region.
static Region
ROOT_PANE
RootPane region.
static Region
SCROLL_BAR
ScrollBar region.
static Region
SCROLL_BAR_THUMB
Thumb of the ScrollBar.
static Region
SCROLL_BAR_TRACK
Track of the ScrollBar.
static Region
SCROLL_PANE
ScrollPane region.
static Region
SEPARATOR
Separator region.
static Region
SLIDER
Slider region.
static Region
SLIDER_THUMB
Thumb of the Slider.
static Region
SLIDER_TRACK
Track of the Slider.
static Region
SPINNER
Spinner region.
static Region
SPLIT_PANE
SplitPane region.
static Region
SPLIT_PANE_DIVIDER
Divider of the SplitPane.
static Region
TABBED_PANE
TabbedPane region.
static Region
TABBED_PANE_CONTENT
Region of a TabbedPane containing the content.
static Region
TABBED_PANE_TAB
Region of a TabbedPane for one tab.
static Region
TABBED_PANE_TAB_AREA
Region of a TabbedPane containing the tabs.
static Region
TABLE
Table region.
static Region
TABLE_HEADER
TableHeader region.
static Region
TEXT_AREA
TextArea region.
static Region
TEXT_FIELD
TextField region.
static Region
TEXT_PANE
TextPane region.
static Region
TOGGLE_BUTTON
ToggleButton region.
static Region
TOOL_BAR
ToolBar region.
static Region
TOOL_BAR_CONTENT
Region of the ToolBar containing the content.
static Region
TOOL_BAR_DRAG_WINDOW
Region for the Window containing the ToolBar.
static Region
TOOL_BAR_SEPARATOR
ToolBar separator region.
static Region
TOOL_TIP
ToolTip region.
static Region
TREE
Tree region.
static Region
TREE_CELL
Region of the Tree for one cell.
static Region
VIEWPORT
Viewport region.

Constructor Summary

Region(String name, String ui, boolean subregion)
Creates a Region with the specified name.

Method Summary

String
getName()
Returns the name of the region.
boolean
isSubregion()
Returns true if the Region is a subregion of a Component, otherwise false.
String
toString()
Returns the name of the Region.

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ARROW_BUTTON

public static final Region ARROW_BUTTON
ArrowButton's are special types of buttons that also render a directional indicator, typically an arrow. ArrowButtons are used by composite components, for example ScrollBar's contain ArrowButtons. To bind a style to this Region use the name ArrowButton.

BUTTON

public static final Region BUTTON
Button region. To bind a style to this Region use the name Button.

CHECK_BOX

public static final Region CHECK_BOX
CheckBox region. To bind a style to this Region use the name CheckBox.

CHECK_BOX_MENU_ITEM

public static final Region CHECK_BOX_MENU_ITEM
CheckBoxMenuItem region. To bind a style to this Region use the name CheckBoxMenuItem.

COLOR_CHOOSER

public static final Region COLOR_CHOOSER
ColorChooser region. To bind a style to this Region use the name ColorChooser.

COMBO_BOX

public static final Region COMBO_BOX
ComboBox region. To bind a style to this Region use the name ComboBox.

DESKTOP_ICON

public static final Region DESKTOP_ICON
DesktopIcon region. To bind a style to this Region use the name DesktopIcon.

DESKTOP_PANE

public static final Region DESKTOP_PANE
DesktopPane region. To bind a style to this Region use the name DesktopPane.

EDITOR_PANE

public static final Region EDITOR_PANE
EditorPane region. To bind a style to this Region use the name EditorPane.

FILE_CHOOSER

public static final Region FILE_CHOOSER
FileChooser region. To bind a style to this Region use the name FileChooser.

FORMATTED_TEXT_FIELD

public static final Region FORMATTED_TEXT_FIELD
FormattedTextField region. To bind a style to this Region use the name FormattedTextField.

INTERNAL_FRAME

public static final Region INTERNAL_FRAME
InternalFrame region. To bind a style to this Region use the name InternalFrame.

INTERNAL_FRAME_TITLE_PANE

public static final Region INTERNAL_FRAME_TITLE_PANE
TitlePane of an InternalFrame. The TitlePane typically shows a menu, title, widgets to manipulate the internal frame. To bind a style to this Region use the name InternalFrameTitlePane.

LABEL

public static final Region LABEL
Label region. To bind a style to this Region use the name Label.

LIST

public static final Region LIST
List region. To bind a style to this Region use the name List.

MENU

public static final Region MENU
Menu region. To bind a style to this Region use the name Menu.

MENU_BAR

public static final Region MENU_BAR
MenuBar region. To bind a style to this Region use the name MenuBar.

MENU_ITEM

public static final Region MENU_ITEM
MenuItem region. To bind a style to this Region use the name MenuItem.

MENU_ITEM_ACCELERATOR

public static final Region MENU_ITEM_ACCELERATOR
Accelerator region of a MenuItem. To bind a style to this Region use the name MenuItemAccelerator.

OPTION_PANE

public static final Region OPTION_PANE
OptionPane region. To bind a style to this Region use the name OptionPane.

PANEL

public static final Region PANEL
Panel region. To bind a style to this Region use the name Panel.

PASSWORD_FIELD

public static final Region PASSWORD_FIELD
PasswordField region. To bind a style to this Region use the name PasswordField.

POPUP_MENU

public static final Region POPUP_MENU
PopupMenu region. To bind a style to this Region use the name PopupMenu.

POPUP_MENU_SEPARATOR

public static final Region POPUP_MENU_SEPARATOR
PopupMenuSeparator region. To bind a style to this Region use the name PopupMenuSeparator.

PROGRESS_BAR

public static final Region PROGRESS_BAR
ProgressBar region. To bind a style to this Region use the name ProgressBar.

RADIO_BUTTON

public static final Region RADIO_BUTTON
RadioButton region. To bind a style to this Region use the name RadioButton.

RADIO_BUTTON_MENU_ITEM

public static final Region RADIO_BUTTON_MENU_ITEM
RegionButtonMenuItem region. To bind a style to this Region use the name RadioButtonMenuItem.

ROOT_PANE

public static final Region ROOT_PANE
RootPane region. To bind a style to this Region use the name RootPane.

SCROLL_BAR

public static final Region SCROLL_BAR
ScrollBar region. To bind a style to this Region use the name ScrollBar.

SCROLL_BAR_THUMB

public static final Region SCROLL_BAR_THUMB
Thumb of the ScrollBar. The thumb is the region of the ScrollBar that gives a graphical depiction of what percentage of the View is currently visible. To bind a style to this Region use the name ScrollBarThumb.

SCROLL_BAR_TRACK

public static final Region SCROLL_BAR_TRACK
Track of the ScrollBar. To bind a style to this Region use the name ScrollBarTrack.

SCROLL_PANE

public static final Region SCROLL_PANE
ScrollPane region. To bind a style to this Region use the name ScrollPane.

SEPARATOR

public static final Region SEPARATOR
Separator region. To bind a style to this Region use the name Separator.

SLIDER

public static final Region SLIDER
Slider region. To bind a style to this Region use the name Slider.

SLIDER_THUMB

public static final Region SLIDER_THUMB
Thumb of the Slider. The thumb of the Slider identifies the current value. To bind a style to this Region use the name SliderThumb.

SLIDER_TRACK

public static final Region SLIDER_TRACK
Track of the Slider. To bind a style to this Region use the name SliderTrack.

SPINNER

public static final Region SPINNER
Spinner region. To bind a style to this Region use the name Spinner.

SPLIT_PANE

public static final Region SPLIT_PANE
SplitPane region. To bind a style to this Region use the name SplitPane.

SPLIT_PANE_DIVIDER

public static final Region SPLIT_PANE_DIVIDER
Divider of the SplitPane. To bind a style to this Region use the name SplitPaneDivider.

TABBED_PANE

public static final Region TABBED_PANE
TabbedPane region. To bind a style to this Region use the name TabbedPane.

TABBED_PANE_CONTENT

public static final Region TABBED_PANE_CONTENT
Region of a TabbedPane containing the content. To bind a style to this Region use the name TabbedPaneContent.

TABBED_PANE_TAB

public static final Region TABBED_PANE_TAB
Region of a TabbedPane for one tab. To bind a style to this Region use the name TabbedPaneTab.

TABBED_PANE_TAB_AREA

public static final Region TABBED_PANE_TAB_AREA
Region of a TabbedPane containing the tabs. To bind a style to this Region use the name TabbedPaneTabArea.

TABLE

public static final Region TABLE
Table region. To bind a style to this Region use the name Table.

TABLE_HEADER

public static final Region TABLE_HEADER
TableHeader region. To bind a style to this Region use the name TableHeader.

TEXT_AREA

public static final Region TEXT_AREA
TextArea region. To bind a style to this Region use the name TextArea.

TEXT_FIELD

public static final Region TEXT_FIELD
TextField region. To bind a style to this Region use the name TextField.

TEXT_PANE

public static final Region TEXT_PANE
TextPane region. To bind a style to this Region use the name TextPane.

TOGGLE_BUTTON

public static final Region TOGGLE_BUTTON
ToggleButton region. To bind a style to this Region use the name ToggleButton.

TOOL_BAR

public static final Region TOOL_BAR
ToolBar region. To bind a style to this Region use the name ToolBar.

TOOL_BAR_CONTENT

public static final Region TOOL_BAR_CONTENT
Region of the ToolBar containing the content. To bind a style to this Region use the name ToolBarContent.

TOOL_BAR_DRAG_WINDOW

public static final Region TOOL_BAR_DRAG_WINDOW
Region for the Window containing the ToolBar. To bind a style to this Region use the name ToolBarDragWindow.

TOOL_BAR_SEPARATOR

public static final Region TOOL_BAR_SEPARATOR
ToolBar separator region. To bind a style to this Region use the name ToolBarSeparator.

TOOL_TIP

public static final Region TOOL_TIP
ToolTip region. To bind a style to this Region use the name ToolTip.

TREE

public static final Region TREE
Tree region. To bind a style to this Region use the name Tree.

TREE_CELL

public static final Region TREE_CELL
Region of the Tree for one cell. To bind a style to this Region use the name TreeCell.

VIEWPORT

public static final Region VIEWPORT
Viewport region. To bind a style to this Region use the name Viewport.

Constructor Details

Region

protected Region(String name,
                 String ui,
                 boolean subregion)
Creates a Region with the specified name. This should only be used if you are creating your own JComponent subclass with a custom ComponentUI class.
Parameters:
name - Name of the region
ui - String that will be returned from component.getUIClassID. This will be null if this is a subregion.
subregion - Whether or not this is a subregion.

Method Details

getName

public String getName()
Returns the name of the region.
Returns:
name of the Region.

isSubregion

public boolean isSubregion()
Returns true if the Region is a subregion of a Component, otherwise false. For example, Region.BUTTON corresponds do a Component so that Region.BUTTON.isSubregion() returns false.
Returns:
true if the Region is a subregion of a Component.

toString

public String toString()
Returns the name of the Region.
Overrides:
toString in interface Object
Returns:
name of the Region.