Класс BasicLookAndFeel
- Все реализованные интерфейсы:
Serializable
- Прямые известные подклассы:
-
MetalLookAndFeel,SynthLookAndFeel
public abstract class BasicLookAndFeel extends LookAndFeel implements Serializable
Каждый из ComponentUI предоставляемых
BasicLookAndFeel получает свое поведение из таблицы значений по умолчанию. За исключением случаев, когда есть особые указания, каждая из ComponentUI реализаций в этом пакете документирует набор значений по умолчанию, которые они используют. За исключением случаев, когда есть особые указания, значения по умолчанию устанавливаются во время вызова installUI, и следуют рекомендациям, изложенным в LookAndFeel для установки значений по умолчанию.
Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. XMLEncoder.
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected Action |
createAudioAction |
Создает и возвращает Action для воспроизведения звука. |
protected ActionMap |
getAudioActionMap() |
Возвращает ActionMap, содержащий действия аудио для данного внешнего вида и ощущения. |
UIDefaults |
getDefaults() |
Возвращает значения по умолчанию внешнего вида и ощущения. |
protected void |
initClassDefaults |
Заполняет table сопоставлениями от uiClassID до полных квалифицированных имен класса UI. |
protected void |
initComponentDefaults |
Заполняет table значениями по умолчанию для базового внешнего вида и ощущения. |
protected void |
initSystemColorDefaults |
Заполняет table системными цветами. |
protected void |
loadSystemColors |
Заполняет table парами name-color в systemColors. |
protected void |
playSound |
При необходимости вызывает 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
Подробное описание конструкторов
BasicLookAndFeel
protected BasicLookAndFeel()
Подробное описание методов
getDefaults
public UIDefaults getDefaults()
UIDefaults заполняются путём вызова, в порядке следования, initClassDefaults, initSystemColorDefaults и initComponentDefaults. Несмотря на то, что этот метод является публичным, он должен вызываться только UIManager при установке внешнего вида в качестве текущего внешнего вида и после вызова initialize.
- Overrides:
-
getDefaultsв классеLookAndFeel - Возвращает:
- значения по умолчанию для внешнего вида
- См. также:
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 - См. также:
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 - См. также:
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нечётно - См. также:
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
protected Action createAudioAction(Object key)
Action для воспроизведения звука. Если key равно non-null, создаётся Action с использованием значения из параметров по умолчанию с ключом key. Значение идентифицирует ресурс звука для загрузки при вызове actionPerformed на Action. Ресурс звука загружается в byte[] с помощью getClass().getResourceAsStream().
- Параметры:
-
key- ключ, идентифицирующий аудиодействие - Возвращает:
Actionдля воспроизведения источника илиnull, еслиkeyравноnull- С момента:
- 1.4
- См. также:
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