javax.swing.plaf.metal
クラス MetalLookAndFeel

java.lang.Object
  javax.swing.LookAndFeel
      javax.swing.plaf.basic.BasicLookAndFeel
          javax.swing.plaf.metal.MetalLookAndFeel

すべての実装されたインタフェース:

Serializable

public class MetalLookAndFeel
extends BasicLookAndFeel

Java Look & Feel (コード名は Metal) を実装します。

多くのコントロールで、metal はデフォルトでボールドフォントを使用します。すべてのコントロール (内部フレームのタイトルやクライアントで装飾したフレームのタイトルバーを除く) がプレーンフォントを使用するようにするには、以下のいずれかを行います。

• システムプロパティ swing.boldMetal を false に設定する。例： java -Dswing.boldMetal=false MyApp.
• デフォルトプロパティ swing.boldMetal を Boolean.FALSE に設定する。例： UIManager.put("swing.boldMetal", Boolean.FALSE);

デフォルトプロパティ swing.boldMetal を設定すると、同じ名前のシステムプロパティよりも優先して使用されます。デフォルトプロパティを設定した後は MetalLookAndFeel を再インストールし、以前に作成したウィジェットの UI をすべて更新する必要があります。そうしない場合は結果が定義できません。コード例を以下に示します。

   // turn off bold fonts
   UIManager.put("swing.boldMetal", Boolean.FALSE);

   // re-install the Metal Look and Feel
   UIManager.setLookAndFeel(new MetalLookAndFeel());

   // only needed to update existing widgets
   SwingUtilities.updateComponentTreeUI(rootComponent);
 

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeans^™ の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

コンストラクタの概要

MetalLookAndFeel()

メソッドの概要

protected void	createDefaultTheme()
static ColorUIResource	getAcceleratorForeground()
static ColorUIResource	getAcceleratorSelectedForeground()
static ColorUIResource	getBlack()
static ColorUIResource	getControl()
static ColorUIResource	getControlDarkShadow()
static ColorUIResource	getControlDisabled()
static ColorUIResource	getControlHighlight()
static ColorUIResource	getControlInfo()
static ColorUIResource	getControlShadow()
static ColorUIResource	getControlTextColor()
static FontUIResource	getControlTextFont()
static MetalTheme	getCurrentTheme() MetalLookAndFeel で現在使用されているテーマを返します。
UIDefaults	getDefaults() Look & Feel 固有のデフォルトテーブルを作成するために、UIManager.setLookAndFeel によって 1 回呼び出されます。
String	getDescription() 「The CDE/Motif Look and Feel」など、この Look & Feel の実装に対する 1 行の説明を返します。
static ColorUIResource	getDesktopColor()
Icon	getDisabledIcon(JComponent component, Icon icon) 使用不可な外観の Icon を返します。
Icon	getDisabledSelectedIcon(JComponent component, Icon icon) 選択された使用不可なコンポーネントが使用する Icon を返します。
static ColorUIResource	getFocusColor()
static ColorUIResource	getHighlightedTextColor()
String	getID() この Look & Feel を識別する文字列を返します。
static ColorUIResource	getInactiveControlTextColor()
static ColorUIResource	getInactiveSystemTextColor()
static ColorUIResource	getMenuBackground()
static ColorUIResource	getMenuDisabledForeground()
static ColorUIResource	getMenuForeground()
static ColorUIResource	getMenuSelectedBackground()
static ColorUIResource	getMenuSelectedForeground()
static FontUIResource	getMenuTextFont()
String	getName() 「CDE/Motif」など、この Look & Feel を識別する短い文字列を返します。
static ColorUIResource	getPrimaryControl()
static ColorUIResource	getPrimaryControlDarkShadow()
static ColorUIResource	getPrimaryControlHighlight()
static ColorUIResource	getPrimaryControlInfo()
static ColorUIResource	getPrimaryControlShadow()
static ColorUIResource	getSeparatorBackground()
static ColorUIResource	getSeparatorForeground()
static FontUIResource	getSubTextFont()
boolean	getSupportsWindowDecorations() LookAndFeel が返す RootPaneUI インスタンスが JRootPane でのウィンドウ装飾の提供をサポートする場合、true を返します。
static ColorUIResource	getSystemTextColor()
static FontUIResource	getSystemTextFont()
static ColorUIResource	getTextHighlightColor()
static ColorUIResource	getUserTextColor()
static FontUIResource	getUserTextFont()
static ColorUIResource	getWhite()
static ColorUIResource	getWindowBackground()
static ColorUIResource	getWindowTitleBackground()
static FontUIResource	getWindowTitleFont()
static ColorUIResource	getWindowTitleForeground()
static ColorUIResource	getWindowTitleInactiveBackground()
static ColorUIResource	getWindowTitleInactiveForeground()
protected void	initClassDefaults(UIDefaults table) ID と ComponentUI のペアを渡されたデフォルトテーブルに配置して、UI クラスの ID から ComponentUI クラスへのマッピングを作成します。
protected void	initComponentDefaults(UIDefaults table)
protected void	initSystemColorDefaults(UIDefaults table) デフォルトのテーブルに SystemColor をロードします。
boolean	isNativeLookAndFeel() 基本のプラットフォームに「ネイティブな」Look & Feel があり、現在の Look & Feel がその実装である場合に true を返します。
boolean	isSupportedLookAndFeel() 基本のプラットフォームがこの Look & Feel をサポートしたり、許容したりする場合に true を返します。
void	provideErrorFeedback(Component component) フォーカスを持つ、編集不可能な JTextField に貼り付けを行うなど、ユーザが無効な操作をしようとしたときに呼び出されます。
static void	setCurrentTheme(MetalTheme theme) MetalLookAndFeel で使用するテーマを設定します。

