Spec-Zone.ru › OpenJDK 21

Класс BasicLookAndFeel

java.lang.Object
javax.swing.LookAndFeel
javax.swing.plaf.basic.BasicLookAndFeel
Все реализованные интерфейсы:
Serializable
Непосредственные подклассы:
MetalLookAndFeel, SynthLookAndFeel
public abstract class BasicLookAndFeel extends LookAndFeel implements Serializable
Базовый класс для создания внешнего вида и ощущений для Swing.

Каждый из ComponentUI предоставляемых BasicLookAndFeel получает своё поведение из таблицы значений по умолчанию. За исключением случаев, когда оговорено иное, каждая из реализаций ComponentUI в этом пакете документирует используемый набор значений по умолчанию. За исключением случаев, когда оговорено иное, значения по умолчанию устанавливаются во время вызова installUI, и следуют рекомендациям, изложенным в LookAndFeel для установки значений по умолчанию.

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

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

BasicLookAndFeel()
Модификатор Конструктор Описание
protected
Конструктор для вызова подклассами.

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

Модификатор и тип Метод Описание
protected Action createAudioAction(Object key)
Создаёт и возвращает Action, используемый для воспроизведения звука.
protected ActionMap getAudioActionMap()
Возвращает ActionMap, содержащий аудиодействия для данного внешнего вида.
UIDefaults getDefaults()
Возвращает значения по умолчанию внешнего вида.
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 для воспроизведения звука.

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

getDescription, getDesktopPropertyValue, getDisabledIcon, getDisabledSelectedIcon, getID, getLayoutStyle, getName, getSupportsWindowDecorations, initialize, installBorder, installColors, installColorsAndFont, installProperty, isNativeLookAndFeel, isSupportedLookAndFeel, loadKeyBindings, makeComponentInputMap, makeIcon, makeInputMap, makeKeyBindings, provideErrorFeedback, toString, uninitialize, uninstallBorder

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

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

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

BasicLookAndFeel

protected BasicLookAndFeel()
Конструктор для вызова подклассами.

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

getDefaults

public UIDefaults getDefaults()
Возвращает значения по умолчанию для внешнего вида. Возвращаемый UIDefaults заполняется путем последовательного вызова initClassDefaults, initSystemColorDefaults и initComponentDefaults.

Хотя этот метод является публичным, его следует вызывать только UIManager при установке внешнего вида в качестве текущего внешнего вида и после вызова initialize.

Overrides:
getDefaults в классе LookAndFeel
Возвращает:
значения по умолчанию для внешнего вида
См. также:
  • initClassDefaults(javax.swing.UIDefaults)
  • initSystemColorDefaults(javax.swing.UIDefaults)
  • initComponentDefaults(javax.swing.UIDefaults)

initClassDefaults

protected void initClassDefaults(UIDefaults table)
Заполняет table отображением от uiClassID к полному имени класса ui. Значение для конкретного uiClassID равно "javax.swing.plaf.basic.Basic + uiClassID". Например, значение для uiClassID TreeUI равно "javax.swing.plaf.basic.BasicTreeUI".
Параметры:
table - экземпляр UIDefaults, в который добавляются записи
Исключения:
NullPointerException - если table равен null
См. также:
  • LookAndFeel
  • getDefaults()

initSystemColorDefaults

protected void initSystemColorDefaults(UIDefaults table)
Заполняет table системными цветами. Это создает массив пар «имя-цвет» и вызывает loadSystemColors.

Имя — это String, соответствующее имени одного из статических SystemColor полей в классе SystemColor . Пара «имя-цвет» создается для каждого такого SystemColor поля.

Цвет соответствует шестнадцатеричному String в том формате, как он понимается Color.decode. Например, одна из пар «имя-цвет» — "desktop"-"#005C5C". Это соответствует полю SystemColor класса desktop, со значением цвета new Color(0x005C5C).

Ниже показаны две пары «имя-цвет»:

   String[] nameColorPairs = new String[] {
          "desktop", "#005C5C",
    "activeCaption", "#000080" };
   loadSystemColors(table, nameColorPairs, isNativeLookAndFeel());
 
Как уже говорилось, это вызывает loadSystemColors с предоставленным массивом пар «имя-цвет» и name-color. Последний аргумент loadSystemColors указывает, следует ли использовать значение поля в SystemColor. Этот метод передает значение isNativeLookAndFeel() в качестве последнего аргумента loadSystemColors.
Параметры:
table - объект UIDefaults, в который добавляются значения
Исключения:
NullPointerException - если table равен null
См. также:
  • SystemColor
  • getDefaults()
  • loadSystemColors(javax.swing.UIDefaults, java.lang.String[], boolean)

loadSystemColors

