コンポーネント固有のプロパティ

SynthのLookおよびある程度のFeelを、コンポーネント固有のプロパティによりカスタマイズできます。 これらのプロパティにはSynthStyle#getからアクセスします。 これらのプロパティをSynth構成ファイルで指定する方法などについては、Synthのファイル形式を参照してください。

このファイルは、各値が取るべき予想されるクラス型を指定します。 不正な型を指定した場合の動作は指定されていません。通常はClassCastExceptionがスローされますが、実装に固有なものとなります。

ArrowButton

ArrowButtonは、矢印を描画するJButtonの特殊な型です。 通常はArrowButtonは直接作成されず、一部のComponentがArrowButtonを作成して矢印付きのボタンを描画します。 ArrowButtonを使用するコンポーネントはJComboBox、JScrollBar、およびJSplitPane (ディバイダのボタン用)です。 Buttonプロパティに加えてArrowButtonは次のプロパティをサポートしています。

ArrowButton固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
ArrowButton.size Integer 16 矢印ボタンの適切なサイズ。

JButton

JButtonはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJButtonは次のプロパティをサポートしています。

JButton固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
Button.defaultButtonFollowsFocus Boolean true デフォルトのJButtonが、フォーカスを取得しているボタンに変わるかどうか。

JCheckBox

JCheckBoxはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJCheckBoxは次のプロパティをサポートしています。

JCheckBox固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
CheckBox.icon Icon null チェックを描画するために使用するアイコン。

JComboBox

JComboBoxは、次の子Componentで構成される複合コンポーネントです。

名前 型 説明
ComboBox.arrowButton SynthArrowButton ドロップ・ダウン・インジケータを描画します。
ComboBox.list JList 値を描画するために使用するJList。
ComboBox.listRenderer Component JComboBoxのJListに使用されるレンダラ。
ComboBox.popup JPopupMenu JComboBoxのComboBox.listの表示に使用されるJPopupMenu。
ComboBox.renderer Component JComboBoxに使用されるレンダラ。 これは、レンダラがUIResourceである場合のみ設定されます。
ComboBox.scrollPane JScrollPane JListを含むJScrollPane。
ComboBox.textField JTextField エディタ。

JComboBox固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
ComboBox.showPopupOnNavigation Boolean false キーボードを使用してナビゲート中にJPopupMenuを表示するべきかどうか。

JFileChooser

JFileChooser固有のプロパティ
プロパティ 予想される型
 		デフォルト値
 		説明
FileChooser.cancelIcon
 		Icon
 		null
 		ファイル・チューザの取消しボタンに表示するアイコン。
FileChooser.okIcon
 		Icon
 		null
 		ファイル・チューザのOKボタンに表示するアイコン。
FileView.directoryIcon
 		Icon
 		null
 		ディレクトリに使用するアイコン。
FileView.fileIcon
 		Icon
 		null
 		ファイルに使用するアイコン。
FileView.computerIcon
 		Icon
 		null
 		コンピュータを表すディレクトリに使用するアイコン。 すべてのプラットフォームがこのアイコンを使用するわけではありません。
FileView.hardDriveIcon
 		Icon
 		null
 		ハード・ドライブのルートを表すために使用するアイコン。 たとえば、Windows上ではCドライブを表示するときに使用されます。
FileView.floppyDriveIcon
 		Icon
 		null
 		フロッピー・ディスクを表すために使用するアイコン。
FileChooser.newFolderIcon
 		Icon
 		null
 		新しいフォルダを作成するボタンが使用するアイコン。
FileChooser.upFolderIcon
 		Icon
 		null
 		親フォルダにナビゲートするボタンが使用するアイコン。
FileChooser.homeFolderIcon
 		Icon
 		null
 		現在のユーザーのホーム・ディレクトリにナビゲートするボタンが使用するアイコン。
FileChooser.detailsViewIcon
 		Icon
 		null
 		詳細ファイル・リスト表示を切り替えるボタンが使用するアイコン。
