- 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
的按钮处于“开启”状态,另外两个处于“关闭”状态。 在此示例中,使用GridLayout
类,三个复选框的状态是独立设置的。或者,可以使用
CheckboxGroup
类在单个对象的控制下将多个复选框组合在一起。 在复选框组中,在任何给定时间,最多一个按钮可以处于“开启”状态。 单击复选框将其打开会强制同一组中的任何其他复选框进入“关闭”状态。- 从以下版本开始:
- 1.0
- 另请参见:
-
GridLayout
,CheckboxGroup
, Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
Checkbox.AccessibleAWTCheckbox
此类实现Checkbox
类的可访问性支持。
-
字段汇总
-
声明的属性在类 java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields declared in interface 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()
创建Checkbox的对等方。AccessibleContext
getAccessibleContext()
获取与此Checkbox关联的AccessibleContext。CheckboxGroup
getCheckboxGroup()
确定此复选框的组。ItemListener[]
getItemListeners()
返回在此复选框上注册的所有项侦听器的数组。String
getLabel()
获取此复选框的标签。<T extends EventListener>
T[]getListeners(类<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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
-
-
-
构造方法详细信息
-
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
- 从以下版本开始:
- 1.1
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
Checkbox
public Checkbox(String label, CheckboxGroup group, boolean state) throws HeadlessException
在指定的复选框组中创建具有指定标签的复选框,并将其设置为指定的状态。- 参数
-
label
- 此复选框的字符串标签,或null
表示无标签。 -
group
- 此复选框的复选框组,或无组的null
。 -
state
- 此复选框的初始状态。 - 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless
返回true
- 从以下版本开始:
- 1.1
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
-
方法详细信息
-
addNotify
public void addNotify()
创建Checkbox的对等方。 对等体允许您在不更改其功能的情况下更改复选框的外观。- 重写:
-
addNotify
类Component
- 另请参见:
-
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
- 结果
-
所选对象的列表,或
null
- 另请参见:
-
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 。
- Specified by:
-
addItemListener
在界面ItemSelectable
- 参数
-
l
- 项侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
removeItemListener(java.awt.event.ItemListener)
,getItemListeners()
,setState(boolean)
,ItemEvent
,ItemListener
-
removeItemListener
public void removeItemListener(ItemListener l)
- Specified by:
-
removeItemListener
在界面ItemSelectable
- 参数
-
l
- 项侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
addItemListener(java.awt.event.ItemListener)
,getItemListeners()
,ItemEvent
,ItemListener
-
getItemListeners
public ItemListener[] getItemListeners()
返回在此复选框上注册的所有项侦听器的数组。- 结果
-
所有这个复选框的
ItemListener
s或如果当前没有注册项目监听器的空数组 - 从以下版本开始:
- 1.4
- 另请参见:
-
addItemListener(java.awt.event.ItemListener)
,removeItemListener(java.awt.event.ItemListener)
,ItemEvent
,ItemListener
-
getListeners
public <T extends EventListener> T[] getListeners(类<T> listenerType)
返回当前在此Checkbox
注册为FooListener
的所有对象的数组。FooListener
s使用addFooListener
方法注册。您可以使用类文字指定
listenerType
参数,例如FooListener.class
。 例如,您可以使用以下代码查询Checkbox c
的项目侦听器:ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
如果不存在此类侦听器,则此方法返回空数组。- 重写:
-
getListeners
类Component
- 参数类型
-
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
,类Component
- 参数
-
e
- 活动 - 从以下版本开始:
- 1.1
- 另请参见:
-
ItemEvent
,processItemEvent(java.awt.event.ItemEvent)
-
processItemEvent
protected void processItemEvent(ItemEvent e)
处理此复选框上发生的项事件,方法是将它们分派给任何已注册的ItemListener
对象。除非为此组件启用了项事件,否则不会调用此方法。 发生以下任一情况时启用项目事件:
-
ItemListener
对象的注册号为addItemListener
。 - 项目事件通过
enableEvents
启用。
请注意,如果事件参数为
null
则行为未指定,可能会导致异常。- 参数
-
e
- 项目事件 - 从以下版本开始:
- 1.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。- Specified by:
-
getAccessibleContext
接口Accessible
- 重写:
-
getAccessibleContext
在类Component
- 结果
- 一个AccessibleAWTCheckbox,用作此Checkbox的AccessibleContext
- 从以下版本开始:
- 1.3
-
-