RadioButtonGroup 类

一组单选按钮，被视为一个组合控件，呈现一组选项，并返回一个值。

继承层次

Object
  VObject
    Control
      TextControl
        GroupBox
          RadioButtonGroup

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

语法

复制

 CLASS RadioButtonGroup INHERIT GroupBox

public class RadioButtonGroup : GroupBox

查看代码

RadioButtonGroup 类型公开以下成员。

构造函数

	名称	说明
	RadioButtonGroup	构造一个单选按钮组。

Top

属性

	名称	说明
	Background	用于绘制控件背景的画刷。例如，在单行编辑控件中，背景是编辑控件中文本后面的颜色。 (继承自 Control。)
	Caption	表示文本控件标题的字符串。 (继承自 TextControl。)
	ContextMenu	表示控件的本地弹出菜单的菜单对象。 (继承自 Control。)
	ControlFont	用于在控件中绘制文本的字体。 (继承自 TextControl。)
	ControlID	表示控件唯一 ID 的 1 到 8000 之间的数字 (继承自 Control。)
	CurrentText	此属性用于覆盖从 TextControl 类继承的功能，因为它不适用于分组框。 (继承自 GroupBox。)
	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	RadioButtonGroup:TextValue 包含 FillUsing() 数组的第一个元素 (重写 TextValue.)
	ToolTipText	表示当用户将鼠标指针移动到控件上时使用的工具提示文本的字符串值。 (继承自 Control。)
	UseHLForToolTip	确定是否应将控件的链接描述文本用作工具提示文本的逻辑值。 (继承自 Control。)
	Value	包含与单选按钮组中选中的单选按钮关联的组值设置(在窗口编辑器属性窗口上指定)。 (重写 Value.)
	ValueChanged	表示控件的值是否已从先前的设置更改的逻辑值。 (继承自 Control。)

Top

方法

	名称	说明
	Activate	提供在控件具有焦点并激活窗口时调用的方法。 (继承自 Control。)
	AsString	返回分组框的标识标签。 (继承自 GroupBox。)
	Button	检索特定的单选按钮。
	Create	创建底层的 Win32 控件 (继承自 TextControl。)
	Deactivate	提供在控件具有焦点并且窗口被停用时调用的方法。 (继承自 Control。)
	DEFAULT	调用控件的默认 Windows 过程并设置 EventReturnValue。 (继承自 Control。)
	Destroy	提供一种方法来取消实例化任何 TextControl.Destroy 对象。 (继承自 TextControl。)
	Disable	禁用单选按钮组(直到后续调用 RadioButtonGroup:Enable())。 (重写 Disable.)
	DisableTheme	禁用控件的 WinXP 主题。 (继承自 Control。)
	Dispatch	提供在控件具有焦点时系统内事件的原型调度程序；将各种事件路由到其相应的事件处理程序。 (继承自 Control。)
	Enable	启用之前禁用的单选按钮组。 (重写 Enable.)
	Expose	提供在控件具有焦点并且窗口的某部分需要重绘时调用的方法。 (继承自 Control。)
	FillUsing	使用数组指定组成组的单选按钮和对应这些按钮的一组值。
	FocusChange	提供在控件具有焦点并且输入焦点从当前控件更改为另一个控件(或反之亦然)时调用的方法。 (继承自 Control。)
	Font	更改文本控件的当前字体。 (继承自 TextControl。)
	GetExStyle	检索控件的扩展样式。 (继承自 Control。)
	GetStyle	检索控件的样式。 (继承自 Control。)
	Handle	返回控件的句柄。 (继承自 Control。)
	HasBorder	检查控件是否设置了边框 (继承自 Control。)
	HasStyle	检查控件是否设置了样式值 (继承自 Control。)
	Hide	隐藏单选按钮组，使其不可见(直到后续调用 RadioButtonGroup:Show())。 (重写 Hide.)
	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	将输入焦点传递给单选按钮组中选中的单选按钮。 (重写 SetFocus.)
	SetParent	更改控件的父句柄。 (继承自 Control。)
	SetStyle	设置控件的样式。 (继承自 Control。)
	Show	显示单选按钮组，使其可见。 (重写 Show.)
	ShowEditBalloonTip	向继承了此类的编辑控件中添加一个 BallonTip。 (继承自 TextControl。)
	SuspendUpdate	暂时挂起控件的所有绘图更新；绘图在调用 Control:RestoreUpdate() 时恢复。 (继承自 Control。)
	Timer	提供在通过 RegisterTimer() 方法注册计时器时调用的方法。 (继承自 Control。)
	ValidateControl	此方法验证控件是否已创建，如果未创建，则触发控件创建 (继承自 Control。)
	VerticalScroll	提供在控件具有焦点并且垂直滚动条滚动时调用的方法。 (继承自 Control。)

Top

字段

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

Top

备注

单选按钮通常用于允许在特定选项列表中选择一个。然而，将多个单选按钮视为单独的控件需要对按钮的行为进行显式管理：当选择一个按钮时，程序必须关闭组中的其他按钮。
单独的单选按钮也不适合与数据库链接：数据库通常不会有多个字段表示链接的属性，而是一个可以取不同值的字段。
单选按钮组是一个更高级别的控件，它自动处理按钮的相互链接。它还以比单独的单选按钮更智能的方式链接到数据库：整个组被视为一个控件，它可以取一组特定的值。
由于单选按钮组是您处理的控件，它的组成单选按钮不是直接由程序引用的，所以像超链接标签、字段规范、标题、值和文本值这样的属性都附加到组。值要么是当前在序列中选择的单选按钮的编号，要么是通过 FillUsing() 方法在二维数组中为单选按钮指定的一个值。文本值是根据附加到组的字段规范的图片规范格式化的相同值(要获取在单选按钮旁边显示的标题，检索所选按钮并引用其标题属性。注意，组的字段规范的数据类型和图片规范被使用，而单选按钮的字段规范被忽略)。
单选按钮组的行为类似于列表框或组合框，当选项的数量少且固定时，可以作为受限制的单选列表框的替代。 (尽管单选按钮组支持为单个按钮的个别按钮提供可变的标题字符串，但列表框通常是非常动态数据的更好选择。)
单选按钮组是空的，单选按钮是通过 FillUsing() 方法与之关联的。如果使用窗口编辑器创建单选按钮，生成的源代码中的 FillUsing() 方法定义了一个二维数组，每个按钮都有一行。第一个元素包含单选按钮的标题，第二个元素包含它的组值。
当按下按钮时，单选按钮组的 TextValue 包含第一个元素(按钮的标题)，Value 包含第二个元素(组的值)。
如果没有按钮被按下，RadioButtonGroup:TextValue 是 NULL_STRING，RadioButtonGroup:Value 是 NIL。
单选按钮组可以与服务器的字段绑定。字段的数据值存储在 RadioButtonGroup:Value 中。单选按钮组将字段的数据值与 FillUsing() 数组中指定的第二个元素的值进行比较，如果找到匹配，将第一个元素(按钮的标题)存储在 RadioButtonGroup:TextValue 中。
如果没有找到匹配，RadioButtonGroup:TextValue 是 NULL_STRING。
如果按下按钮，相应的第二个元素将存储在 RadioButtonGroup:Value 中，并且这个值将被写入服务器。

参见

引用

VO 命名空间