FileChooser.listViewIcon
 		Icon
 		null
 		各ファイルとディレクトリのアイコンと名前のみを表示する通常ファイル・リスト表示を切り替えるボタンが使用するアイコン。
FileChooser.viewMenuIcon
 		Icon
 		null
 		表示モードの選択用のポップアップ・メニューを表示するボタンが使用するアイコン。

JInternalFrame

JInternalFrame固有のプロパティ
プロパティ
 		予想される型
 		DefaultValue
 		説明
InternalFrame.icon
 		Icon null
 		内部フレームのシステム・アイコン
を表すために描画されるアイコン。  押すと
システム・メニューが表示されます。

JInternalFrameTitlePane

JInternalFrameTitlePaneは、フレーム内に存在する制御バーに類似した、内部フレームの最上部に位置する制御バーです。

JInternalFrameTitlePane固有のプロパティ
プロパティ
 		予想される型
 		デフォルト値
 		説明
InternalFrameTitlePane.maximizeIcon
 		Icon null
 		内部フレームを最大化する機能を示すために描画されるアイコン。
InternalFrameTitlePane.minimizeIcon
 		Icon null
 		内部フレームを以前の状態に復元する機能を示すために描画されるアイコン。
InternalFrameTitlePane.iconifyIcon
 		Icon null
 		内部フレームを最小化する機能を示すために描画されるアイコン。
InternalFrameTitlePane.closeIcon
 		Icon null
 		内部フレームを閉じる機能を示すために描画されるアイコン。
InternalFrameTitlePane.titleSpacing
 		Integer 2 タイトル・ペインのボタンとタイトルの間のスペース。
InternalFrameTitlePane.buttonSpacing
 		Integer 2 タイトル・ペインのボタン間のスペース。
InternalFrameTitlePane.maxFrameIconSize
 		Dimension 16x16 タイトル・ペインに描画されるフレーム・アイコンの最大サイズ。 アイコンがこのサイズより大きい場合は縮小されます。
InternalFrameTitlePane.titleAlignment
 		leading|trailing|center leading タイトルの配置方法。 コンポーネント方向が左から右の場合はleadingが左でtrailingが右です。 コンポーネント方向が右から左の場合はleadingが右でtrailingが左です。

JList

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 Integer -1 JListのセルの高さ。 -1の場合、setFixedCellHeightは呼び出されません。

Menuプロパティ

すべてのMenuクラス(JCheckBoxMenuItem、JMenu、JMenuItem、およびJRadioButtonMenuItem)は、同じプロパティ・セットをサポートして同様に動作します。 各コンポーネントは、2つのRegion (コンポーネントに固有のRegionとRegion.MENU_ITEM_ACCELERATOR)で構成されます。 MENU_ITEM_ACCELERATORはアクセラレータのペイントに使用されます。 両方のRegionはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 次のプロパティ・セットがサポートされています。

プロパティ 予想される型 デフォルト値 説明
prefix.acceleratorDelimiter String + 修飾子の説明とキーの間の文字セパレータ(たとえば、Ctrl <acceleratorDelimiter> X)。
prefix.arrowIcon Icon null テキストの右側に描画されるアイコン(またはComponentOrientationが右から左の場合はテキストの左側)。 これは通常、JMenuに対してのみ定義されます。
prefix.checkIcon Icon null テキストの左側に描画されるアイコン(またはComponentOrientationが右から左の場合はテキストの右側)。 これは通常、JCheckBoxMenuItemおよびJRadioButtonMenuItemに対してのみ定義され、チェック・ボタンまたはラジオ・ボタンを提供します。
prefix.margin Insets 空のInsets (0, 0, 0, 0) JMenuItemのマージン。 マージンの使用方法の詳細についてはjavax.swing.AbstractButton#setMargin(java.awt.Insets)のjavadocを参照してください。
prefix.textIconGap Integer 4 アイコンとテキストの間のパディング。 この使用方法の詳細についてはjavax.swing.AbstractButton#setIconTextGap(int)のjavadocを参照してください。

PrefixはCheckBoxMenuItem、Menu、MenuItem、またはRadioButtonMenuItemのいずれかです。

