Класс UIManager

java.lang.Object

javax.swing.UIManager

Все реализованные интерфейсы:: Serializable

public class UIManager extends Object implements Serializable

UIManager управляет текущим оформлением, набором доступных оформлений, PropertyChangeListeners, которые получают уведомления при изменении оформления, значениями по умолчанию для оформления и вспомогательными методами для получения различных значений по умолчанию.

Задание оформления

Оформление можно задать двумя разными способами: указав полное имя класса оформления или создав экземпляр LookAndFeel и передав его в setLookAndFeel. В следующем примере показано, как установить системное оформление:

  UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());

В следующем примере показано, как задать оформление по имени класса:

  UIManager.setLookAndFeel("javax.swing.plaf.metal.MetalLookAndFeel");

После изменения оформления необходимо вызвать updateUI для всех JComponents. Метод SwingUtilities.updateComponentTreeUI(Component) упрощает применение


updateUI

к иерархии контейнеров. Подробности см. в его описании. Точное поведение при невызове


updateUI

после изменения оформления не определено. Вполне возможно возникновение неожиданных исключений, проблем с отрисовкой или чего-то худшего.

Оформление по умолчанию

Класс, используемый для оформления по умолчанию, выбирается следующим образом:

Если системное свойство swing.defaultlaf имеет значение non-null, его значение используется как имя класса оформления по умолчанию.
Если файл Properties swing.properties существует и содержит ключ swing.defaultlaf, его значение используется как имя класса оформления по умолчанию. Расположение, в котором выполняется поиск swing.properties, может различаться в зависимости от реализации платформы Java. Обычно файл swing.properties находится в подкаталоге conf каталога установки Java. Дополнительные сведения см. в примечаниях к выпуску используемой реализации.
В противном случае используется кроссплатформенное оформление.

Значения по умолчанию

UIManager управляет тремя наборами UIDefaults. В следующем порядке это:

Значения разработчика. За редкими исключениями Swing не изменяет значения разработчика; они предназначены для изменения и использования разработчиком.
Значения оформления. Значения оформления предоставляются самим оформлением в момент его установки в качестве текущего (вызывается setLookAndFeel()). Получить значения оформления можно с помощью метода getLookAndFeelDefaults().
Системные значения. Системные значения предоставляются Swing.

Вызов любого из различных методов get приводит к последовательной проверке каждого набора значений с возвратом первого значения non-null. Например, вызов UIManager.getString("Table.foreground") сначала проверяет значения разработчика. Если значения разработчика содержат значение для "Table.foreground", оно возвращается; в противном случае проверяются значения оформления, а затем системные значения.

Важно отметить, что getDefaults возвращает пользовательский экземпляр UIDefaults со встроенной логикой разрешения значений. Например, UIManager.getDefaults().getString("Table.foreground") эквивалентно UIManager.getString("Table.foreground"). В обоих случаях применяется описанный алгоритм. Во многих местах документации под значениями по умолчанию подразумевается пользовательский экземпляр UIDefaults с описанной выше логикой разрешения.

При изменении оформления UIManager изменяет только значения оформления; UIManager никак не изменяет значения разработчика и системные значения.

Набор значений, поддерживаемых конкретным оформлением, определяется и документируется самим оформлением. Кроме того, каждое оформление или ComponentUI, предоставляемый оформлением, может обращаться к значениям в разные моменты своего жизненного цикла. Некоторые оформления активно ищут значения по умолчанию, поэтому изменение значения может не повлиять на оформление после его установки. Другие оформления могут обращаться к значениям по умолчанию только при необходимости, поэтому изменение значений может повлиять на уже существующее оформление. Наконец, некоторые оформления могут вообще не настраиваться на основе таблицы значений по умолчанию. Тем не менее оформление обычно ожидает наличия определённых значений по умолчанию, поэтому, как правило, ComponentUI, предоставляемый одним оформлением, не будет работать с другим оформлением.

Системные оформления

[В данном контексте термины «системный», «нативный» и «платформенный» могут использоваться как синонимы].

Системное оформление предназначено для реализации нативного оформления рабочего стола.

Стандартное оформление Java не обязательно должно быть оформлением по умолчанию, поэтому по умолчанию может использоваться системное оформление.

Оформление рабочего стола может быть непоследовательным, например, если для создания приложений рабочего стола доступны несколько платформенно-нативных инструментальных средств. Swing может выбрать любое из них в качестве нативного оформления.

