javax.swing

Класс LookAndFeel

java.lang. Объект

javax.swing. LookAndFeel

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

BasicLookAndFeel, MultiLookAndFeel

public abstract class LookAndFeel
extends Object

LookAndFeel, поскольку имя подразумевает, инкапсулирует стиль. Вне установки стили большинство разработчиков никогда не должно взаимодействовать непосредственно с LookAndFeel. В общем только разработчики, создающие пользовательский стиль, должны интересоваться этим классом.

Swing создается на основе что каждый JComponent у подкласса есть реализация определенного ComponentUI подкласс. ComponentUI часто упоминается как "ui", "компонент ui", или "стиль делегирует". ComponentUI подкласс ответственен за обеспечение стили определенная функциональность компонента. Например, JTree требует реализации ComponentUI подкласс TreeUI. Реализация определенного ComponentUI подкласс обеспечивается LookAndFeel. Каждый JComponent подкласс идентифицирует ComponentUI подкласс это требует посредством JComponent метод getUIClassID.

Каждый LookAndFeel реализация должна обеспечить реализацию соответствующего ComponentUI подкласс, определяя значение для каждого из ui идентификаторов класса Swing в UIDefaults объект, возвращенный из getDefaults. Например, BasicLookAndFeel использование BasicTreeUI как конкретная реализация для TreeUI. Это выполняется BasicLookAndFeel обеспечение пары ключ/значение "TreeUI"-"javax.swing.plaf.basic.BasicTreeUI", в UIDefaults возвращенный из getDefaults. Обратитесь к UIDefaults.getUI(JComponent) для defails, на как реализация ComponentUI подкласс получается.

Когда a LookAndFeel устанавливается UIManager не проверяет, что запись существует для всех ui идентификаторов класса. Также, случайные исключения произойдут, если текущий стиль не обеспечил значение для определенного ui идентификатора класса и экземпляра JComponent подкласс создается.

Рекомендации для Взгляда и Чувств

Как отмечено в UIManager каждый LookAndFeel имеет возможность обеспечить ряд значений по умолчанию, которые являются многоуровневыми в с разработчиком и системными значениями по умолчанию. Некоторые из компонентов Swing требуют, чтобы стиль обеспечил определенный набор значений по умолчанию. Они документируются в классы, которые требуют определенного значения по умолчанию.

ComponentUIs и значения по умолчанию

Все ComponentUIs обычно должен устанавливать различные свойства на JComponent ComponentUI обеспечивает стиль для. Это обычно делается когда ComponentUI устанавливается на JComponent. Установка свойства должна только быть сделана, если разработчик не установил свойство. Для непримитивных значений рекомендуется что ComponentUI только измените свойство на JComponent если текущая стоимость null или реализации UIResource. Если текущая стоимость null или реализации UIResource это указывает, что свойство не было установлено разработчиком, и ui свободен изменить это. Например, BasicButtonUI.installDefaults только изменяет шрифт на JButton если возвращаемое значение от button.getFont() null или реализации UIResource. С другой стороны, если button.getFont() возвращенный a non-null значение, которое не реализовывало UIResource тогда BasicButtonUI.installDefaults не изменился бы JButton's шрифт.

Для примитивных значений, такой как opaque, метод installProperty должен быть вызван. installProperty только изменяет correspoding свойство, если значение не было изменено разработчиком.

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

Исключения

Все методы установки, обеспеченные LookAndFeel потребность получить доступ к значениям по умолчанию, если значение изменяемого свойства null или a UIResource. Например, установка шрифта делает следующее:

   JComponent c;
   Font font = c.getFont();
   if (font == null || (font instanceof UIResource)) {
       c.setFont(UIManager.getFont("fontKey"));
   }
 

Если шрифт null или a UIResource, таблица значений по умолчанию запрашивается с ключом fontKey. Весь из UIDefault's получите бросок методов a NullPointerException если передано в null. Также, если не указано иное каждый из различных методов установки LookAndFeel бросок a NullPointerException если текущая стоимость null или a UIResource и предоставленный ключ значений по умолчанию null. Кроме того, если иначе не определено весь из install методы бросают a NullPointerException если a null в компоненте передают.

Сводка конструктора

Конструкторы

