Action (Java Platform SE 8)

すべてのスーパー・インタフェース:: ActionListener, EventListener

既知のすべての実装クラス:: AbstractAction, BasicDesktopPaneUI.CloseAction, BasicDesktopPaneUI.MaximizeAction, BasicDesktopPaneUI.MinimizeAction, BasicDesktopPaneUI.NavigateAction, BasicDesktopPaneUI.OpenAction, BasicFileChooserUI.ApproveSelectionAction, BasicFileChooserUI.CancelSelectionAction, BasicFileChooserUI.ChangeToParentDirectoryAction, BasicFileChooserUI.GoHomeAction, BasicFileChooserUI.NewFolderAction, BasicFileChooserUI.UpdateAction, BasicInternalFrameTitlePane.CloseAction, BasicInternalFrameTitlePane.IconifyAction, BasicInternalFrameTitlePane.MaximizeAction, BasicInternalFrameTitlePane.MoveAction, BasicInternalFrameTitlePane.RestoreAction, BasicInternalFrameTitlePane.SizeAction, BasicSliderUI.ActionScroller, BasicTreeUI.TreeCancelEditingAction, BasicTreeUI.TreeHomeAction, BasicTreeUI.TreeIncrementAction, BasicTreeUI.TreePageAction, BasicTreeUI.TreeToggleAction, BasicTreeUI.TreeTraverseAction, DefaultEditorKit.BeepAction, DefaultEditorKit.CopyAction, DefaultEditorKit.CutAction, DefaultEditorKit.DefaultKeyTypedAction, DefaultEditorKit.InsertBreakAction, DefaultEditorKit.InsertContentAction, DefaultEditorKit.InsertTabAction, DefaultEditorKit.PasteAction, HTMLEditorKit.HTMLTextAction, HTMLEditorKit.InsertHTMLTextAction, MetalFileChooserUI.DirectoryComboBoxAction, StyledEditorKit.AlignmentAction, StyledEditorKit.BoldAction, StyledEditorKit.FontFamilyAction, StyledEditorKit.FontSizeAction, StyledEditorKit.ForegroundAction, StyledEditorKit.ItalicAction, StyledEditorKit.StyledTextAction, StyledEditorKit.UnderlineAction, TextAction

public interface Action
extends ActionListener

Actionインタフェースは、同じ機能が複数のコントロールによってアクセスされる場合に、ActionListenerインタフェースに対する便利な拡張機能を提供します。

ActionListenerインタフェースで定義されるactionPerformedメソッドに加えてこのインタフェースを使用すると、アプリケーションでは次のものを1か所で定義できます。

機能を説明する、1つまたは複数のテキスト文字列。この文字列は、ボタンの上にマウスを置いたときのテキスト表示や、メニュー項目のテキストの設定に使用できます。
機能を示す、1つまたは複数のアイコン。このアイコンは、メニュー・コントロール内のイメージや、より高度なユーザー・インタフェースで使う複合エントリに使用できます。
機能の有効/無効の状態。メニュー項目とツールバー・ボタンを個別に無効にする代わりに、アプリケーションは、このインタフェースを実装する機能を無効にできます。状態変更のリスナーとして登録されているすべてのコンポーネントは、該当する項目のイベント生成を無効にすることを認識し、それに合わせて表示を変更します。

このインタフェースは既存のクラスに追加したり、アダプタの生成(通常はAbstractActionのサブクラス化)に使用したりすることができます。そして、Actionオブジェクトが複数のAction対応コンテナに追加され、Action対応コンポーネントに接続されます。これによって、ActionオブジェクトのsetEnabledメソッドを呼び出して、GUIコントロールをすべて一度に起動または終了できます。

Actionの実装は、機能の中央制御やプロパティ変更の通知といった利点を提供しない通常のActionListenerより、記憶領域の点で負荷が大きくなる傾向があります。このため、それらの機能を利用する必要がある場合にのみActionを使用するようにして、それ以外では単純なActionListenerを使用するようにしてください。

`Action`をサポートするSwingコンポーネント

多くのSwingコンポーネントは、Actionプロパティを持っています。コンポーネントにActionが設定されると、次のことが行われます。

ActionがActionListenerとしてコンポーネントに追加されます。
コンポーネントは、一部のプロパティをActionに一致するように構成します。
コンポーネントは、Actionのプロパティの変更に応じてプロパティを変更できるように、ActionにPropertyChangeListenerをインストールします。

