DataBrowser 类

创建一个数据浏览器，它是一个类似电子表格的表，用于显示来自数据服务器的信息。

继承层次

Object
  VObject
    Control
      DataBrowser

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

语法

复制

 CLASS DataBrowser INHERIT Control

public class DataBrowser : Control

查看代码

DataBrowser 类型公开以下成员。

构造函数

	名称	说明
	DataBrowser	构造一个数据浏览器。

Top

属性

	名称	说明
	Background	用于绘制此数据浏览器背景的画刷。 (重写 Background.)
	Caption	表示数据浏览器标题栏中使用的标题的字符串。 (重写 Caption.)
	CellEdit	当DataBrowser处于编辑模式时，返回当前单元格的编辑控件。否则返回 NULL_OBJECT。
	ColumnCount	表示数据浏览器中列数的数值。
	ContextMenu	表示控件的本地弹出菜单的菜单对象。 (继承自 Control。)
	ControlID	表示控件唯一 ID 的 1 到 8000 之间的数字 (继承自 Control。)
	CurrentColumn	数据浏览器中的当前数据列(即，包含光标的列)。
	EditFont	返回 DataBrowser 的编辑字体。可以使用 ChangeFont() 方法更改此字体。
	FieldSpec	连接到控件的字段规范。 (继承自 Control。)
	Font	用于数据浏览器的文本区域的字体。
	HiBackground	返回数据浏览器中突出行和单元格的背景刷。可以使用 ChangeBackground() 方法更改此刷。
	HyperLabel	连接到控件的链接。 (继承自 Control。)
	Modified	当标准编辑控件或可编辑组合框正在修改时，设置为逻辑值 TRUE 。 (继承自 Control。)
	Name	表示控件名称的字符串。 (继承自 Control。)
	NameSym	表示控件名称的符号。 (继承自 Control。)
	Origin	表示控件在其所有者窗口上的位置的点，以画布坐标表示。 (继承自 Control。)
	Owner	数据浏览器的所有者窗口。 (重写 Owner.)
	OwnerAlignment	表示窗口在其所有者窗口内对齐方式的常量。 (继承自 Control。)
	Pointer	用于在数据浏览器的文本区域中使用的 Pointer 对象。
	ReadOnly	控件是否为只读？ (继承自 Control。)
	RowCount	表示数据浏览器中的行数的数值。
	Server	当前连接到此控件的服务器对象。如果没有连接服务器，则值为 NIL。 (继承自 Control。)
	Size	表示控件大小的尺寸。 (继承自 Control。)
	Status	表示控件在验证尝试或其他操作后的状态的链接。 (继承自 Control。)
	TextColor	用于数据浏览器的文本区域的文本颜色。
	TextValue	表示控件中保存的值的字符串。 (继承自 Control。)
	ToolTipText	表示当用户将鼠标指针移动到控件上时使用的工具提示文本的字符串值。 (继承自 Control。)
	UseHLForToolTip	确定是否应将控件的链接描述文本用作工具提示文本的逻辑值。 (继承自 Control。)
	Value	控件中保存的值，以控件保存的任何数据类型表示。 (继承自 Control。)
	ValueChanged	表示控件的值是否已从先前的设置更改的逻辑值。 (继承自 Control。)

Top

