クラスMenuItem

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バージョン1.1で、setEnabled(boolean)に置き換えられています。
    protected final void
    disableEvents(long eventsToDisable)
    指定されたイベント・マスク・パラメータで定義するイベントについて、このメニュー 目への送信を不可にします。
    void
    enable()
    非推奨。
    JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
    void
    enable(boolean b)
    非推奨。
    JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
    protected final 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, 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を返した 合。
      導入されたバージョン:
      1.1
      関連 目:

    • MenuItem

      public MenuItem(String label) throws HeadlessException
      指定されたラベルを持ち、キーボード・ショートカットのない新しいMenuItemを構築します。 た し、ラベルでの"-"の使用は、メニュー 目間のセパレータを示すために予約されます。 デフォルトでは、セパレータを除くすべてのメニュー 目が使用可能です。
      パラメータ:
      label - このメニュー 目のラベル。
      スロー:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した 合。
      導入されたバージョン:
      1.0
      関連 目:

    • MenuItem

      public MenuItem(String label, MenuShortcut s) throws HeadlessException
      キーボード・ショートカットが関連付けられたメニュー 目を構築します。 た し、ラベルでの"-"の使用は、メニュー 目間のセパレータを示すために予約されます。 デフォルトでは、セパレータを除くすべてのメニュー 目が使用可能です。
      パラメータ:
      label - このメニュー 目のラベル。
      s - このメニュー 目に関連したMenuShortcutのインスタンス。
      スロー:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した 合。
      導入されたバージョン:
      1.1
      関連 目:

  • メソッドの詳細

    • addNotify

      public void addNotify()
      メニュー 目のピアを作成します。 ピアを使用すると、ピアの機能性を変えずに、メニュー 目の外観を変更することができます。

    • getLabel

      public String getLabel()
      このメニュー 目のラベルを返します。
      戻り値:
      このメニュー 目のラベル。このメニュー 目にラベルがない 合はnull。
      導入されたバージョン:
      1.0
      関連 目:

    • setLabel

      public void setLabel(String label)
      このメニュー 目のラベルを指定されたラベルに設定します。
      パラメータ:
      label - 新しいラベル。ラベルがない 合はnull。
      導入されたバージョン:
      1.0
      関連 目:

    • isEnabled

      public boolean isEnabled()
      このメニュー 目が使用可能になっているかどうかを判定します。
      戻り値:
       目が有効な 合はtrue; そうでなければfalse
      導入されたバージョン:
      1.0
      関連 目:

    • setEnabled

      public void setEnabled(boolean b)
      このメニュー 目を選択可能にするかどうかを設定します。
      パラメータ:
      b - trueの 合はこのメニュー 目を使用可能にし、falseの 合は使用不可にする。
      導入されたバージョン:
      1.1
      関連 目:

    • enable

      @Deprecated public void enable()
      非推奨。
      JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。

    • enable

      @Deprecated public void enable(boolean b)
      非推奨。
      JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
      このメニュー 目を選択可能にするかどうかを設定します。
      パラメータ:
      b - trueの 合、このメニュー 目を有効にします。それ以外の 合は無効にします

    • disable

      @Deprecated public void disable()
      非推奨。
      JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。

    • getShortcut

      public MenuShortcut getShortcut()
      このメニュー 目に関連付けられたMenuShortcutオブジェクトを取得します。
      戻り値:
      このメニュー 目に関連したメニュー・ショートカット。何も指定されていない 合はnull。
      導入されたバージョン:
      1.1
      関連 目:

    • setShortcut

      public void setShortcut(MenuShortcut s)
      このメニュー 目に関連付けられたMenuShortcutオブジェクトを設定します。 メニュー・ショートカットがすでにこのメニュー 目に関連した 合は、置き換えられます。
      パラメータ:
      s - このメニュー 目に関連付けられたメニュー・ショートカット。
      導入されたバージョン:
      1.1
      関連 目:

    • deleteShortcut

      public void deleteShortcut()
      このメニュー 目に関連付けられたMenuShortcutオブジェクトをすべて削除します。
      導入されたバージョン:
      1.1

    • enableEvents

      protected final void enableEvents(long eventsToEnable)
      指定されたイベント・マスク・パラメータで定義されるイベントについて、このメニュー 目への送信を可能にします。

      イベント型は、その型のリスナーがそのメニュー 目に追 されると、自動的に使用可能になります。このメソッドを呼び出す必要があるのは、MenuItemのサブクラスが、リスナーが登録されているかどうかにかかわらず指定のイベント型をprocessEventに送りたい 合 けです。

      パラメータ:
      eventsToEnable - イベント・タイプを定義するイベント・マスク
      導入されたバージョン:
      1.1
      関連 目:

    • disableEvents

      protected final void disableEvents(long eventsToDisable)
      指定されたイベント・マスク・パラメータで定義するイベントについて、このメニュー 目への送信を不可にします。
      パラメータ:
      eventsToDisable - イベント・タイプを定義するイベント・マスク
      導入されたバージョン:
      1.1
      関連 目:

    • setActionCommand

      public void setActionCommand(String command)
      このメニュー 目でトリガーされるアクション・イベントのコマンド名を設定します。

      デフォルトでは、アクション・コマンドはメニュー 目のラベルに設定されます。

      パラメータ:
      command - このメニュー 目用に設定されるアクション・コマンド。
      導入されたバージョン:
      1.1
      関連 目:

    • getActionCommand

      public String getActionCommand()
      このメニュー 目によってトリガーされるアクション・イベントのコマンド名を返します。
      戻り値:
      アクション・コマンド名
      導入されたバージョン:
      1.1
      関連 目:

    • addActionListener

      public void addActionListener(ActionListener l)
      このメニュー 目からアクション・イベントを受け取るために、指定されたアクション・リスナーを追 します。 lがnullの 合、例外はスローされず、処理も実行されません。

      AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく さい。

      パラメータ:
      l - アクション・リスナー。
      導入されたバージョン:
      1.1
      関連 目:

    • removeActionListener

      public void removeActionListener(ActionListener l)
      以後このメニュー 目からアクション・イベントを受け取らないように、指定されたアクション・リスナーを削除します。 lがnullの 合、例外はスローされず、処理も実行されません。

      AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく さい。

      パラメータ:
      l - アクション・リスナー。
      導入されたバージョン:
      1.1
      関連 目:

    • getActionListeners

      public ActionListener[] getActionListeners()
      このメニュー 目に登録されたすべてのアクション・リスナーの配列を返します。
      戻り値:
      このメニュー 目のすべてのActionListener。アクション・リスナーが現在登録されていない 合は空の配列
      導入されたバージョン:
      1.4
      関連 目:

    • 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));
      このようなリスナーがない 合は空の配列を返します。

      型パラメータ:
      T - リスナーの型
      パラメータ:
      listenerType - 要求されるリスナーの型; java.util.EventListenerの下位インタフェースを指定
      戻り値:
      このメニュー 目にFooListenerとして登録されているすべてのオブジェクトの配列。またはそのようなリスナーが追 されていない 合は空の配列
      スロー:
      ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった 合
      導入されたバージョン:
      1.3
      関連 目:

    • processEvent

      protected void processEvent(AWTEvent e)
      このメニュー 目のイベントを処理します。 イベントがActionEventのインスタンスである 合は、MenuItemで定義されている別のメソッドprocessActionEventを呼び出します。

      現在、メニュー 目はアクション・イベント けをサポートしています。

      イベント・パラメータがnullである 合は、動作が未指定のため、例外が発生する可能性があります。

      オーバーライド:
      processEvent、クラスMenuComponent
      パラメータ:
      e - イベント
      導入されたバージョン:
      1.1
      関連 目:

    • processActionEvent

      protected void processActionEvent(ActionEvent e)
      このメニュー 目で発生するアクション・イベントを、登録されているActionListenerオブジェクトにディスパッチすることによって処理します。 このコンポーネントに対してアクション・イベントが使用可能でないかぎり、このメソッドは呼び出されません。 アクション・イベントは、次のどちらかの 合に使用可能になります。
      • ActionListenerオブジェクトがaddActionListenerによって登録されている。
      • enableEventsによってアクション・イベントが使用可能になっている。

      イベント・パラメータがnullである 合は、動作が未指定のため、例外が発生する可能性があります。

      パラメータ:
      e - アクション・イベント
      導入されたバージョン:
      1.1
      関連 目:

    • 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