Установка нативного оформления может зависеть от наличия ресурсов платформы. Если необходимые ресурсы недоступны, Swing может оказаться не в состоянии установить системное оформление.

Эмуляция Swing нативного оформления имеет приоритет над указаниями по отрисовке для отдельных компонентов. Это означает, что нативное оформление должно отрисовывать компоненты в соответствии с платформой, даже если это противоречит документации по настройкам конкретного компонента. Например:

указания по отрисовке рисуемых границ могут игнорироваться
указания по отрисовке эффектов подсветки могут игнорироваться
указания по отрисовке рисуемого фона и переднего плана могут игнорироваться
указания по отрисовке выбранных и невыбранных компонентов могут игнорироваться
указания по отрисовке включённых и отключённых компонентов могут игнорироваться

Это лишь примеры, а не исчерпывающий список.

Эти оговорки не следует рассматривать как оправдание произвольного игнорирования таких свойств. Они призваны обеспечить соответствие оформления платформы нативной отрисовке в максимально возможной степени.

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

Начиная с:: 1.2

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

Модификатор и тип	Класс	Описание
`static class`	`UIManager.LookAndFeelInfo`	Предоставляет краткую информацию об установленном `LookAndFeel` для настройки меню или первоначальной конфигурации приложения.

Краткое описание конструкторов

Конструктор	Описание
`UIManager()`	Создаёт `UIManager`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static void`	`addAuxiliaryLookAndFeel(LookAndFeel laf)`	Добавляет `LookAndFeel` в список вспомогательных оформлений.
`static void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет `PropertyChangeListener` в список слушателей.
`static LookAndFeel`	`createLookAndFeel(String name)`	Создаёт поддерживаемое встроенное оформление Java `LookAndFeel` с указанным именем `L&F name`.
`static Object`	`get(Object key)`	Возвращает объект из значений по умолчанию.
`static Object`	`get(Object key, Locale l)`	Возвращает объект из значений по умолчанию, соответствующий заданной локали.
`static LookAndFeel[]`	`getAuxiliaryLookAndFeels()`	Возвращает список вспомогательных оформлений (может быть `null`).
`static boolean`	`getBoolean(Object key)`	Возвращает логическое значение из набора значений по умолчанию, связанное со значением ключа.
`static boolean`	`getBoolean(Object key, Locale l)`	Возвращает логическое значение из набора значений по умолчанию, связанное со значением ключа и заданной `Locale`.
`static Border`	`getBorder(Object key)`	Возвращает границу из значений по умолчанию.
`static Border`	`getBorder(Object key, Locale l)`	Возвращает границу из значений по умолчанию, соответствующую заданной локали.
`static Color`	`getColor(Object key)`	Возвращает цвет из значений по умолчанию.
`static Color`	`getColor(Object key, Locale l)`	Возвращает цвет из значений по умолчанию, соответствующий заданной локали.
`static String`	`getCrossPlatformLookAndFeelClassName()`	Возвращает имя класса `LookAndFeel`, реализующего кроссплатформенное оформление по умолчанию — Java Look and Feel (JLF).
`static UIDefaults`	`getDefaults()`	Возвращает значения по умолчанию.
`static Dimension`	`getDimension(Object key)`	Возвращает размер из значений по умолчанию.
`static Dimension`	`getDimension(Object key, Locale l)`	Возвращает размер из значений по умолчанию, соответствующий заданной локали.
`static Font`	`getFont(Object key)`	Возвращает шрифт из значений по умолчанию.
`static Font`	`getFont(Object key, Locale l)`	Возвращает шрифт из значений по умолчанию, соответствующий заданной локали.
`static Icon`	`getIcon(Object key)`	Возвращает `Icon` из значений по умолчанию.
`static Icon`	`getIcon(Object key, Locale l)`	Возвращает `Icon` из значений по умолчанию, соответствующий заданной локали.
`static Insets`	`getInsets(Object key)`	Возвращает объект `Insets` из значений по умолчанию.
`static Insets`	`getInsets(Object key, Locale l)`	Возвращает объект `Insets` из значений по умолчанию, соответствующий заданной локали.
`static UIManager.LookAndFeelInfo[]`	`getInstalledLookAndFeels()`	Возвращает массив `LookAndFeelInfo`, представляющих доступные в данный момент реализации `LookAndFeel`.
`static int`	`getInt(Object key)`	Возвращает целое число из значений по умолчанию.
`static int`	`getInt(Object key, Locale l)`	Возвращает целое число из значений по умолчанию, соответствующее заданной локали.
`static LookAndFeel`	`getLookAndFeel()`	Возвращает текущее оформление или `null`.
`static UIDefaults`	`getLookAndFeelDefaults()`	Возвращает `UIDefaults` из текущего оформления, полученные в момент установки оформления.
`static PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех `PropertyChangeListener`, добавленных в этот UIManager с помощью addPropertyChangeListener().
`static String`	`getString(Object key)`	Возвращает строку из значений по умолчанию.
`static String`	`getString(Object key, Locale l)`	Возвращает строку из значений по умолчанию, соответствующую заданной локали.
`static String`	`getSystemLookAndFeelClassName()`	Возвращает имя класса `LookAndFeel`, реализующего нативное системное оформление, если оно существует; в противном случае возвращает имя класса `LookAndFeel` для кроссплатформенного оформления по умолчанию.
`static ComponentUI`	`getUI(JComponent target)`	Возвращает подходящую реализацию `ComponentUI` для `target`.
`static void`	`installLookAndFeel(String name, String className)`	Добавляет указанное оформление в набор доступных оформлений.
`static void`	`installLookAndFeel(UIManager.LookAndFeelInfo info)`	Добавляет указанное оформление в набор доступных оформлений.
`static Object`	`put(Object key, Object value)`	Сохраняет объект в значениях разработчика.
`static boolean`	`removeAuxiliaryLookAndFeel(LookAndFeel laf)`	Удаляет `LookAndFeel` из списка вспомогательных оформлений.
`static void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей.
`static void`	`setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)`	Задаёт набор доступных оформлений.
`static void`	`setLookAndFeel(String className)`	Загружает `LookAndFeel`, указанный заданным именем класса, с помощью загрузчика классов контекста текущего потока и передаёт его в `setLookAndFeel(LookAndFeel)`.
`static void`	`setLookAndFeel(LookAndFeel newLookAndFeel)`	Устанавливает `newLookAndFeel` в качестве текущего оформления.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

