Spec-Zone.ru › OpenJDK 27

Класс NimbusLookAndFeel

java.lang.Object
javax.swing.LookAndFeel
javax.swing.plaf.basic.BasicLookAndFeel
javax.swing.plaf.synth.SynthLookAndFeel
javax.swing.plaf.nimbus.NimbusLookAndFeel
Все реализованные интерфейсы:
Serializable
public class NimbusLookAndFeel extends SynthLookAndFeel

Класс NimbusLookAndFeel.

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

Конструктор Описание
NimbusLookAndFeel()
Создает новый NimbusLookAndFeel.

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

Модификатор и тип Метод Описание
protected final Color getDerivedColor(Color color1, Color color2, float midPoint)
Декодирует и возвращает цвет, полученный путем смещения между двумя другими цветами.
protected final Color getDerivedColor(Color color1, Color color2, float midPoint, boolean uiResource)
Декодирует и возвращает цвет, полученный путем смещения относительно двух других цветов.
Color getDerivedColor(String uiDefaultParentName, float hOffset, float sOffset, float bOffset, int aOffset, boolean uiResource)
Получает производный цвет. Производные цвета являются общими экземплярами, и значение цвета изменяется при изменении родительского цвета UIDefault.
String getDescription()
Возвращает текстовое описание этого оформления.
String getID()
Возвращает строку, идентифицирующую это оформление.
String getName()
Возвращает короткую строку, идентифицирующую это оформление.
static NimbusStyle getStyle(JComponent c, Region r)
Получает стиль, связанный с указанным компонентом и областью.
void initialize()
Вызывается UIManager при установке этого оформления.
void register(Region region, String prefix)
Регистрирует сторонний компонент в NimbusLookAndFeel.
boolean shouldUpdateStyleOnAncestorChanged()
Возвращает, должны ли пользовательские интерфейсы обновлять свои SynthStyles из SynthStyleFactory при изменении предка JComponent.
protected boolean shouldUpdateStyleOnEvent(PropertyChangeEvent ev)
Возвращает, должны ли пользовательские интерфейсы обновлять свои стили при возникновении определенного события.
void uninitialize()
Вызывается UIManager при удалении этого оформления.

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

createUI, getDefaults, getRegion, getStyleFactory, isNativeLookAndFeel, isSupportedLookAndFeel, load, setStyleFactory, updateStyles
Модификатор и тип Метод Описание
static ComponentUI createUI(JComponent c)
Создает оформление Synth ComponentUI для переданного JComponent.
UIDefaults getDefaults()
Возвращает значения по умолчанию для этого SynthLookAndFeel.
static Region getRegion(JComponent c)
Возвращает Region для JComponent c.
static SynthStyleFactory getStyleFactory()
Возвращает текущий SynthStyleFactory.
boolean isNativeLookAndFeel()
Возвращает false, поскольку SynthLookAndFeel не является встроенным оформлением.
boolean isSupportedLookAndFeel()
Возвращает true, поскольку SynthLookAndFeel всегда поддерживается.
void load(InputStream input, Class<?> resourceBase)
Загружает набор SynthStyles, которые будут использоваться этим SynthLookAndFeel.
static void setStyleFactory(SynthStyleFactory cache)
Задает SynthStyleFactory, который классы пользовательского интерфейса synth будут использовать для получения SynthStyle.
static void updateStyles(Component c)
Обновляет стиль, связанный с c, и всеми его дочерними элементами.

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

createAudioAction, getAudioActionMap, initClassDefaults, initComponentDefaults, initSystemColorDefaults, loadSystemColors, playSound
Модификатор и тип Метод Описание
protected Action createAudioAction(Object key)
Создает и возвращает Action, используемый для воспроизведения звука.
protected ActionMap getAudioActionMap()
Возвращает ActionMap, содержащий звуковые действия для этого оформления.
protected void initClassDefaults(UIDefaults table)
Заполняет table сопоставлениями от uiClassID к полному имени класса пользовательского интерфейса.
protected void initComponentDefaults(UIDefaults table)
Заполняет table значениями по умолчанию для базового оформления.
protected void initSystemColorDefaults(UIDefaults table)
Заполняет table системными цветами.
protected void loadSystemColors(UIDefaults table, String[] systemColors, boolean useNative)
Заполняет table парами name-color из systemColors.
protected void playSound(Action audioAction)
При необходимости вызывает actionPerformed для audioAction, чтобы воспроизвести звук.

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

