CheckBox 类

创建复选框，复选框是用户可以切换开或关的控件(对于三态复选框，可以切换到第三种状态)。

继承层次

Object
  VObject
    Control
      TextControl
        Button
          CheckBox

命名空间： VO
程序集： VOGUIClasses (在 VOGUIClasses.dll 中) 版本：2.22 GA

语法

复制

 CLASS CheckBox INHERIT Button

public class CheckBox : Button

查看代码

CheckBox 类型公开以下成员。

构造函数

	名称	说明
	CheckBox	构造一个复选框。

Top

属性

	名称	说明
	Background	用于绘制控件背景的画刷。例如，在单行编辑控件中，背景是编辑控件中文本后面的颜色。 (继承自 Control。)
	Caption	表示文本控件标题的字符串。 (继承自 TextControl。)
	Checked	表示复选框当前状态的逻辑值。如果框被选中(或对于三态复选框，如果处于第三种未确定状态)，则为 TRUE，否则为 FALSE。 CheckBox:Checked 分配还会更改 CheckBox:Value 和 CheckBox:TextValue。此外，如果 CheckBox:Value 更改，CheckBox:ValueChanged 将设置为 TRUE。
	ContextMenu	表示控件的本地弹出菜单的菜单对象。 (继承自 Control。)
	ControlFont	用于在控件中绘制文本的字体。 (继承自 TextControl。)
	ControlID	表示控件唯一 ID 的 1 到 8000 之间的数字 (继承自 Control。)
	CurrentText	对于复选框、推按钮和单选按钮，Button:CurrentText 包含 NULL_STRING。 (继承自 Button。)
	FieldSpec	连接到控件的字段规范。 (继承自 Control。)
	HyperLabel	连接到控件的链接。 (继承自 Control。)
	Length	一个表示控件中字符数的数字值。 (继承自 TextControl。)
	Modified	当标准编辑控件或可编辑组合框正在修改时，设置为逻辑值 TRUE 。 (继承自 Control。)
	Name	表示控件名称的字符串。 (继承自 Control。)
	NameSym	表示控件名称的符号。 (继承自 Control。)
	Origin	表示控件在其所有者窗口上的位置的点，以画布坐标表示。 (继承自 Control。)
	Owner	控件的所有者窗口。 (继承自 Control。)
	OwnerAlignment	表示窗口在其所有者窗口内对齐方式的常量。 (继承自 Control。)
	ReadOnly	控件是否为只读？ (继承自 Control。)
	Server	当前连接到此控件的服务器对象。如果没有连接服务器，则值为 NIL。 (继承自 Control。)
	Size	表示控件大小的尺寸。 (继承自 Control。)
	Status	表示控件在验证尝试或其他操作后的状态的链接。 (继承自 Control。)
	TextColor	用于在控件中绘制文本的颜色。 (有关在颜色对象中指定颜色对象的详细信息，请参阅 Color:Init() 方法。) (继承自 TextControl。)
	TextValue	CheckBox:TextValue 在数据窗口上初始化为 FALSE，因为控件不包含文本。 (重写 TextValue.)
	ToolTipText	表示当用户将鼠标指针移动到控件上时使用的工具提示文本的字符串值。 (继承自 Control。)
	UseHLForToolTip	确定是否应将控件的链接描述文本用作工具提示文本的逻辑值。 (继承自 Control。)
	Value	CheckBox:Value 包含 TRUE，如果复选框处于选中(ON)状态或对于三态复选框，处于第三种未确定状态。如果处于未选中状态(OFF)，则包含 FALSE。 (重写 Value.)
	ValueChanged	表示控件的值是否已从先前的设置更改的逻辑值。 (继承自 Control。)

Top