クラス javax.swing.plaf.basic.BasicLookAndFeel から継承されたメソッド

createAudioAction, getAudioActionMap, initialize, loadSystemColors, playSound, uninitialize

クラス javax.swing.LookAndFeel から継承されたメソッド

getDesktopPropertyValue, installBorder, installColors, installColorsAndFont, installProperty, loadKeyBindings, makeComponentInputMap, makeIcon, makeInputMap, makeKeyBindings, toString, uninstallBorder

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

MetalLookAndFeel

public MetalLookAndFeel()

メソッドの詳細

getName

public String getName()

クラス LookAndFeel の記述:

「CDE/Motif」など、この Look & Feel を識別する短い文字列を返します。この文字列は、メニュー項目に適しています。Look & Feel は、それぞれ異なる名前を持っています。たとえば、数個のコンポーネントの描画方法を変更する MotifLookAndFeel のサブクラスは、「CDE/Motif My Way」などと呼ばれます。こうした名前は、ユーザが名前のリストから L&F を選択するときに便利です。

定義:

クラス LookAndFeel 内の getName

getID

public String getID()

クラス LookAndFeel の記述:

この Look & Feel を識別する文字列を返します。この文字列は、有名な Look & Feel の実装を認識するアプリケーション/サービスで使用されます。現在、有名なものとしては「Motif」、「Windows」、「Mac」、「Metal」などです。Look & Feel に基本的な変更を加えない有名なスーパークラスから派生した LookAndFeel は、このメソッドをオーバーライドすべきではないことに注意してください。

定義:

クラス LookAndFeel 内の getID

getDescription

public String getDescription()

クラス LookAndFeel の記述:

「The CDE/Motif Look and Feel」など、この Look & Feel の実装に対する 1 行の説明を返します。これはユーザ向けの文字列で、ウィンドウのタイトルやツールヒントメッセージなどに使用されます。

定義:

クラス LookAndFeel 内の getDescription

isNativeLookAndFeel

public boolean isNativeLookAndFeel()

クラス LookAndFeel の記述:

基本のプラットフォームに「ネイティブな」Look & Feel があり、現在の Look & Feel がその実装である場合に true を返します。たとえば CDE/Motif の見た目と実装では、基本のプラットフォームが Solaris であった場合に、true が返されます。

定義:

クラス LookAndFeel 内の isNativeLookAndFeel

isSupportedLookAndFeel

public boolean isSupportedLookAndFeel()

クラス LookAndFeel の記述:

基本のプラットフォームがこの Look & Feel をサポートしたり、許容したりする場合に true を返します。Look & Feel が特殊なリソースや、現在のプラットフォームに対して定義されていない法的契約に依存する場合、このメソッドは false を返します。

定義:

クラス LookAndFeel 内の isSupportedLookAndFeel

関連項目:

UIManager.setLookAndFeel(javax.swing.LookAndFeel)

getSupportsWindowDecorations

public boolean getSupportsWindowDecorations()

LookAndFeel が返す RootPaneUI インスタンスが JRootPane でのウィンドウ装飾の提供をサポートする場合、true を返します。

ボーダとウィンドウのタイトル区画の装飾の提供をサポートするため、この実装は true を返します。

