java.awt

Class Checkbox

java.lang.Object

java.awt.Component

java.awt.Checkbox

All Implemented Interfaces:

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按钮是“在”的状态，和其他两个是在“关”的状态。在这个例子中，使用GridLayout类的三个复选框的状态是独立设置。

另外，几个复选框可以组合在一起的一个对象的控制下，利用CheckboxGroup类。在一个复选框组中，至多一个按钮可以在任何给定时间内的“上”状态。点击一个复选框，将它强制任何其他在同一组中的复选框，即处于“关闭”状态。

从以下版本开始：

JDK1.0

另请参见：

GridLayout， CheckboxGroup， Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Checkbox.AccessibleAWTCheckbox 这个类实现了对 Checkbox类可访问性支持。

Nested classes/interfaces inherited from class java.awt.Component

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

Field Summary

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

构造方法摘要

构造方法

Constructor and Description
Checkbox() 创建一个带有标签的空字符串的复选框。
Checkbox(String label) 用指定的标签创建一个复选框。
Checkbox(String label, boolean state) 用指定的标签创建一个复选框，并设置指定的状态。
Checkbox(String label, boolean state, CheckboxGroup group) 构建一个与指定的标签复选框，设置为指定的状态，并在指定复选框组。
Checkbox(String label, CheckboxGroup group, boolean state) 在指定的复选框组中创建指定的标签的复选框，并将其设置为指定的状态。

方法摘要

Modifier and Type	Method and Description
void	addItemListener(ItemListener l) 添加指定的项目侦听器以从该复选框接收项目事件。
void	addNotify() 创建复选框的同伴。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext复选框。
CheckboxGroup	getCheckboxGroup() 确定此复选框的组。
ItemListener[]	getItemListeners() 返回所有项目的听众对这个复选框注册一个数组。
String	getLabel() 获取此复选框的标签。
<T extends EventListener> T[]	getListeners(类<T> listenerType) 返回对象的当前注册为 FooListeners在这 Checkbox数组。
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) 将此复选框的状态设置为指定的状态。

Methods inherited from class 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

Methods inherited from class java.lang.Object

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

Constructor Detail

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()

确定此复选框是否处于“关闭”状态或“关闭”状态中。布尔值 true表示“在”的状态，和 false表示“关闭”状态。

结果

这个复选框的状态，作为一个布尔值

另请参见：

setState(boolean)

setState

public void setState(boolean state)

将此复选框的状态设置为指定的状态。布尔值 true表示“在”的状态，和 false表示“关闭”状态。

请注意，此方法应主要用于初始化复选框的状态。以编程方式设置复选框的状态将空不触发ItemEvent。触发ItemEvent通过用户交互的唯一方式。

参数

state -布尔状态的复选框

另请参见：

getState()

getSelectedObjects

public Object[] getSelectedObjects()

返回一个数组（长度1）包含复选框的标签或null，如果没有勾选。

Specified by:

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为空，则不会引发异常，并没有执行任何动作。

指对AWT的线程模型的细节AWT Threading Issues。

Specified by:

addItemListener 接口 ItemSelectable

参数

l -项目的倾听者

从以下版本开始：

JDK1.1

另请参见：

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

removeItemListener

public void removeItemListener(ItemListener l)

移除指定的项目侦听器，以便该项目侦听器不再接收来自该复选框的项目事件。如果L为空，则不会引发异常，并没有执行任何动作。

参考AWT Threading Issues对AWT的线程模型的细节。

Specified by:

removeItemListener 接口 ItemSelectable

参数

l -项目的倾听者

从以下版本开始：

JDK1.1

另请参见：

addItemListener(java.awt.event.ItemListener)， getItemListeners()， ItemEvent， ItemListener

getItemListeners

public ItemListener[] getItemListeners()

返回所有项目的听众对这个复选框注册一个数组。

结果

所有这些复选框的 ItemListeners或空数组如果没有项目的听众正在注册

从以下版本开始：

一点四

另请参见：

addItemListener(java.awt.event.ItemListener)， removeItemListener(java.awt.event.ItemListener)， ItemEvent， ItemListener

getListeners

public <T extends EventListener> T[] getListeners(类<T> listenerType)

返回对象的当前注册为 FooListeners在这 Checkbox数组。 FooListeners使用 addFooListener方法注册。如果没有这样

您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其项目的听众与下面的代码Checkbox c：

itemlistener [] ILS =（itemlistener [ ]）（c.getlisteners（itemlistener。类））；

听众的存在，此方法将返回空数组。

重写：

getListeners 方法重写，继承类 Component

参数

listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener

结果

所有对象注册为该复选框 FooListeners数组，或一个空数组如果没有这样的听众已添加

异常

ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener

从以下版本开始：

一点三

另请参见：

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对象。

此方法不调用此方法，除非此组件启用了项目事件。当下列情况之一发生时，启用项目事件：

• 一个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()

获取与此相关的accessiblecontext复选框。复选框，该accessiblecontext以一accessibleawtcheckbox形式。一个新的accessibleawtcheckbox创造必要的。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Component

结果

一个accessibleawtcheckbox作为此复选框的accessiblecontext

从以下版本开始：

一点三