Класс 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. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими ту же версию Swing. Начиная с версии 1.4, добавлена поддержка длительного хранения всех JavaBeans в пакет java.beans. См. XMLEncoder.

С момента:

1.2

См. также:

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

Modifier and Type	Class	Description
`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	Description
`UIDefaults()`	Создает пустую таблицу значений по умолчанию.
`UIDefaults(int initialCapacity, float loadFactor)`	Создает пустую таблицу значений по умолчанию с указанной начальной емкостью и коэффициентом загрузки.
`UIDefaults(Object[] keyValueList)`	Создает таблицу значений по умолчанию, инициализированную указанными парами ключ/значение.

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

Modifier and Type	Method	Description
`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

См. также:

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

public void putDefaults(Object[] keyValueList)

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

Параметры:

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

См. также:

getFont

public Font getFont(Object key)

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

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

getFont

public Font getFont(Object key, Locale l)

Если значение key для заданного Locale является 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)

Если значение key для заданного Locale является 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)

Если значение key для заданного Locale является 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)

Если значение 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:

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

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:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

Parameters:

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

See Also:

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:

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:

setDefaultLocale

public void setDefaultLocale(Locale l)

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

Parameters:

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

Since:

1.4

See Also:

getDefaultLocale

public Locale getDefaultLocale()

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

Returns:

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

Since:

1.4

See Also:

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/UIDefaults.html