Конструктор и Описание
LookAndFeel()

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
UIDefaults	getDefaults() Возвращает значения по умолчанию стили.
abstract String	getDescription() Возвратите одно описание строки этой реализации стили, например.
static Object	getDesktopPropertyValue(String systemPropertyName, Object fallbackValue) Возвращает значение указанного системного настольного свойства, вызывая Toolkit.getDefaultToolkit().getDesktopProperty().
Значок	getDisabledIcon(JComponent component, Icon icon) Возвраты Icon с отключенным появлением.
Значок	getDisabledSelectedIcon(JComponent component, Icon icon) Возвраты Icon для использования отключенными компонентами, которые также выбираются.
abstract String	getID() Возвратите строку, которая идентифицирует этот стиль.
LayoutStyle	getLayoutStyle() Возвраты LayoutStyle для этого стили.
abstract String	getName() Возвратите короткую строку, которая идентифицирует этот стиль, например.
boolean	getSupportsWindowDecorations() Возвраты true если LookAndFeel возвращенный RootPaneUI обеспечение поддержки экземпляров Window художественные оформления в a JRootPane.
void	initialize() Инициализирует стиль.
static void	installBorder(JComponent c, String defaultBorderName) Метод удобства для того, чтобы установить свойство границы компонента со значением от значений по умолчанию.
static void	installColors(JComponent c, String defaultBgName, String defaultFgName) Метод удобства для того, чтобы установить свойства цвета переднего плана и цвета фона компонента со значениями от значений по умолчанию.
static void	installColorsAndFont(JComponent c, String defaultBgName, String defaultFgName, String defaultFontName) Метод удобства для того, чтобы установить передний план компонента, фон и свойства шрифта со значениями от значений по умолчанию.
static void	installProperty(JComponent c, String propertyName, Object propertyValue) Метод удобства для того, чтобы установить свойство с указанным именем и значением на компоненте, если то свойство не было уже установлено разработчиком.
abstract boolean	isNativeLookAndFeel() Если у базовой платформы есть "собственный" стиль, и это - реализация ее, возвратиться true.
abstract boolean	isSupportedLookAndFeel() Возвратиться true если базовая платформа поддерживает и или разрешает этот стиль.
static void	loadKeyBindings(InputMap retMap, Object[] keys) Заполняет InputMap с указанной привязкой.
static ComponentInputMap	makeComponentInputMap(JComponent c, Object[] keys) Создает a ComponentInputMapUIResource от keys.
static Object	makeIcon(Class<?> baseClass, String gifFile) Создает и возвращает a UIDefault.LazyValue это загружает изображение.
static InputMap	makeInputMap(Object[] keys) Создает a InputMapUIResource от keys.
static JTextComponent.KeyBinding[]	makeKeyBindings(Object[] keyBindingList) Метод удобства для создания массива KeyBindings.
void	provideErrorFeedback(Component component) Вызванный, когда пользователь делает попытку недопустимой работы, такой как вставка в недоступное для редактирования JTextField это фокусируется.
Строка	toString() Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.
void	uninitialize() Деинициализирует стиль.
static void	uninstallBorder(JComponent c) Метод удобства для того, чтобы удалить границу.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

LookAndFeel

public LookAndFeel()

Деталь метода

installColors

public static void installColors(JComponent c,
                 String defaultBgName,
                 String defaultFgName)

Метод удобства для того, чтобы установить свойства цвета переднего плана и цвета фона компонента со значениями от значений по умолчанию. Свойства только устанавливаются, если текущая стоимость также null или a UIResource.

Параметры:

c - компонент, чтобы выбрать цвета на

defaultBgName - ключ для фона

defaultFgName - ключ для переднего плана

Броски:

NullPointerException - как описано в исключениях

См. Также:

installColorsAndFont(javax.swing.JComponent, java.lang.String, java.lang.String, java.lang.String), UIManager.getColor(java.lang.Object)

installColorsAndFont

public static void installColorsAndFont(JComponent c,
                        String defaultBgName,
                        String defaultFgName,
                        String defaultFontName)

Метод удобства для того, чтобы установить передний план компонента, фон и свойства шрифта со значениями от значений по умолчанию. Свойства только устанавливаются, если текущая стоимость также null или a UIResource.

Параметры:

c - компонентный набор к цветам и шрифту на

defaultBgName - ключ для фона

defaultFgName - ключ для переднего плана

defaultFontName - ключ для шрифта

Броски:

NullPointerException - как описано в исключениях

См. Также:

installColors(javax.swing.JComponent, java.lang.String, java.lang.String), UIManager.getColor(java.lang.Object), UIManager.getFont(java.lang.Object)

installBorder

public static void installBorder(JComponent c,
                 String defaultBorderName)

Метод удобства для того, чтобы установить свойство границы компонента со значением от значений по умолчанию. Граница только устанавливается, если граница null или экземпляр UIResource.

Параметры:

c - компонент, чтобы установить границу на

defaultBorderName - ключ, определяющий границу

Броски:

NullPointerException - как описано в исключениях

uninstallBorder

public static void uninstallBorder(JComponent c)

Метод удобства для того, чтобы удалить границу. Если граница компонента является a UIResource, это устанавливается в null.

Параметры:

c - компонент, чтобы удалить границу на

Броски:

NullPointerException - если c null

installProperty

public static void installProperty(JComponent c,
                   String propertyName,
                   Object propertyValue)

Метод удобства для того, чтобы установить свойство с указанным именем и значением на компоненте, если то свойство не было уже установлено разработчиком. Этот метод предназначается, чтобы использоваться экземплярами делегата ui, которые должны определить значение по умолчанию для свойства типа примитива (булевская переменная, интервал..), но не хотят переопределять набор значений клиентом. Так как примитивные значения свойств не могут быть обернуты с UIResource маркер, этот метод использует частное состояние, чтобы определить, было ли свойство установлено клиентом.

Параметры:

c - целевой компонент, чтобы установить свойство на

propertyName - имя свойства, чтобы установить

propertyValue - значение свойства

Броски:

IllegalArgumentException - если указанное свойство не является тем, которое может быть установлено, используя этот метод

ClassCastException - если значение свойства не было установлено разработчиком, и тип не соответствует тип свойства

NullPointerException - если c null, или именованное свойство не было установлено разработчиком и propertyValue null

С тех пор:

1.5

makeKeyBindings

public static JTextComponent.KeyBinding[] makeKeyBindings(Object[] keyBindingList)

Метод удобства для создания массива KeyBindings. В то время как этот метод не осуждается, разработчики должны вместо этого использовать ActionMap и InputMap для того, чтобы предоставить привязки клавиш.

Этот метод возвращает массив KeyBindings, один для каждого чередования key-action пара в keyBindingList. A key может или быть a String в формате, определенном KeyStroke.getKeyStroke метод, или a KeyStroke. action часть пары является a String это соответствует имени Action.

Следующий пример иллюстрирует создание a KeyBinding массив от шести чередований key-action пары:

  JTextComponent.KeyBinding[] multilineBindings = makeKeyBindings( new Object[] {
          "UP", DefaultEditorKit.upAction,
        "DOWN", DefaultEditorKit.downAction,
     "PAGE_UP", DefaultEditorKit.pageUpAction,
   "PAGE_DOWN", DefaultEditorKit.pageDownAction,
       "ENTER", DefaultEditorKit.insertBreakAction,
         "TAB", DefaultEditorKit.insertTabAction
  });
 

Если keyBindingList's длина нечетна, последний элемент игнорируется.

Предоставление a null значение для любого key или action часть key-action парные результаты в создании a KeyBinding с соответствующим значением null. Поскольку другие части Swing ожидают non-null значения в a KeyBinding, следует избежать предоставлять null как любой key или action часть key-action пара.

Параметры:

keyBindingList - массив key-action пары

Возвраты:

массив KeyBindings

Броски:

NullPointerException - если keyBindingList null

ClassCastException - если key часть пары не является a KeyStroke или String, или action часть пары не является a String

См. Также:

ActionMap, InputMap, KeyStroke.getKeyStroke(char)

makeInputMap

public static InputMap makeInputMap(Object[] keys)

Создает a InputMapUIResource от keys. Это - метод удобства для того, чтобы создать новое InputMapUIResource, вызов loadKeyBindings(map, keys), и возврат InputMapUIResource.

Параметры:

keys - переменные пары keystroke-action key пары как описано в loadKeyBindings(javax.swing.InputMap, java.lang.Object[])

Возвраты:

недавно создаваемый и заполненный InputMapUIResource

С тех пор:

1.3

См. Также:

loadKeyBindings(javax.swing.InputMap, java.lang.Object[])

makeComponentInputMap

public static ComponentInputMap makeComponentInputMap(JComponent c,
                                      Object[] keys)

Создает a ComponentInputMapUIResource от keys. Это - метод удобства для того, чтобы создать новое ComponentInputMapUIResource, вызов loadKeyBindings(map, keys), и возврат ComponentInputMapUIResource.

Параметры:

c - компонент, чтобы создать ComponentInputMapUIResource с

keys - переменные пары keystroke-action key пары как описано в loadKeyBindings(javax.swing.InputMap, java.lang.Object[])

Возвраты:

недавно создаваемый и заполненный InputMapUIResource

Броски:

IllegalArgumentException - если c null

С тех пор:

1.3

См. Также:

loadKeyBindings(javax.swing.InputMap, java.lang.Object[]), ComponentInputMapUIResource

loadKeyBindings