getDesktopPropertyValue, getDisabledIcon, getDisabledSelectedIcon, getLayoutStyle, getSupportsWindowDecorations, installBorder, installColors, installColorsAndFont, installProperty, loadKeyBindings, makeComponentInputMap, makeIcon, makeInputMap, makeKeyBindings, provideErrorFeedback, toString, uninstallBorder
Модификатор и тип Метод Описание
static Object getDesktopPropertyValue(String systemPropertyName, Object fallbackValue)
Возвращает значение указанного системного свойства рабочего стола, вызывая Toolkit.getDefaultToolkit().getDesktopProperty().
Icon getDisabledIcon(JComponent component, Icon icon)
Возвращает Icon с отключенным внешним видом.
Icon getDisabledSelectedIcon(JComponent component, Icon icon)
Возвращает Icon для отключенных компонентов, которые также выбраны.
LayoutStyle getLayoutStyle()
Возвращает LayoutStyle для этого оформления.
boolean getSupportsWindowDecorations()
Возвращает true, если экземпляры LookAndFeel, возвращаемые RootPaneUI, поддерживают предоставление Window для JRootPane.
static void installBorder(JComponent c, String defaultBorderName)
Вспомогательный метод для установки свойства границы компонента со значением из набора значений по умолчанию.
static void installColors(JComponent c, String defaultBgName, String defaultFgName)
Вспомогательный метод для установки свойств цвета переднего плана и фона компонента со значениями из набора значений по умолчанию.
static void installColorsAndFont(JComponent c, String defaultBgName, String defaultFgName, String defaultFontName)
Вспомогательный метод для установки свойств цвета переднего плана, фона и шрифта компонента со значениями из набора значений по умолчанию.
static void installProperty(JComponent c, String propertyName, Object propertyValue)
Вспомогательный метод для установки свойства с указанным именем и значением компонента, если разработчик еще не задал это свойство.
static void loadKeyBindings(InputMap retMap, Object[] keys)
Заполняет InputMap указанными привязками.
static ComponentInputMap makeComponentInputMap(JComponent c, Object[] keys)
Создает ComponentInputMapUIResource из keys.
static Object makeIcon(Class<?> baseClass, String gifFile)
Создает и возвращает UIDefault.LazyValue, загружающий изображение.
static InputMap makeInputMap(Object[] keys)
Создает InputMapUIResource из keys.
static JTextComponent.KeyBinding[] makeKeyBindings(Object[] keyBindingList)
Вспомогательный метод для создания массива KeyBindings.
void provideErrorFeedback(Component component)
Вызывается, когда пользователь пытается выполнить недопустимую операцию, например вставить текст в нередактируемый JTextField, находящийся в фокусе.
String toString()
Возвращает строку, отображающую свойства этого объекта и идентифицирующую его.
static void uninstallBorder(JComponent c)
Вспомогательный метод для удаления границы.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного времени.

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

NimbusLookAndFeel

public NimbusLookAndFeel()
Создает новый NimbusLookAndFeel.

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

initialize

public void initialize()
Вызывается UIManager при установке этого оформления.
Переопределяет:
initialize в классе SynthLookAndFeel
См. также:
  • LookAndFeel.uninitialize()
  • UIManager.setLookAndFeel(LookAndFeel)

uninitialize

public void uninitialize()
Вызывается UIManager при удалении этого оформления.
Переопределяет:
uninitialize в классе SynthLookAndFeel
См. также:
  • LookAndFeel.initialize()
  • UIManager.setLookAndFeel(LookAndFeel)

getStyle

public static NimbusStyle getStyle(JComponent c, Region r)
Получает стиль, связанный с указанным компонентом и областью. Этот метод никогда не возвращает null. Если не удается определить подходящий компонент и область, возвращается стиль по умолчанию.
Параметры:
c — ссылка на JComponent, не равная null
r — ссылка на область компонента c, не равная null
Возвращает:
ссылку на NimbusStyle, не равную null.

getName

public String getName()
Возвращает короткую строку, идентифицирующую это оформление. Эта строка будет не заключенной в кавычки строкой "Nimbus".
Переопределяет:
getName в классе SynthLookAndFeel
Возвращает:
короткую строку, идентифицирующую это оформление.

getID

public String getID()
Возвращает строку, идентифицирующую это оформление. Эта строка будет не заключенной в кавычки строкой "Nimbus".
Переопределяет:
getID в классе SynthLookAndFeel
Возвращает:
короткую строку, идентифицирующую это оформление.

getDescription

public String getDescription()
Возвращает текстовое описание этого оформления.
Переопределяет:
getDescription в классе SynthLookAndFeel
Возвращает:
текстовое описание этого оформления.

