Класс UIDefaults

java.lang.Object

java.util.Dictionary<K,V>

java.util.Hashtable<Object,Object>

javax.swing.UIDefaults

Все реализуемые интерфейсы:: Serializable, Cloneable, Map<Object,Object>

public class UIDefaults extends Hashtable<Object,Object>

Таблица значений по умолчанию для компонентов Swing. Приложения могут устанавливать/получать значения по умолчанию через UIManager.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. Пожалуйста, обратитесь к XMLEncoder.

С тех пор:

1.2

См. также:

UIManager

Краткое описание вложенных классов

Modifier and Type	Class	Описание
`static interface`	`UIDefaults.ActiveValue`	Этот класс позволяет хранить запись в таблице значений по умолчанию, которая создается каждый раз при ее поиске с помощью одного из методов `getXXX(key)`.
`static class`	`UIDefaults.LazyInputMap`	`LazyInputMap` создаст `InputMap` в своем методе `createValue`.
`static interface`	`UIDefaults.LazyValue`	Этот класс позволяет хранить запись в таблице значений по умолчанию, которая не создается до первого обращения к ней с помощью одного из методов `getXXX(key)`.
`static class`	`UIDefaults.ProxyLazyValue`	Этот класс предоставляет реализацию `LazyValue`, которая может использоваться для отложенной загрузки класса для создания экземпляра.

Краткое описание конструкторов

Constructor	Описание
`UIDefaults()`	Создает пустую таблицу значений по умолчанию.
`UIDefaults(int initialCapacity, float loadFactor)`	Создает пустую таблицу значений по умолчанию с указанной начальной емкостью и коэффициентом загрузки.
`UIDefaults(Object[] keyValueList)`	Создает таблицу значений по умолчанию, инициализированную указанными парами ключ/значение.

Краткое описание методов

