MenuItem (Java Platform SE 7)

java.lang.Object
- java.awt.MenuComponent
- - java.awt.MenuItem

すべての実装されたインタフェース:

Serializable, Accessible

直系の既知のサブクラス:

CheckboxMenuItem, Menu
```
public class MenuItem
extends MenuComponent
implements Accessible
```
メニュー内のすべての項目は、クラス MenuItem か、またはそのいずれかのサブクラスに属している必要があります。
デフォルトの MenuItem オブジェクトは、単純なラベルの付いたメニュー項目を具現化します。
メニューバーのこの画像は 5 つのメニュー項目を示しています。
最初の 2 つの項目は、"Basic" と "Simple" というラベルの付いた、単純なメニュー項目です。次の 2 つの項目はセパレータで、それ自体がラベル "-" 付きで作成されるメニュー項目です。次は、"Check" というラベルの付いた CheckboxMenuItem のインスタンスです。最後のメニュー項目は "More Examples" というラベルの付いたサブメニューで、このサブメニューは Menu のインスタンスです。
メニュー項目が選択されると、AWT はメニュー項目にアクションイベントを送ります。イベントは ActionEvent のインスタンスであるため、processEvent メソッドはそのイベントを検査して processActionEvent に渡します。後者のメソッドは、このメニュー項目によって生成されるアクションイベントの通知を登録しているすべての ActionListener オブジェクトにそのイベントを送ります。
ただし、Menu サブクラスはこの動作をオーバーライドして、そのサブ項目の 1 つが選択されるまでどのイベントもフレームに送りません。

関連項目:
直列化された形式

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラスと説明
`protected class`	`MenuItem.AccessibleAWTMenuItem` アクセシビリティーのデフォルトサポートを提供するために使用される MenuItem の内部クラスです。

クラス java.awt.MenuComponent から継承されたネストされたクラス/インタフェース
MenuComponent.AccessibleAWTMenuComponent

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`MenuItem()` 空ラベルを持ち、キーボードショートカットのない新しい MenuItem を構築します。
`MenuItem(String label)` 指定されたラベルを持ち、キーボードショートカットのない新しい MenuItem を構築します。
`MenuItem(String label, MenuShortcut s)` 関連しているキーボードショートカットを持つメニュー項目を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addActionListener(ActionListener l)` このメニュー項目からアクションイベントを受け取るアクションリスナーを追加します。
`void`	`addNotify()` メニュー項目のピアを作成します。
`void`	`deleteShortcut()` このメニュー項目に関連付けられた `MenuShortcut` オブジェクトをすべて削除します。
`void`	`disable()` 非推奨。 JDK version 1.1 以降は、`setEnabled(boolean)` に置き換えられています。
`protected void`	`disableEvents(long eventsToDisable)` 指定されたイベントマスクパラメータで定義するイベントについて、このメニュー項目への送信を不可にします。
`void`	`enable()` 非推奨。 JDK version 1.1 以降は、`setEnabled(boolean)` に置き換えられています。
`void`	`enable(boolean b)` 非推奨。 JDK version 1.1 以降は、`setEnabled(boolean)` に置き換えられています。
`protected void`	`enableEvents(long eventsToEnable)` 指定されたイベントマスクパラメータで定義されるイベントについて、このメニュー項目への送信を可能にします。
`AccessibleContext`	`getAccessibleContext()` この MenuItem に関連付けられた AccessibleContext を取得します。
`String`	`getActionCommand()` このメニュー項目によってトリガーされるアクションイベントのコマンド名を返します。
`ActionListener[]`	`getActionListeners()` このメニュー項目に登録されたすべてのアクションリスナーの配列を返します。
`String`	`getLabel()` このメニュー項目のラベルを返します。
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` この `MenuItem` に `FooListener` として現在登録されているすべてのオブジェクトの配列を返します。
`MenuShortcut`	`getShortcut()` このメニュー項目に関連付けられた `MenuShortcut` オブジェクトを取得します。
`boolean`	`isEnabled()` このメニュー項目が使用可能になっているかどうかを判定します。
`String`	`paramString()` この `MenuItem` の状態を表す文字列を返します。
`protected void`	`processActionEvent(ActionEvent e)` このメニュー項目で発生するアクションイベントを、登録されているすべての `ActionListener` オブジェクトにディスパッチすることによって処理します。
`protected void`	`processEvent(AWTEvent e)` このメニュー項目のイベントを処理します。
`void`	`removeActionListener(ActionListener l)` 指定されたアクションリスナーを削除します。これによってそのリスナーは、以後、このメニュー項目からアクションイベントを受け取りません。
`void`	`setActionCommand(String command)` このメニュー項目でトリガーされるアクションイベントのコマンド名を設定します。
`void`	`setEnabled(boolean b)` このメニュー項目を選択可能にするかどうかを設定します。
`void`	`setLabel(String label)` このメニュー項目のラベルを指定されたラベルに設定します。
`void`	`setShortcut(MenuShortcut s)` このメニュー項目に関連付けられた `MenuShortcut` オブジェクトを設定します。

