Java Doc for BasicLookAndFeel.java in  » 6.0-JDK-Core » swing » javax » swing » plaf » basic » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Each of the ComponentUI s provided by BasicLookAndFeel derives its behavior from the defaults table. Unless otherwise noted each of the ComponentUI implementations in this package document the set of defaults they use. Unless otherwise noted the defaults are installed at the time installUI is invoked, and follow the recommendations outlined in LookAndFeel for installing defaults.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans^TM has been added to the java.beans package. Please see java.beans.XMLEncoder .
version:
   1.283 05/09/07
author:
   unattributed

If key is non-null , an Action is created using the value from the defaults with key key .

The returned ActionMap contains Actions that embody the ability to render an auditory cue.

If key is non-null , an Action is created using the value from the defaults with key key . The value identifies the sound resource to load when actionPerformed is invoked on the Action . The sound resource is loaded into a byte[] by way of getClass().getResourceAsStream() .
Parameters:
  key - the key identifying the audio action an Action used to play the source, or null if key is null
See Also:   BasicLookAndFeel.playSound(Action)
since:
   1.4

The returned ActionMap contains Actions that embody the ability to render an auditory cue. These auditory cues map onto user and system activities that may be useful for an end user to know about (such as a dialog box appearing).

At the appropriate time, the ComponentUI is responsible for obtaining an Action out of the ActionMap and passing it to playSound.

This method first looks up the ActionMap from the defaults using the key "AuditoryCues.actionMap" .

If the value is non-null , it is returned. If the value of the default "AuditoryCues.actionMap" is null and the value of the default "AuditoryCues.cueList" is non-null , an ActionMapUIResource is created and populated. Population is done by iterating over each of the elements of the "AuditoryCues.cueList" array, and invoking createAudioAction() to create an Action for each element. The resulting Action is placed in the ActionMapUIResource , using the array element as the key. For example, if the "AuditoryCues.cueList" array contains a single-element, "audioKey" , the ActionMapUIResource is created, then populated by way of actionMap.put(cueList[0], createAudioAction(cueList[0])) .

If the value of the default "AuditoryCues.actionMap" is null and the value of the default "AuditoryCues.cueList" is null , an empty ActionMapUIResource is created. an ActionMap containing Actions responsible for playing auditory cues
throws:
  ClassCastException - if the value of thedefault "AuditoryCues.actionMap" is not an ActionMap , or the value of the default "AuditoryCues.cueList" is not an Object[]
See Also:   BasicLookAndFeel.createAudioAction
See Also:   BasicLookAndFeel.playSound(Action)
since:
   1.4

While this method is public, it should only be invoked by the UIManager when the look and feel is set as the current look and feel and after initialize has been invoked. the look and feel defaults
See Also:   BasicLookAndFeel.initClassDefaults
See Also:   BasicLookAndFeel.initSystemColorDefaults
See Also:   BasicLookAndFeel.initComponentDefaults

The name is a String that corresponds to the name of one of the static SystemColor fields in the SystemColor class. A name-color pair is created for every such SystemColor field.

The color corresponds to a hex String as understood by Color.decode . For example, one of the name-color pairs is "desktop"-"#005C5C" . This corresponds to the SystemColor field desktop , with a color value of new Color(0x005C5C) .

The following shows two of the name-color pairs:

 String[] nameColorPairs = new String[] {
 "desktop", "#005C5C",
 "activeCaption", "#000080" };
 loadSystemColors(table, nameColorPairs, isNativeLookAndFeel());
 

An entry is added to table for each of the name-color pairs in systemColors . The entry key is the name of the name-color pair.

The value of the entry corresponds to the color of the name-color pair. The value of the entry is calculated in one of two ways. With either approach the value is always a ColorUIResource .

If useNative is false , the color is created by using Color.decode to convert the String into a Color . If decode can not convert the String into a Color ( NumberFormatException is thrown) then a ColorUIResource of black is used.

If useNative is true , the color is the value of the field in SystemColor with the same name as the name of the name-color pair. If the field is not valid, a ColorUIResource of black is used.
Parameters:
  table - the UIDefaults object the values are added to
Parameters:
  systemColors - array of name-color pairs as describedin BasicLookAndFeel.initSystemColorDefaults(UIDefaults)
Parameters:
  useNative - whether the color is obtained from SystemColor or Color.decode
throws:
  NullPointerException - if systemColors is null ; or systemColors is not empty, and table is null ; or one of thenames of the name-color pairs is null ; or useNative is false and one of the colors of the name-color pairs is null
throws:
  ArrayIndexOutOfBoundsException - if useNative is false and systemColors.length is odd
See Also:   BasicLookAndFeel.initSystemColorDefaults(javax.swing.UIDefaults)
See Also:   java.awt.SystemColor
See Also:   java.awt.Color.decode(String)