Spec-Zone.ru › OpenJDK 17

Класс 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. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией 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 системными цветами. Это создаёт массив name-color пар и вызывает loadSystemColors.

Имя является String, которое соответствует имени одного из статических SystemColor полей в классе SystemColor . Для каждого такого SystemColor поля создаётся пара имя-цвет.

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

Ниже приведены две из пар name-color :

   String[] nameColorPairs = new String[] {
          "desktop", "#005C5C",
    "activeCaption", "#000080" };
   loadSystemColors(table, nameColorPairs, isNativeLookAndFeel());
 
Как уже было сказано, это вызывает loadSystemColors с предоставленным массивом пар table и 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 парами name-color в systemColors. Подробности о формате systemColors см. в initSystemColorDefaults(UIDefaults).

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

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

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

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

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

initComponentDefaults

protected void initComponentDefaults(UIDefaults table)
Заполняет table значениями по умолчанию для внешнего вида Basic.
Параметры:
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[]
С момента:
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
С момента:
1.4
См. также:
  • playSound(Action)

playSound

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

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/plaf/basic/BasicLookAndFeel.html

Spec-Zone.ru

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