🏆 Top Story: javase/jp//docs/api/java/awt/Checkbox.html

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から継承されたフィールド
  accessibleContext, 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のスレッドの問題」を参照してください。
    
    定義:
    
    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のスレッドの問題」を参照してください。
    
    定義:
    
    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の形式を取ります。必要に応じて新規のAccessibleAWTCheckboxが生成されます。
    
    定義:
    
    getAccessibleContext、インタフェースAccessible
    
    オーバーライド:
    
    getAccessibleContext、クラスComponent
    
    戻り値:
    
    このCheckboxのAccessibleContextとして機能するAccessibleAWTCheckbox
    
    導入されたバージョン:
    
    1.3

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスCheckbox

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

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

フィールドのサマリー

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

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

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

メソッドのサマリー

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

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

コンストラクタの詳細

Checkbox

Checkbox

Checkbox

Checkbox

Checkbox

メソッドの詳細

addNotify

getLabel

setLabel

getState

setState

getSelectedObjects

getCheckboxGroup

setCheckboxGroup

addItemListener

removeItemListener

getItemListeners

getListeners

processEvent

processItemEvent

paramString

getAccessibleContext