Modifier and Type	Method	Описание
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет `PropertyChangeListener` в список прослушивателей.
`void`	`addResourceBundle(String bundleName)`	Добавляет пакет ресурсов в список пакетов ресурсов, которые просматриваются на наличие локализованных значений.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка отчетности об изменениях связанных свойств.
`Object`	`get(Object key)`	Возвращает значение для ключа.
`Object`	`get(Object key, Locale l)`	Возвращает значение для ключа, связанного с данной локалью.
`boolean`	`getBoolean(Object key)`	Если значение `key` является булевым, возвращает булево значение, иначе возвращает false.
`boolean`	`getBoolean(Object key, Locale l)`	Если значение `key` для данной `Locale` является булевым, возвращает булево значение, иначе возвращает false.
`Border`	`getBorder(Object key)`	Если значение `key` является `Border`, возвращает его, иначе возвращает `null`.
`Border`	`getBorder(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Border`, возвращает его, иначе возвращает `null`.
`Color`	`getColor(Object key)`	Если значение `key` является `Color`, возвращает его, иначе возвращает `null`.
`Color`	`getColor(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Color`, возвращает его, иначе возвращает `null`.
`Locale`	`getDefaultLocale()`	Возвращает локаль по умолчанию.
`Dimension`	`getDimension(Object key)`	Если значение `key` является `Dimension`, возвращает его, иначе возвращает `null`.
`Dimension`	`getDimension(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Dimension`, возвращает его, иначе возвращает `null`.
`Font`	`getFont(Object key)`	Если значение `key` является `Font`, возвращает его, иначе возвращает `null`.
`Font`	`getFont(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Font`, возвращает его, иначе возвращает `null`.
`Icon`	`getIcon(Object key)`	Если значение `key` является `Icon`, возвращает его, иначе возвращает `null`.
`Icon`	`getIcon(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Icon`, возвращает его, иначе возвращает `null`.
`Insets`	`getInsets(Object key)`	Если значение `key` является `Insets`, возвращает его, иначе возвращает `null`.
`Insets`	`getInsets(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Insets`, возвращает его, иначе возвращает `null`.
`int`	`getInt(Object key)`	Если значение `key` является `Integer`, возвращает его целочисленное значение, иначе возвращает 0.
`int`	`getInt(Object key, Locale l)`	Если значение `key` для данной `Locale` является `Integer`, возвращает его целочисленное значение, иначе возвращает 0.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех `PropertyChangeListener`, добавленных в этот UIDefaults с помощью addPropertyChangeListener().
`String`	`getString(Object key)`	Если значение `key` является `String`, возвращает его, иначе возвращает `null`.
`String`	`getString(Object key, Locale l)`	Если значение `key` для данной `Locale` является `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)` должно быть именем `String` класса, который реализует соответствующий класс `ComponentUI`.
`protected void`	`getUIError(String msg)`	Если `getUI()` завершается неудачно по какой-либо причине, он вызывает этот метод перед возвратом `null`.
`Object`	`put(Object key, Object value)`	Устанавливает значение `key` в `value` для всех локалей.
`void`	`putDefaults(Object[] keyValueList)`	Помещает все пары ключ/значение в базу данных и безусловно генерирует один `PropertyChangeEvent`.
`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)

Возвращает значение для ключа. Если значение является UIDefaults.LazyValue, то реальное значение вычисляется с помощью LazyValue.createValue(), запись в таблице заменяется, и возвращается реальное значение. Если значение является UIDefaults.ActiveValue, то запись в таблице не заменяется - значение вычисляется с помощью ActiveValue.createValue() для каждого вызова get(). Если ключ не найден в таблице, он ищется в списке наборов ресурсов, поддерживаемых этим объектом. Наборы ресурсов ищутся в порядке добавления, начиная с последнего добавленного, с использованием локали, возвращаемой getDefaultLocale. LazyValues и ActiveValues в наборах ресурсов не поддерживаются.

Определено в:

get в интерфейсе Map<Object,Object>

Переопределяет:

get в классе Hashtable<Object,Object>

Параметры:

key - желаемый ключ

Возвращает:

значение для key

С:

1.4

См. также:

get

public Object get(Object key, Locale l)

Возвращает значение для ключа, связанного с заданной локалью. Если значение является UIDefaults.LazyValue, то реальное значение вычисляется с помощью LazyValue.createValue(), запись в таблице заменяется, и возвращается реальное значение. Если значение является UIDefaults.ActiveValue, то запись в таблице не заменяется - значение вычисляется с помощью ActiveValue.createValue() для каждого вызова get(). Если ключ не найден в таблице, он ищется в списке наборов ресурсов, поддерживаемых этим объектом. Наборы ресурсов ищутся в порядке добавления, начиная с последнего добавленного, с использованием заданной локали. LazyValues и ActiveValues в наборах ресурсов не поддерживаются.

Параметры:

key - желаемый ключ

l - желаемая locale

Возвращает:

значение для key

С:

1.4

См. также:

put

public Object put(Object key, Object value)

Устанавливает значение key в value для всех локалей. Если key является строкой и новое значение не равно старому, запускается событие PropertyChangeEvent. Если значение null, ключ удаляется из таблицы.

Определено в:

put в интерфейсе Map<Object,Object>

Переопределяет:

put в классе Hashtable<Object,Object>

Параметры:

key - уникальный Object, значение которого будет использоваться для извлечения значения данных, связанного с ним

value - новое Object для хранения данных под этим ключом

Возвращает:

предыдущее значение Object, или null

См. также:

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

putDefaults

public void putDefaults(Object[] keyValueList)

Добавляет все пары ключ/значение в базу данных и безусловно генерирует одно PropertyChangeEvent. События oldValue и newValue будут null и его propertyName будет "UIDefaults". Пары ключ/значение добавляются для всех локалей.

Параметры:

keyValueList - массив пар ключ/значение

См. также:

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

getFont

public Font getFont(Object key)

Если значение key является шрифтом, вернуть его, иначе вернуть null.

Параметры:: key - желаемый ключ
Возвращает:: если значение для key является шрифтом, вернуть объект шрифта; иначе вернуть null

getFont

public Font getFont(Object key, Locale l)

Если значение key для заданной Locale является шрифтом, вернуть его, иначе вернуть null.

Параметры:: key - желаемый ключ; l - желаемая локали
Возвращает:: если значение для key и Locale является шрифтом, вернуть объект шрифта; иначе вернуть null
С:: 1.4

getColor

public Color getColor(Object key)

Если значение key является цветом, вернуть его, иначе вернуть null.

Параметры:: key - желаемый ключ
Возвращает:: если значение для key является цветом, вернуть объект цвета; иначе вернуть null

getColor

public Color getColor(Object key, Locale l)

Если значение key для заданной Locale является цветом, вернуть его, иначе вернуть null.

Параметры:: key - желаемый ключ; l - желаемая локали
Возвращает:: если значение для key и Locale является цветом, вернуть объект цвета; иначе вернуть null
С:: 1.4

getIcon

public Icon getIcon(Object key)

Если значение key является изображением, вернуть его, иначе вернуть null.

Параметры:: key - желаемый ключ
Возвращает:: если значение для key является изображением, вернуть объект изображения; иначе вернуть null

getIcon

public Icon getIcon(Object key, Locale l)

Если значение key для заданной Locale является изображением, вернуть его, иначе вернуть null.

Параметры:: key - желаемый ключ; l - желаемая локали
Возвращает:: если значение для key и Locale является изображением, вернуть объект изображения; иначе вернуть null
С:: 1.4

getBorder

public Border getBorder(Object key)

Если значение key является границей, вернуть её, иначе вернуть null.

Параметры:: key - желаемый ключ
Возвращает:: если значение для key является границей, вернуть объект границы; иначе вернуть null

getBorder

public Border getBorder(Object key, Locale l)

Если значение key для заданного Locale является Border, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ; l - желаемая локализация
Returns:: если значение для key и Locale является Border, вернуть объект Border; иначе вернуть null
Since:: 1.4

getString

public String getString(Object key)

Если значение key является String, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ
Returns:: если значение для key является String, вернуть объект String; иначе вернуть null

getString

public String getString(Object key, Locale l)

Если значение key для заданного Locale является String, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ; l - желаемая локализация
Returns:: если значение для key для данного Locale является String, вернуть объект String; иначе вернуть null
Since:: 1.4

getInt

public int getInt(Object key)

Если значение key является Integer, вернуть его целое значение, иначе вернуть 0.

Parameters:: key - желаемый ключ
Returns:: если значение для key является Integer, вернуть его значение, иначе вернуть 0

getInt

public int getInt(Object key, Locale l)

Если значение key для заданного Locale является Integer, вернуть его целое значение, иначе вернуть 0.

Parameters:: key - желаемый ключ; l - желаемая локализация
Returns:: если значение для key и Locale является Integer, вернуть его значение, иначе вернуть 0
Since:: 1.4

getBoolean

public boolean getBoolean(Object key)

Если значение key является булевым, вернуть булевое значение, иначе вернуть false.

Parameters:: key - Object, задающий ключ для желаемого булевого значения
Returns:: если значение key является булевым, вернуть булевое значение, иначе вернуть false.
Since:: 1.4

getBoolean

public boolean getBoolean(Object key, Locale l)

Если значение key для заданного Locale является булевым, вернуть булевое значение, иначе вернуть false.

Parameters:: key - Object, задающий ключ для желаемого булевого значения; l - желаемая локализация
Returns:: если значение для key и Locale является булевым, вернуть булевое значение, иначе вернуть false.
Since:: 1.4

getInsets

public Insets getInsets(Object key)

Если значение key является Insets, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ
Returns:: если значение для key является Insets, вернуть объект Insets; иначе вернуть null

getInsets

public Insets getInsets(Object key, Locale l)

Если значение key для заданного Locale является Insets, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ; l - желаемая локализация
Returns:: если значение для key и Locale является Insets, вернуть объект Insets; иначе вернуть null
Since:: 1.4

getDimension

public Dimension getDimension(Object key)

Если значение key является Dimension, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ
Returns:: если значение для key является Dimension, вернуть объект Dimension; иначе вернуть null

getDimension

public Dimension getDimension(Object key, Locale l)

Если значение key для заданного Locale является Dimension, вернуть его, иначе вернуть null.

Parameters:: key - желаемый ключ; l - желаемая локализация
Returns:: если значение для key и Locale является Dimension, вернуть объект Dimension; иначе вернуть null
Since:: 1.4

getUIClass

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

Значение get(uidClassID) должно быть именем класса, реализующим соответствующий класс ComponentUI. Если класс не был загружен ранее, этот метод ищет класс с помощью uiClassLoader.loadClass(), если предоставлен нестандартный загрузчик классов, classForName() в противном случае.

Если отображение для uiClassID существует или указанный класс не найден, вернуть null.

Этот метод используется getUI, обычно вызывать его напрямую не требуется.

Parameters:

uiClassID - строка, содержащая идентификатор класса

uiClassLoader - объект, который загрузит класс

Returns:

значение Class.forName(get(uidClassID))

See Also:

getUI(javax.swing.JComponent)

getUIClass

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

Возвращает класс L&F, который отрисовывает этот компонент.

Parameters:: uiClassID - строка, содержащая идентификатор класса
Returns:: объект Class, возвращаемый getUIClass(uiClassID, null)

getUIError

protected void getUIError(String msg)

Если getUI() по какой-либо причине завершается неудачно, этот метод вызывается перед возвратом null. Подклассы могут выбрать здесь сделать больше или меньше.

Parameters:

msg - строка сообщения для печати

See Also:

getUI(javax.swing.JComponent)

getUI

public ComponentUI getUI(JComponent target)

Создаёт реализацию ComponentUI для указанного компонента. Другими словами, создаёт объект делегата, специфичный для темы оформления target. Это делается в два этапа:

Найти имя класса реализации ComponentUI по значению, возвращаемому target.getUIClassID().
Используйте статический метод класса реализации createUI() для построения объекта делегата темы оформления.

Parameters:: target - JComponent, которому нужен UI
Returns:: объект ComponentUI

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет PropertyChangeListener в список слушателей. Слушатель регистрируется для всех свойств.

Событие PropertyChangeEvent будет срабатывать всякий раз, когда изменяется значение по умолчанию.

Parameters:

listener - добавляемый PropertyChangeListener

See Also:

PropertyChangeSupport

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет PropertyChangeListener из списка слушателей. Это удаляет PropertyChangeListener регистрации для всех свойств.

Parameters:

listener - удаляемый PropertyChangeListener

See Also:

PropertyChangeSupport

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех PropertyChangeListener добавленных к этому UIDefaults с помощью addPropertyChangeListener().

Returns:: все добавленные PropertyChangeListener или пустой массив, если слушатели не добавлены
Since:: 1.4

firePropertyChange

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

Поддержка отчёта о связанных изменениях свойств. Если oldValue и newValue не равны, и список слушателей PropertyChangeEventx не пуст, то для каждого слушателя генерируется событие PropertyChange.

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства

newValue - новое значение свойства

See Also:

PropertyChangeSupport

addResourceBundle

public void addResourceBundle(String bundleName)

Добавляет набор ресурсов в список наборов ресурсов, которые просматриваются для поиска локализованных значений. Наборы ресурсов ищутся в обратном порядке их добавления, используя системный загрузчик классов system class loader. Другими словами, самый недавно добавленный набор ресурсов ищется первым.

Parameters:

bundleName - базовое имя добавляемого набора ресурсов

Since:

1.4

See Also:

removeResourceBundle

public void removeResourceBundle(String bundleName)

Удаляет набор ресурсов из списка наборов ресурсов, которые просматриваются для поиска локализованных значений по умолчанию.

Parameters:

bundleName - базовое имя удаляемого набора ресурсов

Since:

1.4

See Also:

ResourceBundle
addResourceBundle(java.lang.String)

setDefaultLocale

public void setDefaultLocale(Locale l)

Устанавливает локаль по умолчанию. Локаль по умолчанию используется при получении локализованных значений через методы get, которые не принимают аргумент локали. Начиная с версии 1.4, объекты Swing UI должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.

Parameters:

l - новая локаль по умолчанию

Since:

1.4

See Also:

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

getDefaultLocale

public Locale getDefaultLocale()

Возвращает локаль по умолчанию. Локаль по умолчанию используется при получении локализованных значений через методы get, которые не принимают аргумент локали. Начиная с версии 1.4, объекты Swing UI должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.

Returns:

локаль по умолчанию

Since:

1.4

See Also:

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/UIDefaults.html