Spec-Zone.ru › OpenJDK 25

Класс 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 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:
1.2
См. также:
  • UIManager

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

Модификатор и тип Класс Описание
static interface  UIDefaults.ActiveValue
Этот класс позволяет хранить в таблице значений по умолчанию запись, которая создаётся при каждом обращении к ней одним из методов getXXX(key).
static class  UIDefaults.LazyInputMap
LazyInputMap создаст InputMap в своём методе createValue.
static interface  UIDefaults.LazyValue
Этот класс позволяет хранить в таблице значений по умолчанию запись, которая создаётся только при первом обращении к ней одним из методов getXXX(key).
static class  UIDefaults.ProxyLazyValue
Этот класс предоставляет реализацию 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)
Возвращает значение для ключа.
Object get(Object key, Locale l)
Возвращает значение для ключа, связанного с указанной локалью.
boolean getBoolean(Object key)
Если значение key имеет тип boolean, возвращает это логическое значение; в противном случае возвращает false.
boolean getBoolean(Object key, Locale l)
Если значение key для указанной Locale имеет тип boolean, возвращает это логическое значение; в противном случае возвращает 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)
Задаёт локаль по умолчанию.

Методы, объявленные в классе Hashtable

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

Методы, объявленные в классе Object

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

Методы, объявленные в интерфейсе 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
См. также:
  • UIDefaults.LazyValue
  • UIDefaults.ActiveValue
  • Hashtable.get(Object)
  • getDefaultLocale()
  • addResourceBundle(String)

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
См. также:
  • UIDefaults.LazyValue
  • UIDefaults.ActiveValue
  • Hashtable.get(Object)
  • addResourceBundle(String)

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(Object[])
  • Hashtable.put(K, V)

putDefaults

public void putDefaults(Object[] keyValueList)
Помещает все пары ключ/значение в базу данных и безусловно генерирует одно событие PropertyChangeEvent. Значения oldValue и newValue события будут равны null, а его propertyName будет равно "UIDefaults". Пары ключ/значение добавляются для всех локалей.
Параметры:
keyValueList — массив пар ключ/значение
См. также:
  • put(Object, 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)
Если значение 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.
Параметры:
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)
Если значение key для указанной Locale является String, возвращает его, в противном случае возвращает null.
Параметры:
key — требуемый ключ
l — требуемая локаль Locale
Возвращает:
если значение для key для указанной Locale является 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)
Если значение key для указанной Locale является Integer, возвращает его целочисленное значение, в противном случае возвращает 0.
Параметры:
key — требуемый ключ
l — требуемая локаль
Возвращает:
если значение для key и Locale является Integer, возвращает его значение, в противном случае возвращает 0
Начиная с версии:
1.4

getBoolean

public boolean getBoolean(Object key)
Если значение key имеет логический тип, возвращает логическое значение, в противном случае возвращает false.
Параметры:
key — Object, указывающий ключ требуемого логического значения
Возвращает:
если значение key имеет логический тип, возвращает логическое значение, в противном случае возвращает false.
Начиная с версии:
1.4

getBoolean

public boolean getBoolean(Object key, Locale l)
Если значение key для указанной Locale имеет логический тип, возвращает логическое значение, в противном случае возвращает false.
Параметры:
key — Object, указывающий ключ требуемого логического значения
l — требуемая локаль
Возвращает:
если значение для key и Locale имеет логический тип, возвращает логическое значение, в противном случае возвращает 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)
Если значение key для указанной Locale является 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)
Если значение key для указанной Locale является Dimension, возвращает его, в противном случае возвращает null.
Параметры:
key — требуемый ключ
l — требуемая локаль
Возвращает:
если значение для key и Locale является Dimension, возвращает объект Dimension; в противном случае возвращает null
Начиная с версии:
1.4

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID, ClassLoader uiClassLoader)
Значение get(uidClassID) должно быть String именем класса, реализующего соответствующий класс ComponentUI. Если класс ранее не загружался, этот метод ищет класс с помощью uiClassLoader.loadClass(), если предоставлен загрузчик классов, отличный от null, и с помощью classForName() в противном случае.

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

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

Параметры:
uiClassID — строка, содержащая идентификатор класса
uiClassLoader — объект, который загрузит класс
Возвращает:
значение Class.forName(get(uidClassID))
См. также:
  • getUI(JComponent)

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID)
Возвращает класс оформления и стиля (L&F), отвечающий за отображение этого компонента.
Параметры:
uiClassID — строка, содержащая идентификатор класса
Возвращает:
объект Class, возвращенный методом getUIClass(uiClassID, null)

getUIError

protected void getUIError(String msg)
Если getUI() по какой-либо причине завершается с ошибкой, перед возвратом null вызывается этот метод. Подклассы могут выполнять здесь больше или меньше действий.
Параметры:
msg — текст сообщения для вывода
См. также:
  • getUI(JComponent)

getUI

public ComponentUI getUI(JComponent target)
Создает реализацию ComponentUI для указанного компонента. Иными словами, создает объект делегата, специфичный для данного оформления и стиля, для target. Это выполняется в два этапа:
  • Находит имя класса реализации ComponentUI по значению, возвращаемому target.getUIClassID().
  • Использует статический метод createUI() класса реализации для создания делегата оформления и стиля.
Параметры:
target — JComponent, которому требуется UI
Возвращает:
объект 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()
Возвращает массив всех PropertyChangeListener, добавленных в этот UIDefaults с помощью addPropertyChangeListener().
Возвращает:
все добавленные 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(String)
  • ResourceBundle.getBundle(String, Locale, ClassLoader)

removeResourceBundle

public void removeResourceBundle(String bundleName)
Удаляет пакет ресурсов из списка пакетов, в которых выполняется поиск локализованных значений по умолчанию.
Параметры:
bundleName — базовое имя удаляемого пакета ресурсов
Начиная с версии:
1.4
См. также:
  • ResourceBundle
  • addResourceBundle(String)

setDefaultLocale

public void setDefaultLocale(Locale l)
Задает локаль по умолчанию. Локаль по умолчанию используется для получения локализованных значений с помощью методов get, не принимающих аргумент локали. Начиная с выпуска 1.4, объекты Swing UI должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.
Параметры:
l — новая локаль по умолчанию
Начиная с версии:
1.4
См. также:
  • getDefaultLocale()
  • get(Object)
  • get(Object,Locale)

getDefaultLocale

public Locale getDefaultLocale()
Возвращает локаль по умолчанию. Локаль по умолчанию используется для получения локализованных значений с помощью методов get, не принимающих аргумент локали. Начиная с выпуска 1.4, объекты Swing UI должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.
Возвращает:
локаль по умолчанию
Начиная с версии:
1.4
См. также:
  • setDefaultLocale(Locale)
  • get(Object)
  • get(Object,Locale)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/UIDefaults.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API