ActionsをサポートするSwingコンポーネントによって使用されるプロパティを次の表に示します。表のボタンはいずれかのAbstractButtonサブクラスを表し、JButtonだけでなく、JMenuItemなどのクラスも含みます。他に記述がないかぎり、Actionのnullプロパティ値(またはnullであるAction)により、ボタンの対応するプロパティにnullが設定されます。

コンポーネントのプロパティ	コンポーネント	アクション・キー	注記
`enabled`	すべて	`isEnabled`メソッド
`toolTipText`	すべて	`SHORT_DESCRIPTION`
`actionCommand`	すべて	`ACTION_COMMAND_KEY`
`mnemonic`	すべてのボタン	`MNEMONIC_KEY`	`null`値または`Action`は、ボタンの`mnemonic`プロパティを`'\0'`に設定することになります。
`text`	すべてのボタン	`NAME`	ボタンのテキストに`Action`のテキストを反映させたくない場合は、プロパティ`hideActionText`を`true`に設定します。`hideActionText`が`true`の場合、`Action`を設定すると、ボタンのテキストが`null`に変更され、`NAME`の変更はすべて無視されます。`hideActionText`は一般に`Icon`のみを表示するツール・バー・ボタンに便利です。`LARGE_ICON_KEY`または`SMALL_ICON`の`Action`が`null`以外の値を持つ場合、`JToolBar.add(Action)`はプロパティを`true`に設定します。
`displayedMnemonicIndex`	すべてのボタン	`DISPLAYED_MNEMONIC_INDEX_KEY`	`DISPLAYED_MNEMONIC_INDEX_KEY`の値がテキストの境界を越える場合は、無視されます。`setAction`が呼び出されたときに、`Action`の値が`null`の場合は、ニーモニックのインデックスの表示は更新されません。そのあとで`DISPLAYED_MNEMONIC_INDEX_KEY`に変更を加える際には、`null`は -1として処理されます。
`icon`	`JCheckBox`、`JToggleButton`、および`JRadioButton`を除くすべてのボタン。	`LARGE_ICON_KEY`または`SMALL_ICON`	`JMenuItem`サブクラスは`SMALL_ICON`のみを使用します。他のすべてのボタンは`LARGE_ICON_KEY`を使用します。値が`null`の場合、それらは`SMALL_ICON`を使用します。
`accelerator`	すべての`JMenuItem`サブクラス(`JMenu`を除く)。	`ACCELERATOR_KEY`
`selected`	`JToggleButton`、`JCheckBox`、`JRadioButton`、`JCheckBoxMenuItem`、および`JRadioButtonMenuItem`	`SELECTED_KEY`	このプロパティに従うコンポーネントは、値が`null以外`である場合、この値だけを使用します。たとえば、`JToggleButton`の`SELECTED_KEY`の値が`null`である`Action`を設定した場合、`JToggleButton`は選択状態を決して更新しません。同様に、`Action`の`SELECTED_KEY`が`null以外`の値の場合、`JToggleButton`の選択状態が変化するたびに、値は`Action`に戻ります。このプロパティに従うコンポーネントは、選択状態をこのプロパティの状態と同期化します。同じ`Action`を複数のコンポーネントで使用する場合、すべてのコンポーネントの選択状態がこのプロパティの状態と同期します。`ButtonGroup`内の`JToggleButton`のように、相互に排他的な関係にあるボタンは、そのうちのどれか1つだけが選択されます。このため、`SELECTED_KEY`プロパティの値を定義する1つの同じ`Action`を、相互に排他的な関係にある複数のボタンで使用しないでください。

JPopupMenu、JToolBar、およびJMenuはいずれも、コンポーネントの作成と、対応するコンポーネント上でのActionの設定に便利なメソッドを提供します。詳細は、各クラスの説明を参照してください。

Actionは、PropertyChangeListenerを使って、Actionが変更されたことをリスナーに通知します。Bean仕様には、プロパティ名nullを使って複数の値が変更されたことを示すことができると記載されています。デフォルトでは、Actionを実行するSwingコンポーネントは、このような変更を処理しません。SwingがBean仕様に従ってnullを処理するようにするには、システム・プロパティswing.actions.reconfigureOnNullをString値trueに設定します。

