モジュール java.desktop

パッケージ javax.swing

クラスUIDefaults

java.lang.Object

java.util.Dictionary<Object,Object>

java.util.Hashtable<Object,Object>

javax.swing.UIDefaults

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

Serializable, Cloneable, Map<Object,Object>

public class UIDefaults extends Hashtable<Object,Object>

Swingコンポーネントのデフォルト値のテーブルです。 アプリケーションはUIManagerを使用してデフォルト値を設定または取得できます。

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

導入されたバージョン:

1.2

関連項目:

• UIManager

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
static interface	UIDefaults.ActiveValue	このクラスを使うと、getXXX(key)メソッドで検索されるたびに構築されるデフォルトのテーブルにエントリを格納できます。
static class	UIDefaults.LazyInputMap	LazyInputMapは、createValueメソッドでInputMapを作成します。
static interface	UIDefaults.LazyValue	このクラスを使うと、getXXX(key)メソッドではじめて検索されるまで構築されないデフォルトのテーブルにエントリを格納できます。
static class	UIDefaults.ProxyLazyValue	このクラスは、生成されるインスタンスのClassのロードを遅延させるLazyValueの実装を提供します。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
UIDefaults()	空のデフォルト・テーブルを作成します。
UIDefaults(int initialCapacity, float loadFactor)	指定された初期容量と負荷係数で空のデフォルト・テーブルを作成します。
UIDefaults(Object[] keyValueList)	指定されたキーと値のペアを使用して初期化したデフォルト値のテーブルを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addPropertyChangeListener(PropertyChangeListener listener)	リスナー・リストにPropertyChangeListenerを追加します。
void	addResourceBundle(String bundleName)	ローカライズされた値を検索するためのリソース・バンドルのリストに、リソース・バンドルを追加します。
protected void	firePropertyChange(String propertyName, Object oldValue, Object newValue)	バウンド・プロパティの変更の報告をサポートします。
Object	get(Object key)	keyの値を返します。
Object	get(Object key, Locale l)	指定されたロケールに関連付けられたkeyの値を返します。
boolean	getBoolean(Object key)	keyの値がbooleanの場合はそのboolean値を返し、それ以外の場合はfalseを返します。
boolean	getBoolean(Object key, Locale l)	指定のLocaleのkeyの値がbooleanの場合はそのboolean値を返し、それ以外の場合はfalseを返します。
Border	getBorder(Object key)	keyの値がBorderである場合はそれを返し、それ以外の場合はnullを返します。
Border	getBorder(Object key, Locale l)	指定されたLocaleのkeyの値がBorderである場合はそれを返し、それ以外の場合はnullを返します。
Color	getColor(Object key)	keyの値がColorである場合はそれを返し、それ以外の場合はnullを返します。
Color	getColor(Object key, Locale l)	指定されたLocaleのkeyの値がColorである場合はそれを返し、それ以外の場合はnullを返します。
Locale	getDefaultLocale()	デフォルトのロケールを返します。
Dimension	getDimension(Object key)	keyの値がDimensionである場合はそれを返し、それ以外の場合はnullを返します。
Dimension	getDimension(Object key, Locale l)	指定されたLocaleのkeyの値がDimensionである場合はそれを返し、それ以外の場合はnullを返します。
Font	getFont(Object key)	keyの値がFontである場合はそれを返し、それ以外の場合はnullを返します。
Font	getFont(Object key, Locale l)	指定されたLocaleのkeyの値がFontである場合はそれを返し、それ以外の場合はnullを返します。
Icon	getIcon(Object key)	keyの値がIconである場合はそれを返し、それ以外の場合はnullを返します。
Icon	getIcon(Object key, Locale l)	指定されたLocaleのkeyの値がIconである場合はそれを返し、それ以外の場合はnullを返します。
Insets	getInsets(Object key)	keyの値がInsetsである場合はそれを返し、それ以外の場合はnullを返します。
Insets	getInsets(Object key, Locale l)	指定されたLocaleのkeyの値がInsetsである場合はそれを返し、それ以外の場合はnullを返します。
int	getInt(Object key)	keyの値がIntegerの場合はその整数値を返し、それ以外の場合は0を返します。
int	getInt(Object key, Locale l)	指定のLocaleのkeyの値がIntegerの場合はその整数値を返し、それ以外の場合は0を返します。
PropertyChangeListener[]	getPropertyChangeListeners()	addPropertyChangeListener()を使用してこのUIDefaultsに追加されたすべてのPropertyChangeListenerの配列を返します。
String	getString(Object key)	keyの値がStringである場合はそれを返し、それ以外の場合はnullを返します。
String	getString(Object key, Locale l)	指定されたLocaleのkeyの値がStringである場合はそれを返し、それ以外の場合はnullを返します。
ComponentUI	getUI(JComponent target)	指定されたコンポーネントのComponentUIの実装を作成します。
Class<? extends ComponentUI>	getUIClass(String uiClassID)	このコンポーネントをレンダリングするL&Fクラスを返します。
Class<? extends ComponentUI>	getUIClass(String uiClassID, ClassLoader uiClassLoader)	get(uidClassID)の値は、対応するComponentUIクラスを実装するクラスのString名でなければいけません。
protected void	getUIError(String msg)	getUI()がなんらかの理由で失敗した場合、nullを返す前にこのメソッドを呼び出します。
Object	put(Object key, Object value)	すべてのロケールについて、keyの値をvalueに設定します。
void	putDefaults(Object[] keyValueList)	キーと値のペアをすべてデータベースに格納し、無条件にPropertyChangeEventを1つ生成します。
void	removePropertyChangeListener(PropertyChangeListener listener)	PropertyChangeListenerをリスナー・リストから削除します。
void	removeResourceBundle(String bundleName)	ローカライズされたデフォルトを検索するためのリソース・バンドルのリストから、リソース・バンドルを削除します。
void	setDefaultLocale(Locale l)	デフォルトのロケールを設定します。