shouldUpdateStyleOnAncestorChanged

public boolean shouldUpdateStyleOnAncestorChanged()
Возвращает, должны ли пользовательские интерфейсы обновлять свои SynthStyles из SynthStyleFactory при изменении предка JComponent. Подкласс, предоставляющий SynthStyleFactory, который вычисляет возвращаемое значение на основе иерархии вложенности getStyle, должен переопределить этот метод, чтобы он возвращал true.
Переопределяет:
shouldUpdateStyleOnAncestorChanged в классе SynthLookAndFeel
Возвращает:
true

shouldUpdateStyleOnEvent

protected boolean shouldUpdateStyleOnEvent(PropertyChangeEvent ev)
Возвращает, должны ли пользовательские интерфейсы обновлять свои стили при возникновении определенного события.

Переопределен для возврата true при изменении одного из следующих свойств:

  • "Nimbus.Overrides"
  • "Nimbus.Overrides.InheritDefaults"
  • "JComponent.sizeVariant"
Переопределяет:
shouldUpdateStyleOnEvent в классе SynthLookAndFeel
Параметры:
ev — PropertyChangeEvent
Возвращает:
должны ли пользовательские интерфейсы обновлять свои стили
Начиная с:
1.7

register

public void register(Region region, String prefix)

Регистрирует сторонний компонент в NimbusLookAndFeel.

Области представляют компоненты и участки внутри компонентов, выступающие в качестве независимых областей отрисовки. После регистрации в NimbusLookAndFeel стили NimbusStyle для этих областей можно получить с помощью метода getStyle.

NimbusLookAndFeel использует стандартную схему именования записей в таблице UIDefaults. Ключ каждого свойства, состояния, средства отрисовки и другого значения по умолчанию, зарегистрированного в UIDefaults для конкретной области, будет начинаться с указанного prefix

Например, предположим, что у меня есть компонент с именем JFoo. Затем я регистрирую этот компонент в NimbusLookAndFeel следующим образом:

    laf.register(NimbusFooUI.FOO_REGION, "Foo");

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

    UIManager.put("Foo.background", new ColorUIResource(Color.BLACK));
    UIManager.put("Foo.Enabled.backgroundPainter", new FooBackgroundPainter());

В Nimbus также можно зарегистрировать компонент с именем. Например, предположим, что вы хотите задать для фона JPanel с именем "MyPanel" стиль, отличающийся от стиля других JPanel. Это можно сделать следующим образом:

    laf.register(Region.PANEL, "\"MyPanel\"");
    UIManager.put("\"MyPanel\".background", new ColorUIResource(Color.RED));
Параметры:
region — регистрируемая область Synth. Например, Button, ScrollBarThumb или NimbusFooUI.FOO_REGION.
prefix — префикс UIDefault. Например, ComboBox; для компонента с именем — "MyComboBox" или даже что-то вроде ToolBar."MyComboBox"."ComboBox.arrowButton"

getDerivedColor

public Color getDerivedColor(String uiDefaultParentName, float hOffset, float sOffset, float bOffset, int aOffset, boolean uiResource)
Получает производный цвет. Производные цвета являются общими экземплярами, и значение цвета изменяется при изменении родительского цвета UIDefault.
Параметры:
uiDefaultParentName — ключ родительского UIDefault
hOffset — смещение оттенка
sOffset — смещение насыщенности
bOffset — смещение яркости
aOffset — смещение альфа-канала
uiResource — True, если производный цвет должен быть UIResource, и false, если не должен
Возвращает:
сохраненный производный цвет

getDerivedColor

protected final Color getDerivedColor(Color color1, Color color2, float midPoint, boolean uiResource)
Декодирует и возвращает цвет, полученный путем смещения между двумя другими цветами.
Параметры:
color1 — первый цвет
color2 — второй цвет
midPoint — смещение между цветом 1 и цветом 2: значение 0.0 соответствует цвету 1, а 1.0 — цвету 2;
uiResource — True, если производный цвет должен быть UIResource
Возвращает:
производный цвет

getDerivedColor

protected final Color getDerivedColor(Color color1, Color color2, float midPoint)
Декодирует и возвращает цвет, полученный путем смещения относительно двух других цветов.
Параметры:
color1 — первый цвет
color2 — второй цвет
midPoint — смещение между цветом 1 и цветом 2: значение 0.0 соответствует цвету 1, а 1.0 — цвету 2;
Возвращает:
производный цвет, который будет UIResource

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API