|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
javax.swing
|
Nested Class Summary | |
---|---|
static class |
UIManager.LookAndFeelInfo
Provides a little information about an installed LookAndFeel for the sake of configuring a menu or
for initial application set up. |
Constructor Summary | |
---|---|
UIManager()
|
Method Summary | |
---|---|
static void |
addAuxiliaryLookAndFeel(LookAndFeel laf)
Adds a LookAndFeel to the list of auxiliary look and feels. |
static void |
addPropertyChangeListener(PropertyChangeListener listener)
Adds a PropertyChangeListener to the listener list. |
static Object |
get(Object key)
Returns an object from the defaults. |
static Object |
get(Object key,
Locale l)
Returns an object from the defaults that is appropriate for the given locale. |
static LookAndFeel[] |
getAuxiliaryLookAndFeels()
Returns the list of auxiliary look and feels (can be null ). |
static boolean |
getBoolean(Object key)
Returns a boolean from the defaults which is associated with the key value. |
static boolean |
getBoolean(Object key,
Locale l)
Returns a boolean from the defaults which is associated with the key value and the given Locale . |
static Border |
getBorder(Object key)
Returns a border from the defaults. |
static Border |
getBorder(Object key,
Locale l)
Returns a border from the defaults that is appropriate for the given locale. |
static Color |
getColor(Object key)
Returns a color from the defaults. |
static Color |
getColor(Object key,
Locale l)
Returns a color from the defaults that is appropriate for the given locale. |
static String |
getCrossPlatformLookAndFeelClassName()
Returns the name of the LookAndFeel class that implements
the default cross platform look and feel -- the Java
Look and Feel (JLF). |
static UIDefaults |
getDefaults()
Returns the defaults. |
static Dimension |
getDimension(Object key)
Returns a dimension from the defaults. |
static Dimension |
getDimension(Object key,
Locale l)
Returns a dimension from the defaults that is appropriate for the given locale. |
static Font |
getFont(Object key)
Returns a font from the defaults. |
static Font |
getFont(Object key,
Locale l)
Returns a font from the defaults that is appropriate for the given locale. |
static Icon |
getIcon(Object key)
Returns an Icon from the defaults. |
static Icon |
getIcon(Object key,
Locale l)
Returns an Icon from the defaults that is appropriate
for the given locale. |
static Insets |
getInsets(Object key)
Returns an Insets object from the defaults. |
static Insets |
getInsets(Object key,
Locale l)
Returns an Insets object from the defaults that is
appropriate for the given locale. |
static UIManager.LookAndFeelInfo[] |
getInstalledLookAndFeels()
Returns an array of LookAndFeelInfo s representing the
LookAndFeel implementations currently available. |
static int |
getInt(Object key)
Returns an integer from the defaults. |
static int |
getInt(Object key,
Locale l)
Returns an integer from the defaults that is appropriate for the given locale. |
static LookAndFeel |
getLookAndFeel()
Returns the current look and feel or null . |
static UIDefaults |
getLookAndFeelDefaults()
Returns the UIDefaults from the current look and feel,
that were obtained at the time the look and feel was installed. |
static PropertyChangeListener[] |
getPropertyChangeListeners()
Returns an array of all the PropertyChangeListener s added
to this UIManager with addPropertyChangeListener(). |
static String |
getString(Object key)
Returns a string from the defaults. |
static String |
getString(Object key,
Locale l)
Returns a string from the defaults that is appropriate for the given locale. |
static String |
getSystemLookAndFeelClassName()
Returns the name of the LookAndFeel class that implements
the native system look and feel if there is one, otherwise
the name of the default cross platform LookAndFeel
class. |
static ComponentUI |
getUI(JComponent target)
Returns the appropriate ComponentUI implementation for
target . |
static void |
installLookAndFeel(String name,
String className)
Adds the specified look and feel to the set of available look and feels. |
static void |
installLookAndFeel(UIManager.LookAndFeelInfo info)
Adds the specified look and feel to the set of available look and feels. |
static Object |
put(Object key,
Object value)
Stores an object in the developer defaults. |
static boolean |
removeAuxiliaryLookAndFeel(LookAndFeel laf)
Removes a LookAndFeel from the list of auxiliary look and feels. |
static void |
removePropertyChangeListener(PropertyChangeListener listener)
Removes a PropertyChangeListener from the listener list. |
static void |
setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
Sets the set of available look and feels. |
static void |
setLookAndFeel(LookAndFeel newLookAndFeel)
Sets the current look and feel to newLookAndFeel . |
static void |
setLookAndFeel(String className)
Loads the LookAndFeel specified by the given class
name, using the current thread's context class loader, and
passes it to setLookAndFeel(LookAndFeel) . |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public UIManager()
Method Detail |
---|
public static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()
LookAndFeelInfo
s representing the
LookAndFeel
implementations currently available. The
LookAndFeelInfo
objects can be used by an
application to construct a menu of look and feel options for
the user, or to determine which look and feel to set at startup
time. To avoid the penalty of creating numerous LookAndFeel
objects, LookAndFeelInfo
maintains the
class name of the LookAndFeel
class, not the actual
LookAndFeel
instance.
The following example illustrates setting the current look and feel
from an instance of LookAndFeelInfo
:
UIManager.setLookAndFeel(info.getClassName());
LookAndFeelInfo
objectssetLookAndFeel(javax.swing.LookAndFeel)
public static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos) throws SecurityException
LookAndFeelInfos
are
non-null
, it is strongly recommended that only non-null
values are supplied in the infos
array.
infos
- set of LookAndFeelInfo
objects specifying
the available look and feels
NullPointerException
- if infos
is null
SecurityException
getInstalledLookAndFeels()
public static void installLookAndFeel(UIManager.LookAndFeelInfo info)
null
info
,
it is strongly recommended that a non-null
value be used.
info
- a LookAndFeelInfo
object that names the
look and feel and identifies the class that implements itsetInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])
public static void installLookAndFeel(String name, String className)
non-null
values be supplied.
name
- descriptive name of the look and feelclassName
- name of the class that implements the look and feelsetInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])
public static LookAndFeel getLookAndFeel()
null
.
null
setLookAndFeel(javax.swing.LookAndFeel)
public static void setLookAndFeel(LookAndFeel newLookAndFeel) throws UnsupportedLookAndFeelException
newLookAndFeel
.
If the current look and feel is non-null
uninitialize
is invoked on it. If newLookAndFeel
is
non-null
, initialize
is invoked on it followed
by getDefaults
. The defaults returned from newLookAndFeel.getDefaults()
replace those of the defaults
from the previous look and feel. If the newLookAndFeel
is
null
, the look and feel defaults are set to null
.
A value of null
can be used to set the look and feel
to null
. As the LookAndFeel
is required for
most of Swing to function, setting the LookAndFeel
to
null
is strongly discouraged.
This is a JavaBeans bound property.
newLookAndFeel
- LookAndFeel
to install
UnsupportedLookAndFeelException
- if
newLookAndFeel
is non-null
and
newLookAndFeel.isSupportedLookAndFeel()
returns
false
getLookAndFeel()
public static void setLookAndFeel(String className) throws ClassNotFoundException, InstantiationException, IllegalAccessException, UnsupportedLookAndFeelException
LookAndFeel
specified by the given class
name, using the current thread's context class loader, and
passes it to setLookAndFeel(LookAndFeel)
.
className
- a string specifying the name of the class that implements
the look and feel
ClassNotFoundException
- if the LookAndFeel
class could not be found
InstantiationException
- if a new instance of the class
couldn't be created
IllegalAccessException
- if the class or initializer isn't accessible
UnsupportedLookAndFeelException
- if
lnf.isSupportedLookAndFeel()
is false
ClassCastException
- if className
does not identify
a class that extends LookAndFeel
public static String getSystemLookAndFeelClassName()
LookAndFeel
class that implements
the native system look and feel if there is one, otherwise
the name of the default cross platform LookAndFeel
class. This value can be overriden by setting the
swing.systemlaf
system property.
String
of the LookAndFeel
classsetLookAndFeel(javax.swing.LookAndFeel)
,
getCrossPlatformLookAndFeelClassName()
public static String getCrossPlatformLookAndFeelClassName()
LookAndFeel
class that implements
the default cross platform look and feel -- the Java
Look and Feel (JLF). This value can be overriden by setting the
swing.crossplatformlaf
system property.
setLookAndFeel(javax.swing.LookAndFeel)
,
getSystemLookAndFeelClassName()
public static UIDefaults getDefaults()
UIDefaults
object containing the default valuespublic static Font getFont(Object key)
key
is
not a Font
, null
is returned.
key
- an Object
specifying the font
Font
object
NullPointerException
- if key
is null
public static Font getFont(Object key, Locale l)
key
is
not a Font
, null
is returned.
key
- an Object
specifying the fontl
- the Locale
for which the font is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Font
object
NullPointerException
- if key
is null
public static Color getColor(Object key)
key
is
not a Color
, null
is returned.
key
- an Object
specifying the color
Color
object
NullPointerException
- if key
is null
public static Color getColor(Object key, Locale l)
key
is
not a Color
, null
is returned.
key
- an Object
specifying the colorl
- the Locale
for which the color is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Color
object
NullPointerException
- if key
is null
public static Icon getIcon(Object key)
Icon
from the defaults. If the value for
key
is not an Icon
, null
is returned.
key
- an Object
specifying the icon
Icon
object
NullPointerException
- if key
is null
public static Icon getIcon(Object key, Locale l)
Icon
from the defaults that is appropriate
for the given locale. If the value for
key
is not an Icon
, null
is returned.
key
- an Object
specifying the iconl
- the Locale
for which the icon is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Icon
object
NullPointerException
- if key
is null
public static Border getBorder(Object key)
key
is not a Border
, null
is returned.
key
- an Object
specifying the border
Border
object
NullPointerException
- if key
is null
public static Border getBorder(Object key, Locale l)
key
is not a Border
, null
is returned.
key
- an Object
specifying the borderl
- the Locale
for which the border is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Border
object
NullPointerException
- if key
is null
public static String getString(Object key)
key
is not a String
, null
is returned.
key
- an Object
specifying the string
String
NullPointerException
- if key
is null
public static String getString(Object key, Locale l)
key
is not a String
, null
is returned.
key
- an Object
specifying the stringl
- the Locale
for which the string is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
String
NullPointerException
- if key
is null
public static int getInt(Object key)
key
is not an Integer
, or does not exist,
0
is returned.
key
- an Object
specifying the int
NullPointerException
- if key
is null
public static int getInt(Object key, Locale l)
key
is not an Integer
, or does not exist,
0
is returned.
key
- an Object
specifying the intl
- the Locale
for which the int is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
NullPointerException
- if key
is null
public static boolean getBoolean(Object key)
false
is returned.
key
- an Object
specifying the key for the desired boolean value
NullPointerException
- if key
is null
public static boolean getBoolean(Object key, Locale l)
Locale
. If the key is not
found or the key doesn't represent
a boolean value then false
will be returned.
key
- an Object
specifying the key for the desired
boolean valuel
- the Locale
for which the boolean is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
NullPointerException
- if key
is null
public static Insets getInsets(Object key)
Insets
object from the defaults. If the value
for key
is not an Insets
, null
is returned.
key
- an Object
specifying the Insets
object
Insets
object
NullPointerException
- if key
is null
public static Insets getInsets(Object key, Locale l)
Insets
object from the defaults that is
appropriate for the given locale. If the value
for key
is not an Insets
, null
is returned.
key
- an Object
specifying the Insets
objectl
- the Locale
for which the object is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Insets
object
NullPointerException
- if key
is null
public static Dimension getDimension(Object key)
key
is not a Dimension
, null
is returned.
key
- an Object
specifying the dimension object
Dimension
object
NullPointerException
- if key
is null
public static Dimension getDimension(Object key, Locale l)
key
is not a Dimension
, null
is returned.
key
- an Object
specifying the dimension objectl
- the Locale
for which the object is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Dimension
object
NullPointerException
- if key
is null
public static Object get(Object key)
key
- an Object
specifying the desired object
Object
NullPointerException
- if key
is null
public static Object get(Object key, Locale l)
key
- an Object
specifying the desired objectl
- the Locale
for which the object is desired; refer
to UIDefaults
for details on how a null
Locale
is handled
Object
NullPointerException
- if key
is null
public static Object put(Object key, Object value)
getDefaults().put(key, value)
. This only effects the
developer defaults, not the system or look and feel defaults.
key
- an Object
specifying the retrieval keyvalue
- the Object
to store; refer to
UIDefaults
for details on how null
is
handled
Object
returned by UIDefaults.put(java.lang.Object, java.lang.Object)
NullPointerException
- if key
is null
UIDefaults.put(java.lang.Object, java.lang.Object)
public static ComponentUI getUI(JComponent target)
ComponentUI
implementation for
target
. Typically, this is a cover for
getDefaults().getUI(target)
. However, if an auxiliary
look and feel has been installed, this first invokes
getUI(target)
on the multiplexing look and feel's
defaults, and returns that value if it is non-null
.
target
- the JComponent
to return the
ComponentUI
for
ComponentUI
object for target
NullPointerException
- if target
is null
UIDefaults.getUI(javax.swing.JComponent)
public static UIDefaults getLookAndFeelDefaults()
UIDefaults
from the current look and feel,
that were obtained at the time the look and feel was installed.
In general, developers should use the UIDefaults
returned from
getDefaults()
. As the current look and feel may expect
certain values to exist, altering the UIDefaults
returned
from this method could have unexpected results.
UIDefaults
from the current look and feelgetDefaults()
,
setLookAndFeel(LookAndFeel)
,
LookAndFeel.getDefaults()
public static void addAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel
to the list of auxiliary look and feels.
The auxiliary look and feels tell the multiplexing look and feel what
other LookAndFeel
classes for a component instance are to be used
in addition to the default LookAndFeel
class when creating a
multiplexing UI. The change will only take effect when a new
UI class is created or when the default look and feel is changed
on a component instance.
Note these are not the same as the installed look and feels.
laf
- the LookAndFeel
objectremoveAuxiliaryLookAndFeel(javax.swing.LookAndFeel)
,
setLookAndFeel(javax.swing.LookAndFeel)
,
getAuxiliaryLookAndFeels()
,
getInstalledLookAndFeels()
public static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel
from the list of auxiliary look and feels.
The auxiliary look and feels tell the multiplexing look and feel what
other LookAndFeel
classes for a component instance are to be used
in addition to the default LookAndFeel
class when creating a
multiplexing UI. The change will only take effect when a new
UI class is created or when the default look and feel is changed
on a component instance.
Note these are not the same as the installed look and feels.
LookAndFeel
was removed from the listremoveAuxiliaryLookAndFeel(javax.swing.LookAndFeel)
,
getAuxiliaryLookAndFeels()
,
setLookAndFeel(javax.swing.LookAndFeel)
,
getInstalledLookAndFeels()
public static LookAndFeel[] getAuxiliaryLookAndFeels()
null
).
The auxiliary look and feels tell the multiplexing look and feel what
other LookAndFeel
classes for a component instance are
to be used in addition to the default LookAndFeel class when creating a
multiplexing UI.
Note these are not the same as the installed look and feels.
LookAndFeel
s or null
addAuxiliaryLookAndFeel(javax.swing.LookAndFeel)
,
removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel)
,
setLookAndFeel(javax.swing.LookAndFeel)
,
getInstalledLookAndFeels()
public static void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
to the listener list.
The listener is registered for all properties.
listener
- the PropertyChangeListener
to be addedPropertyChangeSupport
public static void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
from the listener list.
This removes a PropertyChangeListener
that was registered
for all properties.
listener
- the PropertyChangeListener
to be removedPropertyChangeSupport
public static PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
s added
to this UIManager with addPropertyChangeListener().
PropertyChangeListener
s added or an empty
array if no listeners have been added