クラスjava.util.Hashtableで宣言されたメソッド

clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, hashCode, isEmpty, keys, keySet, merge, putAll, rehash, remove, size, toString, values

クラスjava.lang.Objectで宣言されたメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェースjava.util.Mapで宣言されたメソッド

forEach, getOrDefault, putIfAbsent, remove, replace, replace, replaceAll

コンストラクタの詳細

UIDefaults

public UIDefaults()

空のデフォルト・テーブルを作成します。

UIDefaults

public UIDefaults(int initialCapacity, float loadFactor)

指定された初期容量と負荷係数で空のデフォルト・テーブルを作成します。

パラメータ:

initialCapacity - デフォルト・テーブルの初期容量

loadFactor - デフォルト・テーブルの負荷係数

導入されたバージョン:

1.6

関連項目:

• Hashtable

UIDefaults

public UIDefaults(Object[] keyValueList)

指定されたキーと値のペアを使用して初期化したデフォルト値のテーブルを作成します。 たとえば:

        Object[] uiDefaults = {
             "Font", new Font("Dialog", Font.BOLD, 12),
            "Color", Color.red,
             "five", Integer.valueOf(5)
        }
        UIDefaults myDefaults = new UIDefaults(uiDefaults);
 

パラメータ:

keyValueList - キーと値のペアを格納するオブジェクトの配列

メソッドの詳細

get

public Object get(Object key)

keyの値を返します。 値がUIDefaults.LazyValueの場合、実際の値がLazyValue.createValue()を使用して計算され、表のエントリを置換した後、計算された実際の値が返されます。 値がUIDefaults.ActiveValueの場合、表のエントリは置換されません。値は、get()呼出しごとにActiveValue.createValue()を使用して計算されます。 キーが表で見つからなかった場合、このオブジェクトが保持するリソース・バンドルのリストが検索されます。 リソース・バンドルは、getDefaultLocaleによって返されたロケールを使用して、もっとも新しく追加されたものから順に検索されます。 LazyValuesとActiveValuesはリソース・バンドルではサポートされていません。

定義:

インタフェースMap<Object,Object>内のget

