Spec-Zone.ru › OpenJDK 21

Класс SynthLookAndFeel

java.lang.Object
javax.swing.LookAndFeel
javax.swing.plaf.basic.BasicLookAndFeel
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)
Устарело, для удаления: Этот элемент API может быть удален в будущей версии.
Используйте load(InputStream, Class) или setStyleFactory(SynthStyleFactory) вместо этого
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, и всеми его дочерними элементами.

Методы, объявленные в классе 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.

См. также:
  • load(java.io.InputStream, java.lang.Class<?>)
  • setStyleFactory(javax.swing.plaf.synth.SynthStyleFactory)

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

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 внешний вид ComponentUI для переданного JComponent.
Параметры:
c - JComponent, для которого требуется создать внешний вид
Возвращает:
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 - если входные данные или 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
См. также:
  • LookAndFeel.uninitialize()
  • UIManager.setLookAndFeel(javax.swing.LookAndFeel)

uninitialize

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

getDefaults

public UIDefaults getDefaults()
Возвращает значения по умолчанию для этого SynthLookAndFeel.
Переопределяет:
getDefaults в классе BasicLookAndFeel
Возвращает:
Таблица значений по умолчанию.
См. также:
  • BasicLookAndFeel.initClassDefaults(javax.swing.UIDefaults)
  • BasicLookAndFeel.initSystemColorDefaults(javax.swing.UIDefaults)
  • BasicLookAndFeel.initComponentDefaults(javax.swing.UIDefaults)

isSupportedLookAndFeel

public boolean isSupportedLookAndFeel()
Возвращает true, SynthLookAndFeel всегда поддерживается.
Указано в:
isSupportedLookAndFeel в классе LookAndFeel
Возвращает:
true.
См. также:
  • UIManager.setLookAndFeel(javax.swing.LookAndFeel)

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 на основе иерархии вложенности, переопределяет этот метод, чтобы вернуть true.
Возвращает:
Следует ли UI обновлять свой SynthStyles из SynthStyleFactory при изменении предка.

shouldUpdateStyleOnEvent

protected boolean shouldUpdateStyleOnEvent(PropertyChangeEvent ev)
Возвращает, следует ли UI обновлять свои стили при наступлении определённого события.
Параметры:
ev - PropertyChangeEvent
Возвращает:
Следует ли UI обновлять свои стили
Начиная с:
1.7

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/plaf/synth/SynthLookAndFeel.html

Spec-Zone.ru

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