ComboBox.AddItem 方法 (Access)

将新项添加到由指定的组合框控件显示的值列表中。

语法

表达式。AddItem (项、索引)

表达一个代表 ComboBox 对象的变量。

名称	必需/可选	数据类型	说明
Item	必需	字符串	新添项的显示文本。
"索引"	可选	Variant	项在列表中的位置。如果省略此参数，项就会添加到列表的尾部。

指定控件的 RowSourceType 属性必须设置为 Value List。

此方法仅对窗体上的列表框或组合框控件有效。

列表项的编号从零开始。如果 Item 参数的值与现有的项编号不对应，就会发生错误。

对于多列列表，要使用分号来分隔每列的字符串（例如，对于一个三列列表有“1010;red;large”）。如果 Item 参数中包含的字符串个数少于控件中的列数，项就会从最左侧的列开始添加。如果 Item 参数中包含的字符串个数多于控件中的列数，多出的字符串就会被忽略。

使用 RemoveItem 方法可以从值列表中删除某些项。

下面的示例将在列表框控件中的列表的尾部添加一项。为使函数奏效，必须将它传给代表窗体上列表框控件的 ListBox 对象和代表添加项的文本的 String 值。

Function AddItemToEnd(ctrlListBox As ListBox, _ 
 ByVal strItem As String) 
 
 ctrlListBox.AddItem Item:=strItem 
 
End Function

下面的示例将在组合框控件中的列表的开头添加一项。为使函数奏效，必须将它传给代表窗体上组合框控件的 ComboBox 对象和代表添加项的文本的 String 值。

Function AddItemToBeginning(ctrlComboBox As ComboBox, _ 
 ByVal strItem As String) 
 
 ctrlComboBox.AddItem Item:=strItem, Index:=0 
 
End Function

有关于 Office VBA 或本文档的疑问或反馈？请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。