オーバーライド:

クラスHashtable<Object,Object>のget

パラメータ:

key - 目的のキー

戻り値:

keyの値

導入されたバージョン:

1.4

関連項目:

• UIDefaults.LazyValue
• UIDefaults.ActiveValue
• Hashtable.get(java.lang.Object)
• getDefaultLocale()
• addResourceBundle(java.lang.String)

get

public Object get(Object key, Locale l)

指定されたロケールに関連付けられたkeyの値を返します。 値がUIDefaults.LazyValueの場合、実際の値がLazyValue.createValue()を使用して計算され、表のエントリを置換した後、計算された実際の値が返されます。 値がUIDefaults.ActiveValueの場合、表のエントリは置換されません。値は、get()呼出しごとにActiveValue.createValue()を使用して計算されます。 キーが表で見つからなかった場合、このオブジェクトが保持するリソース・バンドルのリストが検索されます。 リソース・バンドルは、指定されたロケールを使用して、もっとも新しく追加されたものから順に検索されます。 LazyValuesとActiveValuesはリソース・バンドルではサポートされていません。

パラメータ:

key - 目的のキー

l - 目的のlocale

戻り値:

keyの値

導入されたバージョン:

1.4

関連項目:

• UIDefaults.LazyValue
• UIDefaults.ActiveValue
• Hashtable.get(java.lang.Object)
• addResourceBundle(java.lang.String)

put

public Object put(Object key, Object value)

すべてのロケールについて、keyの値をvalueに設定します。 keyが文字列で新しい値が古い値と等しくない場合は、PropertyChangeEventをトリガーします。 値がnullの場合、キーはテーブルから削除されます。

定義:

インタフェースMap<Object,Object>内のput

オーバーライド:

クラスHashtable<Object,Object>のput

パラメータ:

key - 一意のObject。このオブジェクトの値を使って、オブジェクトに関連付けられたデータ値を取得する

value - キーの下のデータとして格納される新規Object

戻り値:

直前のObject値、またはnull

関連項目:

• putDefaults(java.lang.Object[])
• Hashtable.put(K, V)

putDefaults

public void putDefaults(Object[] keyValueList)

キーと値のペアをすべてデータベースに格納し、無条件にPropertyChangeEventを1つ生成します。 oldValueイベントとnewValueイベントはnullになり、propertyNameは「UIDefaults」になります。 すべてのロケールについて、キーと値のペアが追加されます。

パラメータ:

keyValueList - キーと値のペアの配列

関連項目:

• put(java.lang.Object, java.lang.Object)
• Hashtable.put(K, V)

getFont

public Font getFont(Object key)

keyの値がFontである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がFontの場合、Fontオブジェクトを返す。それ以外の場合はnullを返す

getFont

public Font getFont(Object key, Locale l)

指定されたLocaleのkeyの値がFontである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がFontの場合、Fontオブジェクトを返す。それ以外の場合はnullを返す

導入されたバージョン:

1.4

getColor

public Color getColor(Object key)

keyの値がColorである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がColorの場合、Colorオブジェクトを返す。それ以外の場合はnullを返す

getColor

public Color getColor(Object key, Locale l)

指定されたLocaleのkeyの値がColorである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がColorの場合、Colorオブジェクトを返す。それ以外の場合はnullを返す

導入されたバージョン:

1.4

getIcon

public Icon getIcon(Object key)

keyの値がIconである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がIconの場合はIconオブジェクトを返す。それ以外の場合はnullを返す

getIcon

public Icon getIcon(Object key, Locale l)

指定されたLocaleのkeyの値がIconである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がIconの場合はIconオブジェクトを返す。それ以外の場合はnullを返す

導入されたバージョン:

1.4

getBorder

public Border getBorder(Object key)

keyの値がBorderである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がBorderの場合、Borderオブジェクトを返す。それ以外の場合はnullを返す

getBorder

public Border getBorder(Object key, Locale l)

指定されたLocaleのkeyの値がBorderである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がBorderの場合、Borderオブジェクトを返す。それ以外の場合はnullを返す

