java.awt

クラス Checkbox

java.lang.Object

java.awt.Component

java.awt.Checkbox

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

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible

public class Checkbox
extends Component
implements ItemSelectable, Accessible

チェックボックスは、「オン」(true) または「オフ」(false) のどちらかの状態になることができるグラフィカルコンポーネントです。チェックボックスをクリックすると、その状態を「オン」から「オフ」に、または「オフ」から「オン」に変更できます。

次のコード例では、グリッドレイアウトにチェックボックスのセットを生成します。

 setLayout(new GridLayout(3, 1));
 add(new Checkbox("one", null, true));
 add(new Checkbox("two"));
 add(new Checkbox("three"));
 

このイメージは、このコード例によって作成されるチェックボックスとグリッドレイアウトを表します。

one というラベルの付いたボタンは「オン」の状態で、ほかの 2 つのボタンは「オフ」の状態です。GridLayout クラスを使用するこの例では、3 つのチェックボックスの状態がそれぞれ独立して設定されます。

また、CheckboxGroup クラスを使って、いくつかのチェックボックスをグループ化して 1 つのオブジェクトで制御することもできます。チェックボックスグループでは、一度に 1 つのボタンだけを「オン」の状態にできます。1 つのチェックボックスをクリックしてオンにすると、同一グループ内のほかのチェックボックスは「オフ」の状態になります。

導入されたバージョン:

JDK1.0

関連項目:

GridLayout, CheckboxGroup, 直列化された形式

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

ネストされたクラス

修飾子と型	クラスと説明
protected class	Checkbox.AccessibleAWTCheckbox このクラスは Checkbox クラス用のアクセシビリティーサポートを実装しています。

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

コンストラクタ

コンストラクタと説明
Checkbox() そのラベルが空の文字列のチェックボックスを作成します。
Checkbox(String label) 指定されたラベルが付いたチェックボックスを作成します。
Checkbox(String label, boolean state) 指定されたラベルが付いたチェックボックスを作成し、指定された状態に設定します。
Checkbox(String label, boolean state, CheckboxGroup group) 指定されたラベルが付いたチェックボックスを、指定されたチェックボックスグループに構築し、指定された状態に設定します。
Checkbox(String label, CheckboxGroup group, boolean state) 指定されたラベルが付いたチェックボックスを、指定されたチェックボックスグループに生成し、指定された状態に設定します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	addItemListener(ItemListener l) 指定された項目リスナーを、このチェックボックスの項目イベント受信のために追加します。
void	addNotify() チェックボックスのピアを生成します。
AccessibleContext	getAccessibleContext() この CheckBox に関連付けられた AccessibleContext を取得します。
CheckboxGroup	getCheckboxGroup() このチェックボックスのグループを判定します。
ItemListener[]	getItemListeners() このチェックボックスに登録されているすべての項目リスナーの配列を返します。
String	getLabel() チェックボックスのラベルを取得します。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) この Checkbox に FooListener として現在登録されているすべてのオブジェクトの配列を返します。
Object[]	getSelectedObjects() チェックボックスのラベルを含む配列 (長さ 1) を返します。チェックボックスが選択されていない場合には null を返します。
boolean	getState() このチェックボックスが「オン」の状態であるか、「オフ」の状態であるかを判定します。
protected String	paramString() この Checkbox の状態を表す文字列を返します。
protected void	processEvent(AWTEvent e) このチェックボックスでイベントを処理します。
protected void	processItemEvent(ItemEvent e) このチェックボックスで発生する項目イベントを、登録されているすべての ItemListener オブジェクトにディスパッチすることによって処理します。
void	removeItemListener(ItemListener l) このチェックボックスからの項目イベントを受け取らないように、指定された項目リスナーを削除します。
void	setCheckboxGroup(CheckboxGroup g) このチェックボックスのグループを、指定されたチェックボックスグループに設定します。
void	setLabel(String label) このチェックボックスのラベルを文字列引数に設定します。
void	setState(boolean state) このチェックボックスの状態を、指定された状態に設定します。

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Checkbox

public Checkbox()
         throws HeadlessException

そのラベルが空の文字列のチェックボックスを作成します。このチェックボックスの状態は「オフ」に設定され、チェックボックスグループには属しません。

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

Checkbox

public Checkbox(String label)
         throws HeadlessException

指定されたラベルが付いたチェックボックスを作成します。このチェックボックスの状態は「オフ」に設定され、チェックボックスグループには属しません。

パラメータ:

label - このチェックボックスの文字列ラベル、またはラベルがない場合は null。

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

Checkbox

public Checkbox(String label,
        boolean state)
         throws HeadlessException

指定されたラベルが付いたチェックボックスを作成し、指定された状態に設定します。このチェックボックスは、どのチェックボックスグループにも属しません。

パラメータ:

label - このチェックボックスの文字列ラベル。ラベルがない場合は null

state - このチェックボックスの初期状態

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

Checkbox

public Checkbox(String label,
        boolean state,
        CheckboxGroup group)
         throws HeadlessException

指定されたラベルが付いたチェックボックスを、指定されたチェックボックスグループに構築し、指定された状態に設定します。

パラメータ:

label - このチェックボックスの文字列ラベル、またはラベルがない場合は null。

state - このチェックボックスの初期状態。

group - このチェックボックスのチェックボックスグループ、またはグループがない場合は null。

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

導入されたバージョン:

JDK1.1

関連項目:

GraphicsEnvironment.isHeadless()

Checkbox

public Checkbox(String label,
        CheckboxGroup group,
        boolean state)
         throws HeadlessException