UIManager

public UIManager()

Создает UIManager.

Подробное описание методов

getInstalledLookAndFeels

public static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()

Возвращает массив LookAndFeelInfos, представляющих доступные в данный момент реализации LookAndFeel. Объекты LookAndFeelInfo можно использовать в приложении для создания меню вариантов оформления и стиля для пользователя или для определения оформления и стиля, которые следует установить при запуске. Чтобы избежать затрат на создание множества объектов


LookAndFeel

, LookAndFeelInfo хранит имя класса LookAndFeel, а не сам экземпляр LookAndFeel.

В следующем примере показано, как установить текущее оформление и стиль с помощью экземпляра LookAndFeelInfo:

  UIManager.setLookAndFeel(info.getClassName());

Возвращает:

массив объектов LookAndFeelInfo

См. также:

setInstalledLookAndFeels

public static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)

Устанавливает набор доступных вариантов оформления и стиля. Хотя этот метод не проверяет, что все LookAndFeelInfos являются non-null, настоятельно рекомендуется передавать в массиве infos только значения non-null.

Параметры:

infos — набор объектов LookAndFeelInfo, задающих доступные варианты оформления и стиля

Исключения:

NullPointerException — если infos — null

См. также:

installLookAndFeel

public static void installLookAndFeel(UIManager.LookAndFeelInfo info)

Добавляет указанный вариант оформления и стиля в набор доступных вариантов. Хотя этот метод допускает null info, настоятельно рекомендуется использовать значение non-null.

Параметры:

info — объект LookAndFeelInfo, задающий имя оформления и стиля и определяющий реализующий его класс

См. также:

installLookAndFeel

public static void installLookAndFeel(String name, String className)

Добавляет указанный вариант оформления и стиля в набор доступных вариантов. Хотя этот метод никак не проверяет аргументы, настоятельно рекомендуется передавать значения


non-null

Параметры:

name — описательное имя оформления и стиля

className — имя класса, реализующего оформление и стиль

См. также:

getLookAndFeel

public static LookAndFeel getLookAndFeel()

Возвращает текущее оформление и стиль или null.

Возвращает:

текущее оформление и стиль или null

См. также:

createLookAndFeel

public static LookAndFeel createLookAndFeel(String name) throws UnsupportedLookAndFeelException

Создает поддерживаемое встроенное оформление и стиль Java LookAndFeel, указанное именем L&F name.

