コンポーネント固有のプロパティ
SynthのLookおよびある程度のFeelを、コンポーネント固有のプロパティによりカスタマイズできます。 これらのプロパティにはSynthStyle#getからアクセスします。 これらのプロパティをSynth構成ファイルで指定する方法などについては、Synthのファイル形式を参照してください。
このファイルは、各値が取るべき予想されるクラス型を指定します。 不正な型を指定した場合の動作は指定されていません。通常はClassCastExceptionがスローされますが、実装に固有なものとなります。
ArrowButtonは、矢印を描画するJButtonの特殊な型です。 通常はArrowButtonは直接作成されず、一部のComponentがArrowButtonを作成して矢印付きのボタンを描画します。 ArrowButtonを使用するコンポーネントはJComboBox、JScrollBar、およびJSplitPane (ディバイダのボタン用)です。 Buttonプロパティに加えてArrowButtonは次のプロパティをサポートしています。
ArrowButton固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| ArrowButton.size |
整数 |
16 |
矢印ボタンの適切なサイズ。 |
JButtonはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJButtonは次のプロパティをサポートしています。
JButton固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| Button.defaultButtonFollowsFocus |
Boolean |
true |
デフォルトのJButtonが、フォーカスを取得しているボタンに変わるかどうか。 |
JCheckBoxはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJCheckBoxは次のプロパティをサポートしています。
JCheckBox固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| CheckBox.icon |
アイコン |
null |
チェックを描画するために使用するアイコン。 |
JComboBoxは、次の子Componentで構成される複合コンポーネントです。
JComboBoxの子コンポーネント
| 名前 |
タイプ |
説明 |
| ComboBox.arrowButton |
SynthArrowButton |
ドロップ・ダウン・インジケータを描画します。 |
| ComboBox.list |
JList |
値を描画するために使用するJList。 |
| ComboBox.listRenderer |
コンポーネント |
JComboBoxのJListに使用されるレンダラ。 |
| ComboBox.popup |
JPopupMenu |
JComboBoxのComboBox.listの表示に使用されるJPopupMenu。 |
| ComboBox.renderer |
コンポーネント |
JComboBoxに使用されるレンダラ。 これは、レンダラがUIResourceである場合のみ設定されます。 |
| ComboBox.scrollPane |
JScrollPane |
JListを含むJScrollPane。 |
| ComboBox.textField |
JTextField |
エディタ。 |
JComboBox固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| ComboBox.showPopupOnNavigation |
Boolean |
false |
キーボードを使用してナビゲート中にJPopupMenuを表示するべきかどうか。 |
JFileChooser
JFileChooser固有のプロパティ
| プロパティ |
予想される型
|
デフォルト値
|
説明 |
| FileChooser.cancelIcon
|
アイコン
|
null
|
ファイル・チューザの取消しボタンに表示するアイコン。
|
| FileChooser.okIcon
|
アイコン
|
null
|
ファイル・チューザのOKボタンに表示するアイコン。
|
| FileView.directoryIcon
|
アイコン
|
null
|
ディレクトリに使用するアイコン。
|
| FileView.fileIcon
|
アイコン
|
null
|
ファイルに使用するアイコン。
|
| FileView.computerIcon
|
アイコン
|
null
|
コンピュータを表すディレクトリに使用するアイコン。 すべてのプラットフォームがこのアイコンを使用するわけではありません。
|
| FileView.hardDriveIcon
|
アイコン
|
null
|
ハード・ドライブのルートを表すために使用するアイコン。 たとえば、Windows上ではCドライブを表示するときに使用されます。
|
| FileView.floppyDriveIcon
|
アイコン
|
null
|
フロッピー・ディスクを表すために使用するアイコン。
|
| FileChooser.newFolderIcon
|
アイコン
|
null
|
新しいフォルダを作成するボタンが使用するアイコン。
|
| FileChooser.upFolderIcon
|
アイコン
|
null
|
親フォルダにナビゲートするボタンが使用するアイコン。
|
| FileChooser.homeFolderIcon
|
アイコン
|
null
|
現在のユーザーのホーム・ディレクトリにナビゲートするボタンが使用するアイコン。
|
| FileChooser.detailsViewIcon
|
アイコン
|
null
|
詳細ファイル・リスト表示を切り替えるボタンが使用するアイコン。
|
| FileChooser.listViewIcon
|
アイコン
|
null
|
各ファイルとディレクトリのアイコンと名前のみを表示する通常ファイル・リスト表示を切り替えるボタンが使用するアイコン。
|
| FileChooser.viewMenuIcon
|
アイコン
|
null
|
表示モードの選択用のポップアップ・メニューを表示するボタンが使用するアイコン。
|
JInternalFrame
JInternalFrame固有のプロパティ
| プロパティ
|
予想される型
|
DefaultValue
|
説明
|
| InternalFrame.icon
|
アイコン |
null
|
内部フレームのシステム・アイコンを表すために描画されるアイコン。 押すとシステム・メニューが表示されます。
|
JInternalFrameTitlePane
JInternalFrameTitlePaneは、フレーム内に存在する制御バーに類似した、内部フレームの最上部に位置する制御バーです。
JInternalFrameTitlePane固有のプロパティ
| プロパティ
|
予想される型
|
デフォルト値
|
説明
|
| InternalFrameTitlePane.maximizeIcon
|
アイコン |
null
|
内部フレームを最大化する機能を示すために描画されるアイコン。
|
| InternalFrameTitlePane.minimizeIcon
|
アイコン |
null
|
内部フレームを以前の状態に復元する機能を示すために描画されるアイコン。
|
| InternalFrameTitlePane.iconifyIcon
|
アイコン |
null
|
内部フレームを最小化する機能を示すために描画されるアイコン。
|
| InternalFrameTitlePane.closeIcon
|
アイコン |
null
|
内部フレームを閉じる機能を示すために描画されるアイコン。
|
| InternalFrameTitlePane.titleSpacing
|
整数 |
2 |
タイトル・ペインのボタンとタイトルの間のスペース。
|
| InternalFrameTitlePane.buttonSpacing
|
整数 |
2 |
タイトル・ペインのボタン間のスペース。
|
| InternalFrameTitlePane.maxFrameIconSize
|
ディメンション |
16x16 |
タイトル・ペインに描画されるフレーム・アイコンの最大サイズ。 アイコンがこのサイズより大きい場合は縮小されます。
|
| InternalFrameTitlePane.titleAlignment
|
leading|trailing|center |
leading |
タイトルの配置方法。 コンポーネント方向が左から右の場合はleadingが左でtrailingが右です。 コンポーネント方向が右から左の場合はleadingが右でtrailingが左です。
|
JListはレンダラの名前をList.rendererに設定します。 JListは次のプロパティをサポートしています。
JList固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| List.rendererUseListColors |
Boolean |
true |
trueの場合、レンダラの状態は更新されず、テキストの色はJListのgetSelectionBackgroundおよびgetSelectionForegroundメソッドから取得されます。 falseの場合、レンダラの状態が更新され、色は代わりにStyleから取得されます。 |
| List.rendererUseUIBorder |
Boolean |
true |
trueの場合、渡されたボーダーに関係なくレンダラのsetBorderは成功します。それ以外の場合は、レンダラのsetBorderはSynth Borderの場合にのみ成功します。 |
| List.cellHeight |
整数 |
-1 |
JListのセルの高さ。 -1の場合、setFixedCellHeightは呼び出されません。 |
すべてのMenuクラス(JCheckBoxMenuItem、JMenu、JMenuItem、およびJRadioButtonMenuItem)は、同じプロパティ・セットをサポートして同様に動作します。 各コンポーネントは、2つのRegion (コンポーネントに固有のRegionとRegion.MENU_ITEM_ACCELERATOR)で構成されます。 MENU_ITEM_ACCELERATORはアクセラレータのペイントに使用されます。 両方のRegionはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 次のプロパティ・セットがサポートされています。
メニュー・クラス共通プロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| prefix.acceleratorDelimiter |
文字列 |
+ |
修飾子の説明とキーの間の文字セパレータ(たとえば、Ctrl <acceleratorDelimiter> X)。
|
| prefix.arrowIcon |
アイコン |
null |
テキストの右側に描画されるアイコン(またはComponentOrientationが右から左の場合はテキストの左側)。 これは通常、JMenuに対してのみ定義されます。 |
| prefix.checkIcon |
アイコン |
null |
テキストの左側に描画されるアイコン(またはComponentOrientationが右から左の場合はテキストの右側)。 これは通常、JCheckBoxMenuItemおよびJRadioButtonMenuItemに対してのみ定義され、チェック・ボタンまたはラジオ・ボタンを提供します。 |
| prefix.margin |
Insets |
空のInsets (0, 0, 0, 0) |
JMenuItemのマージン。 マージンの使用方法の詳細についてはjavax.swing.AbstractButton#setMargin(java.awt.Insets)のjavadocを参照してください。 |
| prefix.textIconGap |
整数 |
4 |
アイコンとテキストの間のパディング。 この使用方法の詳細についてはjavax.swing.AbstractButton#setIconTextGap(int)のjavadocを参照してください。 |
PrefixはCheckBoxMenuItem、Menu、MenuItem、またはRadioButtonMenuItemのいずれかです。
JMenuは次のプロパティもサポートしています。
JMenu固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| Menu.delay |
整数 |
200 |
メニューを表示するまでの遅延を設定します。 |
| Menu.shortcutKeys |
int[] |
KeyEvent.ALT_MASK |
ショートカット・キーに使用するKeyEvent修飾子の配列。 |
JOptionPaneは複合コンポーネントであり、多数の子コンポーネントで構成される場合があります。子コンポーネントはOptionPane.button、OptionPane.label、OptionPane.comboBox、OptionPane.scrollPane、OptionPane.list、OptionPane.textField、OptionPane.iconLabelです。
JOptionPane固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| OptionPane.buttonAreaBorder |
Border |
null |
ボタン領域の周囲のボーダー。 |
| OptionPane.buttonClickThreshhold |
整数 |
0 |
作成されたボタンのsetMultiClickThreshholdに渡されます。 |
| OptionPane.buttonOrientation |
整数 |
SwingConstants.CENTER |
ボタンのレイアウト方法(SwingConstants.LEFT、SwingConstants.RIGHTまたはSwingConstants.CENTER (右から左のロケールの場合、これは反転されます)のいずれか)。 |
| OptionPane.buttonPadding |
整数 |
6 |
ボタン間のスペースの量。 |
| OptionPane.cancelIcon |
アイコン |
null |
取消しボタンのアイコン。 |
| OptionPane.errorIcon |
アイコン |
null |
ERROR_MESSAGEに使用するアイコン。 |
| OptionPane.informationIcon |
アイコン |
null |
INFORMATION_MESSAGEに使用するアイコン。 |
| OptionPane.isYesLast |
Boolean |
false |
trueの場合、「はい」ボタンがその他のボタンの前に配置され、それ以外の場合はその他のボタンの後に配置されます。 |
| OptionPane.questionIcon |
アイコン |
null |
エラーQUESTION_MESSAGEに使用するアイコン。 |
| OptionPane.minimumSize |
ディメンション |
262x90 |
JOptionPaneの最小サイズ。 |
| OptionPane.noIcon |
アイコン |
null |
「いいえ」ボタンのアイコン。 |
| OptionPane.okIcon |
アイコン |
null |
「OK」ボタンのアイコン。 |
| OptionPane.sameSizeButtons |
Boolean |
true |
すべてのボタンを同じサイズにするべきかどうか。 |
| OptionPane.separatorPadding |
整数 |
6 |
メッセージ領域とセパレータの間のパディング量。 |
| OptionPane.yesIcon |
アイコン |
null |
「はい」ボタンのアイコン。 |
| OptionPane.warningIcon |
アイコン |
null |
エラーWARNING_MESSAGEに使用するアイコン |
JProgressBar
JProgressBar固有のプロパティ
| プロパティ |
予想される型
|
デフォルト値
|
説明 |
| ProgressBar.repaintInterval
|
整数
|
50
|
不確定進捗バーを再ペイントする間隔のミリ秒数。
|
| ProgressBar.cycleTime
|
整数
|
3000
|
進捗バーが不確定のときに、1フレームあたりのバウンシングボックスの移動距離を決定するために使用するミリ秒数。
|
JRadioButtonはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJRadioButtonは次のプロパティをサポートしています。
JRadioButton固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| RadioButton.icon |
アイコン |
null |
ラジオ・インジケータを描画するために使用するアイコン。 |
JScrollBarは、次の子Componentで構成される複合コンポーネントです。
JScrollBarの子コンポーネント
| 名前 |
タイプ |
説明 |
| ScrollBar.button |
SynthArrowButton |
増分ボタンと減分ボタンを識別します。 |
JScrollBar固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| ScrollBar.allowsAbsolutePositioning |
Boolean |
false |
trueの場合、トラック内でマウスを中クリックすると、トラックの位置がマウスの位置に設定されます。 |
| ScrollBar.maximumThumbSize |
ディメンション |
4096x4096 |
サムの最大サイズ。 |
| ScrollBar.minimumThumbSize |
ディメンション |
ScrollBar.thumbHeightから派生されます |
サムの最小サイズ。 これを指定しない場合、サムの最小サイズは、スクロール・バーの反対軸の方向ではScrollBar.thumbHeightにスクロール・バーのイン・セットを加えた値、もう一方の軸の方向では7です。 たとえば、スクロール・バーのInsetsを指定しておらず、スクロール・バーの方向が垂直の場合、最小のサム・サイズの幅はScrollBar.thumbHeightで、高さは7です。 |
| ScrollBar.squareButtons |
Boolean |
false |
trueの場合、スクロールバー・ボタンの幅と高さは等しくなります。 |
| ScrollBar.thumbHeight |
整数 |
14 |
スクロール・バーの方向が水平の場合は適切な高さ、またはスクロール・バーの方向が垂直の場合は適切な幅。 |
すべてのセパレータ・クラス(JSeparator、JPopupMenu.Separator、およびJToolBar.Separator)は同じプロパティを使用します。
セパレータ・クラスの共通プロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| Separator.thickness |
整数 |
2 |
垂直方向に整列したセパレータの場合は適切な幅、または水平方向に整列したセパレータの場合は適切な高さ。 結果として得られる適切なサイズにはInsetsが含まれます。 |
また、JToolBar.Separatorは次のプロパティもサポートします。
JToolBar.Separatorの特定のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| ToolBar.separatorSize |
ディメンション |
null |
この値はjavax.swing.JToolBar$Separator#setSeparatorSize(java.awt.Dimension)メソッドに渡されます。 指定しない場合、setSeparatorSizeは呼び出されません。
|
JScrollPaneは、JViewportの周囲にBorderを設定するメソッドを提供するという点で特殊です(JViewportのsetBorderからはIllegalArgumentExceptionがスローされます)。 これに対応するため、キーScrollPane.viewportBorderInsetsのインセットを使用する特別なボーダーが、JScrollPaneにインストールされています。 SynthPainterのメソッドpaintViewportBorderは、ビュー・ポートのボーダーをペイントするために呼び出されます。
JScrollPane固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| ScrollPane.viewportBorderInsets |
Insets |
null |
ビュー・ポートBorderのInsets。 |
JSplitPaneは1つのディバイダ、およびsetOneTouchExpandable(true)が呼び出された場合には2つのボタンを含む複合コンポーネントです。 この2つのボタンの名前はSplitPaneDivider.leftOneTouchButtonとSplitPaneDivider.rightOneTouchButtonです。
JSplitPane固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| SplitPane.centerOneTouchButtons |
Boolean |
true |
trueの場合は、ワン・タッチ・ボタンがディバイダの中央に配置されます。 |
| SplitPane.oneTouchButtonOffset |
整数 |
2 |
ワン・タッチ・ボタン間の距離。 |
| SplitPane.oneTouchButtonSize |
整数 |
6 |
ワンタッチ・ボタンの作成サイズ。 |
| SplitPane.oneTouchExpandable |
Boolean |
null |
nullでない場合、この値はsetOneTouchExpandableに渡されます。 |
| SplitPane.size |
整数 |
6 |
ディバイダのサイズ |
JSlider
JSlider固有のプロパティ
| プロパティ
|
予想される型
|
デフォルト値
|
説明
|
| Slider.thumbWidth
|
整数
|
30
|
スライダのサムの幅
|
| Slider.thumbHeight
|
整数
|
14
|
スライダのサムの高さ
|
| Slider.trackBorder
|
整数
|
1
|
トラックのボーダーの幅
|
| Slider.paintValue
|
Boolean
|
true
|
スライダの現在の値をペイントするかどうか。
|
JTabbedPane
JTabbedPane固有のプロパティ
| プロパティ |
予想される型
|
デフォルト値
|
説明 |
| TabbedPane.tabRunOverlay
|
整数
|
0
|
行が複数存在する場合にタブをオーバーラップするピクセルの数。
|
| TabbedPane.textIconGap
|
整数
|
0
|
タブのアイコンとテキストの間に追加されるパディング。 テキストやアイコンがない場合、この値は使用されません。
|
| TabbedPane.selectedTabPadInsets
|
Insets
|
空のInsets (0, 0, 0, 0)
|
選択したタブに追加される追加イン・セット。
|
| TabbedPane.selectionFollowsFocus
|
Boolean
|
true
|
trueの場合、ユーザーがマウスでタブをナビゲートすると、タブ・ペインの選択が変わります。
|
JTableはレンダラの名前をTable.cellRendererに設定します。 JTableは次のプロパティをサポートします。
JTable固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| Table.gridColor |
色 |
null |
グリッドに使用する色。 nullの場合、スタイルの前景色が使用されます。 |
| Table.rendererUseTableColors |
Boolean |
true |
trueの場合、レンダラの状態は更新されず、テキストの色はJTableのgetSelectionBackgroundおよびgetSelectionForegroundメソッドから取得されます。 falseの場合、レンダラの状態が更新され、色は代わりにStyleから取得されます。 |
| Table.rendererUseUIBorder |
Boolean |
true |
trueの場合、渡されたボーダーに関係なくレンダラのsetBorderは成功します。それ以外の場合は、レンダラのsetBorderはSynth Borderの場合にのみ成功します。 |
| Table.rowHeight |
整数 |
-1 |
-1ではない場合、JTable上でsetRowHeightが呼び出されます。 |
JTreeはレンダラの名前をTree.rendererに設定し、エディタの名前はTree.cellEditorになります。
JTree固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| Tree.collapsedIcon |
アイコン |
null |
ノードが折りたたまれている場合に使用するアイコン。 |
| Tree.drawHorizontalLines |
Boolean |
true |
trueの場合、ノードにはノードとその親の先端を接続する水平線が描画されます。 |
| Tree.drawVerticalLines |
Boolean |
true |
trueの場合、展開されたノードから下方向に垂直線が描画されます。 |
| Tree.expandedIcon |
アイコン |
null |
ノードが展開されている場合に使用するアイコン。 |
| Tree.leftChildIndent |
整数 |
0 |
これにTree.rightChildIndentを加えたものが、ノードの親からノードをy軸に沿ってオフセットする合計スペース。 |
| Tree.rightChildIndent |
整数 |
0 |
これにTree.leftChildIndentを加えたものが、ノードの親からノードをy軸に沿ってオフセットする合計スペース。 |
| Tree.rowHeight |
整数 |
-1 |
Treeの行の高さ。 |
| Tree.scrollsHorizontallyAndVertically |
Boolean |
false |
falseの場合、セルをすべて収めるためにスクロールが生じる必要があるときに垂直軸に沿ってのみスクロールが生じ、trueの場合、スクロールが水平軸と垂直軸に沿って生じることがあります。 |
| Tree.scrollsOnExpand |
Boolean |
true |
ノードが展開された場合にJTreeがスクロールするべきかどうか。 |
| Tree.linesStyle |
文字列 |
|
ツリー内の線のスタイル。 Synthは実線(空の値)と破線(「dashed」値)をサポートしています。 新しいSynthGraphicsUtilsを作成してツリーにバインドすることにより、新しいスタイルを追加できます。 |
JToggleButtonはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJToggleButtonは次のプロパティをサポートしています。
JToggleButton固有のプロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| ToggleButton.icon |
アイコン |
null |
ラジオ・インジケータを描画するために使用するアイコン。 |
各Buttonクラス(JButton、JCheckBox、JRadioButton、JToggleButton、およびSynthArrowButton)は同様のプロパティ・セットをサポートしています。 これらのプロパティは次のとおりです。
ボタン・クラスの共通プロパティ
| プロパティ |
予想される型 |
デフォルト値 |
説明 |
| prefix.contentAreaFilled |
整数 |
true |
この使用方法の詳細についてはjavax.swing.AbstractButton#contentAreaFilled(boolean)のjavadocを参照してください。 このプロパティが適切に受け付けられるかどうかはPainterしだいです。
|
| prefix.iconTextGap |
整数 |
指定しない場合、JButton.setIconTextGapは呼び出されません。 |
アイコンとテキストの間のパディング。 この使用方法の詳細についてはjavax.swing.AbstractButton#setIconTextGap(int)のjavadocを参照してください。
|
| prefix.margin |
Insets |
空のInsets (0, 0, 0, 0) |
JButtonのマージン。 マージンの使用方法の詳細についてはjavax.swing.AbstractButton#setMargin(java.awt.Insets)のjavadocを参照してください。
|
| prefix.textShiftOffset |
整数 |
0 |
テキストとアイコンをx軸とy軸に沿って移動する量。通常は配置されます。 これは、ボタンが押された状態であり、かつ押された状態のアイコンがない場合にのみ使用されます。 |
PrefixはButton、CheckBox、RadioButton、またはJToggleButtonのいずれかです。
テキスト・プロパティ
テキスト・クラス共通プロパティ
| プロパティ |
予想される型
|
デフォルト値
|
説明
|
| prefix.caretForeground
|
色
|
#000000 |
キャレットの色。
|
| prefix.margin
|
Insets |
空のInsets (0, 0, 0, 0)、EditorPaneおよびTextPane (3, 3, 3, 3)
|
テキスト・コンポーネントのマージン。
|
| prefix.caretBlinkRate
|
整数
|
500
|
キャレットの点滅間隔を定義するミリ秒数。
|
PrefixはEditorPane、FormattedTextField、PasswordField、TextArea、TextField、またはTextPaneのいずれかです。