指定されたラベルが付いたチェックボックスを、指定されたチェックボックスグループに生成し、指定された状態に設定します。

パラメータ:

label - このチェックボックスの文字列ラベル、またはラベルがない場合は null。

group - このチェックボックスのチェックボックスグループ、またはグループがない場合は null。

state - このチェックボックスの初期状態。

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

導入されたバージョン:

JDK1.1

関連項目:

GraphicsEnvironment.isHeadless()

メソッドの詳細

addNotify

public void addNotify()

チェックボックスのピアを生成します。これにより、チェックボックスの機能を変更することなく、その外観を変更することが可能になります。

オーバーライド:

addNotify、クラス: Component

関連項目:

Toolkit.createCheckbox(java.awt.Checkbox), Component.getToolkit()

getLabel

public String getLabel()

チェックボックスのラベルを取得します。

戻り値:

このチェックボックスのラベル。このチェックボックスにラベルがない場合は null

関連項目:

setLabel(String)

setLabel

public void setLabel(String label)

このチェックボックスのラベルを文字列引数に設定します。

パラメータ:

label - 新しいラベルとして設定する文字列。ラベルがない場合は null

関連項目:

getLabel()

getState

public boolean getState()

このチェックボックスが「オン」の状態であるか、「オフ」の状態であるかを判定します。boolean 値 true は「オン」状態を示し、false は「オフ」状態を示します。

戻り値:

boolean 値で表されるこのチェックボックスの状態

関連項目:

setState(boolean)

setState

public void setState(boolean state)

このチェックボックスの状態を、指定された状態に設定します。boolean 値 true は「オン」状態を示し、false は「オフ」状態を示します。

このメソッドは、主にチェックボックスの状態初期化のために使用してください。チェックボックスの状態をプログラムで設定しても ItemEvent は開始されません。ItemEvent をトリガーするための唯一の方法は、ユーザーの操作です。

パラメータ:

state - boolean 値で表したチェックボックスの状態

関連項目:

getState()

getSelectedObjects

public Object[] getSelectedObjects()

チェックボックスのラベルを含む配列 (長さ 1) を返します。チェックボックスが選択されていない場合には null を返します。

定義:

getSelectedObjects、インタフェース: ItemSelectable

関連項目:

ItemSelectable

getCheckboxGroup

public CheckboxGroup getCheckboxGroup()

このチェックボックスのグループを判定します。

戻り値:

このチェックボックスのグループ。チェックボックスがグループに属さない場合は null

関連項目:

setCheckboxGroup(CheckboxGroup)

setCheckboxGroup

public void setCheckboxGroup(CheckboxGroup g)

このチェックボックスのグループを、指定されたチェックボックスグループに設定します。このチェックボックスがすでにほかのチェックボックスグループにある場合は、最初にそのグループから削除されます。

このチェックボックスの状態が true で、新しいグループのチェックボックスがすでに選択されている場合、このチェックボックスの状態が false に変更されます。このチェックボックスの状態が true で、新しいグループのチェックボックスが選択されていない場合、このチェックボックスは新しいグループの選択されたチェックボックスになり、その状態は true です。

パラメータ:

g - 新しいチェックボックスグループ。チェックボックスグループからこのチェックボックスを削除する場合は null

関連項目:

getCheckboxGroup()

addItemListener

public void addItemListener(ItemListener l)

指定された項目リスナーを、このチェックボックスの項目イベント受信のために追加します。項目イベントは setState() の呼び出しではなく、ユーザーの入力に反応してリスナーに送信されます。l が null の場合、例外はスローされず、処理も実行されません。

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

定義:

addItemListener、インタフェース: ItemSelectable

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

removeItemListener(java.awt.event.ItemListener), getItemListeners(), setState(boolean), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

このチェックボックスからの項目イベントを受け取らないように、指定された項目リスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。

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

定義:

removeItemListener、インタフェース: ItemSelectable

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.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)

この Checkbox に FooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録されます。

FooListener.class などのクラスリテラルを使用して listenerType 引数を指定できます。たとえば、次のコードを使用して、その項目リスナーの Checkbox c を照会できます。

ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));

このようなリスナーがない場合は空の配列を返します。

オーバーライド:

getListeners、クラス: Component

パラメータ:

listenerType - 要求されるリスナーの型。java.util.EventListener の子孫のインタフェースを指定してください

戻り値:

このチェックボックス上で FooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが登録されていない場合は空の配列

例外:

ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合

導入されたバージョン:

1.3

関連項目:

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

このチェックボックスでイベントを処理します。イベントが ItemEvent のインスタンスである場合、このメソッドは processItemEvent メソッドを呼び出します。それ以外の場合は、そのスーパークラスの processEvent メソッドを呼び出します。

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

オーバーライド:

processEvent、クラス: Component

パラメータ:

e - イベント

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

このチェックボックスで発生する項目イベントを、登録されているすべての ItemListener オブジェクトにディスパッチすることによって処理します。

項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。項目イベントは、次の項目の 1 つが発生したときに使用可能になります。

• ItemListener オブジェクトが addItemListener によって登録されている。
• enableEvents によって項目イベントが使用可能になっている。

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

パラメータ:

e - 項目イベント

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

この Checkbox の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

paramString、クラス: Component

戻り値:

このチェックボックスのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

この CheckBox に関連付けられた AccessibleContext を取得します。チェックボックスの場合、AccessibleContext は AccessibleAWTCheckBox の形式を取ります。必要に応じて新規の AccessibleAWTChecBox が生成されます。

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Component

戻り値:

この Checkbox の AccessibleContext として機能する AccessibleAWTCheckbox

導入されたバージョン:

1.3