Класс 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, Сериализованная форма

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

Модификатор и тип Класс Описание
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 является булевым, возвращает булевое значение, иначе возвращает 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) должно быть именем класса, реализующего соответствующий класс 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 - коэффициент загрузки таблицы значений по умолчанию
Since:
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(java.lang.Object), getDefaultLocale(), addResourceBundle(java.lang.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(java.lang.Object), addResourceBundle(java.lang.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(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 является 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 - ключ, определяющий желаемое булевое значение
Возвращает:
Если значение key является булевым, вернуть булевое значение, иначе вернуть false.
С:
1.4

getBoolean

public boolean getBoolean(Object key,
                          Locale l)

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

Параметры:
key - ключ, определяющий желаемое булевое значение
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) должно быть именем класса, реализующего соответствующий класс ComponentUI. Если класс не был загружен ранее, этот метод ищет класс с помощью uiClassLoader.loadClass(), если предоставлен нестандартный null загрузчик классов, classForName() в противном случае.

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

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

Параметры:
uiClassID - строка, содержащая идентификатор класса
uiClassLoader - объект, который загрузит класс
Возвращает:
значение Class.forName(get(uidClassID))
См. также:
getUI(javax.swing.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(javax.swing.JComponent)

getUI

public ComponentUI getUI(JComponent target)

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

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

Параметры:
target - компонент, которому нужен 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 не равны, а список слушателей PropertyChangeEventx не пуст, то будет отправлено событие 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, не принимающие аргумент языка. Начиная с версии 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(java.util.Locale), get(Object), get(Object,Locale)

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

Spec-Zone .ru
спецификации, руководства, описания, API