クラス java.awt.MenuComponent から継承されたメソッド
dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, postEvent, removeNotify, setFont, setName, toString

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - MenuItem
```
public MenuItem()
         throws HeadlessException
```
    空ラベルを持ち、キーボードショートカットのない新しい MenuItem を構築します。
    
    例外:
    
    HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    GraphicsEnvironment.isHeadless()
  - MenuItem
```
public MenuItem(String label)
         throws HeadlessException
```
    指定されたラベルを持ち、キーボードショートカットのない新しい MenuItem を構築します。ただし、ラベルでの "-" の使用は、メニュー項目間のセパレータを示すために予約されます。デフォルトでは、セパレータを除くすべてのメニュー項目が使用可能です。
    
    パラメータ:
    label - このメニュー項目のラベル。
    
    例外:
    
    HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。
    導入されたバージョン:
    
    JDK1.0
    
    関連項目:
    GraphicsEnvironment.isHeadless()
  - MenuItem
```
public MenuItem(String label,
        MenuShortcut s)
         throws HeadlessException
```
    関連しているキーボードショートカットを持つメニュー項目を構築します。ただし、ラベルでの "-" の使用は、メニュー項目間のセパレータを示すために予約されます。デフォルトでは、セパレータを除くすべてのメニュー項目が使用可能です。
    
    パラメータ:
    label - このメニュー項目のラベル。
    s - このメニュー項目に関連した MenuShortcut のインスタンス。
    
    例外:
    
    HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    GraphicsEnvironment.isHeadless()
- メソッドの詳細
  - addNotify
```
public void addNotify()
```
    メニュー項目のピアを作成します。ピアを使用すると、ピアの機能性を変えずに、メニュー項目の外観を変更することができます。
  - getLabel
```
public String getLabel()
```
    このメニュー項目のラベルを返します。
    
    戻り値:
    このメニュー項目のラベル。このメニュー項目にラベルがない場合は null。
    導入されたバージョン:
    
    JDK1.0
    
    関連項目:
    setLabel(java.lang.String)
  - setLabel
```
public void setLabel(String label)
```
    このメニュー項目のラベルを指定されたラベルに設定します。
    
    パラメータ:
    label - 新しいラベル。ラベルがない場合は null。
    導入されたバージョン:
    
    JDK1.0
    
    関連項目:
    getLabel()
  - isEnabled
```
public boolean isEnabled()
```
    このメニュー項目が使用可能になっているかどうかを判定します。
    
    導入されたバージョン:
    
    JDK1.0
    
    関連項目:
    setEnabled(boolean)
  - setEnabled
```
public void setEnabled(boolean b)
```
    このメニュー項目を選択可能にするかどうかを設定します。
    
    パラメータ:
    b - true の場合はこのメニュー項目を使用可能にし、false の場合は使用不可にする。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    isEnabled()
  - enable
```
@Deprecated
public void enable()
```
    非推奨。 JDK Version 1.1 以降は、setEnabled(boolean) に置き換えられています。
  - enable
```
@Deprecated
public void enable(boolean b)
```
    非推奨。 JDK Version 1.1 以降は、setEnabled(boolean) に置き換えられています。
  - disable
```
@Deprecated
public void disable()
```
    非推奨。 JDK Version 1.1 以降は、setEnabled(boolean) に置き換えられています。
  - getShortcut
```
public MenuShortcut getShortcut()
```
    このメニュー項目に関連付けられた MenuShortcut オブジェクトを取得します。
    
    戻り値:
    このメニュー項目に関連したメニューショートカット。何も指定されていない場合は null。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    setShortcut(java.awt.MenuShortcut)
  - setShortcut
```
public void setShortcut(MenuShortcut s)
```
    このメニュー項目に関連付けられた MenuShortcut オブジェクトを設定します。メニューショートカットがすでにこのメニュー項目に関連した場合は、置き換えられます。
    
    パラメータ:
    s - このメニュー項目に関連付けられたメニューショートカット。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    getShortcut()
  - deleteShortcut
```
public void deleteShortcut()
```
    このメニュー項目に関連付けられた MenuShortcut オブジェクトをすべて削除します。
    
    導入されたバージョン:
    
    JDK1.1
  - enableEvents
```
protected final void enableEvents(long eventsToEnable)
```
    指定されたイベントマスクパラメータで定義されるイベントについて、このメニュー項目への送信を可能にします。
    イベント型は、その型のリスナーがそのメニュー項目に追加されると、自動的に使用可能になります。このメソッドを呼び出す必要があるのは、MenuItem のサブクラスが、リスナーが登録されているかどうかにかかわらず指定のイベント型を processEvent に送りたい場合だけです。
    
    パラメータ:
    eventsToEnable - イベントタイプを定義するイベントマスク
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    processEvent(java.awt.AWTEvent), disableEvents(long), Component.enableEvents(long)
  - disableEvents