関連項目:: AbstractAction

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static String`	`ACCELERATOR_KEY` アクションのアクセラレータとして使用する`KeyStroke`の格納に使用されるキーです。
`static String`	`ACTION_COMMAND_KEY` `JComponent`に関連する`Keymap`に常駐している結果として`Action`が通知されるとき作成される、`ActionEvent`のコマンド`String`の判定に使用されるキーです。
`static String`	`DEFAULT` 現在使用されていません。
`static String`	`DISPLAYED_MNEMONIC_INDEX_KEY` ニーモニックの装飾が描画されるテキスト内のインデックス(`NAME`プロパティで識別される)に対応する`Integer`の格納に使用されるキーです。
`static String`	`LARGE_ICON_KEY` `Icon`を格納するために使用されるキーです。
`static String`	`LONG_DESCRIPTION` アクションに関する詳細な`String`の説明を格納するために使用されるキーです。コンテキスト依存ヘルプで使用できます。
`static String`	`MNEMONIC_KEY` `KeyEvent`キー・コードの1つに対応する`Integer`の格納に使用されるキーです。
`static String`	`NAME` アクションの名前を表す`String`の格納に使用するキーです。メニューまたはボタンで使われます。
`static String`	`SELECTED_KEY` 選択された状態に対応する`Boolean`の格納に使用されるキーです。
`static String`	`SHORT_DESCRIPTION` アクションに関する短い`String`の説明を格納するために使用されるキーです。ツールヒントのテキストに使用されます。
`static String`	`SMALL_ICON` `ImageIcon`のような小さい`Icon`を格納するために使用されるキーです。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッドと説明
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` `PropertyChange`リスナーを追加します。
`Object`	`getValue(String key)` 関連付けられているキーを使ってオブジェクトのプロパティを1つ返します。
`boolean`	`isEnabled()` `Action`の有効状態を返します。
`void`	`putValue(String key, Object value)` 関連付けられているキーを使って、オブジェクトのプロパティを1つ設定します。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` `PropertyChange`リスナーを削除します。
`void`	`setEnabled(boolean b)` `Action`の有効状態を設定します。

インタフェース java.awt.event.ActionListenerから継承されたメソッド
actionPerformed

- フィールドの詳細
  - DEFAULT
```
static final String DEFAULT
```
    現在使用されていません。
    
    関連項目:
    
    定数フィールド値
  - NAME
```
static final String NAME
```
    アクションの名前を表すStringの格納に使用するキーです。メニューまたはボタンで使われます。
    
    関連項目:
    
    定数フィールド値
  - SHORT_DESCRIPTION
```
static final String SHORT_DESCRIPTION
```
    アクションに関する短いStringの説明を格納するために使用されるキーです。ツールヒントのテキストに使用されます。
    
    関連項目:
    
    定数フィールド値
  - LONG_DESCRIPTION
```
static final String LONG_DESCRIPTION
```
    アクションに関する詳細なStringの説明を格納するために使用されるキーです。コンテキスト依存ヘルプで使用できます。
    
    関連項目:
    
    定数フィールド値
  - SMALL_ICON
```
static final String SMALL_ICON
```
    ImageIconのような小さいIconを格納するために使用されるキーです。通常はJMenuItemなどのメニューで使用されます。
    メニューとボタンで同じActionを使用する場合は、通常、SMALL_ICONとLARGE_ICON_KEYを両方とも指定します。メニューはSMALL_ICON、ボタンはLARGE_ICON_KEYを使用します。
    
    関連項目:
    
    定数フィールド値
  - ACTION_COMMAND_KEY
```
static final String ACTION_COMMAND_KEY
```
    JComponentに関連するKeymapに常駐している結果としてActionが通知されるとき作成される、ActionEventのコマンドStringの判定に使用されるキーです。
    
    関連項目:
    
    定数フィールド値
  - ACCELERATOR_KEY
```
static final String ACCELERATOR_KEY
```
    アクションのアクセラレータとして使用するKeyStrokeの格納に使用されるキーです。
    
    導入されたバージョン:
    
    1.3
    
    関連項目:
    
    定数フィールド値
  - MNEMONIC_KEY
```
static final String MNEMONIC_KEY
```
    KeyEventキー・コードの1つに対応するIntegerの格納に使用されるキーです。この値は一般にニーモニックを指定するために使用されます。たとえば、myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.VK_A)はmyActionのニーモニックを「a」に設定し、myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.getExtendedKeyCodeForChar('?'))はmyActionのニーモニックをキリル文字の「Ef」に設定します。
    
    導入されたバージョン:
    
    1.3
    
    関連項目:
    
    定数フィールド値
  - SELECTED_KEY
```
static final String SELECTED_KEY
```
    選択された状態に対応するBooleanの格納に使用されるキーです。通常、意味のある選択状態のコンポーネントでのみ使用されます。たとえば、JRadioButtonとJCheckBoxはこれを使用しますが、JMenuのインスタンスは使用しません。
    このプロパティは、コンポーネントによって読取りと設定の両方が行われる点で、ほかのプロパティとは異なっています。たとえば、ActionがJCheckBoxに接続されている場合、JCheckBoxの選択状態はActionの選択状態から設定されます。ユーザーがJCheckBoxをクリックすると、JCheckBox と Actionの両方の選択状態が更新されます。
    注: 既存のActionsとの競合を防ぐため、このフィールドの値の前には「Swing」という接頭辞が付きます。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
  - DISPLAYED_MNEMONIC_INDEX_KEY
```
static final String DISPLAYED_MNEMONIC_INDEX_KEY
```
    ニーモニックの装飾が描画されるテキスト内のインデックス(NAMEプロパティで識別される)に対応するIntegerの格納に使用されるキーです。このプロパティの値がテキストの長さ以上の場合は、-1として処理されます。
    注: 既存のActionsとの競合を防ぐため、このフィールドの値の前には「Swing」という接頭辞が付きます。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    AbstractButton.setDisplayedMnemonicIndex(int), 定数フィールド値
  - LARGE_ICON_KEY
```
static final String LARGE_ICON_KEY
```
    Iconを格納するために使用されるキーです。通常、JButton、JToggleButtonなどのボタンで使用されます。
    メニューとボタンで同じActionを使用する場合は、通常、SMALL_ICONとLARGE_ICON_KEYを両方とも指定します。メニューはSMALL_ICON、ボタンはLARGE_ICON_KEYを使用します。
    注: 既存のActionsとの競合を防ぐため、このフィールドの値の前には「Swing」という接頭辞が付きます。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
- メソッドの詳細
  - getValue
```
Object getValue(String key)
```
    関連付けられているキーを使ってオブジェクトのプロパティを1つ返します。
    
    関連項目:
    
    putValue(java.lang.String, java.lang.Object)
  - putValue
```
void putValue(String key,
              Object value)
