モジュール java.desktop
パッケージ java.awt

クラスMenu

java.lang.Object
java.awt.MenuComponent
java.awt.MenuItem
java.awt.Menu
すべての実装されたインタフェース:
MenuContainer, Serializable, Accessible
直系の既知のサブクラス:
PopupMenu
public class Menu extends MenuItem implements MenuContainer, Accessible
Menuオブジェクトは、メニュー・バーから展開されるプルダウン・メニュー・コンポーネントです。

メニューはオプションで、ティア・オフ・メニューにすることができます。 ティア・オフ・メニューは、その親メニュー・バーまたはメニューから開いてドラッグできます。 このメニューは、マウス・ボタンを離したあとも画面上に残ります。 ティア・オフ・メニューのLook & Feelはそのピアで指定されるので、メニューをティア・オフする仕組みはプラットフォームに依存します。 ティア・オフ・メニューをサポートしていないプラットフォームでは、ティア・オフ・プロパティは無視されます。

メニュー内の各項目は、MenuItemクラスに属している必要があります。 各項目は、MenuItemのインスタンス、サブメニュー(Menuのインスタンス)、またはチェックボックス(CheckboxMenuItemのインスタンス)です。

導入されたバージョン:
1.0
関連項目:

  • コンストラクタの詳細

    • Menu

      public Menu() throws HeadlessException
      空のラベルを持つ新しいメニューを構築します。 このメニューは、ティア・オフ・メニューではありません。
      throws:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
      導入されたバージョン:
      1.1
      関連項目:

    • Menu

      public Menu(String label) throws HeadlessException
      指定されたラベルを持つ新しいメニューを構築します。 このメニューは、ティア・オフ・メニューではありません。
      パラメータ:
      label - メニュー・バー、またはこのメニューがサブメニューになっている別のメニューにあるメニューのラベル。
      throws:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
      関連項目:

    • Menu

      public Menu(String label, boolean tearOff) throws HeadlessException
      メニューをティア・オフできるかどうかを指定して、指定されたラベルを持つ新しいメニューを構築します。

      ティア・オフ機能は、AWTのすべての実装によってサポートされるわけではありません。 特定の実装がティア・オフ・メニューをサポートしていない場合、この値はそのまま無視されます。

      パラメータ:
      label - メニュー・バー、またはこのメニューがサブメニューになっている別のメニューにあるメニューのラベル。
      tearOff - trueの場合、メニューはティア・オフ・メニュー。
      throws:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
      関連項目:

  • メソッドの詳細

    • addNotify

      public void addNotify()
      メニューのピアを作成します。 ピアを使うと、機能性を変えずに、メニューの外観を変更できます。
      オーバーライド:
      addNotify、クラスMenuItem

    • removeNotify

      public void removeNotify()
      メニューのピアを削除します。 ピアを使うと、機能性を変えずに、メニューの外観を変更できます。
      オーバーライド:
      removeNotify、クラスMenuComponent

    • isTearOff

      public boolean isTearOff()
      このメニューがティア・オフ・メニューかどうかを示します。

      ティア・オフ機能は、AWTのすべての実装によってサポートされるわけではありません。 特定の実装がティア・オフ・メニューをサポートしていない場合、この値はそのまま無視されます。

      戻り値:
      これがティア・オフ・メニューの場合はtrue、そうでない場合はfalse。

    • getItemCount

      public int getItemCount()
      このメニューにある項目の数を返します。
      戻り値:
      このメニューにある項目数
      導入されたバージョン:
      1.1

    • countItems

      @Deprecated public int countItems()
      非推奨。
      JDKバージョン1.1で、getItemCount()に置き換えられています。
      このメニューのアイテム数を返します。
      戻り値:
      このメニューにある項目数

    • getItem

      public MenuItem getItem(int index)
      このメニューの指定されたインデックスにある項目を返します。
      パラメータ:
      index - 返される項目の位置。
      戻り値:
      指定されたインデックスにある項目

    • add

      public MenuItem add(MenuItem mi)
      指定されたメニュー項目をこのメニューに追加します。 メニュー項目がほかのメニューの一部である場合、そのメニューからそのメニュー項目を削除します。
      パラメータ:
      mi - 追加されるメニュー項目
      戻り値:
      追加されたメニュー項目
      関連項目:

    • add

      public void add(String label)
      指定されたラベルを持つ項目をこのメニューに追加します。
      パラメータ:
      label - 項目上のテキスト
      関連項目:

    • insert

      public void insert(MenuItem menuitem, int index)
      このメニューの指定された位置にメニュー項目を挿入します。
      パラメータ:
      menuitem - 挿入されるメニュー項目。
      index - メニュー項目が挿入される位置。
      throws:
      IllegalArgumentException - indexの値が0より小さい場合
      導入されたバージョン:
      1.1
      関連項目:

    • insert

      public void insert(String label, int index)
      指定されたラベルを持つメニュー項目を、このメニューの指定された位置に挿入します。 これはinsert(menuItem, index)の簡易メソッドです。
      パラメータ:
      label - 項目上のテキスト
      index - メニュー項目が挿入される位置
      throws:
      IllegalArgumentException - indexの値が0より小さい場合
      導入されたバージョン:
      1.1
      関連項目:

    • addSeparator

      public void addSeparator()
      セパレータ・ライン、つまりハイフンをメニューの現在の位置に追加します。
      関連項目:

    • insertSeparator

      public void insertSeparator(int index)
      指定された位置にセパレータを挿入します。
      パラメータ:
      index - メニュー・セパレータが挿入される位置。
      throws:
      IllegalArgumentException - indexの値が0より小さい場合。
      導入されたバージョン:
      1.1
      関連項目:

    • remove

      public void remove(int index)
      このメニューから、指定されたインデックスにあるメニュー項目を削除します。
      パラメータ:
      index - 削除される項目の位置。

    • remove

      public void remove(MenuComponent item)
      このメニューから指定されたメニュー項目を削除します。
      定義:
      remove、インタフェースMenuContainer
      パラメータ:
      item - メニューから削除する項目。 itemがnullの場合、またはこのメニュー内にない場合、このメソッドは処理を行わない。

    • removeAll

      public void removeAll()
      このメニューからすべての項目を削除します。
      導入されたバージョン:
      1.1

    • paramString

      public String paramString()
      このMenuの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。
      オーバーライド:
      paramString、クラスMenuItem
      戻り値:
      このメニューのパラメータ文字列

    • getAccessibleContext

      public AccessibleContext getAccessibleContext()
      このMenuに関連付けられたAccessibleContextを取得します。 メニューの場合、AccessibleContextはAccessibleAWTMenuの形式を取ります。 必要に応じて新規のAccessibleAWTMenuインスタンスが作成されます。
      定義:
      getAccessibleContext、インタフェースAccessible
      オーバーライド:
      getAccessibleContext、クラスMenuItem
      戻り値:
      このMenuのAccessibleContextとして機能するAccessibleAWTMenu
      導入されたバージョン:
      1.3