オーバーライド:

クラス LookAndFeel 内の getSupportsWindowDecorations

戻り値:

作成された RootPaneUI インスタンスがクライアント側の装飾をサポートする場合、true

導入されたバージョン:

1.4

関連項目:

JDialog.setDefaultLookAndFeelDecorated(boolean), JFrame.setDefaultLookAndFeelDecorated(boolean), JRootPane.setWindowDecorationStyle(int)

initClassDefaults

protected void initClassDefaults(UIDefaults table)

ID と ComponentUI のペアを渡されたデフォルトテーブルに配置して、UI クラスの ID から ComponentUI クラスへのマッピングを作成します。各 JComponent クラスは、それ自体の UI クラスの ID 文字列を指定します。たとえば、JButton は UI クラスの ID 「ButtonUI」を持ち、このメソッドは「javax.swing.plaf.metal.MetalButtonUI」にマッピングします。

オーバーライド:

クラス BasicLookAndFeel 内の initClassDefaults

関連項目:

BasicLookAndFeel.getDefaults(), JComponent.getUIClassID()

initSystemColorDefaults

protected void initSystemColorDefaults(UIDefaults table)

デフォルトのテーブルに SystemColor をロードします。SystemColor の各キーは、デフォルトでは SystemColor の public フィールドの名前と同じになります。

オーバーライド:

クラス BasicLookAndFeel 内の initSystemColorDefaults

initComponentDefaults

protected void initComponentDefaults(UIDefaults table)

オーバーライド:

クラス BasicLookAndFeel 内の initComponentDefaults

createDefaultTheme

protected void createDefaultTheme()

getDefaults

public UIDefaults getDefaults()

クラス LookAndFeel の記述:

Look & Feel 固有のデフォルトテーブルを作成するために、UIManager.setLookAndFeel によって 1 回呼び出されます。アプリケーションビルダなど、ほかのアプリケーションもこのメソッドを呼び出す場合があります。

オーバーライド:

クラス BasicLookAndFeel 内の getDefaults

関連項目:

LookAndFeel.initialize(), LookAndFeel.uninitialize(), UIManager.setLookAndFeel(javax.swing.LookAndFeel)

provideErrorFeedback

public void provideErrorFeedback(Component component)

フォーカスを持つ、編集不可能な JTextField に貼り付けを行うなど、ユーザが無効な操作をしようとしたときに呼び出されます。

デスクトップに可視的なエラー表示を行えるようにした場合、このメソッドはアクティブウィンドウのキャプションバーをフラッシュします。プロパティ awt.visualbell を true に設定しても、同じ結果を得ることができます。

オーバーライド:

クラス LookAndFeel 内の provideErrorFeedback

パラメータ:

component - エラーが発生したコンポーネント。null は、エラー条件を Component に直接関連付けないことを示す

関連項目:

LookAndFeel.provideErrorFeedback(java.awt.Component)

setCurrentTheme

public static void setCurrentTheme(MetalTheme theme)

MetalLookAndFeel で使用するテーマを設定します。 null でも構いません。
テーマを設定したら、After setting the theme, you need to re-install the MetalLookAndFeel を再インストールし、以前に作成したウィジェットの UI をすべて更新する必要があります。そうしない場合は結果が定義できません。以下にコード例を示します。

   // turn off bold fonts
   MetalLookAndFeel.setCurrentTheme(theme);

   // re-install the Metal Look and Feel
   UIManager.setLookAndFeel(new MetalLookAndFeel());

   // only needed to update existing widgets
   SwingUtilities.updateComponentTreeUI(rootComponent);
 

パラメータ:

theme - 使用するテーマ。null 以外。

例外:

NullPointerException - null パラメータが渡された場合

関連項目:

getCurrentTheme()

getCurrentTheme

public static MetalTheme getCurrentTheme()

MetalLookAndFeel で現在使用されているテーマを返します。テーマが設定されていない場合は現在のテーマを設定するため、null になることはありません。

戻り値:

現在のテーマ

導入されたバージョン:

1.5

関連項目:

setCurrentTheme(javax.swing.plaf.metal.MetalTheme)

getDisabledIcon

public Icon getDisabledIcon(JComponent component,
                            Icon icon)

使用不可な外観の Icon を返します。このメソッドは、指定されていない場合に使用不可な Icon を生成するために使用されます。たとえば JButton を作成し setIcon 経由でのみ Icon を指定すると、このメソッドは使用不可な Icon を生成するために呼び出されます。null が渡されるとこのメソッドは null を返します。