導入されたバージョン:

1.4

getString

public String getString(Object key)

keyの値がStringである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がStringの場合、Stringオブジェクトを返す。それ以外の場合はnullを返す

getString

public String getString(Object key, Locale l)

指定されたLocaleのkeyの値がStringである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のLocale

戻り値:

指定のLocaleのkeyの値がStringの場合はStringオブジェクト、そうでない場合はnullを返す

導入されたバージョン:

1.4

getInt

public int getInt(Object key)

keyの値がIntegerの場合はその整数値を返し、それ以外の場合は0を返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がIntegerの場合はその値、そうでない場合は0を返す

getInt

public int getInt(Object key, Locale l)

指定のLocaleのkeyの値がIntegerの場合はその整数値を返し、それ以外の場合は0を返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がIntegerの場合はその値、そうでない場合は0を返す

導入されたバージョン:

1.4

getBoolean

public boolean getBoolean(Object key)

keyの値がbooleanの場合はそのboolean値を返し、それ以外の場合はfalseを返します。

パラメータ:

key - 目的のboolean値のキーを指定するObject

戻り値:

keyの値がbooleanの場合はそのboolean値を返し、それ以外の場合はfalseを返します。

導入されたバージョン:

1.4

getBoolean

public boolean getBoolean(Object key, Locale l)

指定のLocaleのkeyの値がbooleanの場合はそのboolean値を返し、それ以外の場合はfalseを返します。

パラメータ:

key - 目的のboolean値のキーを指定するObject

l - 目的のロケール

戻り値:

keyとLocaleの値がbooleanの場合はそのboolean値、そうでない場合はfalseを返す。

導入されたバージョン:

1.4

getInsets

public Insets getInsets(Object key)

keyの値がInsetsである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がInsetsの場合はInsetsオブジェクトを返す。それ以外の場合はnullを返す

getInsets

public Insets getInsets(Object key, Locale l)

指定されたLocaleのkeyの値がInsetsである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がInsetsの場合はInsetsオブジェクトを返す。それ以外の場合はnullを返す

導入されたバージョン:

1.4

getDimension

public Dimension getDimension(Object key)

keyの値がDimensionである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

戻り値:

keyの値がDimensionの場合、Dimensionオブジェクトを返す。それ以外の場合はnullを返す

getDimension

public Dimension getDimension(Object key, Locale l)

指定されたLocaleのkeyの値がDimensionである場合はそれを返し、それ以外の場合はnullを返します。

パラメータ:

key - 目的のキー

l - 目的のロケール

戻り値:

keyとLocaleの値がDimensionの場合、Dimensionオブジェクトを返す。それ以外の場合はnullを返す

導入されたバージョン:

1.4

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID, ClassLoader uiClassLoader)

get(uidClassID)の値は、対応するComponentUIクラスを実装するクラスのString名でなければいけません。 クラスがそれ以前にロードされていない場合、null以外のクラス・ローダーが提供されていればこのメソッドはクラスをuiClassLoader.loadClass()でルックアップし、そうでなければclassForName()でルックアップします。

uiClassIDのマッピングが存在する場合や、指定されたクラスが見つからない場合は、nullを返します。

このメソッドはgetUIによって使用されます。通常は、このメソッドを直接呼び出す必要はありません。

パラメータ:

uiClassID - クラスIDが格納されている文字列

uiClassLoader - クラスをロードするオブジェクト

戻り値:

Class.forName(get(uidClassID))の値

関連項目:

• getUI(javax.swing.JComponent)

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID)

このコンポーネントをレンダリングするL&Fクラスを返します。

パラメータ:

uiClassID - クラスIDが格納されている文字列

戻り値:

getUIClass(uiClassID, null)によって返されるClassオブジェクト

getUIError

protected void getUIError(String msg)

getUI()がなんらかの理由で失敗した場合、nullを返す前にこのメソッドを呼び出します。 サブクラスによって、処理を追加したり省略したりできます。

パラメータ:

msg - 出力するメッセージ文字列

関連項目:

• getUI(javax.swing.JComponent)