方法

	名称	说明
	Activate	提供在控件具有焦点并激活窗口时调用的方法。 (继承自 Control。)
	AddColumn	向数据浏览器添加一个或多个列。
	AsString	返回数据浏览器的标识标签。 (重写 AsString.)
	CanUndo	确定是否可以撤消对数据浏览器列的最近更改(使用DataBrowser:Undo())。
	ChangeBackground	设置此数据浏览器的新背景画刷。
	ChangeFont	在数据浏览器的特定区域设置新字体。
	ChangeTextColor	在数据浏览器的特定区域设置新颜色。
	Clear	如果数据浏览器中选择了一个或多个单元格，则清除其内容；如果仅选择了单元格中的某些字符，则仅删除这些字符。
	ColPos	返回当前聚焦列的位置。
	ColumnFocusChange	当列焦点发生变化时，提供一个被调用的方法。
	ColumnMoved	当列移动时，提供一个被调用的方法。
	ColumnReSize	当列调整大小时，提供一个被调用的方法。
	Copy	将数据浏览器中的当前选择复制到剪贴板。
	Create	创建底层的 Win32 控件 (继承自 Control。)
	Cut	将数据浏览器中的当前选择剪切到剪贴板。
	Deactivate	提供在控件具有焦点并且窗口被停用时调用的方法。 (继承自 Control。)
	DEFAULT	调用控件的默认 Windows 过程并设置 EventReturnValue。 (重写 DEFAULT(__Usual).)
	Destroy	提供一个方法来取消实例化 DataBrowser 对象。 (重写 Destroy.)
	Disable	禁用控件(直到后续调用 Control:Enable())。 (继承自 Control。)
	DisableTheme	禁用控件的 WinXP 主题。 (继承自 Control。)
	Dispatch	提供在控件具有焦点时系统内事件的原型调度程序；将各种事件路由到其相应的事件处理程序。 (重写 Dispatch(__Usual).)
	Enable	启用先前禁用的控件。 (继承自 Control。)
	EnableBorder	指定数据浏览器的边框样式。
	EnableColumnMove	启用/禁用用户是否可以使用鼠标移动(重新排列)数据浏览器中的列。如果未调用此方法，将默认启用列移动功能。
	EnableColumnReSize	启用/禁用用户是否可以使用鼠标调整数据浏览器中的列。如果未调用此方法，将默认启用列调整大小功能。
	EnableColumnTitles	为整个浏览器打开或关闭列标题。
	EnableGrid	启用/禁用网格的显示。如果未调用此方法，将默认启用网格。
	EnableHorizontalScroll	启用/禁用数据浏览器的水平滚动。如果未调用此方法，将默认启用水平滚动。
	EnableHorizontalSplit	启用/禁用数据浏览器中的水平分隔条。
	EnableVerticalScroll	启用/禁用数据浏览器的垂直滚动。如果未调用此方法，将默认启用垂直滚动。
	EnableVerticalSplit	启用/禁用数据浏览器中的垂直分隔条。
	Error	提供一个方法来处理数据浏览器处理过程中引发的错误条件。
	Expose	提供在控件具有焦点并且窗口的某部分需要重绘时调用的方法。 (继承自 Control。)
	FocusChange	提供在控件具有焦点并且输入焦点从当前控件更改为另一个控件(或反之亦然)时调用的方法。 (继承自 Control。)
	GetColumn	在此数据浏览器中检索指定的列。
	GetExStyle	检索控件的扩展样式。 (继承自 Control。)
	GetStyle	检索控件的样式。 (继承自 Control。)
	Handle	返回控件的句柄。 (继承自 Control。)
	HasBorder	检查控件是否设置了边框 (继承自 Control。)
	HasStyle	检查控件是否设置了样式值 (继承自 Control。)
	Hide	隐藏控件，使其不可见(直到后续调用 Control:Show())。 (继承自 Control。)
	HorizontalScroll	提供在控件具有焦点并且水平滚动条滚动时调用的方法。 (继承自 Control。)
	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。)
	Notify	一个事件处理程序，用于反映已在与此数据浏览器连接的服务器上发生的事件。
	OverRide	这是一个不再使用或需要的兼容性方法。 (继承自 Control。)
	Paste	将剪贴板的当前内容粘贴到当前数据浏览器单元格中。
	PerformValidations	执行所有定义在此控件字段规范中的验证(例如，必填项、最大和最小位数、最大和最小值、验证规则)并返回测试结果。 (继承自 Control。)
	Refresh	强制更新数据浏览器的内容，从数据服务器。
	RegisterTimer	注册一个计时器方法以供控件调用。 (继承自 Control。)
	RemoveColumn	从此数据浏览器中删除一个列。
	RePaint	发送 ExposeEvent 以重新绘制控件 (继承自 Control。)
	Resize	提供在控件具有焦点并且控件大小发生变化时调用的方法。 (继承自 Control。)
	RestoreUpdate	更新此数据浏览器的可视化并恢复标准操作(在调用 DataBrowser:SuspendUpdate() 之后)。 (重写 RestoreUpdate.)
	SetCaption	设置数据浏览器标题栏的标题。
	SetColumn	用另一个列替换数据浏览器中的现有列。
	SetColumnFocus	将列焦点设置为指定的数据列。
	SetExStyle	设置控件的扩展样式。 (继承自 Control。)
	SetFocus	将输入焦点传递给控件，从而将所有鼠标和键盘输入定向到控件。 (继承自 Control。)
	SetParent	更改控件的父句柄。 (继承自 Control。)
	SetPointer	设置新的指针，当鼠标移动到数据浏览器的特定区域时使用。
	SetStandardStyle	设置数据浏览器标题区域的外观。
	SetStyle	设置控件的样式。 (继承自 Control。)
	Show	显示此数据浏览器。 (重写 Show.)
	SuspendUpdate	在修改数据时临时禁用数据浏览器的重绘；通过调用 DataBrowser:RestoreUpdate() 恢复绘制。 (重写 SuspendUpdate.)
	Timer	提供在通过 RegisterTimer() 方法注册计时器时调用的方法。 (继承自 Control。)
	Undo	撤销数据浏览器中一行的最近更改。
	Use	将数据浏览器连接到客户端-服务器关系中的数据服务器。
	Validate	确定当前聚焦记录是否有效。
	ValidateControl	此方法验证控件是否已创建，如果未创建，则触发控件创建 (继承自 Control。)
	VerticalScroll	提供在控件具有焦点并且垂直滚动条滚动时调用的方法。 (继承自 Control。)

