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

Top

字段

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

Top

备注

列表框和组合框向用户显示一系列项目或选择。
列表框方法将允许您添加、排列、删除和查询项目列表。当选择了其中一个项目时， ListBox:CurrentItem, ListBox:CurrentItemNo, ListBox:TextValue 和 ListBox:Value 将被更新。
在 FillUsing() 方法中，可以使用一维或二维数组，每个项目的行。
在二维数组中，第一个元素称为显示值，第二个元素称为返回值。当选择一个项目时，ListBox:TextValue 包含第一个元素(显示值)，ListBox:Value 包含第二个元素(返回值)。如果没有选择项目，ListBox:TextValue 为 NULL_STRING，ListBox:Value 为 NIL。

列表框可以绑定到服务器上的字段(字符、日期、逻辑、数值或备忘录)。字段的数据值存储在 ListBox:Value 中。
列表框将数据值与 FillUsing() 数组中指定的第二个元素值进行比较，如果找到匹配，将第一个元素(显示值)存储在 ListBox:TextValue 中。
在“无匹配”情况下，列表框不显示选择的项目， ListBox:CurrentItem 为 NULL_STRING，ListBox:CurrentItemNo 设置为 0，ListBox:TextValue 和 ListBox:Value 反映字段内容。
如果选择了项目，ListBox:CurrentItemNo 设置为1到 ListBox:ItemCount 之间的一个数字，并且相应的第二个元素被存储为 ListBox:Value 和字段的数据值。

提示：
所有数组索引引用都从1开始。

您还可以创建一个多选列表框，它允许您在列表框中管理多个项目。
列表框中的任意数量的项目可以一起选择(称为多选)。每次用户单击一个项目时，都会切换该项目的选中状态。
通过选择 LBOXMULTIPLESEL 样式创建一个多选列表框。此类列表框的某些属性和方法专门适用于多选列表框，包括 SelectedCount 访问、ChangeSelected()、ClearSelection()、DeselectItem()、FirstSelected()、NextSelected() 和 SelectItem()。

示例

此示例创建并填充了一个列表框，其中包含一系列动物：

复制

 1CLASS MyWindow INHERIT TopAppWindow
 2    HIDDEN oLB AS OBJECT
 3
 4    METHOD Init() CLASS MyWindow
 5        SUPER:Init()
 6        oLB := ListBox{SELF,42,Point{10,10},;
 7        Dimension{100,40}}
 8        oLB:AddItem("Pig")
 9        oLB:AddItem("Cow")
10        oLB:AddItem("Horse")
11        oLB:Show()

一个 X# 列表框相当于一个具有 LBS_NOTIFY 和 LBS_SORT 样式的 Windows 列表框。列表框通常在资源实体中指定，如下所示：

复制

1RESOURCE IDD_ABOUT DIALOG 20, 20, 160, 80
2STYLE WS_POPUP | WS_DLGFRAME
3BEGIN
4    LISTBOX IDL_ITEMLIST, 10, 10, 90, 40
5END

参见

引用

VO 命名空间