getUI

public ComponentUI getUI(JComponent target)

指定されたコンポーネントのComponentUIの実装を作成します。 つまり、targetのルック・アンド・フィールの特定の委譲オブジェクトを作成します。 これは、次の2つのステップで実行されます。

• target.getUIClassID()によって返される値からComponentUIの実装クラスの名前をルックアップする。
• 実装クラスstaticメソッドcreateUI()を使って、ルック・アンド・フィールの委譲を構築する。

パラメータ:

target - UIを必要とするJComponent

戻り値:

ComponentUIオブジェクト

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

リスナー・リストにPropertyChangeListenerを追加します。 リスナーは、すべてのプロパティに対して登録されます。

PropertyChangeEventは、デフォルトが変更されるたびにトリガーされます。

パラメータ:

listener - 追加されるPropertyChangeListener

関連項目:

• PropertyChangeSupport

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListenerをリスナー・リストから削除します。 すべてのプロパティに登録されたPropertyChangeListenerを削除します。

パラメータ:

listener - 削除するPropertyChangeListener

関連項目:

• PropertyChangeSupport

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

addPropertyChangeListener()を使用してこのUIDefaultsに追加されたすべてのPropertyChangeListenerの配列を返します。

戻り値:

追加されたすべてのPropertyChangeListener。リスナーが追加されていない場合は空の配列

導入されたバージョン:

1.4

firePropertyChange

protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)

バウンド・プロパティの変更の報告をサポートします。 oldValueとnewValueが等しくなく、PropertyChangeEventリスナー・リストが空でない場合、各リスナーに対してPropertyChangeイベントをトリガーします。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの古い値

newValue - プロパティの新しい値

関連項目:

• PropertyChangeSupport

addResourceBundle

public void addResourceBundle(String bundleName)

ローカライズされた値を検索するためのリソース・バンドルのリストに、リソース・バンドルを追加します。 リソース・バンドルは、「システム・クラス・ローダー」を使用して、追加された順序とは逆に検索されます。 つまり、もっとも新しく追加されたリソース・バンドルが最初に検索されます。

パラメータ:

bundleName - 追加するリソース・バンドルのベース名

導入されたバージョン:

1.4

関連項目:

• ResourceBundle
• removeResourceBundle(java.lang.String)
• ResourceBundle.getBundle(String, Locale, ClassLoader)

removeResourceBundle

public void removeResourceBundle(String bundleName)

ローカライズされたデフォルトを検索するためのリソース・バンドルのリストから、リソース・バンドルを削除します。

パラメータ:

bundleName - 削除するリソース・バンドルのベース名

導入されたバージョン:

1.4

関連項目:

• ResourceBundle
• addResourceBundle(java.lang.String)

setDefaultLocale

public void setDefaultLocale(Locale l)

デフォルトのロケールを設定します。 getメソッドはロケール引数を使用しないため、getメソッドによってローカライズされた値を取得するときには、デフォルトのロケールが使用されます。 リリース1.4以降、Swing UIオブジェクトは、デフォルトのロケールではなくコンポーネントのロケールを使用して、ローカライズされた値を取得します。 デフォルトのロケールは、1.4よりも前のリリースとの互換性を提供するものです。

パラメータ:

l - 新しいデフォルトのロケール

導入されたバージョン:

1.4

関連項目:

• getDefaultLocale()
• get(Object)
• get(Object,Locale)

getDefaultLocale

public Locale getDefaultLocale()

デフォルトのロケールを返します。 getメソッドはロケール引数を使用しないため、getメソッドによってローカライズされた値を取得するときには、デフォルトのロケールが使用されます。 リリース1.4以降、Swing UIオブジェクトは、デフォルトのロケールではなくコンポーネントのロケールを使用して、ローカライズされた値を取得します。 デフォルトのロケールは、1.4よりも前のリリースとの互換性を提供するものです。

戻り値:

デフォルトのロケール

導入されたバージョン:

1.4

関連項目:

• setDefaultLocale(java.util.Locale)
• get(Object)
• get(Object,Locale)