Класс UIDefaults
- Все реализованные интерфейсы:
Serializable, Cloneable, Map<Object,Object>
public class UIDefaults extends Hashtable<Object,Object>
UIManager. Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной версией Swing. Начиная с версии 1.4 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.
- Начиная с версии:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
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 |
Создаёт пустую таблицу значений по умолчанию с указанной начальной ёмкостью и коэффициентом загрузки. |
UIDefaults |
Создаёт таблицу значений по умолчанию, инициализированную указанными парами ключ/значение. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addPropertyChangeListener |
Добавляет PropertyChangeListener в список слушателей. |
void |
addResourceBundle |
Добавляет пакет ресурсов в список пакетов ресурсов, в которых выполняется поиск локализованных значений. |
protected void |
firePropertyChange |
Поддержка уведомления об изменениях связанных свойств. |
Object |
get |
Возвращает значение для ключа. |
Object |
get |
Возвращает значение для ключа, связанного с указанной локалью. |
boolean |
getBoolean |
Если значение key имеет тип boolean, возвращает это логическое значение; в противном случае возвращает false. |
boolean |
getBoolean |
Если значение key для указанной Locale имеет тип boolean, возвращает это логическое значение; в противном случае возвращает false. |
Border |
getBorder |
Если значение key имеет тип Border, возвращает его; в противном случае возвращает null. |
Border |
getBorder |
Если значение key для указанной Locale имеет тип Border, возвращает его; в противном случае возвращает null. |
Color |
getColor |
Если значение key имеет тип Color, возвращает его; в противном случае возвращает null. |
Color |
getColor |
Если значение key для указанной Locale имеет тип Color, возвращает его; в противном случае возвращает null. |
Locale |
getDefaultLocale() |
Возвращает локаль по умолчанию. |
Dimension |
getDimension |
Если значение key имеет тип Dimension, возвращает его; в противном случае возвращает null. |
Dimension |
getDimension |
Если значение key для указанной Locale имеет тип Dimension, возвращает его; в противном случае возвращает null. |
Font |
getFont |
Если значение key имеет тип Font, возвращает его; в противном случае возвращает null. |
Font |
getFont |
Если значение key для указанной Locale имеет тип Font, возвращает его; в противном случае возвращает null. |
Icon |
getIcon |
Если значение key имеет тип Icon, возвращает его; в противном случае возвращает null. |
Icon |
getIcon |
Если значение key для указанной Locale имеет тип Icon, возвращает его; в противном случае возвращает null. |
Insets |
getInsets |
Если значение key имеет тип Insets, возвращает его; в противном случае возвращает null. |
Insets |
getInsets |
Если значение key для указанной Locale имеет тип Insets, возвращает его; в противном случае возвращает null. |
int |
getInt |
Если значение key имеет тип Integer, возвращает его целочисленное значение; в противном случае возвращает 0. |
int |
getInt |
Если значение key для указанной Locale имеет тип Integer, возвращает его целочисленное значение; в противном случае возвращает 0. |
PropertyChangeListener[] |
getPropertyChangeListeners() |
Возвращает массив всех PropertyChangeListener, добавленных в этот UIDefaults с помощью addPropertyChangeListener(). |
String |
getString |
Если значение key имеет тип String, возвращает его; в противном случае возвращает null. |
String |
getString |
Если значение key для указанной Locale имеет тип String, возвращает его; в противном случае возвращает null. |
ComponentUI |
getUI |
Создаёт реализацию ComponentUI для указанного компонента. |
Class |
getUIClass |
Возвращает класс L&F, который отрисовывает этот компонент. |
Class |
getUIClass |
Значение get(uidClassID) должно быть String именем класса, реализующего соответствующий класс ComponentUI. |
protected void |
getUIError |
Если getUI() завершается неудачей по какой-либо причине, этот метод вызывается перед возвратом null. |
Object |
put |
Задаёт значение key равным value для всех локалей. |
void |
putDefaults |
Помещает все пары ключ/значение в базу данных и безусловно генерирует одно событие PropertyChangeEvent. |
void |
removePropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей. |
void |
removeResourceBundle |
Удаляет пакет ресурсов из списка пакетов ресурсов, в которых выполняется поиск локализованных значений по умолчанию. |
void |
setDefaultLocale |
Задаёт локаль по умолчанию. |
Методы, объявленные в классе Hashtable
clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, hashCode, isEmpty, keys, keySet, merge, putAll, rehash, remove, size, toString, values
Методы, объявленные в интерфейсе 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
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.- Параметры:
-
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)) - См. также:
getUIClass
public Class<? extends ComponentUI> getUIClass(String uiClassID)
- Параметры:
-
uiClassID— строка, содержащая идентификатор класса - Возвращает:
- объект Class, возвращенный методом
getUIClass(uiClassID, null)
getUIError
protected void getUIError(String msg)
getUI() по какой-либо причине завершается с ошибкой, перед возвратом null вызывается этот метод. Подклассы могут выполнять здесь больше или меньше действий.- Параметры:
-
msg— текст сообщения для вывода - См. также:
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 - См. также:
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener из списка слушателей. При этом удаляется PropertyChangeListener, зарегистрированный для всех свойств.- Параметры:
-
listener— удаляемыйPropertyChangeListener - См. также:
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener, добавленных в этот UIDefaults с помощью addPropertyChangeListener().- Возвращает:
- все добавленные
PropertyChangeListenerили пустой массив, если слушатели не добавлялись - Начиная с версии:
- 1.4
firePropertyChange
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
PropertyChangeEvent не пуст, каждому слушателю отправляется событие PropertyChange.- Параметры:
-
propertyName— программное имя измененного свойства -
oldValue— старое значение свойства -
newValue— новое значение свойства - См. также:
addResourceBundle
public void addResourceBundle(String bundleName)
- Параметры:
-
bundleName— базовое имя добавляемого пакета ресурсов - Начиная с версии:
- 1.4
- См. также:
removeResourceBundle
public void removeResourceBundle(String bundleName)
- Параметры:
-
bundleName— базовое имя удаляемого пакета ресурсов - Начиная с версии:
- 1.4
- См. также:
setDefaultLocale
public void setDefaultLocale(Locale l)
get, не принимающих аргумент локали. Начиная с выпуска 1.4, объекты Swing UI должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.- Параметры:
-
l— новая локаль по умолчанию - Начиная с версии:
- 1.4
- См. также:
getDefaultLocale
public Locale getDefaultLocale()
get, не принимающих аргумент локали. Начиная с выпуска 1.4, объекты Swing UI должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.- Возвращает:
- локаль по умолчанию
- Начиная с версии:
- 1.4
- См. также:
© 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