protected void loadSystemColors(UIDefaults table, String[] systemColors, boolean useNative)
Заполняет table парами «имя-цвет» из systemColors. Подробности о формате systemColors см. в initSystemColorDefaults(UIDefaults).

В table добавляется запись для каждой пары «имя-цвет» в systemColors. Ключ записи — это name пары «имя-цвет».

Значение записи соответствует color пары «имя-цвет». Значение записи вычисляется одним из двух способов. В любом случае значение всегда является ColorUIResource.

Если useNative равно false, color создается с помощью Color.decode, преобразующего String в Color. Если decode не может преобразовать String в Color (бросается исключение NumberFormatException), используется черный цвет.

Если useNative равно true, color является значением поля в SystemColor с тем же именем, что и name пары «имя-цвет». Если поле недействительно, используется черный цвет.

Параметры:
table - объект UIDefaults, в который добавляются значения
systemColors - массив пар «имя-цвет» как описано в initSystemColorDefaults(UIDefaults)
useNative - указывает, извлекать цвет из SystemColor или Color.decode
Исключения:
NullPointerException - если systemColors равно null; или systemColors не пусто, и table равно null; или одно из имен пар «имя-цвет» недействительно; или useNative равно false и одно из colors пар «имя-цвет» недействительно
ArrayIndexOutOfBoundsException - если useNative равно false и systemColors.length нечетно
См. также:
  • initSystemColorDefaults(javax.swing.UIDefaults)
  • SystemColor
  • Color.decode(String)

initComponentDefaults

protected void initComponentDefaults(UIDefaults table)
Заполняет table значениями по умолчанию для базового внешнего вида.
Параметры:
table - UIDefaults для добавления значений
Исключения:
NullPointerException - если table равно null

getAudioActionMap

protected ActionMap getAudioActionMap()
Возвращает ActionMap, содержащий аудиодействия для данного внешнего вида.

Возвращаемое ActionMap содержит Actions, которые воплощают возможность воспроизведения звукового сигнала. Эти звуковые сигналы соответствуют действиям пользователя и системы, которые могут быть полезны для конечного пользователя (например, появление диалогового окна).

В нужное время ComponentUI отвечает за получение Action из ActionMap и передачу его playSound.

Сначала этот метод ищет ActionMap в значениях по умолчанию с ключом "AuditoryCues.actionMap".

Если значение равно non-null, оно возвращается. Если значение по умолчанию для "AuditoryCues.actionMap" равно null, а значение по умолчанию для "AuditoryCues.cueList" равно non-null, создается и заполняется ActionMapUIResource. Заполнение выполняется путем итерации по каждому элементу массива "AuditoryCues.cueList" и вызова createAudioAction() для создания Action для каждого элемента. Результирующее Action помещается в ActionMapUIResource, используя элемент массива в качестве ключа. Например, если массив "AuditoryCues.cueList" содержит один элемент "audioKey", то ActionMapUIResource создается и заполняется с помощью actionMap.put(cueList[0], createAudioAction(cueList[0])).

Если значение по умолчанию для "AuditoryCues.actionMap" равно null, а значение по умолчанию для "AuditoryCues.cueList" равно null, создается пустое ActionMapUIResource.

Возвращает:
объект ActionMap, содержащий Actions для воспроизведения звуковых сигналов
Исключения:
ClassCastException - если значение по умолчанию для "AuditoryCues.actionMap" не является ActionMap, или значение по умолчанию для "AuditoryCues.cueList" не является Object[]
Since:
1.4
См. также:
  • createAudioAction(java.lang.Object)
  • playSound(Action)

createAudioAction

protected Action createAudioAction(Object key)
Создает и возвращает Action для воспроизведения звука.

Если key равно non-null, создается Action с использованием значения из значений по умолчанию с ключом key. Значение идентифицирует ресурс звука для загрузки при вызове actionPerformed на Action. Ресурс звука загружается в byte[] с помощью getClass().getResourceAsStream().

Параметры:
key - ключ, идентифицирующий аудиодействие
Возвращает:
объект Action для воспроизведения источника или null, если key равно null
Since:
1.4
См. также:
  • playSound(Action)

playSound

protected void playSound(Action audioAction)
При необходимости вызывает actionPerformed в audioAction, чтобы воспроизвести звук. Метод actionPerformed вызывается, если значение по умолчанию "AuditoryCues.playList" является non-null Object[], содержащим запись String, равную имени audioAction.
Параметры:
audioAction - действие, знающее, как отобразить аудио, связанное с системной или пользовательской активностью; значение null, игнорируется
Исключения:
ClassCastException - если audioAction равно non-null, и значение по умолчанию "AuditoryCues.playList" не является Object[]
С:
1.4

© 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/basic/BasicLookAndFeel.html

Spec-Zone.ru

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