JMenuItem (Java 2 プラットフォーム SE v1.4.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.swing
クラス JMenuItem

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.AbstractButton
                          |
                          +--javax.swing.JMenuItem

すべての実装インタフェース:: Accessible, ImageObserver, ItemSelectable, MenuContainer, MenuElement, Serializable, SwingConstants

直系の既知のサブクラス:: JCheckBoxMenuItem, JMenu, JRadioButtonMenuItem

public class JMenuItem
extends AbstractButton
implements Accessible, MenuElement

メニューの項目の実装です。メニュー項目は実質的にはリストに置かれているボタンです。ユーザが「ボタン」を選択すると、メニュー項目に対応するアクションが実行されます。機能は JPopupMenu が保持する JMenuItem で正確に実行されます。

詳細と例については、「The Java Tutorial」の「How to Use Menus」を参照してください。標準の Look & Feel (L&F) 表現でこのコンポーネントが使うキーボードのキーについては、「JMenuItem のキー割り当て」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 では、すべての JavaBeans^TM の長期間の運用に対するサポートが java.beans パッケージに追加されました。XMLEncoder を参照してください。

関連項目:: JPopupMenu, JMenu, JCheckBoxMenuItem, JRadioButtonMenuItem

コンストラクタの詳細

JMenuItem

public JMenuItem()

テキストおよびアイコンを指定しないで JMenuItem を作成します。

JMenuItem

public JMenuItem(Icon icon)

指定されたアイコンで JMenuItem を作成します。
パラメータ:: icon - JMenuItem のアイコン

JMenuItem

public JMenuItem(String text)

指定されたテキストで JMenuItem を作成します。
パラメータ:: text - JMenuItem のテキスト

JMenuItem

public JMenuItem(Action a)

指定された Action からプロパティを取得するメニュー項目を作成します。
パラメータ:: a - JMenuItem のアクション
導入されたバージョン:: 1.3

JMenuItem

public JMenuItem(String text,
                 Icon icon)

指定されたテキストおよびアイコンで JMenuItem を作成します。
パラメータ:: text - JMenuItem のテキスト; icon - JMenuItem のアイコン

JMenuItem

public JMenuItem(String text,
                 int mnemonic)

指定されたテキストおよびキーボードニーモニックで JMenuItem を作成します。
パラメータ:: text - JMenuItem のテキスト; mnemonic - JMenuItem のキーボードニーモニック

メソッドの詳細

init

protected void init(String text,
                    Icon icon)

指定されたテキストおよびアイコンでメニュー項目を初期化します。

オーバーライド:: クラス AbstractButton 内の init

パラメータ:: text - JMenuItem のテキスト; icon - JMenuItem のアイコン

setUI

public void setUI(MenuItemUI ui)

このコンポーネントを描画する Look & Feel オブジェクトを設定します。

パラメータ:: ui - JMenuItemUI の L&F オブジェクト
関連項目:: UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在の Look & Feel からの値を持つ UI プロパティをリセットします。

オーバーライド:: クラス AbstractButton 内の updateUI

関連項目:: JComponent.updateUI()

getUIClassID

public String getUIClassID()

Look & Feel クラスの名前の構築に使用された接頭辞を返します。このクラスは、このコンポーネントを描画するのに使用されます。

オーバーライド:: クラス JComponent 内の getUIClassID

戻り値:: 文字列「MenuItemUI」
関連項目:: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setArmed

public void setArmed(boolean b)

メニュー項目を「作動準備が整っている」ものとして設定します。この項目上でマウスボタンが離されると、メニューのアクションイベントがトリガされます。それ以外の場所でマウスボタンが離されると、イベントはトリガされずメニュー項目の作動準備は解除されます。

パラメータ:: b - メニュー項目の作動準備を整え、選択可能にする場合は true

isArmed

public boolean isArmed()

メニュー項目の「作動準備が整っている」かどうかを返します。

戻り値:: メニュー項目の作動準備が整っていて選択可能な場合は true
関連項目:: setArmed(boolean)

setEnabled

public void setEnabled(boolean b)

メニュー項目を有効または無効にします。

オーバーライド:: クラス AbstractButton 内の setEnabled

パラメータ:: b - 項目を有効にする場合は true

setAccelerator

public void setAccelerator(KeyStroke keyStroke)

メニュー階層を移動することなくメニュー項目のアクションリスナーを呼び出すキーの組み合わせを設定します。適切なアクションをインストールするのは UI の役割です。キーボードアクセラレータが入力されると、メニューが現在表示されているかどうかを処理します。

パラメータ:: keyStroke - アクセラレータとして機能する KeyStroke

getAccelerator

public KeyStroke getAccelerator()

メニュー項目のアクセラレータとして機能する KeyStroke を返します。

戻り値:: アクセラレータキーを識別する KeyStroke オブジェクト

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

Action インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。設定されるプロパティはサブクラスによって異なります。デフォルトでは、このメソッドは AbstractButton.configurePropertiesFromAction() と同じプロパティと Accelerator を設定します。

オーバーライド:: クラス AbstractButton 内の configurePropertiesFromAction

パラメータ:: a - プロパティを取得する Action、または null
導入されたバージョン:: 1.3
関連項目:: Action

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

ActionEvent ソースを Action インスタンスのプロパティの変更に従って更新するのに使う PropertyChangeListener を生成するファクトリメソッドです。最新の状態で保持する必要のあるプロパティのセットが異なる場合は、独自の PropertyChangeListener を提供するためにサブクラスがこのメソッドをオーバーライドすることがあります。

PropertyChangeListener は ActionEvent ソースへの強参照を保持しないようにする必要があります。これは、ActionEvent ソースのガベージコレクションおよびすべての包含関係の階層のコンポーネントを妨害する可能性があるからです。

オーバーライド:: クラス AbstractButton 内の createActionPropertyChangeListener

パラメータ:: a - プロパティを取得する Action、または null
導入されたバージョン:: 1.3
関連項目:: Action

processMouseEvent

public void processMouseEvent(MouseEvent e,
                              MenuElement[] path,
                              MenuSelectionManager manager)

MenuSelectionManager から転送されるマウスイベントを処理します。必要に応じて MenuSelectionManager の API を使用して、メニュー選択を変更します。

注: イベントをサブコンポーネントに転送する必要はありません。MenuSelectionManager が自動的に実行します。

定義:: インタフェース MenuElement 内の processMouseEvent

パラメータ:: e - MouseEvent; path - MenuElement パス配列; manager - MenuSelectionManager

processKeyEvent

public void processKeyEvent(KeyEvent e,
                            MenuElement[] path,
                            MenuSelectionManager manager)

MenuSelectionManager から転送されるキーイベントを処理します。必要に応じて MenuSelectionManager の API を使用して、メニュー選択を変更します。

注: イベントをサブコンポーネントに転送する必要はありません。MenuSelectionManager が自動的に実行します。

定義:: インタフェース MenuElement 内の processKeyEvent

パラメータ:: e - KeyEvent; path - MenuElement パス配列; manager - MenuSelectionManager

processMenuDragMouseEvent

public void processMenuDragMouseEvent(MenuDragMouseEvent e)

メニューでのマウスドラッグを処理します。

パラメータ:: e - MenuDragMouseEvent オブジェクト

processMenuKeyEvent

public void processMenuKeyEvent(MenuKeyEvent e)

メニューのキーストロークを処理します。

パラメータ:: e - MenuKeyEvent オブジェクト