| Methods Summary |
|---|
| public javax.swing.UIDefaults | getDefaults()This method is called once by UIManager.setLookAndFeel to create
the look and feel specific defaults table. Other applications,
for example an application builder, may also call this method.
return null;
|
| public abstract java.lang.String | getDescription()Return a one line description of this look and feel implementation,
e.g. "The CDE/Motif Look and Feel". This string is intended for
the user, e.g. in the title of a window or in a ToolTip message.
|
| public static java.lang.Object | getDesktopPropertyValue(java.lang.String systemPropertyName, java.lang.Object fallbackValue)Returns the value of the specified system desktop property by
invoking Toolkit.getDefaultToolkit().getDesktopProperty().
If the current value of the specified property is null, the
fallbackValue is returned.
Object value = Toolkit.getDefaultToolkit().getDesktopProperty(systemPropertyName);
if (value == null) {
return fallbackValue;
} else if (value instanceof Color) {
return new ColorUIResource((Color)value);
} else if (value instanceof Font) {
return new FontUIResource((Font)value);
}
return value;
|
| public javax.swing.Icon | getDisabledIcon(javax.swing.JComponent component, javax.swing.Icon icon)Returns an Icon with a disabled appearance.
This method is used to generate a disabled Icon when
one has not been specified. For example, if you create a
JButton and only specify an Icon via
setIcon this method will be called to generate the
disabled Icon. If null is passed as icon
this method returns null.
Some look and feels might not render the disabled Icon, in which
case they will ignore this.
if (icon instanceof ImageIcon) {
return new IconUIResource(new ImageIcon(GrayFilter.
createDisabledImage(((ImageIcon)icon).getImage())));
}
return null;
|
| public javax.swing.Icon | getDisabledSelectedIcon(javax.swing.JComponent component, javax.swing.Icon icon)Returns an Icon for use by disabled
components that are also selected. This method is used to generate an
Icon for components that are in both the disabled and
selected states but do not have a specific Icon for this
state. For example, if you create a JButton and only
specify an Icon via setIcon this method
will be called to generate the disabled and selected
Icon. If null is passed as icon this method
returns null.
Some look and feels might not render the disabled and selected Icon,
in which case they will ignore this.
return getDisabledIcon(component, icon);
|
| public abstract java.lang.String | getID()Return a string that identifies this look and feel. This string
will be used by applications/services that want to recognize
well known look and feel implementations. Presently
the well known names are "Motif", "Windows", "Mac", "Metal". Note
that a LookAndFeel derived from a well known superclass
that doesn't make any fundamental changes to the look or feel
shouldn't override this method.
|
| public abstract java.lang.String | getName()Return a short string that identifies this look and feel, e.g.
"CDE/Motif". This string should be appropriate for a menu item.
Distinct look and feels should have different names, e.g.
a subclass of MotifLookAndFeel that changes the way a few components
are rendered should be called "CDE/Motif My Way"; something
that would be useful to a user trying to select a L&F from a list
of names.
|
| public boolean | getSupportsWindowDecorations()Returns true if the LookAndFeel returned
RootPaneUI instances support providing Window decorations
in a JRootPane.
The default implementation returns false, subclasses that support
Window decorations should override this and return true.
return false;
|
| public void | initialize()UIManager.setLookAndFeel calls this method before the first
call (and typically the only call) to getDefaults(). Subclasses
should do any one-time setup they need here, rather than
in a static initializer, because look and feel class objects
may be loaded just to discover that isSupportedLookAndFeel()
returns false.
|
| public static void | installBorder(javax.swing.JComponent c, java.lang.String defaultBorderName)Convenience method for installing a component's default Border
object on the specified component if either the border is
currently null or already an instance of UIResource.
Border b = c.getBorder();
if (b == null || b instanceof UIResource) {
c.setBorder(UIManager.getBorder(defaultBorderName));
}
|
| public static void | installColors(javax.swing.JComponent c, java.lang.String defaultBgName, java.lang.String defaultFgName)Convenience method for initializing a component's foreground
and background color properties with values from the current
defaults table. The properties are only set if the current
value is either null or a UIResource.
Color bg = c.getBackground();
if (bg == null || bg instanceof UIResource) {
c.setBackground(UIManager.getColor(defaultBgName));
}
Color fg = c.getForeground();
if (fg == null || fg instanceof UIResource) {
c.setForeground(UIManager.getColor(defaultFgName));
}
|
| public static void | installColorsAndFont(javax.swing.JComponent c, java.lang.String defaultBgName, java.lang.String defaultFgName, java.lang.String defaultFontName)Convenience method for initializing a components foreground
background and font properties with values from the current
defaults table. The properties are only set if the current
value is either null or a UIResource.
Font f = c.getFont();
if (f == null || f instanceof UIResource) {
c.setFont(UIManager.getFont(defaultFontName));
}
installColors(c, defaultBgName, defaultFgName);
|
| public static void | installProperty(javax.swing.JComponent c, java.lang.String propertyName, java.lang.Object propertyValue)Convenience method for installing a property with the specified name
and value on a component if that property has not already been set
by the client program. This method is intended to be used by
UI delegate instances that need to specify a default value for a
property of primitive type (boolean, int, ..), but do not wish
to override a value set by the client. Since primitive property
values cannot be wrapped with the UIResource marker, this method
uses private state to determine whether the property has been set
by the client.
c.setUIProperty(propertyName, propertyValue);
|
| public abstract boolean | isNativeLookAndFeel()If the underlying platform has a "native" look and feel, and this
is an implementation of it, return true. For example a CDE/Motif
look and implementation would return true when the underlying
platform was Solaris.
|
| public abstract boolean | isSupportedLookAndFeel()Return true if the underlying platform supports and or permits
this look and feel. This method returns false if the look
and feel depends on special resources or legal agreements that
aren't defined for the current platform.
|
| public static void | loadKeyBindings(javax.swing.InputMap retMap, java.lang.Object[] keys)Loads the bindings in keys into retMap.
This does not remove any existing bindings in retMap.
keys
describes the InputMap, with every even number item being a String
giving
the KeyStroke as speced in KeyStroke.getKeyStroke(String)
(or a KeyStroke), and every odd number item the Object
used to determine the associated Action in an ActionMap.
if (keys != null) {
for (int counter = 0, maxCounter = keys.length;
counter < maxCounter; counter++) {
Object keyStrokeO = keys[counter++];
KeyStroke ks = (keyStrokeO instanceof KeyStroke) ?
(KeyStroke)keyStrokeO :
KeyStroke.getKeyStroke((String)keyStrokeO);
retMap.put(ks, keys[counter]);
}
}
|
| public static javax.swing.ComponentInputMap | makeComponentInputMap(javax.swing.JComponent c, java.lang.Object[] keys)Creates a ComponentInputMap from keys. keys
describes the InputMap, with every even number item being a String
giving
the KeyStroke as speced in KeyStroke.getKeyStroke(String)
(or a KeyStroke), and every odd number item the Object
used to determine the associated Action in an ActionMap.
ComponentInputMap retMap = new ComponentInputMapUIResource(c);
loadKeyBindings(retMap, keys);
return retMap;
|
| public static java.lang.Object | makeIcon(java.lang.Class baseClass, java.lang.String gifFile)Utility method that creates a UIDefaults.LazyValue that creates
an ImageIcon UIResource for the specified gifFile
filename.
return SwingUtilities2.makeIcon(baseClass, baseClass, gifFile);
|
| public static javax.swing.InputMap | makeInputMap(java.lang.Object[] keys)Creates a InputMap from keys. keys
describes the InputMap, with every even number item being a String
giving the KeyStroke as speced in
KeyStroke.getKeyStroke(String)
(or a KeyStroke), and every odd number item the Object
used to determine the associated Action in an ActionMap.
InputMap retMap = new InputMapUIResource();
loadKeyBindings(retMap, keys);
return retMap;
|
| public static javax.swing.text.JTextComponent$KeyBinding[] | makeKeyBindings(java.lang.Object[] keyBindingList)Convenience method for building lists of KeyBindings.
Return an array of KeyBindings, one for each KeyStroke,Action pair
in keyBindingList. A KeyStroke can either be a string in
the format specified by the KeyStroke.getKeyStroke
method or a KeyStroke object.
Actions are strings. Here's an example:
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
});
JTextComponent.KeyBinding[] rv = new JTextComponent.KeyBinding[keyBindingList.length / 2];
for(int i = 0; i < keyBindingList.length; i += 2) {
KeyStroke keystroke = (keyBindingList[i] instanceof KeyStroke)
? (KeyStroke)keyBindingList[i]
: KeyStroke.getKeyStroke((String)keyBindingList[i]);
String action = (String)keyBindingList[i+1];
rv[i / 2] = new JTextComponent.KeyBinding(keystroke, action);
}
return rv;
|
| public void | provideErrorFeedback(java.awt.Component component)Invoked when the user attempts an invalid operation,
such as pasting into an uneditable JTextField
that has focus. The default implementation beeps. Subclasses
that wish different behavior should override this and provide
the additional feedback.
Toolkit toolkit = null;
if (component != null) {
toolkit = component.getToolkit();
} else {
toolkit = Toolkit.getDefaultToolkit();
}
toolkit.beep();
|
| public java.lang.String | toString()Returns a string that displays and identifies this
object's properties.
return "[" + getDescription() + " - " + getClass().getName() + "]";
|
| public void | uninitialize()UIManager.setLookAndFeel calls this method just before we're
replaced by a new default look and feel. Subclasses may
choose to free up some resources here.
|
| public static void | uninstallBorder(javax.swing.JComponent c)Convenience method for un-installing a component's default
border on the specified component if the border is
currently an instance of UIResource.
if (c.getBorder() instanceof UIResource) {
c.setBorder(null);
}
|
