当前位置 类层次 (JDK) 所有类 (JDK) 所有域和方法 (JDK)

类 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 的按钮处于“开”状态，其它两个按钮处于“关”状态。在这个例子中，使用了 GridLayout 类，三个复选框的状态是分别设置的。

同样，可使用 CheckboxGroup 类将一些复选框组成一组，作为一个单个对象来控制。在一个复选框组中，在任何给定时间最多只能有一个按钮处于“开”状态。单击并打开一个复选框，将强迫同组的其它原来打开的复选框变为“关”状态。

来自：
JDK1.0
参见：
GridLayout, CheckboxGroup

构造子索引

Checkbox()
创建一个不带标签的复选框。
Checkbox(String)
用指定的标签创建一个复选框。
Checkbox(String, boolean)
用指定的标签创建一个复选框。
Checkbox(String, boolean, CheckboxGroup)
在指定的复选框组中，用指定的标签创建一个复选框，并将其设置为指定的状态。
Checkbox(String, CheckboxGroup, boolean)
用指定的标签构造一个 Checkbox ，将其设置为指定的状态，并将其设置到指定的复选框组中。 ?/dl>

方法索引

addItemListener(ItemListener)
添加指定的项监听者，接收此复选框的项事件。
addNotify()
创建这个 Checkbox 的同级件。
getCheckboxGroup()
确定该复选框所属的组。
getLabel()
获取该复选框的标签。
getSelectedObjects()
返回一个包含复选框标签的数组 ( 长度为 1 ) ，若该复选框未选中，则返回 null 。
getState()
确定该复选框处于“开”状态还是“关”状态。
paramString()
返回表示该复选框状态的参数串。
processEvent(AWTEvent)
处理该复选框上的事件。
processItemEvent(ItemEvent)
通过将项事件分配给任意已注册的 ItemListener 对象，来处理发生在该复选框上的项事件。
removeItemListener(ItemListener)
删除指定的项监听者，使其不再接收该复选框的项事件。
setCheckboxGroup(CheckboxGroup)
设置该复选框所属的组为指定的复选框组。
setLabel(String)
设置该复选框的标签为字符串参数。
setState(boolean)
设置该复选框的状态为指定的状态。

构造子

Checkbox 
 public Checkbox()
创建一个不带标签的复选框。该复选框的状态设为“关”，它不属于任何复选框组。

Checkbox 
 public Checkbox(String label)
用指定的标签创建一个复选框。该复选框的状态设为“关”，它不属于任何复选框组。

参数：
label - 该复选框的字符串标签，若为 null ，则复选框没有标签。
Checkbox 
 public Checkbox(String label,
                 boolean state)
用指定的标签创建一个复选框。该复选框的状态由 state 参数决定，它不属于任何复选框组。

参数：
label - 该复选框的字符串标签，若为 null ，则复选框没有标签。
state - 该复选框的初始状态。
Checkbox 
 public Checkbox(String label,
                 boolean state,
                 CheckboxGroup group)
在指定的复选框组中，用指定的标签创建一个复选框，并将其设置为指定的状态。

参数：
label - 该复选框的字符串标签，若为 null ，则复选框没有标签。
state - 该复选框的初始状态。
group - 该复选框所属的复选框组，若为 null ，则复选框不属于任何组。
Checkbox 
 public Checkbox(String label,
                 CheckboxGroup group,
                 boolean state)
用指定的标签构造一个 Checkbox ，将其设置为指定的状态，并将其设置到指定的复选框组中。

方法

addNotify 
 public void addNotify()
创建这个 Checkbox 的同级件。该同级件允许在不改变 Checkbox 功能的情况下改变其外观。

覆盖：
类 Component 中的 addNotify
参见：
createCheckbox, getToolkit
getLabel 
 public String getLabel()
获取该复选框的标签。

返回值：
该复选框的标签，若该复选框没有标签，则返回 null 。
参见：
setLabel
setLabel 
 public synchronized void setLabel(String label)
设置该复选框的标签为字符串参数。

参数：
label - 设置为新标签的字符串，若为 null ,则没有标签。
参见：
getLabel
getState 
 public boolean getState()
确定复选框处于“开”状态还是“关”状态。布尔值 true 表示“开”状态，false 表示“关”状态。

返回值：
表示该复选框的状态的布尔值。
参见：
setState
setState 
 public void setState(boolean state)
设置该复选框的状态为指定的状态。布尔值 true 表示“开”状态， false 表示“关”状态。

参数：
state - 表示复选框状态的布尔值。
参见：
getState
getSelectedObjects 
 public Object[] getSelectedObjects()
返回一个包含复选框标签的数组 ( 长度为 1 ) ，若该复选框未选中，则返回 null 。

参见：
ItemSelectable
getCheckboxGroup 
 public CheckboxGroup getCheckboxGroup()
确定该复选框所属的组。

返回值：
该复选框所属的组，若该复选框不属于一个复选框组，则返回 null 。
参见：
setCheckboxGroup
setCheckboxGroup 
 public void setCheckboxGroup(CheckboxGroup g)
设置该复选框所属的组为指定的复选框组。若该复选框已在另一个复选框组中，必须先从那个组中删除该复选框。

参数：
g - 新复选框组，若为 null 则从所有复选框组中删除该复选框。
参见：
getCheckboxGroup
addItemListener 
 public synchronized void addItemListener(ItemListener l)
添加指定的项监听者，接收此复选框的项事件。

参数：
l - 项监听者。
参见：
ItemEvent, ItemListener, removeItemListener
removeItemListener 
 public synchronized void removeItemListener(ItemListener l)
删除指定的项监听者，使其不再接收该复选框的项事件。

参数：
l - 项监听者。
参见：
ItemEvent, ItemListener, addItemListener
processEvent 
 protected void processEvent(AWTEvent e)
处理该复选框上的事件。若事件是 ItemEvent 的一个实例，则该方法调用 processItemEvent 方法。否则，它调用其父类的 processEvent 方法。

参数：
e - 事件。
覆盖：
类 Component 中的 processEvent
参见：
ItemEvent, processItemEvent
processItemEvent 
 protected void processItemEvent(ItemEvent e)
通过将项事件分配给任意已注册的 ItemListener 对象，来处理发生在该复选框上的项事件。

除非这个组件可以启用项事件，否则不能调用此方法。当下列条件之一发生时，项事件可以启用：

  • 通过 addItemListener 方法，注册一个 ItemListener 对象。
  • 通过 enableEvents 方法，使项事件可以启用。

参数：
e - 项事件。
参见：
ItemEvent, ItemListener, addItemListener, enableEvents
paramString 
 protected String paramString()
返回表示该复选框状态的参数串。该字符串对调试有用。

返回值：
该复选框的参数字符串。
覆盖：
类 Component 中的 paramString
当前位置 类层次 (JDK) 所有类 (JDK) 所有域和方法 (JDK)