Параметры:

name — String, задающее имя встроенного оформления и стиля

Возвращает:

встроенный объект LookAndFeel

Исключения:

NullPointerException — если name — null

UnsupportedLookAndFeelException — если встроенное оформление и стиль Java L&F не найдено для указанного имени или не поддерживается базовой платформой

Начиная с:

См. также:

setLookAndFeel

public static void setLookAndFeel(LookAndFeel newLookAndFeel) throws UnsupportedLookAndFeelException

Устанавливает newLookAndFeel в качестве текущего оформления и стиля. Если текущее оформление и стиль — non-null, для него вызывается


uninitialize

. Если newLookAndFeel — non-null, для него вызывается initialize, а затем getDefaults. Значения по умолчанию, возвращаемые


newLookAndFeel.getDefaults()

, заменяют значения по умолчанию предыдущего оформления и стиля. Если newLookAndFeel — null, значения оформления и стиля устанавливаются в null.

Для установки оформления и стиля в null можно использовать значение null. Поскольку для работы большинства компонентов Swing требуется LookAndFeel, настоятельно не рекомендуется устанавливать для LookAndFeel значение null.

Это связанное свойство JavaBeans.

Параметры:

newLookAndFeel — устанавливаемое LookAndFeel

Исключения:

UnsupportedLookAndFeelException — если newLookAndFeel — non-null и newLookAndFeel.isSupportedLookAndFeel() возвращает false

См. также:

setLookAndFeel

public static void setLookAndFeel(String className) throws ClassNotFoundException, InstantiationException, IllegalAccessException, UnsupportedLookAndFeelException

Загружает LookAndFeel, указанное именем класса, с помощью загрузчика классов контекста текущего потока и передает его в setLookAndFeel(LookAndFeel).

Параметры:: className — строка, задающая имя класса, реализующего оформление и стиль
Исключения:: ClassNotFoundException — если класс LookAndFeel не найден; InstantiationException — если не удалось создать новый экземпляр класса; IllegalAccessException — если класс или инициализатор недоступен; UnsupportedLookAndFeelException — если lnf.isSupportedLookAndFeel() имеет значение false; ClassCastException — если className не указывает на класс, расширяющий LookAndFeel; NullPointerException — если className — null

getSystemLookAndFeelClassName

public static String getSystemLookAndFeelClassName()

Возвращает имя класса LookAndFeel, реализующего собственное оформление и стиль системы, если оно существует; в противном случае возвращает имя класса оформления и стиля LookAndFeel, используемого по умолчанию на разных платформах. Это значение можно переопределить, задав системное свойство swing.systemlaf.

Возвращает:

String класса LookAndFeel

См. также:

getCrossPlatformLookAndFeelClassName

public static String getCrossPlatformLookAndFeelClassName()

Возвращает имя класса LookAndFeel, реализующего оформление и стиль по умолчанию для разных платформ — Java Look and Feel (JLF). Это значение можно переопределить, задав системное свойство swing.crossplatformlaf.

Возвращает:

строку с именем класса реализации JLF

См. также:

getDefaults

public static UIDefaults getDefaults()

Возвращает значения по умолчанию. При разрешении возвращенных значений используется логика, описанная в документации класса.

Возвращает:: объект UIDefaults, содержащий значения по умолчанию

getFont

public static Font getFont(Object key)

Возвращает шрифт из значений по умолчанию. Если значение для key не является Font, возвращается null.

Параметры:: key — Object, задающий шрифт
Возвращает:: объект Font
Исключения:: NullPointerException — если key — null

getFont

public static Font getFont(Object key, Locale l)

Возвращает из значений по умолчанию шрифт, подходящий для указанной локали. Если значение для key не является Font, возвращается null.

Параметры:: key — Object, задающий шрифт; l — Locale, для которой требуется шрифт; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: объект Font
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getColor

public static Color getColor(Object key)

Возвращает цвет из значений по умолчанию. Если значение для key не является Color, возвращается null.

Параметры:: key — Object, задающий цвет
Возвращает:: объект Color
Исключения:: NullPointerException — если key — null

getColor

public static Color getColor(Object key, Locale l)

Возвращает из значений по умолчанию цвет, подходящий для указанной локали. Если значение для key не является Color, возвращается null.

Параметры:: key — Object, задающий цвет; l — Locale, для которой требуется цвет; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: объект Color
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getIcon

public static Icon getIcon(Object key)