Look & Feel によっては使用不可な Icon を描画しないかもしれません。その場合は無視されます。

オーバーライド:

クラス LookAndFeel 内の getDisabledIcon

パラメータ:

component - Icon を表示する JComponent。null でも可。

icon - 使用不可なアイコンを生成する Icon

戻り値:

使用不可なアイコン。適切な Icon が生成されなかった場合は null

導入されたバージョン:

1.5

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon(JComponent component,
                                    Icon icon)

選択された使用不可なコンポーネントが使用する Icon を返します。 このメソッドは、使用不可かつ選択されているがその状態に対する特定の Icon を持たないコンポーネントの Icon を生成するために使用されます。たとえば JButton を作成し setIcon 経由でのみ Icon を指定すると、このメソッドは使用不可かつ選択された Icon を生成するために呼び出されます。null が 渡されるとこのメソッドは null を返します。

Look & Feel によっては使用不可かつ選択された Icon を描画しないかもしれません。その場合は無視されます。

オーバーライド:

クラス LookAndFeel 内の getDisabledSelectedIcon

パラメータ:

component - Icon を表示する JComponent。null でも可。

icon - 使用不可かつ選択されたアイコンを生成する Icon

戻り値:

使用不可かつ選択されたアイコン。適切な Icon が生成されなかった場合は null

導入されたバージョン:

1.5

getControlTextFont

public static FontUIResource getControlTextFont()

getSystemTextFont

public static FontUIResource getSystemTextFont()

getUserTextFont

public static FontUIResource getUserTextFont()

getMenuTextFont

public static FontUIResource getMenuTextFont()

getWindowTitleFont

public static FontUIResource getWindowTitleFont()

getSubTextFont

public static FontUIResource getSubTextFont()

getDesktopColor

public static ColorUIResource getDesktopColor()

getFocusColor

public static ColorUIResource getFocusColor()

getWhite

public static ColorUIResource getWhite()

getBlack

public static ColorUIResource getBlack()

getControl

public static ColorUIResource getControl()

getControlShadow

public static ColorUIResource getControlShadow()

getControlDarkShadow

public static ColorUIResource getControlDarkShadow()

getControlInfo

public static ColorUIResource getControlInfo()

getControlHighlight

public static ColorUIResource getControlHighlight()

getControlDisabled

public static ColorUIResource getControlDisabled()

getPrimaryControl

public static ColorUIResource getPrimaryControl()

getPrimaryControlShadow

public static ColorUIResource getPrimaryControlShadow()

getPrimaryControlDarkShadow

public static ColorUIResource getPrimaryControlDarkShadow()

getPrimaryControlInfo

public static ColorUIResource getPrimaryControlInfo()

getPrimaryControlHighlight

public static ColorUIResource getPrimaryControlHighlight()

getSystemTextColor

public static ColorUIResource getSystemTextColor()

getControlTextColor

public static ColorUIResource getControlTextColor()

getInactiveControlTextColor

public static ColorUIResource getInactiveControlTextColor()

getInactiveSystemTextColor

public static ColorUIResource getInactiveSystemTextColor()

getUserTextColor

public static ColorUIResource getUserTextColor()

getTextHighlightColor

public static ColorUIResource getTextHighlightColor()

getHighlightedTextColor

public static ColorUIResource getHighlightedTextColor()

getWindowBackground

public static ColorUIResource getWindowBackground()

getWindowTitleBackground

public static ColorUIResource getWindowTitleBackground()

getWindowTitleForeground

public static ColorUIResource getWindowTitleForeground()

getWindowTitleInactiveBackground

public static ColorUIResource getWindowTitleInactiveBackground()

getWindowTitleInactiveForeground

public static ColorUIResource getWindowTitleInactiveForeground()

getMenuBackground

public static ColorUIResource getMenuBackground()

getMenuForeground

public static ColorUIResource getMenuForeground()

getMenuSelectedBackground

public static ColorUIResource getMenuSelectedBackground()

getMenuSelectedForeground

public static ColorUIResource getMenuSelectedForeground()

getMenuDisabledForeground

public static ColorUIResource getMenuDisabledForeground()

getSeparatorBackground

public static ColorUIResource getSeparatorBackground()

getSeparatorForeground

public static ColorUIResource getSeparatorForeground()

getAcceleratorForeground

public static ColorUIResource getAcceleratorForeground()

getAcceleratorSelectedForeground

public static ColorUIResource getAcceleratorSelectedForeground()