javax.swing
インタフェース Action

すべてのスーパーインタフェース:

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 つまたは複数のアイコン。このアイコンは、メニューコントロール内のイメージや、より高度なユーザインタフェースで使う複合エントリに使用できる
• 機能の有効/無効の状態。メニュー項目とツールバーボタンを個別に無効にする代わりに、アプリケーションは、このインタフェースを実装する機能を無効にできる。状態変化のリスナーとして登録されているすべてのコンポーネントは、該当する項目へのイベント生成を無効にする通知を受け、表示をそれに合わせて変更する

一部のコンテナは、メニューやツールバーを保持し、Action オブジェクトの追加方法を認識しています。このようなコンテナに Action オブジェクトが追加されると、コンテナは次のことを実行します。

1. そのコンテナに対する適切なコンポーネントの生成。たとえば、ツールバーがボタンコンポーネントを生成するなど
2. コンポーネントをカスタマイズするのに適切なプロパティの Action オブジェクトからの取得。たとえば、アイコンのイメージ、およびボタン上にカーソルがあるときに表示されるテキスト
3. Action オブジェクトの初期状態の確認、有効か無効かの決定、および適切な方法でのコンポーネントの描画
4. Action オブジェクトとともにリスナーを登録して、状態の変化が通知されるようにする。Action オブジェクトが有効から無効に変化したり、戻ったりした場合に、コンテナはイベント生成機構に適切な変更を加え、それに合わせてコンポーネントを描画する

たとえば、メニュー項目およびツールバーボタンは、両方とも Cut アクションオブジェクトにアクセスできます。このオブジェクトに関連したテキストは「Cut」として指定され、はさみのイメージがオブジェクトのアイコンに指定されます。このようにして、Cut というアクションオブジェクトは、メニューおよびツールバーに追加されます。各コンテナはオブジェクトを適切に扱い、関連したコンポーネントがアクティブになると、actionPerformed メソッドを呼び出します。これでアプリケーションは、アプリケーションオブジェクトを有効あるいは無効にする際に、どのユーザインタフェースコンポーネントが接続されているかを気にせずに済みます。

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

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

関連項目:

AbstractAction

フィールドの概要

static String	ACCELERATOR_KEY アクションのアクセラレータとして使用する KeyStroke の格納に使用するキーです。
static String	ACTION_COMMAND_KEY JComponent に関連付けられた Keymap に常駐している結果として、Action が通知されるときに生成される ActionEvent のコマンド String の判定に使用するキーです。
static String	DEFAULT 現在使用されていません。
static String	LONG_DESCRIPTION アクションについての詳細な説明を表す String の格納に使用するキーです。
static String	MNEMONIC_KEY アクションのニーモニックとして使用する KeyEvent の格納に使用するキーです。
static String	NAME アクションの名前を表す String の格納に使用するキーです。
static String	SHORT_DESCRIPTION アクションについての短い説明を表す String の格納に使用するキーです。
static String	SMALL_ICON アクションに対応する小さい Icon (ImageIcon など) の格納に使用するキーです。

メソッドの概要

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

アクションに対応する小さい Icon (ImageIcon など) の格納に使用するキーです。ツールバーのボタンに使われます。

関連項目:

定数フィールド値

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.3

関連項目:

定数フィールド値

メソッドの詳細

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 オブジェクトの通知対象として登録します。Action オブジェクトが有効になった場合、またはその他のプロパティが変化した場合、登録されたリスナーに変更が通知されます。

パラメータ:

listener - PropertyChangeListener オブジェクト

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

PropertyChange リスナーを削除します。

パラメータ:

listener - PropertyChangeListener オブジェクト

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener)