Класс SynthLookAndFeel

javax.swing.plaf.synth.SynthLookAndFeel

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

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

public class SynthLookAndFeel extends BasicLookAndFeel

SynthLookAndFeel предоставляет основу для создания настраиваемого внешнего вида. SynthLookAndFeel напрямую не предоставляет внешний вид, все отрисовка делегируется. Вам необходимо либо предоставить конфигурационный файл, используя метод load(java.io.InputStream, java.lang.Class<?>), либо предоставить собственный SynthStyleFactory к методу setStyleFactory(javax.swing.plaf.synth.SynthStyleFactory). Обратитесь к обзору пакета для примера загрузки файла и к SynthStyleFactory для примера предоставления собственного SynthStyleFactory к setStyleFactory.

Интерфейс 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)`	Возвращает область для JComponent `c`.
`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`.
`void`	`load(URL url)`	Deprecated, для удаления: Этот элемент API может быть удалён в будущих версиях. Используйте `load(InputStream, Class)` или `setStyleFactory(SynthStyleFactory)` вместо этого.
`static void`	`setStyleFactory(SynthStyleFactory cache)`	Устанавливает SynthStyleFactory, который UI-классы, предоставляемые synth, будут использовать для получения SynthStyle.
`boolean`	`shouldUpdateStyleOnAncestorChanged()`	Возвращает, следует ли обновлять свои `SynthStyles` из `SynthStyleFactory` при изменении предка `JComponent`.
`protected boolean`	`shouldUpdateStyleOnEvent(PropertyChangeEvent ev)`	Возвращает, следует ли обновлять стили UI при наступлении определённого события.
`void`	`uninitialize()`	Вызывается UIManager при удалении этого внешнего вида.
`static void`	`updateStyles(Component c)`	Обновляет стиль, связанный с `c` и всеми его потомками.

Методы, объявленные в классе javax.swing.plaf.basic.BasicLookAndFeel

createAudioAction, getAudioActionMap, initClassDefaults, initComponentDefaults, initSystemColorDefaults, loadSystemColors, playSound

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

getDesktopPropertyValue, getDisabledIcon, getDisabledSelectedIcon, getLayoutStyle, getSupportsWindowDecorations, installBorder, installColors, installColorsAndFont, installProperty, loadKeyBindings, makeComponentInputMap, makeIcon, makeInputMap, makeKeyBindings, provideErrorFeedback, toString, uninstallBorder

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

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

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

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 для JComponent c.

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

createUI

public static ComponentUI createUI(JComponent c)

Создаёт вид и ощущения Synth look and feel ComponentUI для переданного 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 - Поток ввода для загрузки; resourceBase - используется для разрешения любых изображений или других ресурсов
Исключения:: ParseException - если произошла ошибка при разборе; IllegalArgumentException - если вход или resourceBase являются null

load

@Deprecated(since="21", forRemoval=true) public void load(URL url) throws ParseException, IOException

Устарело, для удаления: Элемент API может быть удалён в будущей версии.

Используйте load(InputStream, Class) или setStyleFactory(SynthStyleFactory) вместо этого

Загружает набор SynthStyle, которые будут использоваться этим SynthLookAndFeel. Ресурсы, основанные на пути, разрешаются относительно указанного URL стиля. Например, Image будет разрешаться new URL(synthFile, path). Для получения дополнительной информации см. Формат файла Synth.

Хотя этот API может быть безопасным для загрузки локальных ресурсов, которые поставляются с LookAndFeel или приложением, и поэтому имеют одинаковый уровень доверия к коду приложения, использование его для загрузки из удалённых ресурсов, особенно тех, которые могут иметь более низкий уровень доверия, настоятельно не рекомендуется. Альтернативные механизмы для загрузки стилей из InputStream load(InputStream, Class), используя ресурсы, расположенные совместно с приложением, или предоставляя SynthStyleFactory setStyleFactory(SynthStyleFactory) предпочтительнее. Следовательно, этот метод устарел и будет удалён в будущей версии.

Параметры:: url - URL для загрузки набора SynthStyle
Исключения:: ParseException - если произошла ошибка при разборе; IllegalArgumentException - если synthSet является null; IOException - если synthSet не может быть открыт как InputStream
С момента:: 1.6

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)

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

Параметры:: ev - a PropertyChangeEvent
Возвращаемое значение:: следует ли обновлять стили пользовательских интерфейсов
С тех пор:: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/plaf/synth/SynthLookAndFeel.html