Top

字段

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

Top

备注

数据浏览器是一种控件，如复选框或编辑字段。然而，它通常不应作为独立控件创建；使用数据浏览器的最简单方法是将数据窗口切换到浏览视图。这会创建DataBrowser对象；可以通过数据窗口的Browser属性引用它。

数据浏览器是数据感知的，类似于窗口，并且可以作为客户端连接到数据服务器。
它表现出与数据窗口相同的行为：将数据传播到服务器，并响应服务器发送给其客户端的所有通知消息。

将浏览器作为控件与其他控件一起放置在窗口上的最简单方法是将另一个数据窗口作为嵌套子表单放置；请参阅 DataWindow 类的描述。这可以通过窗口编辑器使用编辑插入菜单命令或自动布局功能轻松完成。
有关详细信息，请参阅您的IDE用户指南中的“使用窗口编辑器”。

提示：
在此版本的X#中，包含 DataBrowser 和 SplitWindow 功能的 CATO3*.DLL 文件的静态依赖项已被移除。不使用数据浏览器和/或拆分窗口的应用程序不再需要这些.DLL文件。这导致更小的内存占用、更快的应用程序启动和更小的安装包。

数据浏览器以类似电子表格的表格形式呈现信息，具有行和列。
列是DataColumn对象。数据列对应于数据服务器中的字段——每个数据列都链接到一个服务器字段(就像数据窗口上的数据控件一样)。行对应于服务器中的记录。

与常规数据窗口不同，常规数据窗口一次只显示一条记录——“当前”记录——浏览器将多条记录显示为表格中的行。它始终保持一行作为“当前”行，即服务所在的记录。对数据和操作方法的引用始终指的是“当前”记录，就像在常规数据窗口中一样。因此，唯一的区别是视觉上的，因为浏览器显示了除当前记录之外的记录。

用户和开发人员在数据浏览器的视觉布局上有很大的灵活性。
列可以由用户使用鼠标(除非开发人员禁用这些选项)或在程序控制下动态调整大小和重新排列。
为了在列重新排列后保持对列内容的有意义控制，列通过其名称进行标识。
如果需要使用数字进行引用(如在对其数据一无所知的通用实用程序程序中)，则可以通过其在浏览器中的原始位置编号引用列，这可能与其视觉位置相同或不同。

参见

引用

VO 命名空间