- すべての実装されたインタフェース:
ItemSelectable
,Serializable
,Accessible
public class CheckboxMenuItem extends MenuItem implements ItemSelectable, Accessible
次の図は、CheckBoxMenuItem
のインスタンスが含まれているメニューを表します。
Check
というラベルの付いた項目は、「オフ」の状態のチェックボックス・メニュー項目を示します。
チェックボックス・メニュー項目を選択すると、AWTは項目イベントをその項目に送ります。 イベントはItemEvent
のインスタンスであるため、processEvent
メソッドはそのイベントを検査してprocessItemEvent
に渡します。 後者のメソッドは、このメニュー項目によって生成される項目イベントの通知を登録しているすべてのItemListener
オブジェクトにそのイベントを送ります。
- 導入されたバージョン:
- 1.0
- 関連項目:
ItemEvent
,ItemListener
, 直列化された形式
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 protected class
CheckboxMenuItem.AccessibleAWTCheckboxMenuItem
アクセシビリティのデフォルト・サポートを提供するために使用するCheckboxMenuItemの内部クラスです。 -
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 CheckboxMenuItem()
空のラベルが付いた、チェックボックス・メニュー項目を生成します。CheckboxMenuItem(String label)
指定されたラベルが付いた、チェックボックス・メニュー項目を生成します。CheckboxMenuItem(String label, boolean state)
指定されたラベルが付いたチェックボックス・メニュー項目を、指定された状態で生成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 void
addItemListener(ItemListener l)
指定された項目リスナーを、このチェックボックスの項目イベント受信のために追加します。void
addNotify()
チェックボックス項目のピアを生成します。AccessibleContext
getAccessibleContext()
このCheckboxMenuItemに関連付けられたAccessibleContextを取得します。ItemListener[]
getItemListeners()
このチェックボックス・メニュー項目に登録されているすべての項目リスナーの配列を返します。<T extends EventListener>
T[]getListeners(クラス<T> listenerType)
このCheckboxMenuItem
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。Object[]
getSelectedObjects()
チェックボックス・メニュー項目のラベルを含む配列(長さ1)を返します。ただし、チェックボックスが選択されていない場合には、nullを返します。boolean
getState()
このチェックボックス・メニュー項目の状態が「オン」であるか「オフ」であるかを判定します。String
paramString()
このCheckBoxMenuItem
の状態を表す文字列を返します。protected void
processEvent(AWTEvent e)
このチェックボックス・メニュー項目のイベントを処理します。protected void
processItemEvent(ItemEvent e)
このチェックボックス・メニュー項目で発生する項目イベントを、登録されているすべてのItemListener
オブジェクトにディスパッチすることによって処理します。void
removeItemListener(ItemListener l)
このチェックボックス・メニュー項目からの項目イベントを受け取らないように、指定された項目リスナーを削除します。void
setState(boolean b)
このチェック・ボックス・メニュー項目を指定された状態に設定します。クラス java.awt.MenuItemで宣言されたメソッド
addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getShortcut, isEnabled, processActionEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
クラス java.awt.MenuComponentで宣言されたメソッド
dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, removeNotify, setFont, setName, toString
-
コンストラクタの詳細
-
CheckboxMenuItem
public CheckboxMenuItem() throws HeadlessException空のラベルが付いた、チェックボックス・メニュー項目を生成します。 項目の初期状態は「オフ」に設定されます。- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.1
- 関連項目:
GraphicsEnvironment.isHeadless()
-
CheckboxMenuItem
public CheckboxMenuItem(String label) throws HeadlessException指定されたラベルが付いた、チェックボックス・メニュー項目を生成します。 項目の初期状態は「オフ」に設定されます。- パラメータ:
label
- チェックボックス・メニュー項目の文字列ラベル、またはラベルが付いていないメニュー項目の場合はnull
。- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
CheckboxMenuItem
public CheckboxMenuItem(String label, boolean state) throws HeadlessException指定されたラベルが付いたチェックボックス・メニュー項目を、指定された状態で生成します。- パラメータ:
label
- チェックボックス・メニュー項目の文字列ラベル、またはラベルが付いていないメニュー項目の場合はnull
。state
- メニュー項目の初期状態。true
は「オン」を、false
は「オフ」を示す- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.1
- 関連項目:
GraphicsEnvironment.isHeadless()
-
-
メソッドの詳細
-
addNotify
public void addNotify()チェックボックス項目のピアを生成します。 これにより、チェックボックス項目の機能を変更することなく、その外観を変更することが可能になります。 ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。- オーバーライド:
addNotify
、クラス:MenuItem
- 関連項目:
Component.getToolkit()
-
getState
public boolean getState()このチェックボックス・メニュー項目の状態が「オン」であるか「オフ」であるかを判定します。- 戻り値:
- このチェックボックス・メニュー項目の状態。
true
は「オン」を、false
は「オフ」を示す - 関連項目:
setState(boolean)
-
setState
public void setState(boolean b)このチェック・ボックス・メニュー項目を指定された状態に設定します。 boolean値true
は「オン」を示し、false
は「オフ」を示します。このメソッドは主にチェックボックス・メニュー項目のステータス初期化のために使用してください。 チェックボックス・メニュー項目のステータスをプログラムで設定しても
ItemEvent
は開始されません。ItemEvent
をトリガーするための唯一の方法は、ユーザーの操作です。- パラメータ:
b
- チェックボックス・メニュー項目が「オン」の場合はtrue
、そうでない場合はfalse
- 関連項目:
getState()
-
getSelectedObjects
public Object[] getSelectedObjects()チェックボックス・メニュー項目のラベルを含む配列(長さ1)を返します。ただし、チェックボックスが選択されていない場合には、nullを返します。- 定義:
getSelectedObjects
、インタフェース:ItemSelectable
- 戻り値:
- 選択されたオブジェクトのリスト、または
null
- 関連項目:
ItemSelectable
-
addItemListener
public void addItemListener(ItemListener l)指定された項目リスナーを、このチェックボックスの項目イベント受信のために追加します。 項目イベントはsetState()の呼出しではなく、ユーザーのアクションに反応してリスナーに送信されます。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- 定義:
addItemListener
、インタフェース:ItemSelectable
- パラメータ:
l
- 項目リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
removeItemListener(java.awt.event.ItemListener)
,getItemListeners()
,setState(boolean)
,ItemEvent
,ItemListener
-
removeItemListener
public void removeItemListener(ItemListener l)このチェックボックス・メニュー項目からの項目イベントを受け取らないように、指定された項目リスナーを削除します。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- 定義:
removeItemListener
、インタフェース:ItemSelectable
- パラメータ:
l
- 項目リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
addItemListener(java.awt.event.ItemListener)
,getItemListeners()
,ItemEvent
,ItemListener
-
getItemListeners
public ItemListener[] getItemListeners()このチェックボックス・メニュー項目に登録されているすべての項目リスナーの配列を返します。- 戻り値:
- このチェックボックス・メニュー項目のすべての
ItemListener
。項目リスナーが現在登録されていない場合は空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
addItemListener(java.awt.event.ItemListener)
,removeItemListener(java.awt.event.ItemListener)
,ItemEvent
,ItemListener
-
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)このCheckboxMenuItem
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。FooListener
は、addFooListener
メソッドを使用して登録されます。FooListener.class
などのクラス・リテラルを使用してlistenerType
引数を指定できます。 たとえば、次のコードを使用して、その項目リスナーのCheckboxMenuItem c
を照会できます。ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
このようなリスナーがない場合は空の配列を返します。- オーバーライド:
getListeners
、クラス:MenuItem
- 型パラメータ:
T
- リスナーの型- パラメータ:
listenerType
- 要求されるリスナーの型。java.util.EventListener
の子孫のインタフェースを指定してください- 戻り値:
- このチェックボックス・メニュー項目上で
FooListener
として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが登録されていない場合は空の配列 - 例外:
ClassCastException
-listenerType
で、java.util.EventListener
を実装するクラスまたはインタフェースが指定されなかった場合- 導入されたバージョン:
- 1.3
- 関連項目:
getItemListeners()
-
processEvent
protected void processEvent(AWTEvent e)このチェックボックス・メニュー項目のイベントを処理します。 イベントがItemEvent
のインスタンスである場合、このメソッドはprocessItemEvent
メソッドを呼び出します。 イベントが項目イベントでない場合、スーパー・クラスのprocessEvent
を呼び出します。現在、チェックボックス・メニュー項目がサポートしているのは、項目イベントだけです。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- オーバーライド:
processEvent
、クラス:MenuItem
- パラメータ:
e
- イベント- 導入されたバージョン:
- 1.1
- 関連項目:
ItemEvent
,processItemEvent(java.awt.event.ItemEvent)
-
processItemEvent
protected void processItemEvent(ItemEvent e)このチェックボックス・メニュー項目で発生する項目イベントを、登録されているすべてのItemListener
オブジェクトにディスパッチすることによって処理します。このメニュー項目で項目イベントが使用可能でない場合、このメソッドは呼び出されません。 項目イベントは、次の項目の1つが発生したときに使用可能になります。
ItemListener
オブジェクトがaddItemListener
によって登録されている。enableEvents
によって項目イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- 項目イベント- 導入されたバージョン:
- 1.1
- 関連項目:
ItemEvent
,ItemListener
,addItemListener(java.awt.event.ItemListener)
,MenuItem.enableEvents(long)
-
paramString
public String paramString()このCheckBoxMenuItem
の状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる場合があります。 返される文字列は空の場合がありますが、null
にはなりません。- オーバーライド:
paramString
、クラス:MenuItem
- 戻り値:
- このチェックボックス・メニュー項目のパラメータ文字列
-
getAccessibleContext
public AccessibleContext getAccessibleContext()このCheckboxMenuItemに関連付けられたAccessibleContextを取得します。 CheckboxMenuItemの場合、AccessibleContextはAccessibleAWTCheckboxMenuItemの形式を取ります。 必要に応じて新規のAccessibleAWTCheckboxMenuItemが生成されます。- 定義:
getAccessibleContext
、インタフェース:Accessible
- オーバーライド:
getAccessibleContext
、クラス:MenuItem
- 戻り値:
- このCheckboxMenuItemのAccessibleContextとして機能するAccessibleAWTCheckboxMenuItem
- 導入されたバージョン:
- 1.3
-