方法

	名称	说明
	Activate	提供在控件具有焦点并激活窗口时调用的方法。 (继承自 Control。)
	AsString	返回按钮的标识标签。 (继承自 Button。)
	Create	创建底层的 Win32 控件 (继承自 TextControl。)
	Deactivate	提供在控件具有焦点并且窗口被停用时调用的方法。 (继承自 Control。)
	DEFAULT	调用控件的默认 Windows 过程并设置 EventReturnValue。 (继承自 Control。)
	Destroy	提供一种方法来销毁 CheckBox 对象。 (重写 Destroy.)
	Disable	禁用控件(直到后续调用 Control:Enable())。 (继承自 Control。)
	DisableTheme	禁用控件的 WinXP 主题。 (继承自 Control。)
	Dispatch	提供在控件具有焦点时系统内事件的原型调度程序；将各种事件路由到其相应的事件处理程序。 (继承自 Control。)
	Enable	启用先前禁用的控件。 (继承自 Control。)
	Expose	提供在控件具有焦点并且窗口的某部分需要重绘时调用的方法。 (继承自 Control。)
	FocusChange	提供在控件具有焦点并且输入焦点从当前控件更改为另一个控件(或反之亦然)时调用的方法。 (继承自 Control。)
	Font	更改文本控件的当前字体。 (继承自 TextControl。)
	GetExStyle	检索控件的扩展样式。 (继承自 Control。)
	GetStyle	检索控件的样式。 (继承自 Control。)
	Handle	返回控件的句柄。 (继承自 Control。)
	HasBorder	检查控件是否设置了边框 (继承自 Control。)
	HasStyle	检查控件是否设置了样式值 (继承自 Control。)
	Hide	隐藏控件，使其不可见(直到后续调用 Control:Show())。 (继承自 Control。)
	HorizontalScroll	提供在控件具有焦点并且水平滚动条滚动时调用的方法。 (继承自 Control。)
	Ime	返回并可选地设置此文本控件的输入法编辑器是否启用。 (继承自 TextControl。)
	IsEnabled	报告此控件当前是否启用。 (继承自 Control。)
	IsExStyle	检查控件是否设置了扩展样式值 (继承自 Control。)
	IsReadOnly	报告此控件当前是否为只读。 (继承自 Control。)
	IsStyle	检查控件是否设置了样式值 (继承自 Control。)
	IsVisible	报告此控件是可见(完全或部分)还是隐藏。 (继承自 Control。)
	KeyDown	提供在控件具有焦点并且按下键盘上的键时调用的方法。 (继承自 Control。)
	KeyUp	提供在控件具有焦点并且释放键盘上的键时调用的方法。 (继承自 Control。)
	LinkDF	将控件连接到数据服务中的数据字段。 (继承自 Control。)
	MenuInit	提供在控件拥有的弹出菜单即将弹出时调用的方法。 (继承自 Control。)
	MenuSelect	提供在控件拥有的菜单上的项目被高亮显示时调用的方法。 (继承自 Control。)
	MouseButtonDoubleClick	提供在控件具有焦点、鼠标指针位于窗口上方并且双击鼠标按钮时调用的方法。 (继承自 Control。)
	MouseButtonDown	提供在控件具有焦点、鼠标指针位于窗口上方并且单击鼠标按钮时调用的方法。 (继承自 Control。)
	MouseButtonUp	提供在控件具有焦点、鼠标指针位于窗口上方并且释放鼠标按钮时调用的方法。 (继承自 Control。)
	MouseDrag	提供在控件具有焦点并且在窗口中移动一个或多个按钮被单击的鼠标时调用的方法。 (继承自 Control。)
	MouseMove	提供在控件具有焦点并且在控件中移动鼠标时调用的方法。 (继承自 Control。)
	Move	提供在控件具有焦点并且控件被移动(由用户或应用程序)时调用的方法。 (继承自 Control。)
	OverRide	这是一个不再使用或需要的兼容性方法。 (继承自 Control。)
	PerformValidations	执行所有定义在此控件字段规范中的验证(例如，必填项、最大和最小位数、最大和最小值、验证规则)并返回测试结果。 (继承自 Control。)
	RegisterTimer	注册一个计时器方法以供控件调用。 (继承自 Control。)
	RemoveEditBalloonTip	从继承了此类的编辑控件中移除当前的 BallonTip。 (继承自 TextControl。)
	RePaint	发送 ExposeEvent 以重新绘制控件 (继承自 Control。)
	Resize	提供在控件具有焦点并且控件大小发生变化时调用的方法。 (继承自 Control。)
	RestoreUpdate	恢复控件的所有绘图更新(在调用 Control:SuspendUpdate() 之后)。 (继承自 Control。)
	SetCueBanner	向继承了此类的编辑控件中添加一个提示文本。 (继承自 TextControl。)
	SetExStyle	设置控件的扩展样式。 (继承自 Control。)
	SetFocus	将输入焦点传递给控件，从而将所有鼠标和键盘输入定向到控件。 (继承自 Control。)
	SetParent	更改控件的父句柄。 (继承自 Control。)
	SetStyle	(继承自 Button。)
	Show	显示控件，使其可见。 (继承自 Control。)
	ShowEditBalloonTip	向继承了此类的编辑控件中添加一个 BallonTip。 (继承自 TextControl。)
	SuspendUpdate	暂时挂起控件的所有绘图更新；绘图在调用 Control:RestoreUpdate() 时恢复。 (继承自 Control。)
	Timer	提供在通过 RegisterTimer() 方法注册计时器时调用的方法。 (继承自 Control。)
	ValidateControl	此方法验证控件是否已创建，如果未创建，则触发控件创建 (继承自 Control。)
	VerticalScroll	提供在控件具有焦点并且垂直滚动条滚动时调用的方法。 (继承自 Control。)