JMenuは次のプロパティもサポートしています。

プロパティ 予想される型 デフォルト値 説明
Menu.delay Integer 200 メニューを表示するまでの遅延を設定します。
Menu.shortcutKeys int[] KeyEvent.ALT_MASK ショートカット・キーに使用するKeyEvent修飾子の配列。

JOptionPane

JOptionPaneは複合コンポーネントであり、多数の子コンポーネントで構成される場合があります。子コンポーネントはOptionPane.button、OptionPane.label、OptionPane.comboBox、OptionPane.scrollPane、OptionPane.list、OptionPane.textField、OptionPane.iconLabelです。

JOptionPane固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
OptionPane.buttonAreaBorder Border null ボタン領域の周囲のボーダー。
OptionPane.buttonClickThreshhold Integer 0 作成されたボタンのsetMultiClickThreshholdに渡されます。
OptionPane.buttonOrientation Integer SwingConstants.CENTER ボタンのレイアウト方法で、SwingConstants.LEFT、SwingConstants.RIGHT、またはSwingConstants.CENTERのいずれか(右から左のロケールの場合は反転される)。
OptionPane.buttonPadding Integer 6 ボタン間のスペースの量。
OptionPane.cancelIcon Icon null 取消しボタンのアイコン。
OptionPane.errorIcon Icon null ERROR_MESSAGEに使用するアイコン。
OptionPane.informationIcon Icon null INFORMATION_MESSAGEに使用するアイコン。
OptionPane.isYesLast Boolean false trueの場合、「はい」ボタンがその他のボタンの前に配置され、それ以外の場合はその他のボタンの後に配置されます。
OptionPane.questionIcon Icon null エラーQUESTION_MESSAGEに使用するアイコン。
OptionPane.minimumSize Dimension 262x90 JOptionPaneの最小サイズ。
OptionPane.noIcon Icon null 「いいえ」ボタンのアイコン。
OptionPane.okIcon Icon null 「OK」ボタンのアイコン。
OptionPane.sameSizeButtons Boolean true すべてのボタンを同じサイズにするべきかどうか。
OptionPane.separatorPadding Integer 6 メッセージ領域とセパレータの間のパディング量。
OptionPane.yesIcon Icon null 「はい」ボタンのアイコン。
OptionPane.warningIcon Icon null エラーWARNING_MESSAGEに使用するアイコン

JProgressBar

JProgressBar固有のプロパティ
プロパティ 予想される型
 		デフォルト値
 		説明
ProgressBar.repaintInterval
 		Integer
 		50
 		不確定進捗バーを再ペイントする間隔のミリ秒数。
ProgressBar.cycleTime
 		Integer
 		3000
 		進捗バーが不確定のときに、1フレームあたりのバウンシング
ボックスの移動距離を決定するために使用するミリ秒数。

JRadioButton

JRadioButtonはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJRadioButtonは次のプロパティをサポートしています。

JRadioButton固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
RadioButton.icon Icon null ラジオ・インジケータを描画するために使用するアイコン。

JScrollBar

JScrollBarは、次の子Componentで構成される複合コンポーネントです。

名前 型 説明
ScrollBar.button SynthArrowButton 増分ボタンと減分ボタンを識別します。

JScrollBar固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
ScrollBar.allowsAbsolutePositioning Boolean false trueの場合、トラック内でマウスを中クリックすると、トラックの位置がマウスの位置に設定されます。
ScrollBar.maximumThumbSize Dimension 4096x4096 サムの最大サイズ。
ScrollBar.minimumThumbSize Dimension ScrollBar.thumbHeightから派生されます サムの最小サイズ。 これを指定しない場合、サムの最小サイズは、スクロール・バーの反対軸の方向ではScrollBar.thumbHeightにスクロール・バーのイン・セットを加えた値、もう一方の軸の方向では7です。 たとえば、スクロール・バーのInsetsを指定しておらず、スクロール・バーの方向が垂直の場合、最小のサム・サイズの幅はScrollBar.thumbHeightで、高さは7です。
ScrollBar.squareButtons Boolean false trueの場合、スクロールバー・ボタンの幅と高さは等しくなります。
ScrollBar.thumbHeight Integer 14 スクロール・バーの方向が水平の場合は適切な高さ、またはスクロール・バーの方向が垂直の場合は適切な幅。

