DataListView 类

创建一个数据列表视图，作为更快速、只读、独立控件和数据浏览器的替代。

继承层次

Object
  VObject
    Control
      TextControl
        ListView
          DataListView

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

语法

复制

 CLASS DataListView INHERIT ListView

public class DataListView : ListView

查看代码

DataListView 类型公开以下成员。

构造函数

	名称	说明
	DataListView	构造一个数据列表视图。

Top

属性

	名称	说明
	Background	用于绘制控件背景的画刷。例如，在单行编辑控件中，背景是编辑控件中文本后面的颜色。 (继承自 Control。)
	BackgroundColor	一个 Color 对象，用于在列表视图中绘制背景。 (继承自 ListView。)
	Caption	表示文本控件标题的字符串。 (继承自 TextControl。)
	CheckBoxes	一个逻辑值，确定列表视图中是否使用复选框。 (继承自 ListView。)
	ColumnCount	一个数字值，表示列表视图中的列数。 (继承自 ListView。)
	ColumnOrderArray	一个 ListViewColumn 对象符号名称的数组，表示列表视图中列的顺序。 (继承自 ListView。)
	ContextMenu	表示控件的本地弹出菜单的菜单对象。 (继承自 Control。)
	ControlFont	用于在控件中绘制文本的字体。 (继承自 TextControl。)
	ControlID	表示控件唯一 ID 的 1 到 8000 之间的数字 (继承自 Control。)
	CurrentText	一个字符串，表示当前在文本控件中显示的文本。对于编辑控件，包括简单和下拉组合框关联的编辑框，它包含当前在编辑框中显示的文本。对于 FixedIcon 和组框控件，TextControl:CurrentText 包含 NULL_STRING。 (继承自 TextControl。)
	CurrentView	一个符号名称，表示列表视图的当前视图。 (继承自 ListView。)
	DragDropEnabled	一个逻辑值，如果列表视图启用了拖放，则为 TRUE。如果启用了拖放，项目可以在控件内部和外部拖动。 (继承自 ListView。)
	DragImageList	一个 ImageList 对象，其中包含在列表视图的拖放操作期间显示的单个图像。 (继承自 ListView。)
	FieldSpec	连接到控件的字段规范。 (继承自 Control。)
	FullRowSelect	一个逻辑值，确定在选择列表视图项目时是否高亮整行。 (继承自 ListView。)
	GridLines	一个逻辑值，确定列表视图中是否显示网格线。 (继承自 ListView。)
	HeaderDragDrop	一个逻辑值，确定是否可以通过拖放列标题在列表视图中重新排列列。 (继承自 ListView。)
	HyperLabel	连接到控件的链接。 (继承自 Control。)
	IsGroupViewEnabled	一个逻辑值，确定是否启用了 ListView 分组。 (继承自 ListView。)
	ItemCount	一个数字值，表示列表视图中的项目数量。 (继承自 ListView。)
	ItemsPerPage	一个数字值，表示可以在列表视图的可见区域中垂直容纳的项目数量。 (继承自 ListView。)
	LargeImageList	一个包含大图像的图像列表，用于在图标视图中显示列表视图的每个项目。 (继承自 ListView。)
	Length	一个表示控件中字符数的数字值。 (继承自 TextControl。)
	Modified	当标准编辑控件或可编辑组合框正在修改时，设置为逻辑值 TRUE 。 (继承自 Control。)
	Name	表示控件名称的字符串。 (继承自 Control。)
	NameSym	表示控件名称的符号。 (继承自 Control。)
	Origin	表示控件在其所有者窗口上的位置的点，以画布坐标表示。 (继承自 Control。)
	Owner	此 DataListView 控件的所有者。 (重写 Owner.)
	OwnerAlignment	表示窗口在其所有者窗口内对齐方式的常量。 (继承自 Control。)
	ReadOnly	控件是否为只读？ (继承自 Control。)
	SearchString	与列表视图关联的增量搜索字符串。 (继承自 ListView。)
	SelectedCount	一个数字值，表示在列表视图中选择的项目数量。 (继承自 ListView。)
	Server	与数据列表视图关联的数据服务器。 (重写 Server.)
	Size	表示控件大小的尺寸。 (继承自 Control。)
	SmallImageList	一个包含小图像的图像列表，用于在列表视图、报表视图或小图标视图中显示列表视图的每个项目。此列表中的图标必须在其他地方定义 (继承自 ListView。)
	StateImageList	一个包含状态图像的图像列表，用于在列表视图的每个项目中显示。 (继承自 ListView。)
	Status	表示控件在验证尝试或其他操作后的状态的链接。 (继承自 Control。)
	TextBackgroundColor	一个 Color 对象，用于在列表视图中绘制文本背景。 (继承自 ListView。)
	TextColor	一个 Color 对象，用于在列表视图中绘制文本。 (继承自 ListView。)
	TextValue	一个字符串，表示控件中保存的值。 (继承自 TextControl。)
	ToolTipText	表示当用户将鼠标指针移动到控件上时使用的工具提示文本的字符串值。 (继承自 Control。)
	TopItem	一个数字值，表示列表视图或报表视图中顶部可见项目的索引。 (继承自 ListView。)
	UseHLForToolTip	确定是否应将控件的链接描述文本用作工具提示文本的逻辑值。 (继承自 Control。)
	Value	控件中保存的值，以控件保存的任何数据类型表示。 (继承自 Control。)
	ValueChanged	表示控件的值是否已从先前的设置更改的逻辑值。 (继承自 Control。)
	ViewBoundingBox	当在图标视图或小图标视图中时，包围列表视图所有项目的边界框。 (继承自 ListView。)
	ViewOrigin	表示列表视图当前视图原点的 Point 对象，当在图标视图或小图标视图中时。 (继承自 ListView。)

