|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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
的按钮处于“开”状态,其他两个按钮处于“关”状态。在这个例子中,使用了 GridLayout
类,三个复选框的状态是分别设置的。
作为选择,可使用 CheckboxGroup
类将一些复选框组成一组,作为单个对象来控制。在一个复选框组中,在任何给定时间,最多只能有一个按钮处于“开”状态。单击并打开一个复选框,这会强迫同组的其他原来处于打开状态的复选框变为“关”状态。
- 从以下版本开始:
- JDK1.0
- 另请参见:
-
GridLayout
,CheckboxGroup
, 序列化表格
嵌套类摘要 | |
---|---|
protected class |
Checkbox.AccessibleAWTCheckbox 此类实现对 Checkbox 类的可访问性支持。 |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, 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,并将它设置为指定状态,使它处于指定复选框组中。 |
|
Checkbox(String label, CheckboxGroup group, boolean state) 使用指定标签创建一个 Checkbox,并使它处于指定复选框组内,将它设置为指定状态。 |
方法摘要 | ||
---|---|---|
void |
addItemListener(ItemListener l) 添加指定的项侦听器,以接收来自此复选框的项事件。 |
|
void |
addNotify() 创建 Checkbox 的同位体。 |
|
AccessibleContext |
getAccessibleContext() 获得与此 Checkbox 相关的 AccessibleContext。 |
|
CheckboxGroup |
getCheckboxGroup() 确定此复选框的组。 |
|
ItemListener[] |
getItemListeners() 返回已在此复选框上注册的所有项侦听器所组成的数组。 |
|
String |
getLabel() 获得此复选框的标签。 |
|
|
getListeners(Class<T> listenerType) 返回目前已在此 Checkbox 上注册为 FooListener 的所有对象的数组。 |
|
Object[] |
getSelectedObjects() 返回包含复选框标签的数组 (length 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.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
-
使用指定标签构造一个 Checkbox,并将它设置为指定状态,使它处于指定复选框组中。
- 参数:
-
label
- 此复选框的字符串标签,如果没有标签,则该参数为null
。 -
state
- 此复选框的初始状态。 -
group
- 此复选框的复选框组,如果没有这样的复选框组,则该参数为null
。 - 抛出:
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless
返回true
- 从以下版本开始:
- JDK1.1
- 另请参见:
-
GraphicsEnvironment.isHeadless()
Checkbox
public Checkbox(String label, CheckboxGroup group, boolean state) throws HeadlessException
-
使用指定标签创建一个 Checkbox,并使它处于指定复选框组内,将它设置为指定状态。
- 参数:
-
label
- 此复选框的字符串标签,如果没有标签,则该参数为null
。 -
group
- 此复选框的复选框组,如果没有这样的复选框组,则该参数为null
。 -
state
- 此复选框的初始状态。 - 抛出:
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless
返回true
- 从以下版本开始:
- JDK1.1
- 另请参见:
-
GraphicsEnvironment.isHeadless()
方法详细信息 |
---|
addNotify
public void addNotify()
- 创建 Checkbox 的同位体。该同位体允许您更改 Checkbox 的外观,而不更改其功能。