```
protected final void disableEvents(long eventsToDisable)
```
    指定されたイベントマスクパラメータで定義するイベントについて、このメニュー項目への送信を不可にします。
    
    パラメータ:
    eventsToDisable - イベントタイプを定義するイベントマスク
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    processEvent(java.awt.AWTEvent), enableEvents(long), Component.disableEvents(long)
  - setActionCommand
```
public void setActionCommand(String command)
```
    このメニュー項目でトリガーされるアクションイベントのコマンド名を設定します。
    デフォルトでは、アクションコマンドはメニュー項目のラベルに設定されます。
    
    パラメータ:
    command - このメニュー項目用に設定されるアクションコマンド。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    getActionCommand()
  - getActionCommand
```
public String getActionCommand()
```
    このメニュー項目によってトリガーされるアクションイベントのコマンド名を返します。
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    setActionCommand(java.lang.String)
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    このメニュー項目からアクションイベントを受け取るアクションリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。
    AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
    
    パラメータ:
    l - アクションリスナー。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    指定されたアクションリスナーを削除します。これによってそのリスナーは、以後、このメニュー項目からアクションイベントを受け取りません。l が null の場合、例外はスローされず、処理も実行されません。
    AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
    
    パラメータ:
    l - アクションリスナー。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    このメニュー項目に登録されたすべてのアクションリスナーの配列を返します。
    
    戻り値:
    このメニュー項目のすべての ActionListener。アクションリスナーが現在登録されていない場合は空の配列
    導入されたバージョン:
    
    1.4
    
    関連項目:
    addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListener
  - getListeners
```
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
```
    この MenuItem に FooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録されます。
    FooListener.class などのクラスリテラルを使用して listenerType 引数を指定できます。たとえば、次のコードを使用して、MenuItem m のアクションリスナーを照会できます。
```
ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));
```
    このようなリスナーがない場合は空の配列を返します。
    パラメータ:
    listenerType - 要求されるリスナーの型。次の下位インタフェースを指定: java.util.EventListener
    
    戻り値:
    このメニュー項目に FooListener として登録されているすべてのオブジェクトの配列。またはそのようなリスナーが追加されていない場合は空の配列
    
    例外:
    
    ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合
    導入されたバージョン:
    
    1.3
    
    関連項目:
    getActionListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    このメニュー項目のイベントを処理します。イベントが ActionEvent のインスタンスである場合は、MenuItem で定義されている別のメソッド processActionEvent を呼び出します。
    現在、メニュー項目はアクションイベントだけをサポートしています。
    イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
    
    オーバーライド:
    
    processEvent、クラス: MenuComponent
    
    パラメータ:
    e - イベント
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    processActionEvent(java.awt.event.ActionEvent)
  - processActionEvent
```
protected void processActionEvent(ActionEvent e)
```
    このメニュー項目で発生するアクションイベントを、登録されているすべての ActionListener オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してアクションイベントが使用可能でないかぎり、このメソッドは呼び出されません。アクションイベントは、次のどちらかの場合に使用可能になります。
    - ActionListener オブジェクトが addActionListener によって登録されている。
    - enableEvents によってアクションイベントが使用可能になっている。
    イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
    パラメータ:
    e - アクションイベント
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    ActionEvent, ActionListener, enableEvents(long)
  - paramString
```
public String paramString()
```
    この MenuItem の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
    
    オーバーライド:
    
    paramString、クラス: MenuComponent
    
    戻り値:
    このメニュー項目のパラメータ文字列
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    この MenuItem に関連付けられた AccessibleContext を取得します。メニューバーの場合、AccessibleContext は AccessibleAWTMenuItem の形式を取ります。必要に応じて新規の AccessibleAWTMenuItem インスタンスが作成されます。
    
    定義:
    
    getAccessibleContext、インタフェース: Accessible
    
    オーバーライド:
    
    getAccessibleContext、クラス: MenuComponent
    
    戻り値:
    この MenuItem の AccessibleContext として機能する AccessibleAWTMenuItem
    導入されたバージョン:
    
    1.3

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

クラス MenuItem

ネストされたクラスのサマリー

クラス java.awt.MenuComponent から継承されたネストされたクラス/インタフェース

コンストラクタのサマリー

メソッドのサマリー

クラス java.awt.MenuComponent から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

MenuItem

MenuItem

MenuItem

メソッドの詳細

addNotify

getLabel

setLabel

isEnabled

setEnabled

enable

enable

disable

getShortcut

setShortcut

deleteShortcut

enableEvents

disableEvents

setActionCommand

getActionCommand

addActionListener

removeActionListener

getActionListeners

getListeners

processEvent

processActionEvent

paramString

getAccessibleContext