Top

方法

	名称	说明
	Activate	提供在控件具有焦点并激活窗口时调用的方法。 (继承自 Control。)
	AddColumn	在列表视图的列列表的末尾添加一个新的 ListViewColumn 对象。 (继承自 ListView。)
	AddGroup	将图像设置为列表视图的背景。 (继承自 ListView。)
	AddItem	在列表视图的最后添加一个新的 ListViewItem 对象。 (继承自 ListView。)
	Arrange	在图标视图中对齐列表视图项目。 (继承自 ListView。)
	AsString	返回控件的内容(或其标识标签)。 (继承自 Control。)
	Create	创建底层的 Win32 控件 (继承自 TextControl。)
	Deactivate	提供在控件具有焦点并且窗口被停用时调用的方法。 (继承自 Control。)
	DEFAULT	调用控件的默认 Windows 过程并设置 EventReturnValue。 (继承自 Control。)
	DeleteAll	删除数据列表视图中的所有项目。 (重写 DeleteAll.)
	DeleteAllColumns	从列表视图中删除所有列。 (继承自 ListView。)
	DeleteColumn	从列表视图中删除一个 ListViewColumn 对象。 (继承自 ListView。)
	DeleteItem	从列表视图中删除一个 ListViewItem 对象。 (继承自 ListView。)
	Destroy	提供一个方法，用于取消实例化 DataListView 对象。 (重写 Destroy.)
	Disable	禁用控件(直到后续调用 Control:Enable())。 (继承自 Control。)
	DisableTheme	禁用控件的 WinXP 主题。 (继承自 Control。)
	Dispatch	提供在控件具有焦点时系统内事件的原型调度程序；将各种事件路由到其相应的事件处理程序。 (继承自 Control。)
	EditItemLabel	开始在列表视图中的项目上编辑标签。 (继承自 ListView。)
	Enable	启用先前禁用的控件。 (继承自 Control。)
	EnableDragDrop	启用或禁用列表视图的拖放功能。 (继承自 ListView。)
	EnableGroupView	在 ListView 控件中启用或禁用分组视图。 (继承自 ListView。)
	EnableSort	注册一个用户定义的方法，用于在列表视图中对项目进行排序。 (继承自 ListView。)
	EnsureVisible	确保列表视图中的项目可见，如果需要滚动。 (继承自 ListView。)
	Expose	提供在控件具有焦点并且窗口的某部分需要重绘时调用的方法。 (继承自 Control。)
	FIELDGET
	FocusChange	提供在控件具有焦点并且输入焦点从当前控件更改为另一个控件(或反之亦然)时调用的方法。 (继承自 Control。)
	Font	更改文本控件的当前字体。 (继承自 TextControl。)
	GetAllItems	获取所有 Listview 项目的数组 (继承自 ListView。)
	GetAllSelectedItems	获取所有选定的 Listview 项目的数组 (继承自 ListView。)
	GetColumn	返回特定的 ListViewColumn 对象。 (继承自 ListView。)
	GetExStyle	检索控件的扩展样式。 (继承自 Control。)
	GetGroupTextColor	获取在显示 ListView 控件时用于标题的文本颜色。 (继承自 ListView。)
	GetItemAtPosition	返回特定位置的 ListViewItem 对象，如果存在的话。 (继承自 ListView。)
	GetItemAttributes	根据其项目索引返回一个 ListViewItem 对象。 (继承自 ListView。)
	GetItemBoundingBox	返回其项目索引的 ListViewItem 对象的边界框。 (继承自 ListView。)
	GetItemPosition	返回其项目索引的 ListViewItem 对象的原点。 (继承自 ListView。)
	GetItemSpacing	返回图标视图或小图标视图中列表视图项目之间的间距。 (继承自 ListView。)
	GetNextItem	检索具有所有指定属性的下一个列表视图项目。 (继承自 ListView。)
	GetSelectedItem	检索当前选定的 ListViewItem 对象。 (继承自 ListView。)
	GetStyle	检索控件的样式。 (继承自 Control。)
	Handle	返回控件的句柄。 (继承自 Control。)
	HasBorder	检查控件是否设置了边框 (继承自 Control。)
	HasGroup	一个逻辑值，确定指定ID的组是否存在于 ListView 控件中。 (继承自 ListView。)
	HasStyle	检查控件是否设置了样式值 (继承自 Control。)
	Hide	隐藏控件，使其不可见(直到后续调用 Control:Show())。 (继承自 Control。)
	HorizontalScroll	提供在控件具有焦点并且水平滚动条滚动时调用的方法。 (继承自 Control。)
	Ime	返回并可选地设置此文本控件的输入法编辑器是否启用。 (继承自 TextControl。)
	InsertColumn	在列表视图中的特定列索引后插入一个新的 ListViewColumn 对象。 (继承自 ListView。)
	InsertItem	在列表视图中的特定项目索引后插入一个新的 ListViewItem 对象。 (继承自 ListView。)
	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。)
	PerformValidations	执行所有定义在此控件字段规范中的验证(例如，必填项、最大和最小位数、最大和最小值、验证规则)并返回测试结果。 (继承自 Control。)
	RedrawRange	重绘列表视图项目的范围。 (继承自 ListView。)
	Refresh	强制更新数据列表视图的内容，从数据服务器。
	RegisterTimer	注册一个计时器方法以供控件调用。 (继承自 Control。)
	RemoveAllGroups	从 ListView 控件中删除所有分组。 (继承自 ListView。)
	RemoveEditBalloonTip	从继承了此类的编辑控件中移除当前的 BallonTip。 (继承自 TextControl。)
	RemoveGroup	从 ListView 控件中删除具有指定ID的分组。 (继承自 ListView。)
	RePaint	发送 ExposeEvent 以重新绘制控件 (继承自 Control。)
	Resize	提供在控件具有焦点并且控件大小发生变化时调用的方法。 (继承自 Control。)
	RestoreUpdate	恢复控件的所有绘图更新(在调用 Control:SuspendUpdate() 之后)。 (继承自 Control。)
	Scroll	滚动列表视图的内容。 (继承自 ListView。)
	Seek	在列表视图中搜索特定的列表视图项目。 (继承自 ListView。)
	SelectItem	在列表视图中选择或取消选择特定的项目。 (继承自 ListView。)
	SelectNextItem	选择当前选择项目后的下一个列表视图项目。 (继承自 ListView。)
	SetBackgroundImage	将图像设置为列表视图的背景。 (继承自 ListView。)
	SetColumnFormat	为列表视图设置所需的扩展样式。 (继承自 ListView。)
	SetCueBanner	向继承了此类的编辑控件中添加一个提示文本。 (继承自 TextControl。)
	SetExStyle	设置控件的扩展样式。 (继承自 Control。)
	SetFocus	将输入焦点传递给控件，从而将所有鼠标和键盘输入定向到控件。 (继承自 Control。)
	SetGroupName	设置列表视图组的名称。 (继承自 ListView。)
	SetGroupTextColor	设置在按组显示 ListView 控件时用于标题的文本颜色。 (继承自 ListView。)
	SetItemAttributes	使用新属性更新 ListViewItem 对象。 (继承自 ListView。)
	SetItemGroupId	一个逻辑值，确定具有指定ID的组是否存在于 ListView 控件中。 (继承自 ListView。)
	SetItemPosition	将列表视图项目移动到图标视图或小图标视图中的新位置。 (继承自 ListView。)
	SetParent	更改控件的父句柄。 (继承自 Control。)
	SetSelectedColumn	将列显示为选定。 (继承自 ListView。)
	SetStyle	设置控件的样式。 (继承自 Control。)
	Show	显示控件，使其可见。 (继承自 Control。)
	ShowEditBalloonTip	向继承了此类的编辑控件中添加一个 BallonTip。 (继承自 TextControl。)
	SortItems	使用 EnableSort() 指定的用户定义排序方法对列表视图项目进行排序。 (继承自 ListView。)
	SuspendUpdate	暂时挂起控件的所有绘图更新；绘图在调用 Control:RestoreUpdate() 时恢复。 (继承自 Control。)
	Timer	提供在通过 RegisterTimer() 方法注册计时器时调用的方法。 (继承自 Control。)
	Update	更新列表视图项目。 (继承自 ListView。)
	Use	将数据服务器与数据列表视图关联。
	ValidateControl	此方法验证控件是否已创建，如果未创建，则触发控件创建 (继承自 Control。)
	VerticalScroll	提供在控件具有焦点并且垂直滚动条滚动时调用的方法。 (继承自 Control。)
	ViewAs	更改列表视图的当前视图。 (继承自 ListView。)