Separators

すべてのセパレータ・クラス(JSeparator、JPopupMenu.Separator、およびJToolBar.Separator)は同じプロパティを使用します。

プロパティ 予想される型 デフォルト値 説明
Separator.thickness Integer 2 垂直方向に整列したセパレータの場合は適切な幅、または水平方向に整列したセパレータの場合は適切な高さ。 結果として得られる適切なサイズにはInsetsが含まれます。

また、JToolBar.Separatorは次のプロパティもサポートします。

プロパティ 予想される型 デフォルト値 説明
ToolBar.separatorSize Dimension null この値はjavax.swing.JToolBar$Separator#setSeparatorSize(java.awt.Dimension)メソッドに渡されます。 指定しない場合、setSeparatorSizeは呼び出されません。

JScrollPane

JScrollPaneは、JViewportの周囲にBorderを設定するメソッドを提供するという点で特殊です(JViewportのsetBorderからはIllegalArgumentExceptionがスローされます)。 これに対応するため、キーScrollPane.viewportBorderInsetsのインセットを使用する特別なボーダーが、JScrollPaneにインストールされています。 SynthPainterのメソッドpaintViewportBorderは、ビュー・ポートのボーダーをペイントするために呼び出されます。

JScrollPane固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
ScrollPane.viewportBorderInsets Insets null ビュー・ポートBorderのInsets。

JSplitPane

JSplitPaneは1つのディバイダ、およびsetOneTouchExpandable(true)が呼び出された場合には2つのボタンを含む複合コンポーネントです。 この2つのボタンの名前はSplitPaneDivider.leftOneTouchButtonとSplitPaneDivider.rightOneTouchButtonです。

JSplitPane固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
SplitPane.centerOneTouchButtons Boolean true trueの場合は、ワン・タッチ・ボタンがディバイダの中央に配置されます。
SplitPane.oneTouchButtonOffset Integer 2 ワン・タッチ・ボタン間の距離。
SplitPane.oneTouchButtonSize Integer 6 ワンタッチ・ボタンの作成サイズ。
SplitPane.oneTouchExpandable Boolean null nullでない場合、この値はsetOneTouchExpandableに渡されます。
SplitPane.size Integer 6 ディバイダのサイズ

JSlider

JSlider固有のプロパティ
プロパティ
 		予想される型
 		デフォルト値
 		説明
Slider.thumbWidth
 		Integer
 		30
 		スライダのサムの幅
Slider.thumbHeight
 		Integer
 		14
 		スライダのサムの高さ
Slider.trackBorder
 		Integer
 		1
 		トラックのボーダーの幅
Slider.paintValue
 		Boolean
 		true
 		スライダの現在の値をペイントするかどうか。

JTabbedPane

JTabbedPane固有のプロパティ
プロパティ 予想される型
 		デフォルト値
 		説明
TabbedPane.tabRunOverlay
 		Integer
 		0
 		行が複数存在する場合にタブをオーバーラップするピクセルの数。
TabbedPane.textIconGap
 		Integer
 		0
 		タブのアイコンとテキストの間に追加されるパディング。 テキストやアイコンがない場合、この値は使用されません。
TabbedPane.selectedTabPadInsets
 		Insets
 		空のInsets (0, 0, 0, 0)
 		選択したタブに追加される追加イン・セット。
TabbedPane.selectionFollowsFocus
 		Boolean
 		true
 		trueの場合、ユーザーがマウスでタブをナビゲートすると、タブ・ペインの選択が変わります。

JTable

JTableはレンダラの名前をTable.cellRendererに設定します。 JTableは次のプロパティをサポートします。

