Java プラットフォーム 1.2 API 仕様: クラス Checkbox

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.awt
クラス Checkbox

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Checkbox

public class Checkbox
extends Component
implements ItemSelectable

チェックボックスは、「オン」 (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, 直列化された形式

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

BOTTOM_ALIGNMENT,  
CENTER_ALIGNMENT,  
LEFT_ALIGNMENT,  
RIGHT_ALIGNMENT,  
TOP_ALIGNMENT

コンストラクタの概要
`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()` チェックボックスのピアを作成します。
`CheckboxGroup`	`getCheckboxGroup()` このチェックボックスのグループを判定します。
`String`	`getLabel()` チェックボックスのラベルを返します。
`Object[]`	`getSelectedObjects()` チェックボックスのラベルを含む配列 (長さ 1) を返します。
`boolean`	`getState()` このチェックボックスが「オン」の状態であるか、「オフ」の状態であるかを判定します。
`protected String`	`paramString()` このチェックボックスの状態を表すパラメータ文字列を返します。
`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, 
addInputMethodListener, 
addKeyListener, 
addMouseListener, 
addMouseMotionListener, 
addPropertyChangeListener, 
addPropertyChangeListener, 
bounds, 
checkImage, 
checkImage, 
coalesceEvents, 
contains, 
contains, 
createImage, 
createImage, 
deliverEvent, 
disable, 
disableEvents, 
dispatchEvent, 
doLayout, 
enable, 
enable, 
enableEvents, 
enableInputMethods, 
firePropertyChange, 
getAlignmentX, 
getAlignmentY, 
getBackground, 
getBounds, 
getBounds, 
getColorModel, 
getComponentAt, 
getComponentAt, 
getComponentOrientation, 
getCursor, 
getDropTarget, 
getFont, 
getFontMetrics, 
getForeground, 
getGraphics, 
getHeight, 
getInputContext, 
getInputMethodRequests, 
getLocale, 
getLocation, 
getLocation, 
getLocationOnScreen, 
getMaximumSize, 
getMinimumSize, 
getName, 
getParent, 
getPeer, 
getPreferredSize, 
getSize, 
getSize, 
getToolkit, 
getTreeLock, 
getWidth, 
getX, 
getY, 
gotFocus, 
handleEvent, 
hasFocus, 
hide, 
imageUpdate, 
inside, 
invalidate, 
isDisplayable, 
isDoubleBuffered, 
isEnabled, 
isFocusTraversable, 
isLightweight, 
isOpaque, 
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, 
processInputMethodEvent, 
processKeyEvent, 
processMouseEvent, 
processMouseMotionEvent, 
remove, 
removeComponentListener, 
removeFocusListener, 
removeInputMethodListener, 
removeKeyListener, 
removeMouseListener, 
removeMouseMotionListener, 
removeNotify, 
removePropertyChangeListener, 
removePropertyChangeListener, 
repaint, 
repaint, 
repaint, 
repaint, 
requestFocus, 
reshape, 
resize, 
resize, 
setBackground, 
setBounds, 
setBounds, 
setComponentOrientation, 
setCursor, 
setDropTarget, 
setEnabled, 
setFont, 
setForeground, 
setLocale, 
setLocation, 
setLocation, 
setName, 
setSize, 
setSize, 
setVisible, 
show, 
show, 
size, 
toString, 
transferFocus, 
update, 
validate

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

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

コンストラクタの詳細

Checkbox

public Checkbox()

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

Checkbox

public Checkbox(String label)

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

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

Checkbox

public Checkbox(String label,
                boolean state)

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

パラメータ:: label - このチェックボックスの文字列ラベル。ラベルがない場合は null; state - このチェックボックスの初期状態

Checkbox

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

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

パラメータ:: label - このチェックボックスの文字列ラベル。ラベルがない場合は null; state - このチェックボックスの初期状態; group - このチェックボックスのチェックボックスグループ。チェックボックスグループがない場合は null
導入されたバージョン:: JDK1.1

Checkbox

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

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

パラメータ:: label - このチェックボックスの文字列ラベル。ラベルがない場合は null; group - このチェックボックスのチェックボックスグループ。グループがない場合は null; state - このチェックボックスの初期状態
導入されたバージョン:: JDK1.1

メソッドの詳細

addNotify

public void addNotify()

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

オーバーライド:: クラス Component 内の addNotify
関連項目:: Toolkit.createCheckbox(java.awt.Checkbox), Component.getToolkit()

getLabel

public String getLabel()

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

戻り値:: このチェックボックスのラベル。このチェックボックスにラベルがない場合は null
関連項目:: setLabel(java.lang.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 は「オフ」の状態を示します。

パラメータ:: state - このチェックボックスの状態
関連項目:: getState()

getSelectedObjects

public Object[] getSelectedObjects()

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

定義:: インタフェース ItemSelectable 内の getSelectedObjects
関連項目:: ItemSelectable

getCheckboxGroup

public CheckboxGroup getCheckboxGroup()

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

戻り値:: このチェックボックスのグループ。チェックボックスグループにない場合は null
関連項目:: setCheckboxGroup(java.awt.CheckboxGroup)

setCheckboxGroup

public void setCheckboxGroup(CheckboxGroup g)

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

パラメータ:: g - 新しいチェックボックスグループ。チェックボックスグループからこのチェックボックスを削除する場合は null
関連項目:: getCheckboxGroup()

addItemListener

public void addItemListener(ItemListener l)

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

定義:: インタフェース ItemSelectable 内の addItemListener
パラメータ:: l - 項目リスナー
導入されたバージョン:: JDK1.1
関連項目:: ItemEvent, ItemListener, removeItemListener(java.awt.event.ItemListener)

removeItemListener

public void removeItemListener(ItemListener l)

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

定義:: インタフェース ItemSelectable 内の removeItemListener
パラメータ:: l - 項目リスナー
導入されたバージョン:: JDK1.1
関連項目:: ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener)

processEvent

protected void processEvent(AWTEvent e)

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

パラメータ:: e - イベント
オーバーライド:: クラス Component 内の processEvent
導入されたバージョン:: JDK1.1
関連項目:: ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

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

このコンポーネントで項目イベントが使用可能でない場合、このメソッドは呼び出されません。項目イベントは、次のどれかの場合に使用可能になります。

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

パラメータ:: e - イベント
導入されたバージョン:: JDK1.1
関連項目:: ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

このチェックボックスの状態を表すパラメータ文字列を返します。この文字列はデバッグの際に便利です。

戻り値:: このチェックボックスのパラメータ文字列
オーバーライド:: クラス Component 内の paramString

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.

java.awt クラス Checkbox

Checkbox

Checkbox

Checkbox

Checkbox

Checkbox

addNotify

getLabel

setLabel

getState

setState

getSelectedObjects

getCheckboxGroup

setCheckboxGroup

addItemListener

removeItemListener

processEvent

processItemEvent

paramString

java.awt
クラス Checkbox