Класс 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 - желаемый Locale
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 - ключ, определяющий искомое булевое значение
Returns:: если значение key является булевым, возвращается это значение, в противном случае возвращается false.
Since:: 1.4

getBoolean

public boolean getBoolean(Object key, Locale l)

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

Parameters:: key - ключ, определяющий искомое булевое значение; 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 не равны, и список слушателей PropertyChangeEvent не пуст, то для каждого слушателя генерируется событие PropertyChange.

Parameters:

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

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

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

See Also:

addResourceBundle

public void addResourceBundle(String bundleName)

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

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)

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

Parameters:

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

Since:

1.4

See Also:

getDefaultLocale

public Locale getDefaultLocale()

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

Returns:

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

Since:

1.4

See Also:

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/UIDefaults.html