javax/swing/Action.java

32  * The <code>Action</code> interface provides a useful extension to the
57  * The <code>Action</code> object
58  * can then be added to multiple <code>Action</code>-aware containers
59  * and connected to <code>Action</code>-capable
61  * deactivated all at once by invoking the <code>Action</code> object's
64  * Note that <code>Action</code> implementations tend to be more expensive
68  * you should take care to only use <code>Action</code>s where their benefits
72  * <h3><a id="buttonActions"></a>Swing Components Supporting <code>Action</code></h3>
74  * Many of Swing's components have an <code>Action</code> property.  When
75  * an <code>Action</code> is set on a component, the following things
78  * <li>The <code>Action</code> is added as an <code>ActionListener</code> to
81  *      <code>Action</code>.
83  *     <code>Action</code> so that the component can change its properties
84  *     to reflect changes in the <code>Action</code>'s properties.
93  * <code>null</code> property value in an <code>Action</code> (or a
94  * <code>Action</code> that is <code>null</code>) results in the
98  * <caption>Supported Action properties</caption>
103  *    <th>Action Key
126  *      <td>A <code>null</code> value or <code>Action</code> results in the
134  *          of the <code>Action</code>, set the property
137  *          <code>Action</code> changes the text of the button to
141  *          <code>JToolBar.add(Action)</code> sets the property to
142  *          <code>true</code> if the <code>Action</code> has a
152  *          <code>Action</code> is <code>null</code>, the displayed
180  *          you set an {@code Action} that has a {@code null}
185  *          the {@code Action} if the {@code Action} has a {@code non-null}
189  *          in sync with this property. When the same {@code Action} is used
194  *          use the same {@code Action} that defines a value for the
202  * <code>Action</code> on the corresponding component.  Refer to each of
205  * <code>Action</code> uses <code>PropertyChangeListener</code> to
206  * inform listeners the <code>Action</code> has changed.  The beans
209  * components that take an <code>Action</code> do not handle such a
219 public interface Action extends ActionListener {
249      * If the same <code>Action</code> is used with menus and buttons you'll
260      * <code>Action</code> is going to be notified as the result of
278      * <code>myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.VK_A)</code>
280      * <code>myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.getExtendedKeyCodeForChar('\u0444'))</code>
296      * if an <code>Action</code> is attached to a <code>JCheckBox</code>
298      * that of the <code>Action</code>.  If the user clicks on the
300      * <b>and</b> the <code>Action</code> will <b>both</b> be updated.
330      * If the same <code>Action</code> is used with menus and buttons you'll
363      * Sets the enabled state of the {@code Action}.  When enabled,
369      * @param  b true to enable this {@code Action}, false to disable it
374      * Returns the enabled state of the {@code Action}. When enabled,
378      * @return true if this {@code Action} is enabled
401      * <code>Action</code> object. When its enabled state or other property