|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public class UIManager extends Object implements Serializable
UIManager управляет текущим стилем, набором доступного взгляда и чувств, PropertyChangeListeners это уведомляется, когда стиль изменяется, значения по умолчанию стили, и методы удобства для того, чтобы получить различные значения по умолчанию. LookAndFeel и передача этого к setLookAndFeel. Следующий пример иллюстрирует установку стили к системному стили: UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());Следующий пример иллюстрирует установку стили, основанного на имени class:
UIManager.setLookAndFeel("javax.swing.plaf.metal.MetalLookAndFeel");
Как только стиль был изменен, обязательно вызвать updateUI на всех JComponents. Метод SwingUtilities.updateComponentTreeUI(java.awt.Component) облегчает применяться updateUI к иерархии включения. Обратитесь к этому для деталей. Точное поведение не вызова updateUI после изменения стили является неуказанным. Очень возможно получить неожиданные исключения, крася проблемы, или хуже. swing.defaultlaf non-null, используйте его значение в качестве стили значения по умолчанию имя class. Properties файл swing.properties существует и содержит ключ swing.defaultlaf, используйте его значение в качестве стили значения по умолчанию имя class. Расположение, которое проверяется на swing.properties может измениться в зависимости от реализации платформы Java. Обычно swing.properties файл располагается в lib подкаталог каталога установки Java. Сошлитесь на информацию о версии реализации, используемой для получения дальнейшей информации. UIManager управляет тремя наборами UIDefaults. В порядке они: setLookAndFeel() вызывается). Значения по умолчанию стили могут быть получены, используя getLookAndFeelDefaults() метод. get методы приводят к проверке каждого из значений по умолчанию, в порядке, возвращая первое non-null значение. Например, вызов UIManager.getString("Table.foreground") результаты в первых значениях по умолчанию разработчика проверки. Если значения по умолчанию разработчика содержат значение для "Table.foreground" это возвращается, иначе значения по умолчанию стили проверяются, сопровождаются системными значениями по умолчанию. Важно отметить это getDefaults возвращает пользовательский экземпляр UIDefaults с этой логикой разрешения, встроенной в это. Например, UIManager.getDefaults().getString("Table.foreground") эквивалентно UIManager.getString("Table.foreground"). Оба решения, используя алгоритм только описываются. Во многих местах документация использует значения по умолчанию слова, чтобы обратиться к пользовательскому экземпляру UIDefaults с логикой разрешения как ранее описано.
Когда стиль изменяется, UIManager изменяет только значения по умолчанию стили; разработчик и системные значения по умолчанию не изменяются UIManager всегда.
Набор значений по умолчанию, которые поддерживает определенный стиль, определяется и документируется тем стилем. Кроме того, каждый стиль, или ComponentUI если стилем, может получить доступ к значениям по умолчанию в разное время в их жизненном цикле. Некоторый взгляд и чувства могут агрессивно искать значения по умолчанию, так, чтобы изменение значения по умолчанию, возможно, не имело эффекта после установки стили. Другой взгляд и чувства могут лениво получить доступ к значениям по умолчанию так, чтобы изменение к значениям по умолчанию могло произвести существующий стиль. Наконец, другой взгляд и чувства не могли бы сконфигурировать себя от таблицы значений по умолчанию всегда. Тем не менее, это обычно имеет место, что стиль ожидает определенные значения по умолчанию, так, чтобы в общем a ComponentUI если одним стилем не будет работать с другим стилем.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.
| Модификатор и Тип | Класс и Описание |
|---|---|
static class |
UIManager. LookAndFeelInfo
Предоставляет немного информации об установленном
LookAndFeel ради конфигурирования меню или для начального приложения устанавливается. |
| Конструктор и Описание |
|---|
UIManager() |
| Модификатор и Тип | Метод и Описание |
|---|---|
static void |
addAuxiliaryLookAndFeel(LookAndFeel laf)
Добавляет a
LookAndFeel к списку вспомогательного взгляда и чувств. |
static void |
addPropertyChangeListener(PropertyChangeListener listener)
Добавляет a
PropertyChangeListener к списку слушателя. |
static Object |
get(Object key)
Возвращает объект из значений по умолчанию.
|
static Object |
get(Object key, Locale l)
Возвращает объект из значений по умолчанию, который является подходящим для данной локали.
|
static LookAndFeel[] |
getAuxiliaryLookAndFeels()
Возвращает список вспомогательного взгляда, и чувства (может быть
null). |
static boolean |
getBoolean(Object key)
Возвращает булево из значений по умолчанию, которое связывается со значением ключа.
|
static boolean |
getBoolean(Object key, Locale l)
Возвращает булево из значений по умолчанию, которое связывается со значением ключа и данным
Locale. |
static Border |
getBorder(Object key)
Возвращает границу из значений по умолчанию.
|
static Border |
getBorder(Object key, Locale l)
Возвращает границу из значений по умолчанию, которая является подходящей для данной локали.
|
static Color |
getColor(Object key)
Возвращает цвет из значений по умолчанию.
|
static Color |
getColor(Object key, Locale l)
Возвращает цвет из значений по умолчанию, который является подходящим для данной локали.
|
static String |
getCrossPlatformLookAndFeelClassName()
Возвращает имя
LookAndFeel class, который реализует перекрестный стиль платформы значения по умолчанию - Стиль Java (JLF). |
static UIDefaults |
getDefaults()
Возвращает значения по умолчанию.
|
static Dimension |
getDimension(Object key)
Возвращает размерность из значений по умолчанию.
|
static Dimension |
getDimension(Object key, Locale l)
Возвращает размерность из значений по умолчанию, которая является подходящей для данной локали.
|
static Font |
getFont(Object key)
Возвращает шрифт из значений по умолчанию.
|
static Font |
getFont(Object key, Locale l)
Возвращает шрифт из значений по умолчанию, который является подходящим для данной локали.
|
static Icon |
getIcon(Object key)
Возвраты
Icon от значений по умолчанию. |
static Icon |
getIcon(Object key, Locale l)
Возвраты
Icon от значений по умолчанию, который является подходящим для данной локали. |
static Insets |
getInsets(Object key)
Возвраты
Insets объект от значений по умолчанию. |
static Insets |
getInsets(Object key, Locale l)
Возвраты
Insets объект от значений по умолчанию, который является подходящим для данной локали. |
static UIManager.LookAndFeelInfo[] |
getInstalledLookAndFeels()
Возвращает массив
LookAndFeelInfos представление LookAndFeel в настоящий момент доступные реализации. |
static int |
getInt(Object key)
Возвращает целое число из значений по умолчанию.
|
static int |
getInt(Object key, Locale l)
Возвращает целое число из значений по умолчанию, которое является подходящим для данной локали.
|
static LookAndFeel |
getLookAndFeel()
Возвращает текущий стиль или
null. |
static UIDefaults |
getLookAndFeelDefaults()
Возвраты
UIDefaults от текущего стили, которые были получены в то время, когда был установлен стиль. |
static PropertyChangeListener[] |
getPropertyChangeListeners()
Возвращает массив весь
PropertyChangeListeners добавленный к этому UIManager с addPropertyChangeListener (). |
static String |
getString(Object key)
Возвращает строку из значений по умолчанию.
|
static String |
getString(Object key, Locale l)
Возвращает строку из значений по умолчанию, которая является подходящей для данной локали.
|
static String |
getSystemLookAndFeelClassName()
Возвращает имя
LookAndFeel class, который реализует собственный системный стиль, если есть один, иначе имя перекрестной платформы значения по умолчанию LookAndFeel class. |
static ComponentUI |
getUI(JComponent target)
Возвращает соответствующее
ComponentUI реализация для target. |
static void |
installLookAndFeel(String name, String className)
Добавляет указанный стиль к набору доступного взгляда и чувств.
|
static void |
installLookAndFeel(UIManager.LookAndFeelInfo info)
Добавляет указанный стиль к набору доступного взгляда и чувств.
|
static Object |
put(Object key, Object value)
Хранит объект в значениях по умолчанию разработчика.
|
static boolean |
removeAuxiliaryLookAndFeel(LookAndFeel laf)
Удаляет a
LookAndFeel от списка вспомогательного взгляда и чувств. |
static void |
removePropertyChangeListener(PropertyChangeListener listener)
Удаляет a
PropertyChangeListener от списка слушателя. |
static void |
setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
Устанавливает набор доступного взгляда и чувств.
|
static void |
setLookAndFeel(LookAndFeel newLookAndFeel)
Устанавливает текущий стиль в
newLookAndFeel. |
static void |
setLookAndFeel(String className)
Загрузки
LookAndFeel определенный данным именем class, используя контекст текущего потока загрузчик class, и передачи это к setLookAndFeel(LookAndFeel). |
public static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()
LookAndFeelInfos представление LookAndFeel в настоящий момент доступные реализации. LookAndFeelInfo объекты могут использоваться приложением, чтобы создать меню опций стили для пользователя, или определить который стиль установить во время запуска. Избегать штрафа создания многочисленного LookAndFeel объекты, LookAndFeelInfo поддерживает имя class LookAndFeel class, не фактическое LookAndFeel экземпляр. Следующий пример иллюстрирует установку текущего стили от экземпляра LookAndFeelInfo:
UIManager.setLookAndFeel(info.getClassName());
LookAndFeelInfo объектыsetLookAndFeel(javax.swing.LookAndFeel)public static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos) throws SecurityException
LookAndFeelInfos non-null, этому строго рекомендуют это только non-null значения предоставляются в infos массив.infos - набор LookAndFeelInfo объекты, определяющие доступный взгляд и чувстваNullPointerException - если infos nullSecurityExceptiongetInstalledLookAndFeels()public static void installLookAndFeel(UIManager.LookAndFeelInfo info)
null info, этому строго рекомендуют это a non-null оцените использоваться.info - a LookAndFeelInfo возразите, что называет стиль и идентифицирует class, который реализует егоsetInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])public static void installLookAndFeel(String name, String className)
non-null значения быть предоставленным.name - описательное имя стилиclassName - имя class, который реализует стильsetInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])public static LookAndFeel getLookAndFeel()
null.nullsetLookAndFeel(javax.swing.LookAndFeel)public static void setLookAndFeel(LookAndFeel newLookAndFeel) throws UnsupportedLookAndFeelException
newLookAndFeel. Если текущий стиль non-null uninitialize вызывается на это. Если newLookAndFeel non-null, initialize вызывается на сопровождаемое getDefaults. Значения по умолчанию, возвращенные из newLookAndFeel.getDefaults() таковые замены из значений по умолчанию от предыдущего стили. Если newLookAndFeel null, значения по умолчанию стили устанавливаются в null. Значение null может использоваться, чтобы установить стиль в null. Как LookAndFeel требуется для большей части Swing функционировать, устанавливая LookAndFeel к null строго обескураживается.
Это - JavaBeans связанное свойство.
newLookAndFeel - LookAndFeel устанавливатьUnsupportedLookAndFeelException - если newLookAndFeel non-null и newLookAndFeel.isSupportedLookAndFeel() возвраты falsegetLookAndFeel()public static void setLookAndFeel(String className) throws ClassNotFoundException, InstantiationException, IllegalAccessException, UnsupportedLookAndFeelException
LookAndFeel определенный данным именем class, используя контекст текущего потока загрузчик class, и передачи это к setLookAndFeel(LookAndFeel).className - строка, определяющая имя class, который реализует стильClassNotFoundException - если LookAndFeel class не мог быть найденInstantiationException - если новый экземпляр class не мог бы быть созданIllegalAccessException - если class или инициализатор не доступныUnsupportedLookAndFeelException - если lnf.isSupportedLookAndFeel() ложьClassCastException - если className не идентифицирует class, который расширяется LookAndFeelpublic static String getSystemLookAndFeelClassName()
LookAndFeel class, который реализует собственный системный стиль, если есть один, иначе имя перекрестной платформы значения по умолчанию LookAndFeel class. Это значение может быть overriden, устанавливая swing.systemlaf системное свойство.String из LookAndFeel classsetLookAndFeel(javax.swing.LookAndFeel), getCrossPlatformLookAndFeelClassName()public static String getCrossPlatformLookAndFeelClassName()
LookAndFeel class, который реализует перекрестный стиль платформы значения по умолчанию - Стиль Java (JLF). Это значение может быть overriden, устанавливая swing.crossplatformlaf системное свойство.setLookAndFeel(javax.swing.LookAndFeel), getSystemLookAndFeelClassName()public static UIDefaults getDefaults()
UIDefaults объект, содержащий значения по умолчаниюpublic static Font getFont(Object key)
key не a Font, null возвращается.key - Object определение шрифтаFont объектNullPointerException - если key nullpublic static Font getFont(Object key, Locale l)
key не a Font, null возвращается.key - Object определение шрифтаl - Locale для которого требуется шрифт; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяFont объектNullPointerException - если key nullpublic static Color getColor(Object key)
key не a Color, null возвращается.key - Object определение цветаColor объектNullPointerException - если key nullpublic static Color getColor(Object key, Locale l)
key не a Color, null возвращается.key - Object определение цветаl - Locale для которого требуется цвет; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяColor объектNullPointerException - если key nullpublic static Icon getIcon(Object key)
Icon от значений по умолчанию. Если значение для key не Icon, null возвращается.key - Object определение значкаIcon объектNullPointerException - если key nullpublic static Icon getIcon(Object key, Locale l)
Icon от значений по умолчанию, который является подходящим для данной локали. Если значение для key не Icon, null возвращается.key - Object определение значкаl - Locale для которого требуется значок; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяIcon объектNullPointerException - если key nullpublic static Border getBorder(Object key)
key не a Border, null возвращается.key - Object определение границыBorder объектNullPointerException - если key nullpublic static Border getBorder(Object key, Locale l)
key не a Border, null возвращается.key - Object определение границыl - Locale для которого требуется граница; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяBorder объектNullPointerException - если key nullpublic static String getString(Object key)
key не a String, null возвращается.key - Object определение строкиStringNullPointerException - если key nullpublic static String getString(Object key, Locale l)
key не a String, null возвращается.key - Object определение строкиl - Locale для которого требуется строка; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяStringNullPointerException - если key nullpublic static int getInt(Object key)
key не Integer, или не существует, 0 возвращается.key - Object определение интервалаNullPointerException - если key nullpublic static int getInt(Object key, Locale l)
key не Integer, или не существует, 0 возвращается.key - Object определение интервалаl - Locale для которого требуется интервал; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяNullPointerException - если key nullpublic static boolean getBoolean(Object key)
false возвращается.key - Object определение ключа для требуемого булева значенияNullPointerException - если key nullpublic static boolean getBoolean(Object key, Locale l)
Locale. Если ключ не находится, или ключ не представляет булево значение тогда false будет возвращен.key - Object определение ключа для требуемого булева значенияl - Locale для которого требуется булево; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяNullPointerException - если key nullpublic static Insets getInsets(Object key)
Insets объект от значений по умолчанию. Если значение для key не Insets, null возвращается.key - Object определение Insets объектInsets объектNullPointerException - если key nullpublic static Insets getInsets(Object key, Locale l)
Insets объект от значений по умолчанию, который является подходящим для данной локали. Если значение для key не Insets, null возвращается.key - Object определение Insets объектl - Locale для которого требуется объект; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяInsets объектNullPointerException - если key nullpublic static Dimension getDimension(Object key)
key не a Dimension, null возвращается.key - Object определение объекта размерностиDimension объектNullPointerException - если key nullpublic static Dimension getDimension(Object key, Locale l)
key не a Dimension, null возвращается.key - Object определение объекта размерностиl - Locale для которого требуется объект; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяDimension объектNullPointerException - если key nullpublic static Object get(Object key)
key - Object определение требуемого объектаObjectNullPointerException - если key nullpublic static Object get(Object key, Locale l)
key - Object определение требуемого объектаl - Locale для которого требуется объект; обратитесь к UIDefaults для деталей, на как a null
Locale обрабатываетсяObjectNullPointerException - если key nullpublic static Object put(Object key, Object value)
getDefaults().put(key, value). Это только производит значения по умолчанию разработчика, не значения по умолчанию стили или систему.key - Object определение ключа извлеченияvalue - Object сохранить; обратитесь к UIDefaults для деталей, на как null обрабатываетсяObject возвращенный UIDefaults.put(java.lang.Object, java.lang.Object)NullPointerException - если key nullUIDefaults.put(java.lang.Object, java.lang.Object)public static ComponentUI getUI(JComponent target)
ComponentUI реализация для target. Как правило, это - прикрытие для getDefaults().getUI(target). Однако, если вспомогательный стиль был установлен, это сначала вызывает getUI(target) на значениях по умолчанию стили мультиплексирования, и возвратах, которые оценивают, если это non-null.target - JComponent возвратиться ComponentUI дляComponentUI объект для targetNullPointerException - если target nullUIDefaults.getUI(javax.swing.JComponent)public static UIDefaults getLookAndFeelDefaults()
UIDefaults от текущего стили, которые были получены в то время, когда был установлен стиль. Вообще, разработчики должны использовать UIDefaults возвращенный из getDefaults(). Поскольку текущий стиль может ожидать, что определенные значения будут существовать, изменяясь UIDefaults возвращенный из этого метода мог иметь неожиданные результаты.
UIDefaults от текущего стилиgetDefaults(), setLookAndFeel(LookAndFeel), LookAndFeel.getDefaults()public static void addAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel к списку вспомогательного взгляда и чувств. Вспомогательный взгляд и чувства говорят стиль мультиплексирования что другой LookAndFeel классы для компонентного экземпляра должны использоваться в дополнение к значению по умолчанию LookAndFeel class, создавая мультиплексирование UI. Изменение только вступит в силу, когда новый UI, class создается или когда стиль значения по умолчанию изменяется на компонентном экземпляре. Отметьте, что они не то же самое как установленный взгляд и чувства.
laf - LookAndFeel объектremoveAuxiliaryLookAndFeel(javax.swing.LookAndFeel), setLookAndFeel(javax.swing.LookAndFeel), getAuxiliaryLookAndFeels(), getInstalledLookAndFeels()public static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel от списка вспомогательного взгляда и чувств. Вспомогательный взгляд и чувства говорят стиль мультиплексирования что другой LookAndFeel классы для компонентного экземпляра должны использоваться в дополнение к значению по умолчанию LookAndFeel class, создавая мультиплексирование UI. Изменение только вступит в силу, когда новый UI, class создается или когда стиль значения по умолчанию изменяется на компонентном экземпляре. Отметьте, что они не то же самое как установленный взгляд и чувства.
LookAndFeel был удален из спискаremoveAuxiliaryLookAndFeel(javax.swing.LookAndFeel), getAuxiliaryLookAndFeels(), setLookAndFeel(javax.swing.LookAndFeel), getInstalledLookAndFeels()public static LookAndFeel[] getAuxiliaryLookAndFeels()
null). Вспомогательный взгляд и чувства говорят стиль мультиплексирования что другой LookAndFeel классы для компонентного экземпляра должны использоваться в дополнение к значению по умолчанию LookAndFeel class, создавая мультиплексирование UI. Отметьте, что они не то же самое как установленный взгляд и чувства.
LookAndFeels или nulladdAuxiliaryLookAndFeel(javax.swing.LookAndFeel), removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel), setLookAndFeel(javax.swing.LookAndFeel), getInstalledLookAndFeels()public static void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener к списку слушателя. Слушатель регистрируется для всех свойств.listener - PropertyChangeListener быть добавленнымPropertyChangeSupportpublic static void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener от списка слушателя. Это удаляет a PropertyChangeListener это было зарегистрировано для всех свойств.listener - PropertyChangeListener быть удаленнымPropertyChangeSupportpublic static PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListeners добавленный к этому UIManager с addPropertyChangeListener ().PropertyChangeListeners добавленный или пустой массив, если никакие слушатели не были добавлены
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
ЧЕРНОВАЯ земля-b92