JTable固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
Table.gridColor Color null グリッドに使用する色。 nullの場合、スタイルの前景色が使用されます。
Table.rendererUseTableColors Boolean true trueの場合、レンダラの状態は更新されず、テキストの色はJTableのgetSelectionBackgroundおよびgetSelectionForegroundメソッドから取得されます。 falseの場合、レンダラの状態が更新され、色は代わりにStyleから取得されます。
Table.rendererUseUIBorder Boolean true trueの場合、渡されたボーダーに関係なくレンダラのsetBorderは成功します。それ以外の場合は、レンダラのsetBorderはSynth Borderの場合にのみ成功します。
Table.rowHeight Integer -1 -1ではない場合、JTable上でsetRowHeightが呼び出されます。

JTree

JTreeはレンダラの名前をTree.rendererに設定し、エディタの名前はTree.cellEditorになります。

JTree固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
Tree.collapsedIcon Icon null ノードが折りたたまれている場合に使用するアイコン。
Tree.drawHorizontalLines Boolean true trueの場合、ノードにはノードとその親の先端を接続する水平線が描画されます。
Tree.drawVerticalLines Boolean true trueの場合、展開されたノードから下方向に垂直線が描画されます。
Tree.expandedIcon Icon null ノードが展開されている場合に使用するアイコン。
Tree.leftChildIndent Integer 0 これにTree.rightChildIndentを加えたものが、ノードの親からノードをy軸に沿ってオフセットする合計スペース。
Tree.rightChildIndent Integer 0 これにTree.leftChildIndentを加えたものが、ノードの親からノードをy軸に沿ってオフセットする合計スペース。
Tree.rowHeight Integer -1 Treeの行の高さ。
Tree.scrollsHorizontallyAndVertically Boolean false falseの場合、セルをすべて収めるためにスクロールが生じる必要があるときに垂直軸に沿ってのみスクロールが生じ、trueの場合、スクロールが水平軸と垂直軸に沿って生じることがあります。
Tree.scrollsOnExpand Boolean true ノードが展開された場合にJTreeがスクロールするべきかどうか。
Tree.linesStyle String ツリー内の線のスタイル。 Synthは実線(空の値)と破線(「dashed」値)をサポートしています。 新しいSynthGraphicsUtilsを作成してツリーにバインドすることにより、新しいスタイルを追加できます。

JToggleButton

JToggleButtonはTEXT_FOREGROUND ColorTypeを使用してテキストをペイントします。 Buttonプロパティに加えてJToggleButtonは次のプロパティをサポートしています。

JToggleButton固有のプロパティ
プロパティ 予想される型 デフォルト値 説明
ToggleButton.icon Icon null ラジオ・インジケータを描画するために使用するアイコン。

Buttonプロパティ

各Buttonクラス(JButton、JCheckBox、JRadioButton、JToggleButton、およびSynthArrowButton)は同様のプロパティ・セットをサポートしています。 これらのプロパティは次のとおりです。

プロパティ 予想される型 デフォルト値 説明
prefix.contentAreaFilled Integer true この使用方法の詳細についてはjavax.swing.AbstractButton#contentAreaFilled(boolean)のjavadocを参照してください。 このプロパティが適切に受け付けられるかどうかはPainterしだいです。
prefix.iconTextGap Integer 指定しない場合、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 Integer 0 テキストとアイコンを通常レイアウトされている位置からx軸とy軸に沿って移動する量。 これは、ボタンが押された状態であり、かつ押された状態のアイコンがない場合にのみ使用されます。

PrefixはButton、CheckBox、RadioButton、またはJToggleButtonのいずれかです。

テキスト・プロパティ

プロパティ 予想される型
 		デフォルト値
 		説明
prefix.caretForeground
 		Color
 		#000000 キャレットの色。
prefix.margin
 		Insets 空のInsets (0, 0, 0, 0)、
EditorPaneおよびTextPane (3, 3, 3, 3)
 		テキスト・コンポーネントのマージン。
prefix.caretBlinkRate
 		Integer
 		500
 		キャレットの点滅間隔を定義するミリ秒数。

PrefixはEditorPane、FormattedTextField、PasswordField、TextArea、TextField、またはTextPaneのいずれかです。