< prev index next >
src/java.desktop/share/classes/javax/swing/LookAndFeel.java
Print this page
*** 289,299 ****
* supplying key bindings.
* <p>
* This method returns an array of {@code KeyBindings}, one for each
* alternating {@code key-action} pair in {@code keyBindingList}.
* A {@code key} can either be a {@code String} in the format
! * specified by the <code>KeyStroke.getKeyStroke</code> method, or
* a {@code KeyStroke}. The {@code action} part of the pair is a
* {@code String} that corresponds to the name of the {@code
* Action}.
* <p>
* The following example illustrates creating a {@code KeyBinding} array
--- 289,299 ----
* supplying key bindings.
* <p>
* This method returns an array of {@code KeyBindings}, one for each
* alternating {@code key-action} pair in {@code keyBindingList}.
* A {@code key} can either be a {@code String} in the format
! * specified by the {@code KeyStroke.getKeyStroke} method, or
* a {@code KeyStroke}. The {@code action} part of the pair is a
* {@code String} that corresponds to the name of the {@code
* Action}.
* <p>
* The following example illustrates creating a {@code KeyBinding} array
*** 344,354 ****
return rv;
}
/**
! * Creates a {@code InputMapUIResource} from <code>keys</code>. This is
* a convenience method for creating a new {@code InputMapUIResource},
* invoking {@code loadKeyBindings(map, keys)}, and returning the
* {@code InputMapUIResource}.
*
* @param keys alternating pairs of {@code keystroke-action key}
--- 344,354 ----
return rv;
}
/**
! * Creates a {@code InputMapUIResource} from {@code keys}. This is
* a convenience method for creating a new {@code InputMapUIResource},
* invoking {@code loadKeyBindings(map, keys)}, and returning the
* {@code InputMapUIResource}.
*
* @param keys alternating pairs of {@code keystroke-action key}
*** 364,374 ****
return retMap;
}
/**
* Creates a {@code ComponentInputMapUIResource} from
! * <code>keys</code>. This is a convenience method for creating a
* new {@code ComponentInputMapUIResource}, invoking {@code
* loadKeyBindings(map, keys)}, and returning the {@code
* ComponentInputMapUIResource}.
*
* @param c component to create the {@code ComponentInputMapUIResource}
--- 364,374 ----
return retMap;
}
/**
* Creates a {@code ComponentInputMapUIResource} from
! * {@code keys}. This is a convenience method for creating a
* new {@code ComponentInputMapUIResource}, invoking {@code
* loadKeyBindings(map, keys)}, and returning the {@code
* ComponentInputMapUIResource}.
*
* @param c component to create the {@code ComponentInputMapUIResource}
*** 411,423 ****
* </pre>
* <p>
* Supplying a {@code null} list of bindings ({@code keys}) does not
* change {@code retMap} in any way.
* <p>
! * Specifying a {@code null} {@code action key} results in
* removing the {@code keystroke's} entry from the {@code InputMap}.
! * A {@code null} {@code keystroke} is ignored.
*
* @param retMap {@code InputMap} to add the {@code key-action}
* pairs to
* @param keys bindings to add to {@code retMap}
* @throws NullPointerException if {@code keys} is
--- 411,423 ----
* </pre>
* <p>
* Supplying a {@code null} list of bindings ({@code keys}) does not
* change {@code retMap} in any way.
* <p>
! * Specifying a {@code null action key} results in
* removing the {@code keystroke's} entry from the {@code InputMap}.
! * A {@code null keystroke} is ignored.
*
* @param retMap {@code InputMap} to add the {@code key-action}
* pairs to
* @param keys bindings to add to {@code retMap}
* @throws NullPointerException if {@code keys} is
*** 467,502 ****
public static Object makeIcon(final Class<?> baseClass, final String gifFile) {
return SwingUtilities2.makeIcon_Unprivileged(baseClass, baseClass, gifFile);
}
/**
! * Returns the <code>LayoutStyle</code> for this look
* and feel. This never returns {@code null}.
* <p>
! * You generally don't use the <code>LayoutStyle</code> from
! * the look and feel, instead use the <code>LayoutStyle</code>
! * method <code>getInstance</code>.
*
* @see LayoutStyle#getInstance
! * @return the <code>LayoutStyle</code> for this look and feel
* @since 1.6
*/
public LayoutStyle getLayoutStyle() {
return DefaultLayoutStyle.getInstance();
}
/**
* Invoked when the user attempts an invalid operation,
! * such as pasting into an uneditable <code>JTextField</code>
* that has focus. The default implementation beeps. Subclasses
* that wish different behavior should override this and provide
* the additional feedback.
*
! * @param component the <code>Component</code> the error occurred in,
! * may be <code>null</code>
* indicating the error condition is not directly
! * associated with a <code>Component</code>
* @since 1.4
*/
public void provideErrorFeedback(Component component) {
Toolkit toolkit = null;
if (component != null) {
--- 467,502 ----
public static Object makeIcon(final Class<?> baseClass, final String gifFile) {
return SwingUtilities2.makeIcon_Unprivileged(baseClass, baseClass, gifFile);
}
/**
! * Returns the {@code LayoutStyle} for this look
* and feel. This never returns {@code null}.
* <p>
! * You generally don't use the {@code LayoutStyle} from
! * the look and feel, instead use the {@code LayoutStyle}
! * method {@code getInstance}.
*
* @see LayoutStyle#getInstance
! * @return the {@code LayoutStyle} for this look and feel
* @since 1.6
*/
public LayoutStyle getLayoutStyle() {
return DefaultLayoutStyle.getInstance();
}
/**
* Invoked when the user attempts an invalid operation,
! * such as pasting into an uneditable {@code JTextField}
* that has focus. The default implementation beeps. Subclasses
* that wish different behavior should override this and provide
* the additional feedback.
*
! * @param component the {@code Component} the error occurred in,
! * may be {@code null}
* indicating the error condition is not directly
! * associated with a {@code Component}
* @since 1.4
*/
public void provideErrorFeedback(Component component) {
Toolkit toolkit = null;
if (component != null) {
*** 507,517 ****
toolkit.beep();
} // provideErrorFeedback()
/**
* Returns the value of the specified system desktop property by
! * invoking <code>Toolkit.getDefaultToolkit().getDesktopProperty()</code>.
* If the value of the specified property is {@code null},
* {@code fallbackValue} is returned.
*
* @param systemPropertyName the name of the system desktop property being queried
* @param fallbackValue the object to be returned as the value if the system value is null
--- 507,517 ----
toolkit.beep();
} // provideErrorFeedback()
/**
* Returns the value of the specified system desktop property by
! * invoking {@code Toolkit.getDefaultToolkit().getDesktopProperty()}.
* If the value of the specified property is {@code null},
* {@code fallbackValue} is returned.
*
* @param systemPropertyName the name of the system desktop property being queried
* @param fallbackValue the object to be returned as the value if the system value is null
*** 532,548 ****
}
return value;
}
/**
! * Returns an <code>Icon</code> with a disabled appearance.
! * This method is used to generate a disabled <code>Icon</code> when
* one has not been specified. For example, if you create a
! * <code>JButton</code> and only specify an <code>Icon</code> via
! * <code>setIcon</code> this method will be called to generate the
! * disabled <code>Icon</code>. If {@code null} is passed as
! * <code>icon</code> this method returns {@code null}.
* <p>
* Some look and feels might not render the disabled {@code Icon}, in which
* case they will ignore this.
*
* @param component {@code JComponent} that will display the {@code Icon},
--- 532,548 ----
}
return value;
}
/**
! * Returns an {@code Icon} with a disabled appearance.
! * This method is used to generate a disabled {@code Icon} when
* one has not been specified. For example, if you create a
! * {@code JButton} and only specify an {@code Icon} via
! * {@code setIcon} this method will be called to generate the
! * disabled {@code Icon}. If {@code null} is passed as
! * {@code icon} this method returns {@code null}.
* <p>
* Some look and feels might not render the disabled {@code Icon}, in which
* case they will ignore this.
*
* @param component {@code JComponent} that will display the {@code Icon},
*** 559,576 ****
}
return null;
}
/**
! * Returns an <code>Icon</code> for use by disabled
* components that are also selected. This method is used to generate an
! * <code>Icon</code> for components that are in both the disabled and
! * selected states but do not have a specific <code>Icon</code> for this
! * state. For example, if you create a <code>JButton</code> and only
! * specify an <code>Icon</code> via <code>setIcon</code> this method
* will be called to generate the disabled and selected
! * <code>Icon</code>. If {@code null} is passed as <code>icon</code> this
* methods returns {@code null}.
* <p>
* Some look and feels might not render the disabled and selected
* {@code Icon}, in which case they will ignore this.
*
--- 559,576 ----
}
return null;
}
/**
! * Returns an {@code Icon} for use by disabled
* components that are also selected. This method is used to generate an
! * {@code Icon} for components that are in both the disabled and
! * selected states but do not have a specific {@code Icon} for this
! * state. For example, if you create a {@code JButton} and only
! * specify an {@code Icon} via {@code setIcon} this method
* will be called to generate the disabled and selected
! * {@code Icon}. If {@code null} is passed as {@code icon} this
* methods returns {@code null}.
* <p>
* Some look and feels might not render the disabled and selected
* {@code Icon}, in which case they will ignore this.
*
*** 622,634 ****
*/
public abstract String getDescription();
/**
! * Returns {@code true} if the <code>LookAndFeel</code> returned
! * <code>RootPaneUI</code> instances support providing {@code Window}
! * decorations in a <code>JRootPane</code>.
* <p>
* The default implementation returns {@code false}, subclasses that
* support {@code Window} decorations should override this and return
* {@code true}.
*
--- 622,634 ----
*/
public abstract String getDescription();
/**
! * Returns {@code true} if the {@code LookAndFeel} returned
! * {@code RootPaneUI} instances support providing {@code Window}
! * decorations in a {@code JRootPane}.
* <p>
* The default implementation returns {@code false}, subclasses that
* support {@code Window} decorations should override this and return
* {@code true}.
*
< prev index next >