Класс 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 | Модификатор и тип | Метод | Описание |
|---|---|---|
void |
clear() |
Очищает эту хеш-таблицу, удаляя из неё все ключи. |
Object |
clone() |
Создаёт поверхностную копию этой хеш-таблицы. |
Object |
compute |
Пытается вычислить соответствие для указанного ключа и его текущего сопоставленного значения либо null, если текущего соответствия нет (необязательная операция). |
Object |
computeIfAbsent |
Если указанному ключу ещё не сопоставлено значение (или ему сопоставлено null), пытается вычислить его значение с помощью указанной функции сопоставления и добавляет его в эту карту, если результат не равен null (необязательная операция). |
Object |
computeIfPresent |
Если для указанного ключа имеется ненулевое значение, пытается вычислить новое соответствие на основе ключа и его текущего сопоставленного значения (необязательная операция). |
boolean |
contains |
Проверяет, сопоставлен ли какой-либо ключ с указанным значением в этой хеш-таблице. |
boolean |
containsKey |
Проверяет, является ли указанный объект ключом в этой хеш-таблице. |
boolean |
containsValue |
Возвращает true, если эта хеш-таблица сопоставляет одному или нескольким ключам данное значение. |
Enumeration |
elements() |
Возвращает перечисление значений из этой хеш-таблицы. |
Set |
entrySet() |
Возвращает представление в виде Set соответствий, содержащихся в этой карте. |
boolean |
equals |
Сравнивает указанный объект с этой картой на равенство согласно определению в интерфейсе Map. |
int |
hashCode() |
Возвращает хеш-код этой карты согласно определению в интерфейсе Map. |
boolean |
isEmpty() |
Проверяет, не сопоставляет ли эта хеш-таблица ни одному ключу никаких значений. |
Enumeration |
keys() |
Возвращает перечисление ключей этой хеш-таблицы. |
Set |
keySet() |
Возвращает представление в виде Set ключей, содержащихся в этой карте. |
Object |
merge |
Если указанному ключу ещё не сопоставлено значение или ему сопоставлено null, сопоставляет его с указанным ненулевым значением (необязательная операция). |
void |
putAll |
Копирует все соответствия из указанной карты в эту хеш-таблицу. |
protected void |
rehash() |
Увеличивает ёмкость и внутренне реорганизует эту хеш-таблицу, чтобы повысить эффективность хранения и доступа к её записям. |
Object |
remove |
Удаляет ключ (и соответствующее ему значение) из этой хеш-таблицы. |
int |
size() |
Возвращает количество ключей в этой хеш-таблице. |
String |
toString() |
Возвращает строковое представление этого объекта Hashtable в виде набора записей, заключённых в фигурные скобки и разделённых символами ASCII " , " (запятая и пробел). |
Collection |
values() |
Возвращает представление в виде Collection значений, содержащихся в этой карте. |
Методы, объявленные в классе Object
finalize, getClass, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
finalize() |
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого объекта Object. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Переводит текущий поток в состояние ожидания до пробуждения, обычно вследствие вызова notify или interrupt. |
final void |
wait |
Переводит текущий поток в состояние ожидания до пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Переводит текущий поток в состояние ожидания до пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Методы, объявленные в интерфейсе Map
forEach, getOrDefault, putIfAbsent, remove, replace, replace, replaceAll | Модификатор и тип | Метод | Описание |
|---|---|---|
default void |
forEach |
Выполняет указанное действие для каждой записи этой карты, пока не будут обработаны все записи или пока действие не вызовет исключение. |
default Object |
getOrDefault |
Возвращает значение, сопоставленное указанному ключу, или defaultValue, если в этой карте нет соответствия для данного ключа. |
default Object |
putIfAbsent |
Если указанному ключу ещё не сопоставлено значение (или ему сопоставлено null), сопоставляет ему указанное значение и возвращает null; в противном случае возвращает текущее значение (необязательная операция). |
default boolean |
remove |
Удаляет запись для указанного ключа, только если в данный момент ему сопоставлено указанное значение (необязательная операция). |
default Object |
replace |
Заменяет запись для указанного ключа, только если в данный момент ему сопоставлено какое-либо значение (необязательная операция). |
default boolean |
replace |
Заменяет запись для указанного ключа, только если в данный момент ему сопоставлено указанное значение (необязательная операция). |
default void |
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 должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 1.4.- Параметры:
-
l— новая локаль по умолчанию - С версии:
- 1.4
- См. также:
getDefaultLocale
public Locale getDefaultLocale()
get, которые не принимают аргумент локали. Начиная с выпуска 1.4, объекты пользовательского интерфейса Swing должны получать локализованные значения, используя локаль своего компонента, а не локаль по умолчанию. Локаль по умолчанию существует для обеспечения совместимости с поведением до версии 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.