|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Objectjavax.swing.UIManager
public class UIManager
UIManager は、現在の Look & Feel、使用可能な Look & Feel のセット、Look & Feel の変更時に通知を受ける PropertyChangeListener、Look & Feel のデフォルト値、およびさまざまなデフォルト値を取得するために使用する簡易メソッドを管理します。
LookAndFeel のインスタンスを作成し、setLookAndFeel に渡す方法です。次に、システムの Look & Feel を Look & Feel として設定する例を示します。
UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());次に、クラス名を指定して Look & Feel を設定する例を示します。
UIManager.setLookAndFeel("javax.swing.plaf.metal.MetalLookAndFeel");
Look & Feel を変更したら必ず、すべての JComponents 上で updateUI を呼び出します。SwingUtilities.updateComponentTreeUI(java.awt.Component) メソッドを使用すると、包含関係の階層に updateUI を簡単に適用できます。詳細は、このメソッドを参照してください。Look & Feel の変更後、updateUI を呼び出さなかった場合の正確な動作は指定されていません。予期しない例外、ペイントの問題、またはそれ以上に困った事態が発生する可能性が高いです。
swing.defaultlaf が null 以外 の場合、このプロパティーの値をデフォルトの Look & Feel のクラス名として使用します。
Properties ファイルの swing.properties が存在し、キー swing.defaultlaf が格納されている場合、その値をデフォルトの Look & Feel のクラス名として使用します。swing.properties が確認される場所は、Java プラットフォームの実装によって異なる可能性があります。Sun の実装の場合、${java.home}/lib/swing.properties になります。詳細は、使用する実装のリリースノートを参照してください。
UIManager は、UIDefault のセットを 3 組管理します。これらは順番に、次のとおりです。
setLookAndFeel() が呼び出されたとき)、この Look & Feel によって提供されます。Look & Feel のデフォルトは、getLookAndFeelDefaults() メソッドを使って取得できます。
get メソッドを呼び出しても、各デフォルトが順番にチェックされ、最初に見つかった null 以外の 値が返されます。たとえば、UIManager.getString("Table.foreground") を呼び出した場合、最初に開発者のデフォルトがチェックされます。開発者のデフォルトに "Table.foreground" の値が含まれていれば、その値が返されます。そうでない場合は、Look & Feel のデフォルト、続いてシステムのデフォルトがチェックされます。
getDefaults は、この解決ロジックが組み込まれた UIDefaults のカスタムインスタンスを返すという点に注意してください。たとえば、UIManager.getDefaults().getString("Table.foreground") は UIManager.getString("Table.foreground") と同等です。どちらも、ここで説明したアルゴリズムに従って解決を行います。ドキュメント内では、多くの場合、上記の解決ロジックを備えた UIDefaults のカスタムインスタンスを「デフォルト」と呼びます。
Look & Feel が変更された場合、UIManager は Look & Feel のデフォルトだけを変更します。UIManager が開発者のデフォルトやシステムのデフォルトを変更することはありません。
特定の Look & Feel でサポートされるデフォルトのセットは、その Look & Feel に定義され、ドキュメント化されています。さらに、個々の Look & Feel (または任意の Look & Feel が提供する ComponentUI) が、それぞれのライフサイクル内の異なった時期にデフォルトにアクセスする場合があります。積極的にデフォルトを検索する Look & Feel もあれば (この場合、Look & Feel のインストール後にデフォルトに変更を加えても効果はない)、めったにデフォルトにアクセスしない Look & Feel もあります (この場合、デフォルトの変更が既存の Look & Feel に影響を及ぼす)。結局、その他の Look & Feel は、デフォルトテーブルから自身の設定を行わない可能性があります。それにもかかわらず、通常、Look & Feel はなんらかのデフォルトを求めます。このため、一般に、ある Look & Feel が提供する ComponentUI) は、別の Look & Feel では動作しません。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans™ の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。
| 入れ子のクラスの概要 | |
|---|---|
static class |
UIManager.LookAndFeelInfo
メニューの設定またはアプリケーションの初期設定のための、インストール済み LookAndFeel に関する概要を説明します。 |
| コンストラクタの概要 | |
|---|---|
UIManager()
|
|
| メソッドの概要 | |
|---|---|
static void |
addAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel を補助的な Look & Feel のリストに追加します。 |
static void |
addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。 |
static Object |
get(Object key)
デフォルトからオブジェクトを返します。 |
static Object |
get(Object key,
Locale l)
デフォルトから、指定されたロケールに適したオブジェクトを返します。 |
static LookAndFeel[] |
getAuxiliaryLookAndFeels()
補助的な Look & Feel のリストを返します。 |
static boolean |
getBoolean(Object key)
デフォルトから、キーの値に関連付けられた boolean 値を返します。 |
static boolean |
getBoolean(Object key,
Locale l)
デフォルトから、キーの値および指定された Locale に関連付けられた boolean 値を返します。 |
static Border |
getBorder(Object key)
デフォルトからボーダーを返します。 |
static Border |
getBorder(Object key,
Locale l)
デフォルトから、指定されたロケールに適したボーダーを返します。 |
static Color |
getColor(Object key)
デフォルトから色を返します。 |
static Color |
getColor(Object key,
Locale l)
デフォルトから、指定されたロケールに適した色を返します。 |
static String |
getCrossPlatformLookAndFeelClassName()
デフォルトクロスプラットフォームの Look & Feel、つまり Java Look & Feel (JLF) を実装する LookAndFeel クラスの名前を返します。 |
static UIDefaults |
getDefaults()
デフォルトを返します。 |
static Dimension |
getDimension(Object key)
デフォルトから寸法を返します。 |
static Dimension |
getDimension(Object key,
Locale l)
デフォルトから、指定されたロケールに適した寸法を返します。 |
static Font |
getFont(Object key)
デフォルトからフォントを返します。 |
static Font |
getFont(Object key,
Locale l)
デフォルトから、指定されたロケールに適したフォントを返します。 |
static Icon |
getIcon(Object key)
デフォルトから Icon を返します。 |
static Icon |
getIcon(Object key,
Locale l)
デフォルトから、指定されたロケールに適した Icon を返します。 |
static Insets |
getInsets(Object key)
デフォルトから Insets オブジェクトを返します。 |
static Insets |
getInsets(Object key,
Locale l)
デフォルトから、指定されたロケールに適した Insets オブジェクトを返します。 |
static UIManager.LookAndFeelInfo[] |
getInstalledLookAndFeels()
現在使用可能な LookAndFeel 実装を表す LookAndFeelInfo の配列を返します。 |
static int |
getInt(Object key)
デフォルトから int 値を返します。 |
static int |
getInt(Object key,
Locale l)
デフォルトから、指定されたロケールに適した int 値を返します。 |
static LookAndFeel |
getLookAndFeel()
現在の Look & Feel、または null を返します。 |
static UIDefaults |
getLookAndFeelDefaults()
現在の Look & Feel がインストールされたとき取得された、この Look & Feel の UIDefaults を返します。 |
static PropertyChangeListener[] |
getPropertyChangeListeners()
addPropertyChangeListener() を使用してこの UIManager に追加されているすべての PropertyChangeListener の配列を返します。 |
static String |
getString(Object key)
デフォルトから文字列を返します。 |
static String |
getString(Object key,
Locale l)
デフォルトから、指定されたロケールに適した文字列を返します。 |
static String |
getSystemLookAndFeelClassName()
ネイティブシステムの Look & Feel を実装する LookAndFeel クラスの名前があればそれを返し、そうでない場合はデフォルトのクロスプラットフォームの LookAndFeel クラスの名前を返します。 |
static ComponentUI |
getUI(JComponent target)
target に適した ComponentUI 実装を返します。 |
static void |
installLookAndFeel(String name,
String className)
使用可能な Look & Feel のセットに、指定された Look & Feel を追加します。 |
static void |
installLookAndFeel(UIManager.LookAndFeelInfo info)
使用可能な Look & Feel のセットに、指定された Look & Feel を追加します。 |
static Object |
put(Object key,
Object value)
開発者のデフォルトにオブジェクトを格納します。 |
static boolean |
removeAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel を補助的な Look & Feel のリストから削除します。 |
static void |
removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストから削除します。 |
static void |
setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
使用可能な Look & Feel のセットを設定します。 |
static void |
setLookAndFeel(LookAndFeel newLookAndFeel)
newLookAndFeel を現在の Look & Feel として設定します。 |
static void |
setLookAndFeel(String className)
現在のスレッドのコンテキストクラスローダーを使って、指定のクラス名で示される LookAndFeel をロードし、setLookAndFeel(LookAndFeel) に渡します。 |
| クラス java.lang.Object から継承されたメソッド |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| コンストラクタの詳細 |
|---|
public UIManager()
| メソッドの詳細 |
|---|
public static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()
LookAndFeel 実装を表す LookAndFeelInfo の配列を返します。アプリケーションは LookAndFeelInfo オブジェクトを使用して、ユーザー用 Look & Feel オプションのメニューを構築したり、起動時に設定する Look & Feel を決定したりできます。大量の LookAndFeel オブジェクトの生成による負荷を避けるため、LookAndFeelInfo は、実際の LookAndFeel インスタンスではなく、LookAndFeel クラスのクラス名を管理します。
次に、LookAndFeelInfo のインスタンスから現在の Look & Feel を設定する例を示します。
UIManager.setLookAndFeel(info.getClassName());
LookAndFeelInfo オブジェクトの配列setLookAndFeel(javax.swing.LookAndFeel)
public static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
throws SecurityException
LookAndFeelInfo が null 以外 であるかどうかをチェックするわけではありませんが、情報 配列には null 以外 の値だけを指定することを強くお勧めします。
infos - 使用可能な Look & Feel を指定する LookAndFeelInfo オブジェクトのセット
NullPointerException - 情報 が null の場合
SecurityExceptiongetInstalledLookAndFeels()public static void installLookAndFeel(UIManager.LookAndFeelInfo info)
null 情報 を許容しますが、null 以外 の値を使用することを強くお勧めします。
info - Look & Feel を指定し、その Look & Feel を実装するクラスを識別する LookAndFeelInfo オブジェクトsetInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])
public static void installLookAndFeel(String name,
String className)
null 以外 の値を使用することを強くお勧めします。
name - Look & Feel の説明的な名前className - この Look & Feel を実装するクラスの名前setInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])public static LookAndFeel getLookAndFeel()
null を返します。
nullsetLookAndFeel(javax.swing.LookAndFeel)
public static void setLookAndFeel(LookAndFeel newLookAndFeel)
throws UnsupportedLookAndFeelException
newLookAndFeel を現在の Look & Feel として設定します。現在の Look & Feel が null 以外 である場合、その上で uninitialize が呼び出されます。newLookAndFeel が null 以外 である場合、その上で initialize が呼び出され、続いて getDefaults が呼び出されます。それまでの Look & Feel のデフォルトは、newLookAndFeel.getDefaults() が返すデフォルトに置き換えられます。newLookAndFeel が null の場合、Look & Feel のデフォルトは null に設定されます。
値 null は、Look & Feel を null に設定する場合に使用できます。ほとんどの場合、Swing を機能させるためには LookAndFeel が必要です。したがって、LookAndFeel を null に設定することはまったくお勧めしません。
これは JavaBeans バウンドプロパティーです。
newLookAndFeel - インストールする LookAndFeel
UnsupportedLookAndFeelException - newLookAndFeel が null 以外 で、newLookAndFeel.isSupportedLookAndFeel() が false を返す場合getLookAndFeel()
public static void setLookAndFeel(String className)
throws ClassNotFoundException,
InstantiationException,
IllegalAccessException,
UnsupportedLookAndFeelException
LookAndFeel をロードし、setLookAndFeel(LookAndFeel) に渡します。
className - Look & Feel を実装するクラスの名前を指定する文字列
ClassNotFoundException - LookAndFeel クラスが見つからなかった場合
InstantiationException - クラスの新しいインスタンスを生成できなかった場合
IllegalAccessException - クラスまたは初期化子にアクセスできない場合
UnsupportedLookAndFeelException - lnf.isSupportedLookAndFeel() が false の場合
ClassCastException - LookAndFeel を拡張するクラスを、className で識別できない場合public static String getSystemLookAndFeelClassName()
LookAndFeel クラスの名前があればそれを返し、そうでない場合はデフォルトのクロスプラットフォームの LookAndFeel クラスの名前を返します。この値は、swing.systemlaf システムプロパティーを設定することによりオーバーライドできます。
LookAndFeel クラスの StringsetLookAndFeel(javax.swing.LookAndFeel),
getCrossPlatformLookAndFeelClassName()public static String getCrossPlatformLookAndFeelClassName()
LookAndFeel クラスの名前を返します。この値は、swing.crossplatformlaf システムプロパティーを設定することによりオーバーライドできます。
setLookAndFeel(javax.swing.LookAndFeel),
getSystemLookAndFeelClassName()public static UIDefaults getDefaults()
UIDefaults オブジェクトpublic static Font getFont(Object key)
key の値が Font でない場合、null が返されます。
key - フォントを指定する Object
Font オブジェクト
NullPointerException - key が null の場合
public static Font getFont(Object key,
Locale l)
key の値が Font でない場合、null が返されます。
key - フォントを指定する Objectl - そのフォントが適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Font オブジェクト
NullPointerException - key が null の場合public static Color getColor(Object key)
key の値が Color でない場合、null が返されます。
key - 色を指定する Object
Color オブジェクト
NullPointerException - key が null の場合
public static Color getColor(Object key,
Locale l)
key の値が Color でない場合、null が返されます。
key - 色を指定する Objectl - その色が適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Color オブジェクト
NullPointerException - key が null の場合public static Icon getIcon(Object key)
Icon を返します。key の値が Icon でない場合、null が返されます。
key - アイコンを指定する Object
Icon オブジェクト
NullPointerException - key が null の場合
public static Icon getIcon(Object key,
Locale l)
Icon を返します。key の値が Icon でない場合、null が返されます。
key - アイコンを指定する Objectl - そのアイコンが適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Icon オブジェクト
NullPointerException - key が null の場合public static Border getBorder(Object key)
key の値が Border でない場合、null が返されます。
key - ボーダーを指定する Object
Border オブジェクト
NullPointerException - key が null の場合
public static Border getBorder(Object key,
Locale l)
key の値が Border でない場合、null が返されます。
key - ボーダーを指定する Objectl - そのボーダーが適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Border オブジェクト
NullPointerException - key が null の場合public static String getString(Object key)
key の値が String でない場合、null が返されます。
key - 文字列を指定する Object
String
NullPointerException - key が null の場合
public static String getString(Object key,
Locale l)
key の値が String でない場合、null が返されます。
key - 文字列を指定する Objectl - その文字列が適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
String
NullPointerException - key が null の場合public static int getInt(Object key)
key の値が Integer でない場合や存在しない場合は、0 が返されます。
key - int 値を指定する Object
NullPointerException - key が null の場合
public static int getInt(Object key,
Locale l)
key の値が Integer でない場合や存在しない場合は、0 が返されます。
key - int 値を指定する Objectl - その int 値が適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
NullPointerException - key が null の場合public static boolean getBoolean(Object key)
false が返されます。
key - 目的の boolean 値のキーを指定する Object
NullPointerException - key が null の場合
public static boolean getBoolean(Object key,
Locale l)
Locale に関連付けられた boolean 値を返します。キーが見つからない場合、またはキーが boolean 値で表されていない場合、false が返されます。
key - 目的の boolean 値のキーを指定する Objectl - その boolean 値が適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
NullPointerException - key が null の場合public static Insets getInsets(Object key)
Insets オブジェクトを返します。key の値が Insets でない場合、null が返されます。
key - Insets オブジェクトを指定する Object
Insets オブジェクト
NullPointerException - key が null の場合
public static Insets getInsets(Object key,
Locale l)
Insets オブジェクトを返します。key の値が Insets でない場合、null が返されます。
key - Insets オブジェクトを指定する Objectl - そのオブジェクトが適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Insets オブジェクト
NullPointerException - key が null の場合public static Dimension getDimension(Object key)
key の値が Dimension でない場合、null が返されます。
key - 寸法オブジェクトを指定する Object
Dimension オブジェクト
NullPointerException - key が null の場合
public static Dimension getDimension(Object key,
Locale l)
key の値が Dimension でない場合、null が返されます。
key - 寸法オブジェクトを指定する Objectl - そのオブジェクトが適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Dimension オブジェクト
NullPointerException - key が null の場合public static Object get(Object key)
key - 目的のオブジェクトを指定する Object
Object
NullPointerException - key が null の場合
public static Object get(Object key,
Locale l)
key - 目的のオブジェクトを指定する Objectl - そのオブジェクトが適している Locale。Locale が null の場合の処理方法については、UIDefaults を参照
Object
NullPointerException - key が null の場合
public static Object put(Object key,
Object value)
getDefaults().put(key, value) のカバーメソッドです。このメソッドは、開発者のデフォルトだけに影響を及ぼします。システムのデフォルトや Look & Feel のデフォルトに影響はありません。
key - 検索キーを指定する Objectvalue - 格納する Object。null の場合の処理方法については UIDefaults を参照
UIDefaults.put(java.lang.Object, java.lang.Object) によって返された Object
NullPointerException - key が null の場合UIDefaults.put(java.lang.Object, java.lang.Object)public static ComponentUI getUI(JComponent target)
target に適した ComponentUI 実装を返します。通常これは、getDefaults().getUI(target) のカバーメソッドです。しかし、補助的な Look & Feel がインストールされている場合、このメソッドは、まず多重化した Look & Feel のデフォルト上で getUI(target) を呼び出し、null 以外 の値だった場合はその値を返します。
target - ComponentUI を返される JComponent
target の ComponentUI オブジェクト
NullPointerException - target が null の場合UIDefaults.getUI(javax.swing.JComponent)public static UIDefaults getLookAndFeelDefaults()
UIDefaults を返します。
通常、開発者は、getDefaults() から返される UIDefaults を使用するべきです。現在の Look & Feel は、特定の値の存在を求める可能性があります。このため、このメソッドから返される UIDefaults を変更すると、予期しない結果になる可能性があります。
UIDefaultsgetDefaults(),
setLookAndFeel(LookAndFeel),
LookAndFeel.getDefaults()public static void addAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel を補助的な Look & Feel のリストに追加します。補助的な Look & Feel は、多重化 UI の作成時にデフォルトの LookAndFeel クラスに加えて使用するコンポーネントインスタンスの LookAndFeel クラスを、多重化した Look & Feel に通知します。変更が有効になるのは、新しい UI クラスが作成されるときと、デフォルトの Look & Feel がコンポーネントインスタンスで変更されるときだけです。 これらはインストール済みの Look & Feel とは異なります。
laf - LookAndFeel オブジェクトremoveAuxiliaryLookAndFeel(javax.swing.LookAndFeel),
setLookAndFeel(javax.swing.LookAndFeel),
getAuxiliaryLookAndFeels(),
getInstalledLookAndFeels()public static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel を補助的な Look & Feel のリストから削除します。補助的な Look & Feel は、多重化 UI の作成時にデフォルトの LookAndFeel クラスに加えて使用するコンポーネントインスタンスの LookAndFeel クラスを、多重化した Look & Feel に通知します。変更が有効になるのは、新しい UI クラスが作成されるときと、デフォルトの Look & Feel がコンポーネントインスタンスで変更されるときだけです。 これらはインストール済みの Look & Feel とは異なります。
LookAndFeel がリストから削除された場合は trueremoveAuxiliaryLookAndFeel(javax.swing.LookAndFeel),
getAuxiliaryLookAndFeels(),
setLookAndFeel(javax.swing.LookAndFeel),
getInstalledLookAndFeels()public static LookAndFeel[] getAuxiliaryLookAndFeels()
null の場合もあります。補助的な Look & Feel は、多重化 UI の作成時にデフォルトの LookAndFeel クラスに加えて使用するコンポーネントインスタンスの LookAndFeel クラスを、多重化した Look & Feel に通知します。 これらはインストール済みの Look & Feel とは異なります。
LookAndFeel のリストまたは nulladdAuxiliaryLookAndFeel(javax.swing.LookAndFeel),
removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel),
setLookAndFeel(javax.swing.LookAndFeel),
getInstalledLookAndFeels()public static void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティーに対して登録されます。
listener - 追加する PropertyChangeListenerPropertyChangeSupportpublic static void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストから削除します。すべてのプロパティーに登録された PropertyChangeListener を削除します。
listener - 削除する PropertyChangeListenerPropertyChangeSupportpublic static PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener の配列を返します。
PropertyChangeListener、リスナーが追加されていない場合は
空の配列
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。