< prev index next >
src/java.desktop/share/classes/javax/swing/JButton.java
Print this page
*** 42,54 ****
/**
* An implementation of a "push" button.
* <p>
* Buttons can be configured, and to some degree controlled, by
* <code><a href="Action.html">Action</a></code>s. Using an
! * <code>Action</code> with a button has many benefits beyond directly
* configuring a button. Refer to <a href="Action.html#buttonActions">
! * Swing Components Supporting <code>Action</code></a> for more
* details, and you can find more information in <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/misc/action.html">How
* to Use Actions</a>, a section in <em>The Java Tutorial</em>.
* <p>
* See <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/button.html">How to Use Buttons, Check Boxes, and Radio Buttons</a>
--- 42,54 ----
/**
* An implementation of a "push" button.
* <p>
* Buttons can be configured, and to some degree controlled, by
* <code><a href="Action.html">Action</a></code>s. Using an
! * {@code Action} with a button has many benefits beyond directly
* configuring a button. Refer to <a href="Action.html#buttonActions">
! * Swing Components Supporting {@code Action}</a> for more
* details, and you can find more information in <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/misc/action.html">How
* to Use Actions</a>, a section in <em>The Java Tutorial</em>.
* <p>
* See <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/button.html">How to Use Buttons, Check Boxes, and Radio Buttons</a>
*** 64,74 ****
* 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.
* Please see {@link java.beans.XMLEncoder}.
*
* @beaninfo
* attribute: isContainer false
* description: An implementation of a \"push\" button.
--- 64,74 ----
* 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} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @beaninfo
* attribute: isContainer false
* description: An implementation of a \"push\" button.
*** 111,123 ****
this(text, null);
}
/**
* Creates a button where properties are taken from the
! * <code>Action</code> supplied.
*
! * @param a the <code>Action</code> used to specify the new button
*
* @since 1.3
*/
public JButton(Action a) {
this();
--- 111,123 ----
this(text, null);
}
/**
* Creates a button where properties are taken from the
! * {@code Action} supplied.
*
! * @param a the {@code Action} used to specify the new button
*
* @since 1.3
*/
public JButton(Action a) {
this();
*** 164,181 ****
return uiClassID;
}
/**
! * Gets the value of the <code>defaultButton</code> property,
! * which if <code>true</code> means that this button is the current
! * default button for its <code>JRootPane</code>.
* Most look and feels render the default button
* differently, and may potentially provide bindings
* to access the default button.
*
! * @return the value of the <code>defaultButton</code> property
* @see JRootPane#setDefaultButton
* @see #isDefaultCapable
* @beaninfo
* description: Whether or not this button is the default button
*/
--- 164,181 ----
return uiClassID;
}
/**
! * Gets the value of the {@code defaultButton} property,
! * which if {@code true} means that this button is the current
! * default button for its {@code JRootPane}.
* Most look and feels render the default button
* differently, and may potentially provide bindings
* to access the default button.
*
! * @return the value of the {@code defaultButton} property
* @see JRootPane#setDefaultButton
* @see #isDefaultCapable
* @beaninfo
* description: Whether or not this button is the default button
*/
*** 186,217 ****
}
return false;
}
/**
! * Gets the value of the <code>defaultCapable</code> property.
*
! * @return the value of the <code>defaultCapable</code> property
* @see #setDefaultCapable
* @see #isDefaultButton
* @see JRootPane#setDefaultButton
*/
public boolean isDefaultCapable() {
return defaultCapable;
}
/**
! * Sets the <code>defaultCapable</code> property,
* which determines whether this button can be
* made the default button for its root pane.
! * The default value of the <code>defaultCapable</code>
! * property is <code>true</code> unless otherwise
* specified by the look and feel.
*
! * @param defaultCapable <code>true</code> if this button will be
* capable of being the default button on the
! * <code>RootPane</code>; otherwise <code>false</code>
* @see #isDefaultCapable
* @beaninfo
* bound: true
* attribute: visualUpdate true
* description: Whether or not this button can be the default button
--- 186,217 ----
}
return false;
}
/**
! * Gets the value of the {@code defaultCapable} property.
*
! * @return the value of the {@code defaultCapable} property
* @see #setDefaultCapable
* @see #isDefaultButton
* @see JRootPane#setDefaultButton
*/
public boolean isDefaultCapable() {
return defaultCapable;
}
/**
! * Sets the {@code defaultCapable} property,
* which determines whether this button can be
* made the default button for its root pane.
! * The default value of the {@code defaultCapable}
! * property is {@code true} unless otherwise
* specified by the look and feel.
*
! * @param defaultCapable {@code true} if this button will be
* capable of being the default button on the
! * {@code RootPane}; otherwise {@code false}
* @see #isDefaultCapable
* @beaninfo
* bound: true
* attribute: visualUpdate true
* description: Whether or not this button can be the default button
*** 221,235 ****
this.defaultCapable = defaultCapable;
firePropertyChange("defaultCapable", oldDefaultCapable, defaultCapable);
}
/**
! * Overrides <code>JComponent.removeNotify</code> to check if
* this button is currently set as the default button on the
! * <code>RootPane</code>, and if so, sets the <code>RootPane</code>'s
! * default button to <code>null</code> to ensure the
! * <code>RootPane</code> doesn't hold onto an invalid button reference.
*/
public void removeNotify() {
JRootPane root = SwingUtilities.getRootPane(this);
if (root != null && root.getDefaultButton() == this) {
root.setDefaultButton(null);
--- 221,235 ----
this.defaultCapable = defaultCapable;
firePropertyChange("defaultCapable", oldDefaultCapable, defaultCapable);
}
/**
! * Overrides {@code JComponent.removeNotify} to check if
* this button is currently set as the default button on the
! * {@code RootPane}, and if so, sets the {@code RootPane}'s
! * default button to {@code null} to ensure the
! * {@code RootPane} doesn't hold onto an invalid button reference.
*/
public void removeNotify() {
JRootPane root = SwingUtilities.getRootPane(this);
if (root != null && root.getDefaultButton() == this) {
root.setDefaultButton(null);
*** 252,268 ****
}
}
/**
! * Returns a string representation of this <code>JButton</code>.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
! * be <code>null</code>.
*
! * @return a string representation of this <code>JButton</code>
*/
protected String paramString() {
String defaultCapableString = (defaultCapable ? "true" : "false");
return super.paramString() +
--- 252,268 ----
}
}
/**
! * Returns a string representation of this {@code JButton}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
! * be {@code null}.
*
! * @return a string representation of this {@code JButton}
*/
protected String paramString() {
String defaultCapableString = (defaultCapable ? "true" : "false");
return super.paramString() +
*** 273,290 ****
/////////////////
// Accessibility support
////////////////
/**
! * Gets the <code>AccessibleContext</code> associated with this
! * <code>JButton</code>. For <code>JButton</code>s,
! * the <code>AccessibleContext</code> takes the form of an
! * <code>AccessibleJButton</code>.
! * A new <code>AccessibleJButton</code> instance is created if necessary.
*
! * @return an <code>AccessibleJButton</code> that serves as the
! * <code>AccessibleContext</code> of this <code>JButton</code>
* @beaninfo
* expert: true
* description: The AccessibleContext associated with this Button.
*/
public AccessibleContext getAccessibleContext() {
--- 273,290 ----
/////////////////
// Accessibility support
////////////////
/**
! * Gets the {@code AccessibleContext} associated with this
! * {@code JButton}. For {@code JButton}s,
! * the {@code AccessibleContext} takes the form of an
! * {@code AccessibleJButton}.
! * A new {@code AccessibleJButton} instance is created if necessary.
*
! * @return an {@code AccessibleJButton} that serves as the
! * {@code AccessibleContext} of this {@code JButton}
* @beaninfo
* expert: true
* description: The AccessibleContext associated with this Button.
*/
public AccessibleContext getAccessibleContext() {
*** 294,314 ****
return accessibleContext;
}
/**
* This class implements accessibility support for the
! * <code>JButton</code> class. It provides an implementation of the
* Java Accessibility API appropriate to button user-interface
* elements.
* <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.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial")
protected class AccessibleJButton extends AccessibleAbstractButton {
--- 294,314 ----
return accessibleContext;
}
/**
* This class implements accessibility support for the
! * {@code JButton} class. It provides an implementation of the
* Java Accessibility API appropriate to button user-interface
* elements.
* <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} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial")
protected class AccessibleJButton extends AccessibleAbstractButton {
< prev index next >