public static void loadKeyBindings(InputMap retMap,
                   Object[] keys)

Заполняет InputMap с указанной привязкой. Привязка предоставляется как список чередования keystroke-action key пары. keystroke любой экземпляр KeyStroke, или a String это идентифицирует KeyStroke для привязки. Обратитесь к KeyStroke.getKeyStroke(String) для определенного формата. action key часть пары является ключом, зарегистрированным в InputMap для KeyStroke.

Следующее иллюстрирует загрузку InputMap с два key-action пары:

   LookAndFeel.loadKeyBindings(inputMap, new Object[] {
     "control X", "cut",
     "control V", "paste"
   });
 

Предоставление a null список привязки (keys) не изменяется retMap всегда.

Определение a null action key результаты в удалении keystroke's запись от InputMap. A null keystroke игнорируется.

Параметры:

retMap - InputMap добавить key-action пары к

keys - привязка, чтобы добавить к retMap

Броски:

NullPointerException - если keys non-null, не пустой, и retMap null

С тех пор:

1.3

См. Также:

KeyStroke.getKeyStroke(String), InputMap

makeIcon

public static Object makeIcon(Class<?> baseClass,
              String gifFile)

Создает и возвращает a UIDefault.LazyValue это загружает изображение. Возвращенное значение является реализацией UIDefaults.LazyValue. Когда createValue вызывается на возвращенный объект, изображение загружается. Если изображение non-null, это тогда обертывается в Icon это реализует UIResource. Изображение загружается, используя Class.getResourceAsStream(gifFile).

Этот метод не проверяет параметры всегда. Этому строго рекомендуют это non-null значения еще предоставляются, исключения могут произойти когда createValue вызывается на возвращенный объект.

Параметры:

baseClass - Class используемый, чтобы загрузить ресурс

gifFile - соедините каналом к изображению, чтобы загрузиться

Возвраты:

a UIDefaults.LazyValue; когда разрешено LazyValue загружает указанное изображение

См. Также:

UIDefaults.LazyValue, Icon, Class.getResourceAsStream(String)

getLayoutStyle

public LayoutStyle getLayoutStyle()

Возвраты LayoutStyle для этого стили. Это никогда не возвращается null.

Вы обычно не используете LayoutStyle от стили вместо этого используйте LayoutStyle метод getInstance.

Возвраты:

LayoutStyle для этого стили

С тех пор:

1.6

См. Также:

LayoutStyle.getInstance()

provideErrorFeedback

public void provideErrorFeedback(Component component)

Вызванный, когда пользователь делает попытку недопустимой работы, такой как вставка в недоступное для редактирования JTextField это фокусируется. Звуковые сигналы реализации по умолчанию. Подклассы, которые желают различное поведение, должны переопределить это и обеспечить дополнительную обратную связь.

Параметры:

component - Component ошибка произошла в, может быть null указание на состояние ошибки непосредственно не связывается с a Component

С тех пор:

1.4

getDesktopPropertyValue

public static Object getDesktopPropertyValue(String systemPropertyName,
                             Object fallbackValue)

Возвращает значение указанного системного настольного свойства, вызывая Toolkit.getDefaultToolkit().getDesktopProperty(). Если значение указанного свойства null, fallbackValue возвращается.

Параметры:

systemPropertyName - имя системного настольного запрашиваемого свойства

fallbackValue - объект, который будет возвращен как значение, если системное значение является нулем

Возвраты:

текущая стоимость настольного свойства

С тех пор:

1.4

См. Также:

Toolkit.getDesktopProperty(java.lang.String)

getDisabledIcon

public Icon getDisabledIcon(JComponent component,
                   Icon icon)

Возвраты Icon с отключенным появлением. Этот метод используется, чтобы генерировать отключенный Icon когда каждый не был определен. Например, если Вы создаете a JButton и только определите Icon через setIcon этот метод вызовут, чтобы генерировать отключенный Icon. Если null передается как icon этот метод возвраты null.

Некоторый взгляд и чувства не могли бы представить отключенный Icon, когда они проигнорируют это.

Параметры:

component - JComponent это выведет на экран Icon, может быть null

icon - Icon генерировать отключенный значок от

Возвраты:

отключенный Icon, или null если подходящее Icon не может быть сгенерирован

С тех пор:

1.5

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon(JComponent component,
                           Icon icon)

Возвраты Icon для использования отключенными компонентами, которые также выбираются. Этот метод используется, чтобы генерировать Icon для компонентов, которые находятся в обоих отключенные и выбранные состояния, но не имеют определенного Icon для этого состояния. Например, если Вы создаете a JButton и только определите Icon через setIcon этот метод вызовут, чтобы генерировать отключенный и выбранный Icon. Если null передается как icon это возвраты методов null.

