additem 方法

应用于 请参阅

在组合框或列表框中添加一个新数据项，并且可以指定数据项索引。


语法

Control.AddItem(cItem [, nIndex] [, nColumn])

参数
cItem

指定添加到控制中的字符串表达式。

nIndex

指定控制中放置数据项的位置。如果指定了有效的 nIndex 值，cItem 将放置在控制的正确位置。如果指定的 nIndex 已经存在，数据项将插入到这个位置，在这个数据项后面的其他所有数据项在组合框或列表框控制的列表区中向下移一个位置。
如果忽略参数 nIndex，并且 Sorted 属性设置为“真”(.T.)，则 cItem 数据按字母排序方式添加到队列；如果忽略参数 nIndex，并且 Sorted 属性设置为“假”(.F.)，则 cItem 将添加到组合框或列表框控制的列表区未尾。

nColumn

指定控制的列，新数据项加入到此列中。默认值为 1。

说明

当 RowSourceType 属性设置为 0 (None) 时，可使用 additem 方法或 AddListItem 方法。
每个添加到组合框或列表框中的数据项都有两个标识号：

• nItemID，这是一个与控制中数据项的唯一标识 ID 相关的整数。除非指定了其他的 nIndexID 值，第一个数据项的 nIndexID 值为 1。
• nIndex，这是一个与控制中数据项显示顺序有关的整数，在控制中第一个数据项的 nIndex
  值为 1。