< prev index next >
src/java.desktop/share/classes/javax/swing/UIDefaults.java
Print this page
@@ -54,19 +54,19 @@
import sun.swing.SwingUtilities2;
import sun.util.CoreResourceBundleControl;
/**
* A table of defaults for Swing components. Applications can set/get
- * default values via the <code>UIManager</code>.
+ * default values via the {@code UIManager}.
* <p>
* <strong>Warning:</strong>
* 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™
- * has been added to the <code>java.beans</code> package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see UIManager
* @author Hans Muller
* @since 1.2
@@ -133,27 +133,27 @@
}
}
/**
* Returns the value for key. If the value is a
- * <code>UIDefaults.LazyValue</code> then the real
- * value is computed with <code>LazyValue.createValue()</code>,
+ * {@code UIDefaults.LazyValue} then the real
+ * value is computed with {@code LazyValue.createValue()},
* the table entry is replaced, and the real value is returned.
- * If the value is an <code>UIDefaults.ActiveValue</code>
+ * If the value is an {@code UIDefaults.ActiveValue}
* the table entry is not replaced - the value is computed
- * with <code>ActiveValue.createValue()</code> for each
- * <code>get()</code> call.
+ * with {@code ActiveValue.createValue()} for each
+ * {@code get()} call.
*
* If the key is not found in the table then it is searched for in the list
* of resource bundles maintained by this object. The resource bundles are
* searched most recently added first using the locale returned by
- * <code>getDefaultLocale</code>. <code>LazyValues</code> and
- * <code>ActiveValues</code> are not supported in the resource bundles.
+ * {@code getDefaultLocale}. {@code LazyValues} and
+ * {@code ActiveValues} are not supported in the resource bundles.
*
* @param key the desired key
- * @return the value for <code>key</code>
+ * @return the value for {@code key}
* @see LazyValue
* @see ActiveValue
* @see java.util.Hashtable#get
* @see #getDefaultLocale
* @see #addResourceBundle
@@ -237,27 +237,27 @@
}
/**
* Returns the value for key associated with the given locale.
- * If the value is a <code>UIDefaults.LazyValue</code> then the real
- * value is computed with <code>LazyValue.createValue()</code>,
+ * If the value is a {@code UIDefaults.LazyValue} then the real
+ * value is computed with {@code LazyValue.createValue()},
* the table entry is replaced, and the real value is returned.
- * If the value is an <code>UIDefaults.ActiveValue</code>
+ * If the value is an {@code UIDefaults.ActiveValue}
* the table entry is not replaced - the value is computed
- * with <code>ActiveValue.createValue()</code> for each
- * <code>get()</code> call.
+ * with {@code ActiveValue.createValue()} for each
+ * {@code get()} call.
*
* If the key is not found in the table then it is searched for in the list
* of resource bundles maintained by this object. The resource bundles are
* searched most recently added first using the given locale.
- * <code>LazyValues</code> and <code>ActiveValues</code> are not supported
+ * {@code LazyValues} and {@code ActiveValues} are not supported
* in the resource bundles.
*
* @param key the desired key
- * @param l the desired <code>locale</code>
- * @return the value for <code>key</code>
+ * @param l the desired {@code locale}
+ * @return the value for {@code key}
* @see LazyValue
* @see ActiveValue
* @see java.util.Hashtable#get
* @see #addResourceBundle
* @since 1.4
@@ -328,20 +328,20 @@
}
return values;
}
/**
- * Sets the value of <code>key</code> to <code>value</code> for all locales.
- * If <code>key</code> is a string and the new value isn't
- * equal to the old one, fire a <code>PropertyChangeEvent</code>.
- * If value is <code>null</code>, the key is removed from the table.
+ * Sets the value of {@code key} to {@code value} for all locales.
+ * If {@code key} is a string and the new value isn't
+ * equal to the old one, fire a {@code PropertyChangeEvent}.
+ * If value is {@code null}, the key is removed from the table.
*
- * @param key the unique <code>Object</code> who's value will be used
+ * @param key the unique {@code Object} who's value will be used
* to retrieve the data value associated with it
- * @param value the new <code>Object</code> to store as data under
+ * @param value the new {@code Object} to store as data under
* that key
- * @return the previous <code>Object</code> value, or <code>null</code>
+ * @return the previous {@code Object} value, or {@code null}
* @see #putDefaults
* @see java.util.Hashtable#put
*/
public Object put(Object key, Object value) {
Object oldValue = (value == null) ? super.remove(key) : super.put(key, value);
@@ -352,13 +352,13 @@
}
/**
* Puts all of the key/value pairs in the database and
- * unconditionally generates one <code>PropertyChangeEvent</code>.
- * The events oldValue and newValue will be <code>null</code> and its
- * <code>propertyName</code> will be "UIDefaults". The key/value pairs are
+ * unconditionally generates one {@code PropertyChangeEvent}.
+ * The events oldValue and newValue will be {@code null} and its
+ * {@code propertyName} will be "UIDefaults". The key/value pairs are
* added for all locales.
*
* @param keyValueList an array of key/value pairs
* @see #put
* @see java.util.Hashtable#put
@@ -376,212 +376,212 @@
firePropertyChange("UIDefaults", null, null);
}
/**
- * If the value of <code>key</code> is a <code>Font</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is a {@code Font} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is a <code>Font</code>,
- * return the <code>Font</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is a {@code Font},
+ * return the {@code Font} object; otherwise return
+ * {@code null}
*/
public Font getFont(Object key) {
Object value = get(key);
return (value instanceof Font) ? (Font)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is a <code>Font</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is a {@code Font} return it, otherwise return {@code null}.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is a <code>Font</code>,
- * return the <code>Font</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} and {@code Locale}
+ * is a {@code Font},
+ * return the {@code Font} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public Font getFont(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Font) ? (Font)value : null;
}
/**
- * If the value of <code>key</code> is a <code>Color</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is a {@code Color} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is a <code>Color</code>,
- * return the <code>Color</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is a {@code Color},
+ * return the {@code Color} object; otherwise return
+ * {@code null}
*/
public Color getColor(Object key) {
Object value = get(key);
return (value instanceof Color) ? (Color)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is a <code>Color</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is a {@code Color} return it, otherwise return {@code null}.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is a <code>Color</code>,
- * return the <code>Color</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} and {@code Locale}
+ * is a {@code Color},
+ * return the {@code Color} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public Color getColor(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Color) ? (Color)value : null;
}
/**
- * If the value of <code>key</code> is an <code>Icon</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is an {@code Icon} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is an <code>Icon</code>,
- * return the <code>Icon</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is an {@code Icon},
+ * return the {@code Icon} object; otherwise return
+ * {@code null}
*/
public Icon getIcon(Object key) {
Object value = get(key);
return (value instanceof Icon) ? (Icon)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is an <code>Icon</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is an {@code Icon} return it, otherwise return {@code null}.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is an <code>Icon</code>,
- * return the <code>Icon</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} and {@code Locale}
+ * is an {@code Icon},
+ * return the {@code Icon} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public Icon getIcon(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Icon) ? (Icon)value : null;
}
/**
- * If the value of <code>key</code> is a <code>Border</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is a {@code Border} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is a <code>Border</code>,
- * return the <code>Border</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is a {@code Border},
+ * return the {@code Border} object; otherwise return
+ * {@code null}
*/
public Border getBorder(Object key) {
Object value = get(key);
return (value instanceof Border) ? (Border)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is a <code>Border</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is a {@code Border} return it, otherwise return {@code null}.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is a <code>Border</code>,
- * return the <code>Border</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} and {@code Locale}
+ * is a {@code Border},
+ * return the {@code Border} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public Border getBorder(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Border) ? (Border)value : null;
}
/**
- * If the value of <code>key</code> is a <code>String</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is a {@code String} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is a <code>String</code>,
- * return the <code>String</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is a {@code String},
+ * return the {@code String} object; otherwise return
+ * {@code null}
*/
public String getString(Object key) {
Object value = get(key);
return (value instanceof String) ? (String)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is a <code>String</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is a {@code String} return it, otherwise return {@code null}.
* @param key the desired key
- * @param l the desired <code>Locale</code>
- * @return if the value for <code>key</code> for the given
- * <code>Locale</code> is a <code>String</code>,
- * return the <code>String</code> object; otherwise return
- * <code>null</code>
+ * @param l the desired {@code Locale}
+ * @return if the value for {@code key} for the given
+ * {@code Locale} is a {@code String},
+ * return the {@code String} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public String getString(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof String) ? (String)value : null;
}
/**
- * If the value of <code>key</code> is an <code>Integer</code> return its
+ * If the value of {@code key} is an {@code Integer} return its
* integer value, otherwise return 0.
* @param key the desired key
- * @return if the value for <code>key</code> is an <code>Integer</code>,
+ * @return if the value for {@code key} is an {@code Integer},
* return its value, otherwise return 0
*/
public int getInt(Object key) {
Object value = get(key);
return (value instanceof Integer) ? ((Integer)value).intValue() : 0;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is an <code>Integer</code> return its integer value, otherwise return 0.
+ * If the value of {@code key} for the given {@code Locale}
+ * is an {@code Integer} return its integer value, otherwise return 0.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is an <code>Integer</code>,
+ * @return if the value for {@code key} and {@code Locale}
+ * is an {@code Integer},
* return its value, otherwise return 0
* @since 1.4
*/
public int getInt(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Integer) ? ((Integer)value).intValue() : 0;
}
/**
- * If the value of <code>key</code> is boolean, return the
+ * If the value of {@code key} is boolean, return the
* boolean value, otherwise return false.
*
- * @param key an <code>Object</code> specifying the key for the desired boolean value
- * @return if the value of <code>key</code> is boolean, return the
+ * @param key an {@code Object} specifying the key for the desired boolean value
+ * @return if the value of {@code key} is boolean, return the
* boolean value, otherwise return false.
* @since 1.4
*/
public boolean getBoolean(Object key) {
Object value = get(key);
return (value instanceof Boolean) ? ((Boolean)value).booleanValue() : false;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
+ * If the value of {@code key} for the given {@code Locale}
* is boolean, return the boolean value, otherwise return false.
*
- * @param key an <code>Object</code> specifying the key for the desired boolean value
+ * @param key an {@code Object} specifying the key for the desired boolean value
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
+ * @return if the value for {@code key} and {@code Locale}
* is boolean, return the
* boolean value, otherwise return false.
* @since 1.4
*/
public boolean getBoolean(Object key, Locale l) {
@@ -589,89 +589,89 @@
return (value instanceof Boolean) ? ((Boolean)value).booleanValue() : false;
}
/**
- * If the value of <code>key</code> is an <code>Insets</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is an {@code Insets} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is an <code>Insets</code>,
- * return the <code>Insets</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is an {@code Insets},
+ * return the {@code Insets} object; otherwise return
+ * {@code null}
*/
public Insets getInsets(Object key) {
Object value = get(key);
return (value instanceof Insets) ? (Insets)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is an <code>Insets</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is an {@code Insets} return it, otherwise return {@code null}.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is an <code>Insets</code>,
- * return the <code>Insets</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} and {@code Locale}
+ * is an {@code Insets},
+ * return the {@code Insets} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public Insets getInsets(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Insets) ? (Insets)value : null;
}
/**
- * If the value of <code>key</code> is a <code>Dimension</code> return it,
- * otherwise return <code>null</code>.
+ * If the value of {@code key} is a {@code Dimension} return it,
+ * otherwise return {@code null}.
* @param key the desired key
- * @return if the value for <code>key</code> is a <code>Dimension</code>,
- * return the <code>Dimension</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} is a {@code Dimension},
+ * return the {@code Dimension} object; otherwise return
+ * {@code null}
*/
public Dimension getDimension(Object key) {
Object value = get(key);
return (value instanceof Dimension) ? (Dimension)value : null;
}
/**
- * If the value of <code>key</code> for the given <code>Locale</code>
- * is a <code>Dimension</code> return it, otherwise return <code>null</code>.
+ * If the value of {@code key} for the given {@code Locale}
+ * is a {@code Dimension} return it, otherwise return {@code null}.
* @param key the desired key
* @param l the desired locale
- * @return if the value for <code>key</code> and <code>Locale</code>
- * is a <code>Dimension</code>,
- * return the <code>Dimension</code> object; otherwise return
- * <code>null</code>
+ * @return if the value for {@code key} and {@code Locale}
+ * is a {@code Dimension},
+ * return the {@code Dimension} object; otherwise return
+ * {@code null}
* @since 1.4
*/
public Dimension getDimension(Object key, Locale l) {
Object value = get(key,l);
return (value instanceof Dimension) ? (Dimension)value : null;
}
/**
- * The value of <code>get(uidClassID)</code> must be the
- * <code>String</code> name of a
- * class that implements the corresponding <code>ComponentUI</code>
+ * The value of {@code get(uidClassID)} must be the
+ * {@code String} name of a
+ * class that implements the corresponding {@code ComponentUI}
* class. If the class hasn't been loaded before, this method looks
- * up the class with <code>uiClassLoader.loadClass()</code> if a non
- * <code>null</code>
- * class loader is provided, <code>classForName()</code> otherwise.
+ * up the class with {@code uiClassLoader.loadClass()} if a non
+ * {@code null}
+ * class loader is provided, {@code classForName()} otherwise.
* <p>
- * If a mapping for <code>uiClassID</code> exists or if the specified
- * class can't be found, return <code>null</code>.
+ * If a mapping for {@code uiClassID} exists or if the specified
+ * class can't be found, return {@code null}.
* <p>
- * This method is used by <code>getUI</code>, it's usually
+ * This method is used by {@code getUI}, it's usually
* not necessary to call it directly.
*
* @param uiClassID a string containing the class ID
* @param uiClassLoader the object which will load the class
- * @return the value of <code>Class.forName(get(uidClassID))</code>
+ * @return the value of {@code Class.forName(get(uidClassID))}
* @see #getUI
*/
public Class<? extends ComponentUI>
getUIClass(String uiClassID, ClassLoader uiClassLoader)
{
@@ -708,20 +708,20 @@
/**
* Returns the L&F class that renders this component.
*
* @param uiClassID a string containing the class ID
* @return the Class object returned by
- * <code>getUIClass(uiClassID, null)</code>
+ * {@code getUIClass(uiClassID, null)}
*/
public Class<? extends ComponentUI> getUIClass(String uiClassID) {
return getUIClass(uiClassID, null);
}
/**
- * If <code>getUI()</code> fails for any reason,
- * it calls this method before returning <code>null</code>.
+ * If {@code getUI()} fails for any reason,
+ * it calls this method before returning {@code null}.
* Subclasses may choose to do more or less here.
*
* @param msg message string to print
* @see #getUI
*/
@@ -734,22 +734,22 @@
e.printStackTrace();
}
}
/**
- * Creates an <code>ComponentUI</code> implementation for the
+ * Creates an {@code ComponentUI} implementation for the
* specified component. In other words create the look
- * and feel specific delegate object for <code>target</code>.
+ * and feel specific delegate object for {@code target}.
* This is done in two steps:
* <ul>
- * <li> Look up the name of the <code>ComponentUI</code> implementation
- * class under the value returned by <code>target.getUIClassID()</code>.
- * <li> Use the implementation classes static <code>createUI()</code>
+ * <li> Look up the name of the {@code ComponentUI} implementation
+ * class under the value returned by {@code target.getUIClassID()}.
+ * <li> Use the implementation classes static {@code createUI()}
* method to construct a look and feel delegate.
* </ul>
- * @param target the <code>JComponent</code> which needs a UI
- * @return the <code>ComponentUI</code> object
+ * @param target the {@code JComponent} which needs a UI
+ * @return the {@code ComponentUI} object
*/
public ComponentUI getUI(JComponent target) {
Object cl = get("ClassLoader");
ClassLoader uiClassLoader =
@@ -779,17 +779,17 @@
return (ComponentUI)uiObject;
}
/**
- * Adds a <code>PropertyChangeListener</code> to the listener list.
+ * Adds a {@code PropertyChangeListener} to the listener list.
* The listener is registered for all properties.
* <p>
- * A <code>PropertyChangeEvent</code> will get fired whenever a default
+ * A {@code PropertyChangeEvent} will get fired whenever a default
* is changed.
*
- * @param listener the <code>PropertyChangeListener</code> to be added
+ * @param listener the {@code PropertyChangeListener} to be added
* @see java.beans.PropertyChangeSupport
*/
public synchronized void addPropertyChangeListener(PropertyChangeListener listener) {
if (changeSupport == null) {
changeSupport = new SwingPropertyChangeSupport(this);
@@ -797,29 +797,29 @@
changeSupport.addPropertyChangeListener(listener);
}
/**
- * Removes a <code>PropertyChangeListener</code> from the listener list.
- * This removes a <code>PropertyChangeListener</code> that was registered
+ * Removes a {@code PropertyChangeListener} from the listener list.
+ * This removes a {@code PropertyChangeListener} that was registered
* for all properties.
*
- * @param listener the <code>PropertyChangeListener</code> to be removed
+ * @param listener the {@code PropertyChangeListener} to be removed
* @see java.beans.PropertyChangeSupport
*/
public synchronized void removePropertyChangeListener(PropertyChangeListener listener) {
if (changeSupport != null) {
changeSupport.removePropertyChangeListener(listener);
}
}
/**
- * Returns an array of all the <code>PropertyChangeListener</code>s added
+ * Returns an array of all the {@code PropertyChangeListener}s added
* to this UIDefaults with addPropertyChangeListener().
*
- * @return all of the <code>PropertyChangeListener</code>s added or an empty
+ * @return all of the {@code PropertyChangeListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
public synchronized PropertyChangeListener[] getPropertyChangeListeners() {
if (changeSupport == null) {
@@ -829,13 +829,13 @@
}
/**
* Support for reporting bound property changes. If oldValue and
- * newValue are not equal and the <code>PropertyChangeEvent</code>x
+ * newValue are not equal and the {@code PropertyChangeEvent}x
* listener list isn't empty, then fire a
- * <code>PropertyChange</code> event to each listener.
+ * {@code PropertyChange} event to each listener.
*
* @param propertyName the programmatic name of the property
* that was changed
* @param oldValue the old value of the property
* @param newValue the new value of the property
@@ -889,11 +889,11 @@
resourceCache.clear();
}
/**
* Sets the default locale. The default locale is used in retrieving
- * localized values via <code>get</code> methods that do not take a
+ * localized values via {@code get} methods that do not take a
* locale argument. As of release 1.4, Swing UI objects should retrieve
* localized values using the locale of their component rather than the
* default locale. The default locale exists to provide compatibility with
* pre 1.4 behaviour.
*
@@ -907,11 +907,11 @@
defaultLocale = l;
}
/**
* Returns the default locale. The default locale is used in retrieving
- * localized values via <code>get</code> methods that do not take a
+ * localized values via {@code get} methods that do not take a
* locale argument. As of release 1.4, Swing UI objects should retrieve
* localized values using the locale of their component rather than the
* default locale. The default locale exists to provide compatibility with
* pre 1.4 behaviour.
*
@@ -926,20 +926,20 @@
}
/**
* This class enables one to store an entry in the defaults
* table that isn't constructed until the first time it's
- * looked up with one of the <code>getXXX(key)</code> methods.
+ * looked up with one of the {@code getXXX(key)} methods.
* Lazy values are useful for defaults that are expensive
* to construct or are seldom retrieved. The first time
- * a <code>LazyValue</code> is retrieved its "real value" is computed
- * by calling <code>LazyValue.createValue()</code> and the real
- * value is used to replace the <code>LazyValue</code> in the
- * <code>UIDefaults</code>
+ * a {@code LazyValue} is retrieved its "real value" is computed
+ * by calling {@code LazyValue.createValue()} and the real
+ * value is used to replace the {@code LazyValue} in the
+ * {@code UIDefaults}
* table. Subsequent lookups for the same key return
- * the real value. Here's an example of a <code>LazyValue</code>
- * that constructs a <code>Border</code>:
+ * the real value. Here's an example of a {@code LazyValue}
+ * that constructs a {@code Border}:
* <pre>
* Object borderLazyValue = new UIDefaults.LazyValue() {
* public Object createValue(UIDefaults table) {
* return new BorderFactory.createLoweredBevelBorder();
* }
@@ -950,29 +950,29 @@
*
* @see UIDefaults#get
*/
public interface LazyValue {
/**
- * Creates the actual value retrieved from the <code>UIDefaults</code>
+ * Creates the actual value retrieved from the {@code UIDefaults}
* table. When an object that implements this interface is
* retrieved from the table, this method is used to create
* the real value, which is then stored in the table and
* returned to the calling method.
*
- * @param table a <code>UIDefaults</code> table
- * @return the created <code>Object</code>
+ * @param table a {@code UIDefaults} table
+ * @return the created {@code Object}
*/
Object createValue(UIDefaults table);
}
/**
* This class enables one to store an entry in the defaults
* table that's constructed each time it's looked up with one of
- * the <code>getXXX(key)</code> methods. Here's an example of
- * an <code>ActiveValue</code> that constructs a
- * <code>DefaultListCellRenderer</code>:
+ * the {@code getXXX(key)} methods. Here's an example of
+ * an {@code ActiveValue} that constructs a
+ * {@code DefaultListCellRenderer}:
* <pre>
* Object cellRendererActiveValue = new UIDefaults.ActiveValue() {
* public Object createValue(UIDefaults table) {
* return new DefaultListCellRenderer();
* }
@@ -983,84 +983,84 @@
*
* @see UIDefaults#get
*/
public interface ActiveValue {
/**
- * Creates the value retrieved from the <code>UIDefaults</code> table.
+ * Creates the value retrieved from the {@code UIDefaults} table.
* The object is created each time it is accessed.
*
- * @param table a <code>UIDefaults</code> table
- * @return the created <code>Object</code>
+ * @param table a {@code UIDefaults} table
+ * @return the created {@code Object}
*/
Object createValue(UIDefaults table);
}
/**
- * This class provides an implementation of <code>LazyValue</code>
+ * This class provides an implementation of {@code LazyValue}
* which can be
* used to delay loading of the Class for the instance to be created.
* It also avoids creation of an anonymous inner class for the
- * <code>LazyValue</code>
+ * {@code LazyValue}
* subclass. Both of these improve performance at the time that a
* a Look and Feel is loaded, at the cost of a slight performance
- * reduction the first time <code>createValue</code> is called
+ * reduction the first time {@code createValue} is called
* (since Reflection APIs are used).
* @since 1.3
*/
public static class ProxyLazyValue implements LazyValue {
private AccessControlContext acc;
private String className;
private String methodName;
private Object[] args;
/**
- * Creates a <code>LazyValue</code> which will construct an instance
+ * Creates a {@code LazyValue} which will construct an instance
* when asked.
*
- * @param c a <code>String</code> specifying the classname
+ * @param c a {@code String} specifying the classname
* of the instance to be created on demand
*/
public ProxyLazyValue(String c) {
this(c, (String)null);
}
/**
- * Creates a <code>LazyValue</code> which will construct an instance
+ * Creates a {@code LazyValue} which will construct an instance
* when asked.
*
- * @param c a <code>String</code> specifying the classname of
+ * @param c a {@code String} specifying the classname of
* the class
* containing a static method to be called for
* instance creation
- * @param m a <code>String</code> specifying the static
+ * @param m a {@code String} specifying the static
* method to be called on class c
*/
public ProxyLazyValue(String c, String m) {
this(c, m, null);
}
/**
- * Creates a <code>LazyValue</code> which will construct an instance
+ * Creates a {@code LazyValue} which will construct an instance
* when asked.
*
- * @param c a <code>String</code> specifying the classname
+ * @param c a {@code String} specifying the classname
* of the instance to be created on demand
- * @param o an array of <code>Objects</code> to be passed as
+ * @param o an array of {@code Objects} to be passed as
* paramaters to the constructor in class c
*/
public ProxyLazyValue(String c, Object[] o) {
this(c, null, o);
}
/**
- * Creates a <code>LazyValue</code> which will construct an instance
+ * Creates a {@code LazyValue} which will construct an instance
* when asked.
*
- * @param c a <code>String</code> specifying the classname
+ * @param c a {@code String} specifying the classname
* of the class
* containing a static method to be called for
* instance creation.
- * @param m a <code>String</code> specifying the static method
+ * @param m a {@code String} specifying the static method
* to be called on class c
- * @param o an array of <code>Objects</code> to be passed as
+ * @param o an array of {@code Objects} to be passed as
* paramaters to the static method in class c
*/
public ProxyLazyValue(String c, String m, Object[] o) {
acc = AccessController.getContext();
className = c;
@@ -1069,15 +1069,15 @@
args = o.clone();
}
}
/**
- * Creates the value retrieved from the <code>UIDefaults</code> table.
+ * Creates the value retrieved from the {@code UIDefaults} table.
* The object is created each time it is accessed.
*
- * @param table a <code>UIDefaults</code> table
- * @return the created <code>Object</code>
+ * @param table a {@code UIDefaults} table
+ * @return the created {@code Object}
*/
public Object createValue(final UIDefaults table) {
// In order to pick up the security policy in effect at the
// time of creation we use a doPrivileged with the
// AccessControlContext that was in place when this was created.
@@ -1127,11 +1127,11 @@
/*
* Coerce the array of class types provided into one which
* looks the way the Reflection APIs expect. This is done
* by substituting primitive types for their Object counterparts,
* and superclasses for subclasses used to add the
- * <code>UIResource</code> tag.
+ * {@code UIResource} tag.
*/
private Class<?>[] getClassArray(Object[] args) {
Class<?>[] types = null;
if (args!=null) {
types = new Class<?>[args.length];
@@ -1175,18 +1175,18 @@
}
}
/**
- * <code>LazyInputMap</code> will create a <code>InputMap</code>
- * in its <code>createValue</code>
+ * {@code LazyInputMap} will create a {@code InputMap}
+ * in its {@code createValue}
* method. The bindings are passed in the constructor.
* The bindings are an array with
- * the even number entries being string <code>KeyStrokes</code>
+ * the even number entries being string {@code KeyStrokes}
* (eg "alt SPACE") and
* the odd number entries being the value to use in the
- * <code>InputMap</code> (and the key in the <code>ActionMap</code>).
+ * {@code InputMap} (and the key in the {@code ActionMap}).
* @since 1.3
*/
public static class LazyInputMap implements LazyValue {
/** Key bindings are registered under. */
private Object[] bindings;
@@ -1198,15 +1198,15 @@
public LazyInputMap(Object[] bindings) {
this.bindings = bindings;
}
/**
- * Creates an <code>InputMap</code> with the bindings that are
+ * Creates an {@code InputMap} with the bindings that are
* passed in.
*
- * @param table a <code>UIDefaults</code> table
- * @return the <code>InputMap</code>
+ * @param table a {@code UIDefaults} table
+ * @return the {@code InputMap}
*/
public Object createValue(UIDefaults table) {
if (bindings != null) {
InputMap km = LookAndFeel.makeInputMap(bindings);
return km;
@@ -1214,18 +1214,18 @@
return null;
}
}
/**
- * <code>TextAndMnemonicHashMap</code> stores swing resource strings. Many of strings
+ * {@code TextAndMnemonicHashMap} stores swing resource strings. Many of strings
* can have a mnemonic. For example:
* FileChooser.saveButton.textAndMnemonic=&Save
* For this case method get returns "Save" for the key "FileChooser.saveButtonText" and
* mnemonic "S" for the key "FileChooser.saveButtonMnemonic"
*
* There are several patterns for the text and mnemonic suffixes which are checked by the
- * <code>TextAndMnemonicHashMap</code> class.
+ * {@code TextAndMnemonicHashMap} class.
* Patterns which are converted to the xxx.textAndMnemonic key:
* (xxxNameText, xxxNameMnemonic)
* (xxxNameText, xxxMnemonic)
* (xxx.nameText, xxx.mnemonic)
* (xxxText, xxxMnemonic)
< prev index next >