Некоторый взгляд и чувства не могли бы представить отключенный и выбранный Icon, когда они проигнорируют это.

Параметры:

component - JComponent это выведет на экран Icon, может быть null

icon - Icon генерировать отключенный и выбранный значок от

Возвраты:

отключенный и выбранный значок, или null если подходящее Icon не может быть сгенерирован.

С тех пор:

1.5

getName

public abstract String getName()

Возвратите короткую строку, которая идентифицирует этот стиль, например, "CDE/Motif". Эта строка должна быть подходящей для пункта меню. У отличного взгляда и чувств должны быть различные имена, например, подкласс MotifLookAndFeel, который изменяет способ, которым представляются несколько компонентов, должен быть вызван "CDE/Motif Моим Путем"; что-то, что было бы полезно для пользователя, пытающегося выбрать L&F из списка имен.

Возвраты:

короткий идентификатор для стили

getID

public abstract String getID()

Возвратите строку, которая идентифицирует этот стиль. Эта строка будет использоваться приложениями/службами, которые хотят распознать известные реализации стили. Теперь известными именами является "Мотив", "Windows", "Mac", "Металл". Отметьте, что LookAndFeel, полученный из известного суперкласса, который не делает коренных изменений к взгляду или чувству, не должен переопределить этот метод.

Возвраты:

идентификатор для стили

getDescription

public abstract String getDescription()

Возвратите одно описание строки этой реализации стили, например, "Стиль CDE/Motif". Эта строка предназначается для пользователя, например, в заголовке окна или в сообщении ToolTip.

Возвраты:

краткое описание для стили

getSupportsWindowDecorations

public boolean getSupportsWindowDecorations()

Возвраты true если LookAndFeel возвращенный RootPaneUI обеспечение поддержки экземпляров Window художественные оформления в a JRootPane.

Возвраты реализации по умолчанию false, подклассы та поддержка Window художественные оформления должны переопределить это и возврат true.

Возвраты:

true если RootPaneUI экземпляры, создаваемые этим стилем, поддерживают художественные оформления клиентской стороны

С тех пор:

1.4

См. Также:

JDialog.setDefaultLookAndFeelDecorated(boolean), JFrame.setDefaultLookAndFeelDecorated(boolean), JRootPane.setWindowDecorationStyle(int)

isNativeLookAndFeel

public abstract boolean isNativeLookAndFeel()

Если у базовой платформы есть "собственный" стиль, и это - реализация ее, возвратиться true. Например, когда базовой платформой является Солярис, выполняющий CDE, реализация стили CDE/Motif возвратилась бы true.

Возвраты:

true если этот стиль представляет базовый стиль платформы

isSupportedLookAndFeel

public abstract boolean isSupportedLookAndFeel()

Возвратиться true если базовая платформа поддерживает и или разрешает этот стиль. Этот метод возвраты false если стиль зависит от специальных ресурсов или юридических соглашений, которые не определяются для текущей платформы.

Возвраты:

true если это - поддерживаемый стиль

См. Также:

UIManager.setLookAndFeel(javax.swing.LookAndFeel)

инициализировать

public void initialize()

Инициализирует стиль. В то время как этот метод общедоступен, он должен только быть вызван UIManager когда стиль устанавливается как текущий стиль. Этот метод вызывается перед UIManager вызывает getDefaults. Этот метод предназначается, чтобы выполнить любую инициализацию для стили. Подклассы должны сделать любую одноразовую установку, в которой они нуждаются здесь, а не в статическом инициализаторе, потому что объекты класса стили могут быть загружены только, чтобы обнаружить это isSupportedLookAndFeel() возвраты false.

См. Также:

uninitialize(), UIManager.setLookAndFeel(javax.swing.LookAndFeel)

деинициализация

public void uninitialize()

Деинициализирует стиль. В то время как этот метод общедоступен, он должен только быть вызван UIManager когда стиль удаляется. Например, UIManager.setLookAndFeel вызывает это, когда стиль изменяется.

Подклассы могут хотеть освобождать некоторые ресурсы здесь.

См. Также:

initialize(), UIManager.setLookAndFeel(javax.swing.LookAndFeel)

getDefaults

public UIDefaults getDefaults()

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

Возвраты:

значения по умолчанию стили

См. Также:

initialize(), uninitialize(), UIManager.setLookAndFeel(javax.swing.LookAndFeel)

toString

public String toString()

Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.

Переопределения:

toString в классе Object

Возвраты:

Строковое представление этого объекта