Top

字段

	名称	说明
	EventReturnValue	(继承自 Control。)
	oCargo	Cargo slot. (继承自 VObject。)

Top

备注

复选框允许用户在2种或3种状态之间进行选择。
2态复选框允许在选中(ON)和未选中(OFF)状态之间进行选择。选择反映在 CheckBox:Value 访问中，可以为 TRUE 或 FALSE。
3态复选框增加了第三种(未确定)状态，其中框变暗。第三种状态由 CheckBox:Value 为 TRUE 和 CheckBox:ValueChanged(通常为TRUE) 为 FALSE 表示。

复选框可以绑定到服务中的逻辑字段。
因此，您不能直接将三态复选框绑定到服务；相反，您必须创建一个数字或字符字段来存储三态信息，并根据 CheckBox:Value 和 CheckBox:ValueChanged 访问的状态更新它。
Window:ButtonClick() 事件处理程序响应复选框中的事件。事件处理程序的默认行为是切换复选框的状态。通常，您会实现自己的 ButtonClick() 事件处理程序，其中首先调用默认处理程序来设置按钮的状态。例如：

复制

1METHOD ButtonClick(oControlEvent) CLASS MyWind
2    SUPER:ButtonClick(oControlEvent)
3// 执行其他操作

示例

此示例在对话窗口上创建一个复选框，然后选中它：

复制

 1CLASS MyDialog INHERIT DialogWindow
 2    HIDDEN oCBNew AS OBJECT
 3
 4    METHOD Init(oWindow,nResourceID) CLASS MyDialog
 5        SUPER:Init(oWindow,nResourceID)
 6
 7        oCBNew := CheckBox{SELF,IDB_CHECKBOX}
 8        oCBNew:Checked := TRUE
 9
10        SELF:Show()

在Windows中，复选框等同于具有 BS_CHECKBOX 样式的按钮。
BS_AUTOCHECKBOX 样式非常有用，因为按钮会自动选中和取消选中，而无需在系统中编写任何代码。它们通常在资源实体中指定，如下所示：

复制

1RESOURCE IDD_ABOUT DIALOG 20,20,160,120
2STYLE WS_POPUP | WS_DLGFRAME
3
4BEGIN
5    CHECKBOX "&Color" IDB_COLOR,10,20,40,12
6    CHECKBOX "&Filled" IDB_FILLED,10,35,40,12
7    CONTROL "&Auto",IDB_AUTO,"button", BS_AUTOCHECKBOX,10,65,40,12
8    DEFPUSHBUTTON "OK" IDB_OK,64,80,32,14, WS_GROUP
9END

参见

引用

VO 命名空间