Top

字段

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

Top

备注

数据列表视图是一个“数据仓库”列表视图控件，它作为数据浏览器的快速、只读替代。与列表视图列控件一起，在窗口编辑器中可以“绘制”数据窗口的浏览视图部分。它也可以作为一个独立控件使用。
DataListView 控件在内部使用虚拟列表视图，这意味着它的速度不受数据库中记录总数的影响。此外，滚动条的大小和位置始终正确地表示数据库中的位置。 DataListView 控件依赖于关联服务的 OrderKeyCount()、OrderKeyGoto() 和 OrderKeyNo() 方法。如果没有活动的顺序，DataListView 控件使用 RecCount()、GoTo() 和 RecNo()。
此外，DataListView 控件有一些限制，取决于当前活动的 RDD：
仅对 NTX 和 CDX 驱动程序支持 SetFilter。不是所有 RDD 都支持 SetDeleted(TRUE)。如果要隐藏所有已删除的记录，应使用 SetDeleted(FALSE) 并指定数据服务器的过滤条件，如：

复制

1SetFilter({||!Deleted()}, "!Deleted()")

仅对 NTX 和 CDX 驱动程序支持 OrderScopes。
如果要将 DataListView 控件用作 DataBrowser 控件的替代，将 Window Editor 中的 Browser Inherits From 属性设置为 DataListView。生成的代码将引用 DataListView。

提示：
选择 DataListView 控件作为 DataBrowser 控件的替代还有一个优势：您的应用程序将不需要 CATO3xxx.DLL 支持DLL。

DataListView 控件也可以作为一个独立控件，可以放置在任何窗口或对话框上。在这种情况下，您必须显式地将一个数据服务器分配给 DataListView:Server 属性。

参见

引用

VO 命名空间