Класс SynthLookAndFeel

javax.swing.plaf.synth.SynthLookAndFeel

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

Прямые известные подклассы:: NimbusLookAndFeel

public class SynthLookAndFeel extends BasicLookAndFeel

SynthLookAndFeel служит основой для создания настраиваемого оформления. SynthLookAndFeel не предоставляет готового оформления: вся отрисовка делегируется. Необходимо либо предоставить файл конфигурации с помощью метода load(InputStream, Class), либо предоставить собственный SynthStyleFactory и передать его методу setStyleFactory(SynthStyleFactory). Пример загрузки файла приведён в обзоре пакета, а пример предоставления собственного SynthStyleFactory для setStyleFactory — в описании SynthStyleFactory.

Интерфейс SynthIcon предоставляет метод paintIcon(synthContext, graphics, x, y, width, height), позволяющий нарисовать значок с заданным SynthContext.

Предупреждение: Этот класс реализует интерфейс Serializable вследствие наследования от BasicLookAndFeel. Он не предназначен для сериализации. Попытка сериализовать его приведёт к возникновению NotSerializableException.

С версии:: 1.5

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

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

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

Модификатор и тип	Метод	Описание
`static ComponentUI`	`createUI(JComponent c)`	Создаёт оформление Synth `ComponentUI` для переданного `JComponent`.
`UIDefaults`	`getDefaults()`	Возвращает значения по умолчанию для этого SynthLookAndFeel.
`String`	`getDescription()`	Возвращает текстовое описание SynthLookAndFeel.
`String`	`getID()`	Возвращает строку, идентифицирующую это оформление.
`String`	`getName()`	Возвращает короткую строку, идентифицирующую это оформление.
`static Region`	`getRegion(JComponent c)`	Возвращает Region для `c` JComponent.
`static SynthStyle`	`getStyle(JComponent c, Region region)`	Получает SynthStyle для указанного региона указанного компонента.
`static SynthStyleFactory`	`getStyleFactory()`	Возвращает текущий SynthStyleFactory.
`void`	`initialize()`	Вызывается UIManager при установке этого оформления.
`boolean`	`isNativeLookAndFeel()`	Возвращает false: SynthLookAndFeel не является нативным оформлением.
`boolean`	`isSupportedLookAndFeel()`	Возвращает true: SynthLookAndFeel всегда поддерживается.
`void`	`load(InputStream input, Class<?> resourceBase)`	Загружает набор `SynthStyle`, используемых этим `SynthLookAndFeel`.
`static void`	`setStyleFactory(SynthStyleFactory cache)`	Задаёт SynthStyleFactory, который классы UI, предоставляемые synth, будут использовать для получения SynthStyle.
`boolean`	`shouldUpdateStyleOnAncestorChanged()`	Возвращает, должны ли интерфейсы UI обновлять свои `SynthStyles` из `SynthStyleFactory` при изменении родительского компонента `JComponent`.
`protected boolean`	`shouldUpdateStyleOnEvent(PropertyChangeEvent ev)`	Возвращает, должны ли интерфейсы UI обновлять стили при возникновении определённого события.
`void`	`uninitialize()`	Вызывается UIManager при удалении этого оформления.
`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` к полному имени класса UI.
`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`, если экземпляры `RootPaneUI`, возвращаемые `LookAndFeel`, поддерживают предоставление `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, либо до истечения заданного промежутка реального времени.

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

SynthLookAndFeel

public SynthLookAndFeel()

Создаёт SynthLookAndFeel.

Чтобы возвращённый SynthLookAndFeel можно было использовать, необходимо вызвать load для задания набора SynthStyle либо вызвать setStyleFactory.

См. также:

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

setStyleFactory

public static void setStyleFactory(SynthStyleFactory cache)

Задаёт SynthStyleFactory, который классы UI, предоставляемые synth, будут использовать для получения SynthStyle.

Параметры:: cache — SynthStyleFactory, который должны использовать интерфейсы UI.

getStyleFactory

public static SynthStyleFactory getStyleFactory()

Возвращает текущий SynthStyleFactory.

Возвращает:: SynthStyleFactory

getStyle

public static SynthStyle getStyle(JComponent c, Region region)

Получает SynthStyle для указанного региона указанного компонента. Этот метод предназначен не для общего использования: вызывать его должны только пользовательские интерфейсы UI.

Параметры:: c — JComponent, для которого требуется получить SynthStyle; region — идентификатор региона указанного компонента
Возвращает:: SynthStyle для использования.

updateStyles

public static void updateStyles(Component c)

Обновляет стиль, связанный с c, и всеми его дочерними элементами. Это упрощённая версия SwingUtilities.updateComponentTreeUI.

Параметры:: c — компонент, стиль которого требуется обновить.

getRegion

public static Region getRegion(JComponent c)

Возвращает Region для c JComponent.

Параметры:: c — JComponent, для которого требуется получить Region
Возвращает:: Region, соответствующий c

createUI

public static ComponentUI createUI(JComponent c)

Создаёт ComponentUI оформления Synth для переданного JComponent.

Параметры:: c — JComponent, для которого требуется создать ComponentUI
Возвращает:: ComponentUI для использования с c

load

public void load(InputStream input, Class<?> resourceBase) throws ParseException

Загружает набор SynthStyle, используемых этим SynthLookAndFeel. resourceBase используется для разрешения путей к ресурсам, например, Image будет разрешён с помощью resourceBase.getResource(path). Дополнительные сведения см. в разделе Формат файлов Synth.

Параметры:: input — InputStream, из которого выполняется загрузка; resourceBase — используется для разрешения путей к изображениям и другим ресурсам
Вызывает исключения:: ParseException — если при разборе возникла ошибка; IllegalArgumentException — если input или resourceBase равен null

initialize

public void initialize()

Вызывается UIManager при установке этого оформления.

Переопределяет:

initialize в классе LookAndFeel

См. также:

uninitialize

public void uninitialize()

Вызывается UIManager при удалении этого оформления.

Переопределяет:

uninitialize в классе LookAndFeel

См. также:

getDefaults

public UIDefaults getDefaults()

Возвращает значения по умолчанию для этого SynthLookAndFeel.

Переопределяет:

getDefaults в классе BasicLookAndFeel

Возвращает:

Таблица значений по умолчанию.

См. также:

isSupportedLookAndFeel

public boolean isSupportedLookAndFeel()

Возвращает true: SynthLookAndFeel всегда поддерживается.

Указано в:

isSupportedLookAndFeel в классе LookAndFeel

Возвращает:

true.

См. также:

isNativeLookAndFeel

public boolean isNativeLookAndFeel()

Возвращает false: SynthLookAndFeel не является нативным оформлением.

Указано в:: isNativeLookAndFeel в классе LookAndFeel
Возвращает:: false

getDescription

public String getDescription()

Возвращает текстовое описание SynthLookAndFeel.

Указано в:: getDescription в классе LookAndFeel
Возвращает:: текстовое описание synth.

getName

public String getName()

Возвращает короткую строку, идентифицирующую это оформление.

Указано в:: getName в классе LookAndFeel
Возвращает:: короткая строка, идентифицирующая это оформление.

getID

public String getID()

Возвращает строку, идентифицирующую это оформление.

Указано в:: getID в классе LookAndFeel
Возвращает:: короткая строка, идентифицирующая это оформление.

shouldUpdateStyleOnAncestorChanged

public boolean shouldUpdateStyleOnAncestorChanged()

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

Возвращает:: должны ли интерфейсы UI обновлять свои SynthStyles из SynthStyleFactory при изменении родительского компонента.

shouldUpdateStyleOnEvent

protected boolean shouldUpdateStyleOnEvent(PropertyChangeEvent ev)

Возвращает, должны ли интерфейсы UI обновлять свои стили при возникновении определённого события.

Параметры:: ev — PropertyChangeEvent
Возвращает:: должны ли интерфейсы UI обновлять свои стили
С версии:: 1.7

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