Возвращает Icon из значений по умолчанию. Если значение для key не является Icon, возвращается null.

Параметры:: key — Object, задающий значок
Возвращает:: объект Icon
Исключения:: NullPointerException — если key — null

getIcon

public static Icon getIcon(Object key, Locale l)

Возвращает из значений по умолчанию значок Icon, подходящий для указанной локали. Если значение для key не является Icon, возвращается null.

Параметры:: key — Object, задающий значок; l — Locale, для которой требуется значок; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: объект Icon
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getBorder

public static Border getBorder(Object key)

Возвращает границу из значений по умолчанию. Если значение для key не является Border, возвращается null.

Параметры:: key — Object, задающий границу
Возвращает:: объект Border
Исключения:: NullPointerException — если key — null

getBorder

public static Border getBorder(Object key, Locale l)

Возвращает из значений по умолчанию границу, подходящую для указанной локали. Если значение для key не является Border, возвращается null.

Параметры:: key — Object, задающий границу; l — Locale, для которой требуется граница; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: объект Border
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getString

public static String getString(Object key)

Возвращает строку из значений по умолчанию. Если значение для key не является String, возвращается null.

Параметры:: key — Object, задающий строку
Возвращает:: String
Исключения:: NullPointerException — если key — null

getString

public static String getString(Object key, Locale l)

Возвращает из значений по умолчанию строку, подходящую для указанной локали. Если значение для key не является String, возвращается null.

Параметры:: key — Object, задающий строку; l — Locale, для которой требуется строка; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: String
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getInt

public static int getInt(Object key)

Возвращает целое число из значений по умолчанию. Если значение для key не является Integer или отсутствует, возвращается 0.

Параметры:: key — Object, задающий целое число
Возвращает:: целое число
Исключения:: NullPointerException — если key — null

getInt

public static int getInt(Object key, Locale l)

Возвращает из значений по умолчанию целое число, подходящее для указанной локали. Если значение для key не является Integer или отсутствует, возвращается 0.

Параметры:: key — Object, задающий целое число; l — Locale, для которой требуется целое число; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: целое число
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getBoolean

public static boolean getBoolean(Object key)

Возвращает логическое значение из значений по умолчанию, соответствующее значению ключа. Если ключ не найден или не представляет логическое значение, возвращается false.

Параметры:: key — Object, задающий ключ искомого логического значения
Возвращает:: логическое значение, соответствующее ключу
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getBoolean

public static boolean getBoolean(Object key, Locale l)

Возвращает логическое значение из значений по умолчанию, соответствующее значению ключа и указанной Locale. Если ключ не найден или не представляет логическое значение, возвращается false.

Параметры:: key — Object, задающий ключ искомого логического значения; l — Locale, для которой требуется логическое значение; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: логическое значение, соответствующее ключу
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getInsets

public static Insets getInsets(Object key)

Возвращает объект Insets из значений по умолчанию. Если значение для key не является Insets, возвращается null.

Параметры:: key — Object, задающий объект Insets
Возвращает:: объект Insets
Исключения:: NullPointerException — если key — null

getInsets

public static Insets getInsets(Object key, Locale l)

Возвращает из значений по умолчанию объект Insets, подходящий для указанной локали. Если значение для key не является Insets, возвращается null.

Параметры:: key — Object, задающий объект Insets; l — Locale, для которой требуется объект; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: объект Insets
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

getDimension

public static Dimension getDimension(Object key)

Возвращает размер из значений по умолчанию. Если значение для key не является Dimension, возвращается null.

Параметры:: key — Object, задающий объект размера
Возвращает:: объект Dimension
Исключения:: NullPointerException — если key — null

getDimension

public static Dimension getDimension(Object key, Locale l)

Возвращает из значений по умолчанию размер, подходящий для указанной локали. Если значение для key не является Dimension, возвращается null.

Параметры:: key — Object, задающий объект размера; l — Locale, для которой требуется объект; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: объект Dimension
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

get

public static Object get(Object key)

Возвращает объект из значений по умолчанию.

Параметры:: key — Object, задающий искомый объект
Возвращает:: Object
Исключения:: NullPointerException — если key — null

get

public static Object get(Object key, Locale l)

Возвращает объект из значений по умолчанию, подходящий для указанной локали.

Параметры:: key — Object, задающий искомый объект; l — Locale, для которой требуется объект; подробные сведения об обработке null Locale см. в UIDefaults
Возвращает:: Object
Исключения:: NullPointerException — если key — null
Начиная с:: 1.4

