最初の 2 つの項目は、
"Basic" と "Simple" というラベルの付いた、単純なメニュー項目です。以下の 2 つの項目はセパレータで、それ自体が、ラベル "-" で作成されるメニュー項目です。次は、"Check" というラベルの付いた CheckboxMenuItem のインスタンスです。最後のメニュー項目は "More Examples" というラベルの付いたサブメニューで、このサブメニューは Menu のインスタンスです。
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
java.lang.Object
|
+--java.awt.MenuComponent
|
+--java.awt.MenuItem
メニュー内のすべての項目は、MenuItem クラスかそのサブクラスの 1 つに属している必要があります。
デフォルトの MenuItem オブジェクトは、単純なラベルの付いたメニュー項目を具現化します。
メニューバーのこの画像は 5 つのメニュー項目を表示します。
最初の 2 つの項目は、"Basic" と "Simple" というラベルの付いた、単純なメニュー項目です。以下の 2 つの項目はセパレータで、それ自体が、ラベル "-" で作成されるメニュー項目です。次は、"Check" というラベルの付いた CheckboxMenuItem のインスタンスです。最後のメニュー項目は "More Examples" というラベルの付いたサブメニューで、このサブメニューは Menu のインスタンスです。
メニュー項目が選択されると、AWT はメニュー項目にアクションイベントを送ります。そのイベントは ActionEvent のインスタンスなので、processEvent メソッドはそのイベントを調べて、それを processActionEvent に渡します。processActionEvent メソッドはイベントを、このメニュー項目によって生成されたアクションイベントの通知を対象として登録しているすべての ActionListener オブジェクトに転送します。
ただし、Menu サブクラスはこの動作をオーバーライドして、そのサブ項目の 1 つが選択されるまでどのイベントもフレームに送りません。
| 入れ子クラスの概要 | |
protected class |
MenuItem.AccessibleAWTMenuItem
ユーザ補助機能のデフォルトサポートを提供するのに使用する MenuItem の内部クラスです。 |
| クラス java.awt.MenuComponent から継承した入れ子クラス |
|
| コンストラクタの概要 | |
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 void |
disableEvents(long eventsToDisable)
指定されたイベントマスクパラメータで定義するイベントについて、このメニュー項目への送信を不可にします。 |
void |
enable()
推奨されていません。 JDK バージョン 1.1 以降は、 setEnabled(boolean) を使用 |
void |
enable(boolean b)
推奨されていません。 JDK バージョン 1.1 以降は、 setEnabled(boolean) を使用 |
protected void |
enableEvents(long eventsToEnable)
指定されたイベントマスクパラメータで定義されるイベントについて、このメニュー項目への送信を可能にします。 |
AccessibleContext |
getAccessibleContext()
この MenuItem に関連付けられた AccessibleContext を返します。 |
String |
getActionCommand()
このメニュー項目によってトリガされるアクションイベントのコマンド名を返します。 |
ActionListener[] |
getActionListeners()
このメニュー項目に登録されたすべてのアクションリスナーの配列を返します。 |
String |
getLabel()
このメニュー項目のラベルを返します。 |
EventListener[] |
getListeners(Class 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 |
| コンストラクタの詳細 |
public MenuItem()
throws HeadlessException
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public MenuItem(String label)
throws HeadlessException
label - このメニュー項目のラベル
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public MenuItem(String label,
MenuShortcut s)
throws HeadlessException
label - このメニュー項目のラベルs - このメニュー項目に関連した MenuShortcut のインスタンス
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()| メソッドの詳細 |
public void addNotify()
public String getLabel()
nullsetLabel(java.lang.String)public void setLabel(String label)
label - 新しいラベル。ラベルがない場合は nullgetLabel()public boolean isEnabled()
setEnabled(boolean)public void setEnabled(boolean b)
b - true の場合はこのメニュー項目を使用可能にし、false の場合は使用不可にするisEnabled()public void enable()
setEnabled(boolean) を使用
public void enable(boolean b)
setEnabled(boolean) を使用
public void disable()
setEnabled(boolean) を使用
public MenuShortcut getShortcut()
MenuShortcut オブジェクトを返します。
nullsetShortcut(java.awt.MenuShortcut)public void setShortcut(MenuShortcut s)
MenuShortcut オブジェクトを設定します。メニューショートカットがすでにこのメニュー項目に関連した場合は、置き換えられます。
s - このメニュー項目に関連したメニューショートカットgetShortcut()public void deleteShortcut()
MenuShortcut オブジェクトがあれば削除します。
protected final void enableEvents(long eventsToEnable)
イベントタイプは、そのタイプのリスナーがそのメニュー項目に追加されると、自動的に使用可能になります。このメソッドを呼び出す必要があるのは、MenuItem のサブクラスが、指定されたイベントタイプを processEvent に送る場合だけです。リスナーが登録されているかどうかはこの場合関係ありません。
eventsToEnable - イベントタイプを定義するイベントマスクprocessEvent(java.awt.AWTEvent),
disableEvents(long),
Component.enableEvents(long)protected final void disableEvents(long eventsToDisable)
eventsToDisable - イベントタイプを定義するイベントマスクprocessEvent(java.awt.AWTEvent),
enableEvents(long),
Component.disableEvents(long)public void setActionCommand(String command)
デフォルトでは、アクションコマンドはメニュー項目のラベルに設定されます。
command - このメニュー項目用に設定されるアクションコマンドgetActionCommand()public String getActionCommand()
setActionCommand(java.lang.String)public void addActionListener(ActionListener l)
l - アクションリスナーremoveActionListener(java.awt.event.ActionListener),
getActionListeners(),
ActionEvent,
ActionListenerpublic void removeActionListener(ActionListener l)
l - アクションリスナーaddActionListener(java.awt.event.ActionListener),
getActionListeners(),
ActionEvent,
ActionListenerpublic ActionListener[] getActionListeners()
ActionListener、または現在アクションリスナーが登録されていない場合は空の配列addActionListener(java.awt.event.ActionListener),
removeActionListener(java.awt.event.ActionListener),
ActionEvent,
ActionListenerpublic EventListener[] getListeners(Class 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 を実装するクラスまたはインタフェースを指定しない場合getActionListeners()protected void processEvent(AWTEvent e)
ActionEvent のインスタンスの場合、MenuItem によって定義されたほかのメソッドである processActionEvent を呼び出します。
現在、メニュー項目はアクションイベントだけをサポートしています。
イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。
MenuComponent 内の processEvente - イベントprocessActionEvent(java.awt.event.ActionEvent)protected void processActionEvent(ActionEvent e)
ActionListener オブジェクトにディスパッチすることにより、このアクションイベントを処理します。このメソッドは、アクションイベントがこのコンポーネント用に使用可能にならないかぎり呼び出されません。アクションイベントは、次の項目の 1 つが発生したときに使用可能になります。
ActionListener オブジェクトが addActionListener によって登録されている
enableEvents によってアクションイベントが使用可能になっている
イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。
e - アクションイベントActionEvent,
ActionListener,
enableEvents(long)public String paramString()
MenuItem の状態を表す文字列を返します。このメソッドは、デバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
MenuComponent 内の paramStringpublic AccessibleContext getAccessibleContext()
Accessible 内の getAccessibleContextMenuComponent 内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.