Класс UIDefaults

public class UIDefaults
extends Hashtable<Object,Object>

Таблица значений по умолчанию для компонентов Swing. Приложения могут устанавливать/получать значения по умолчанию через UIManager.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans™ в пакете java.beans. См. XMLEncoder.

Конструкторы

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", new Integer(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 является boolean, возвращается его булево значение, в противном случае возвращается false.

Параметры:

key - Object, определяющий ключ для требуемого булевого значения

Возвращает:

если значение key является boolean, возвращается его булево значение, в противном случае возвращается false.

С:

1.4

getBoolean

public boolean getBoolean(Object key,
                          Locale l)

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

Параметры:

key - Object, определяющий ключ для требуемого булевого значения

l - требуемый язык

Возвращает:

если значение для key и Locale является boolean, возвращается его булево значение, в противном случае возвращается 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)

Параметры:

uiClassID - строка, содержащая идентификатор класса

uiClassLoader - объект, который загрузит класс

Возвращает:

значение Class.forName(get(uidClassID))

См. также:

getUI(javax.swing.JComponent)

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID)

Возвращает класс L&F, который отображает этот компонент.

Параметры:

uiClassID - строка, содержащая идентификатор класса

Возвращает:

объект класса, возвращенный 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 - JComponent, которому нужен UI

Возвращает:

объект ComponentUI

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Параметры:

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(java.lang.String)

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)