```
    関連付けられているキーを使って、オブジェクトのプロパティを1つ設定します。値が変更されると、PropertyChangeEventがリスナーに送信されます。
    
    パラメータ:
    
    key - キーが格納されているString
    
    value - Object値
  - setEnabled
```
void setEnabled(boolean b)
```
    Actionの有効状態を設定します。有効な場合は、このオブジェクトに関連した任意のコンポーネントはアクティブであり、このオブジェクトのactionPerformedメソッドをトリガーできます。値が変更されると、PropertyChangeEventがリスナーに送信されます。
    
    パラメータ:
    
    b - このActionを有効にする場合はtrue、無効にする場合はfalse
  - isEnabled
```
boolean isEnabled()
```
    Actionの有効状態を返します。有効な場合は、このオブジェクトに関連した任意のコンポーネントはアクティブであり、このオブジェクトのactionPerformedメソッドをトリガーできます。
    
    戻り値:
    
    このActionが有効な場合はtrue
  - addPropertyChangeListener
```
void addPropertyChangeListener(PropertyChangeListener listener)
```
    PropertyChangeリスナーを追加します。コンテナ、および接続されたコンポーネントは、これらのメソッドを使用してActionオブジェクトの通知対象として登録します。有効になった場合、またはその他のプロパティが変化した場合、登録されたリスナーに変更が通知されます。
    
    パラメータ:
    
    listener - PropertyChangeListenerオブジェクト
  - removePropertyChangeListener
```
void removePropertyChangeListener(PropertyChangeListener listener)
```
    PropertyChangeリスナーを削除します。
    
    パラメータ:
    
    listener - PropertyChangeListenerオブジェクト
    
    関連項目:
    
    addPropertyChangeListener(java.beans.PropertyChangeListener)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2018, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースAction

ActionをサポートするSwingコンポーネント

フィールドのサマリー

メソッドのサマリー

インタフェース java.awt.event.ActionListenerから継承されたメソッド

フィールドの詳細

DEFAULT

NAME

SHORT_DESCRIPTION

LONG_DESCRIPTION

SMALL_ICON

ACTION_COMMAND_KEY

ACCELERATOR_KEY

MNEMONIC_KEY

SELECTED_KEY

DISPLAYED_MNEMONIC_INDEX_KEY

LARGE_ICON_KEY

メソッドの詳細

getValue

putValue

setEnabled

isEnabled

addPropertyChangeListener

removePropertyChangeListener

`Action`をサポートするSwingコンポーネント