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()
Возвращает массив
LookAndFeelInfo s представление LookAndFeel в настоящий момент доступные реализации. |
static int |
getInt(Object key)
Возвращает целое число из значений по умолчанию.
|
static int |
getInt(Object key, Locale l)
Возвращает целое число из значений по умолчанию, которое является подходящим для данной локали.
|
static LookAndFeel |
getLookAndFeel()
Возвращает текущий стиль или
null . |
static UIDefaults |
getLookAndFeelDefaults()
Возвраты
UIDefaults от текущего стили, которые были получены в то время, когда был установлен стиль. |
static PropertyChangeListener[] |
getPropertyChangeListeners()
Возвращает массив весь
PropertyChangeListener s добавленный к этому 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()
LookAndFeelInfo
s представление 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
null
SecurityException
getInstalledLookAndFeels()
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
.null
setLookAndFeel(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()
возвраты false
getLookAndFeel()
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, который расширяется LookAndFeel
public 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
null
public static Font getFont(Object key, Locale l)
key
не a Font
, null
возвращается.key
- Object
определение шрифтаl
- Locale
для которого требуется шрифт; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяFont
объектNullPointerException
- если key
null
public static Color getColor(Object key)
key
не a Color
, null
возвращается.key
- Object
определение цветаColor
объектNullPointerException
- если key
null
public static Color getColor(Object key, Locale l)
key
не a Color
, null
возвращается.key
- Object
определение цветаl
- Locale
для которого требуется цвет; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяColor
объектNullPointerException
- если key
null
public static Icon getIcon(Object key)
Icon
от значений по умолчанию. Если значение для key
не Icon
, null
возвращается.key
- Object
определение значкаIcon
объектNullPointerException
- если key
null
public static Icon getIcon(Object key, Locale l)
Icon
от значений по умолчанию, который является подходящим для данной локали. Если значение для key
не Icon
, null
возвращается.key
- Object
определение значкаl
- Locale
для которого требуется значок; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяIcon
объектNullPointerException
- если key
null
public static Border getBorder(Object key)
key
не a Border
, null
возвращается.key
- Object
определение границыBorder
объектNullPointerException
- если key
null
public static Border getBorder(Object key, Locale l)
key
не a Border
, null
возвращается.key
- Object
определение границыl
- Locale
для которого требуется граница; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяBorder
объектNullPointerException
- если key
null
public static String getString(Object key)
key
не a String
, null
возвращается.key
- Object
определение строкиString
NullPointerException
- если key
null
public static String getString(Object key, Locale l)
key
не a String
, null
возвращается.key
- Object
определение строкиl
- Locale
для которого требуется строка; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяString
NullPointerException
- если key
null
public static int getInt(Object key)
key
не Integer
, или не существует, 0
возвращается.key
- Object
определение интервалаNullPointerException
- если key
null
public static int getInt(Object key, Locale l)
key
не Integer
, или не существует, 0
возвращается.key
- Object
определение интервалаl
- Locale
для которого требуется интервал; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяNullPointerException
- если key
null
public static boolean getBoolean(Object key)
false
возвращается.key
- Object
определение ключа для требуемого булева значенияNullPointerException
- если key
null
public static boolean getBoolean(Object key, Locale l)
Locale
. Если ключ не находится, или ключ не представляет булево значение тогда false
будет возвращен.key
- Object
определение ключа для требуемого булева значенияl
- Locale
для которого требуется булево; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяNullPointerException
- если key
null
public static Insets getInsets(Object key)
Insets
объект от значений по умолчанию. Если значение для key
не Insets
, null
возвращается.key
- Object
определение Insets
объектInsets
объектNullPointerException
- если key
null
public static Insets getInsets(Object key, Locale l)
Insets
объект от значений по умолчанию, который является подходящим для данной локали. Если значение для key
не Insets
, null
возвращается.key
- Object
определение Insets
объектl
- Locale
для которого требуется объект; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяInsets
объектNullPointerException
- если key
null
public static Dimension getDimension(Object key)
key
не a Dimension
, null
возвращается.key
- Object
определение объекта размерностиDimension
объектNullPointerException
- если key
null
public static Dimension getDimension(Object key, Locale l)
key
не a Dimension
, null
возвращается.key
- Object
определение объекта размерностиl
- Locale
для которого требуется объект; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяDimension
объектNullPointerException
- если key
null
public static Object get(Object key)
key
- Object
определение требуемого объектаObject
NullPointerException
- если key
null
public static Object get(Object key, Locale l)
key
- Object
определение требуемого объектаl
- Locale
для которого требуется объект; обратитесь к UIDefaults
для деталей, на как a null
Locale
обрабатываетсяObject
NullPointerException
- если key
null
public 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
null
UIDefaults.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
объект для target
NullPointerException
- если target
null
UIDefaults.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. Отметьте, что они не то же самое как установленный взгляд и чувства.
LookAndFeel
s или null
addAuxiliaryLookAndFeel(javax.swing.LookAndFeel)
, removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel)
, setLookAndFeel(javax.swing.LookAndFeel)
, getInstalledLookAndFeels()
public static void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
к списку слушателя. Слушатель регистрируется для всех свойств.listener
- PropertyChangeListener
быть добавленнымPropertyChangeSupport
public static void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
от списка слушателя. Это удаляет a PropertyChangeListener
это было зарегистрировано для всех свойств.listener
- PropertyChangeListener
быть удаленнымPropertyChangeSupport
public static PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
s добавленный к этому UIManager с addPropertyChangeListener ().PropertyChangeListener
s добавленный или пустой массив, если никакие слушатели не были добавлены
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
ЧЕРНОВАЯ земля-b92