put

public static Object put(Object key, Object value)

Сохраняет объект в значениях разработчика по умолчанию. Этот метод-обертка вызывает getDefaults().put(key, value). Он влияет только на значения разработчика по умолчанию, но не на системные значения или значения оформления и стиля.

Параметры:

key — Object, задающий ключ для получения значения

value — сохраняемый Object; подробные сведения об обработке null см. в UIDefaults

Возвращает:

значение Object, возвращаемое методом UIDefaults.put(Object, Object)

Исключения:

NullPointerException — если key — null

См. также:

getUI

public static ComponentUI getUI(JComponent target)

Возвращает подходящую реализацию ComponentUI для target. Обычно этот метод является оберткой для getDefaults().getUI(target). Однако, если установлено вспомогательное оформление и стиль, сначала вызывается getUI(target) для значений по умолчанию мультиплексирующего оформления и стиля, и это значение возвращается, если оно non-null.

Параметры:

target — JComponent, для которого нужно вернуть ComponentUI

Возвращает:

объект ComponentUI для target

Исключения:

NullPointerException — если target — null

См. также:

getLookAndFeelDefaults

public static UIDefaults getLookAndFeelDefaults()

Возвращает UIDefaults текущего оформления и стиля, полученные при его установке.

Как правило, разработчикам следует использовать UIDefaults, возвращаемые методом getDefaults(). Поскольку текущему оформлению и стилю могут требоваться определенные существующие значения, изменение UIDefaults, возвращаемых этим методом, может привести к непредвиденным результатам.

Возвращает:

UIDefaults текущего оформления и стиля

См. также:

addAuxiliaryLookAndFeel

public static void addAuxiliaryLookAndFeel(LookAndFeel laf)

Добавляет LookAndFeel в список вспомогательных вариантов оформления и стиля. Вспомогательные варианты сообщают мультиплексирующему оформлению и стилю, какие еще классы LookAndFeel для экземпляра компонента следует использовать вместе с классом LookAndFeel по умолчанию при создании мультиплексирующего пользовательского интерфейса. Изменение вступит в силу только при создании нового класса пользовательского интерфейса или изменении оформления и стиля по умолчанию для экземпляра компонента.

Обратите внимание: это не те же варианты, что и установленные оформления и стили.

Параметры:

laf — объект LookAndFeel

См. также:

removeAuxiliaryLookAndFeel

public static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)

Удаляет LookAndFeel из списка вспомогательных вариантов внешнего вида. Вспомогательные варианты внешнего вида сообщают многослойному варианту внешнего вида, какие другие классы LookAndFeel для экземпляра компонента следует использовать дополнительно к классу LookAndFeel по умолчанию при создании многослойного пользовательского интерфейса. Изменение вступит в силу только при создании нового класса пользовательского интерфейса или при изменении варианта внешнего вида по умолчанию для экземпляра компонента.

Обратите внимание, что это не то же самое, что установленные варианты внешнего вида.

Параметры:

laf — LookAndFeel, который необходимо удалить

Возвращает:

true, если LookAndFeel был удалён из списка

См. также:

getAuxiliaryLookAndFeels

public static LookAndFeel[] getAuxiliaryLookAndFeels()

Возвращает список вспомогательных вариантов внешнего вида (может быть null). Вспомогательные варианты внешнего вида сообщают многослойному варианту внешнего вида, какие другие классы LookAndFeel для экземпляра компонента следует использовать дополнительно к классу LookAndFeel по умолчанию при создании многослойного пользовательского интерфейса.

Обратите внимание, что это не то же самое, что установленные варианты внешнего вида.

Возвращает:

список вспомогательных LookAndFeels или null

См. также:

addPropertyChangeListener

public static void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет PropertyChangeListener в список слушателей. Слушатель регистрируется для всех свойств.

Параметры:

listener — PropertyChangeListener, который необходимо добавить

См. также:

removePropertyChangeListener

public static void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет PropertyChangeListener из списка слушателей. Это удаляет PropertyChangeListener, зарегистрированный для всех свойств.

Параметры:

listener — PropertyChangeListener, который необходимо удалить

См. также:

getPropertyChangeListeners

public static PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех PropertyChangeListeners, добавленных в этот UIManager с помощью addPropertyChangeListener().

Возвращает:: все добавленные PropertyChangeListeners или пустой массив, если слушатели не добавлялись
Начиная с версии:: 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.