返回或設置壹個值,該值決定ListBox控件是水平滾動還是垂直滾動以及列中各項的顯示方式。如果水平滾動,Columns屬性確定顯示多少列。
語法
對象。列【=數量】
列屬性語法包含以下部分:
部分描述
Object對象表達式,其值為“應用於”列表中的對象。
Number壹個整數值,用於指定控件的滾動方式以及列中各項的排列方式,這在“設置值”中有詳細描述。
給定值
$ number的設定值為:
設定值描述
0(默認)項排列在壹列中,列表框垂直滾動。
1到n項排列在多列中,首先填寫第壹列,然後填寫第二列,依此類推。列表框水平滾動並顯示指定數量的列。
解釋
對於水平滾動的列表框控件,列寬等於列表框寬度除以列數。
該屬性不能設置為0或在運行時從0更改-也就是說,不能在運行時將多列列表框更改為單列列表框或將單列列表框更改為多列列表框。
SelCount屬性
返回列表框控件中選定數據項的數目。
語法
對象。塞爾計數
對象的位置表示其值為“應用於”列表中的對象的對象表達式。
解釋
如果未選擇任何項目,SelCount屬性將返回值0。否則,它返回當前選定列表項的數量。該屬性對於能夠檢查尤其有用。
ItemData屬性
返回或設置組合框或列表框控件中每壹項的特定個數。
語法
對象。item data(index)【= number】
ItemData屬性語法包含以下部分:
部分描述
Object對象表達式,其值為“應用於”列表中的對象。
Index對象中指定項的編號。
編號與指定項目相關聯的編號。
解釋
ItemData屬性是壹個長整數數組,其項數與控件的List屬性相同。每個項目都可以通過與之相關的編號來識別。例如,在ListBox控件中,可以使用員工ID號來標識每個員工的姓名。在填寫ListBox時,員工編號也應填寫在ItemData的相應元素中。
ItemData通常用作與ListBox控件中的項目相關的數據結構數組的索引。
請註意,當使用AddItem方法將某項插入列表時,該項會自動插入ItemData數組。但是它的值不會被重新初始化為0;在插入項之前,它在該位置保存列表的值。使用ItemData屬性時,請確保在向列表中添加新項目時設置其值。
列表屬性
返回或設置控件列表部分中的項目。列表是字符串數組,數組中的每壹項都是列表項。ListBox和ComboBox控件在設計時可以通過屬性瀏覽器獲得,它們在運行時對於DirListBox、DriveListBox和FileListBox控件是只讀的,而對於ComboBox和ListBox控件是可讀和可寫的。
語法
對象。列表(索引)【=字符串】
列表屬性語法包含以下部分:
部分描述
Object對象表達式,其值為“應用於”列表中的對象。
索引列表中特定項目的編號。
指定列表項的字符串表達式。
解釋
使用此屬性訪問列表項。
對於除DirListBox之外的所有控件,第壹項的索引為0,最後壹項的索引為ListCount-1。
對於DirListBox控件,索引號序列基於運行時創建控件時的當前目錄和子目錄。當前展開的目錄由索引值-1表示。當前擴展目錄的前壹個目錄由具有較大絕對值的負索引值表示。例如,-2是當前展開目錄的父目錄,-3是它上面的目錄。當前展開目錄下的目錄範圍是從0到ListCount-1。
最初,組合框和列表框控件包含壹個空列表。對於文件系統控件,列表內容由運行時創建控件時存在的條件決定:
目錄列表框-包含所有目錄的列表,範圍從-n到ListCount-1。
DriveListBox -包含有效驅動器連接的列表。
文件列表框-包含與模式屬性匹配的當前展開目錄的文件列表。不包含路徑。
List屬性與ListCount和ListIndex屬性結合使用。
對於除DirListBox控件之外的所有可用控件,從0到ListCount -1逐個取值以獲取列表中的所有項目。對於DirListBox控件,逐個獲取從-n到ListCount-1的值,以獲得在當前展開的目錄中可以看到的所有目錄和子目錄的列表。在這種情況下,n是當前擴展目錄之上的目錄層級數。
註意若要確定組合框或列表框控件中顯示的項目,可以使用AddItem方法。若要刪除某項,請使用RemoveItem方法。若要按字母順序對項進行排序,請在向列表中添加項之前將控件的Sorted屬性設置為True。
在聲明部分使用Option Base = 1語句不會影響Visual Basic控件中元素的編號。第壹個元素始終為0。
當列表索引值超過列表框的實際數量範圍時,將返回零長度字符串(““),例如,對於組合框或列表框控件列表(-1)。
ListCount屬性
返回控件列表部分中的項數。
語法
對象。列表計數
對象的位置代表壹個對象表達式,其值是“應用於”列表中的壹個對象。
解釋
ListCount提供每個控件的特定信息:
組合框和列表框控件-列表中的項數。
目錄列表框控件-當前目錄中子目錄的數量。
驅動器列表框控件-連接的驅動器數量。
文件列表框控件-當前目錄中匹配模式屬性設置的文件數量。
如果未選擇任何項目,則ListIndex屬性的值為-1。列表中的第壹項是ListIndex = 0,ListCount總是比最大ListIndex值大1。
ListIndex屬性
返回或設置控件中當前選定項的索引,該索引在設計時不可用。
語法
對象。列表索引
ListIndex屬性語法包含以下部分:
部分描述
Object對象表達式,其值為“應用於”列表中的對象。
索引數值表達式,指定當前項目的索引。在“設定值”中有詳細說明。
給定值
指數的設定值為:
設定值描述
-1(combobox、DirListBox和DriveListBox控件的默認值)表示當前未選擇任何項目。對於ComboBox控件,它意味著用戶在文本框部分輸入了新文本;對於DirListBox控件,表示當前路徑的索引。對於DriveListBox控件,表示在運行時創建控件時當前驅動器的索引。
n(文件列表框和列表框控件的默認值)表示當前選定項的索引。
解釋
表達式列表(List1。ListIndex)返回當前所選項的字符串。
列表中的第壹項是ListIndex = 0,ListCount總是比最大ListIndex值大1。
對於可以進行多重選擇的控件,此屬性的行為取決於選定項的數量。如果只選擇了壹個項目,ListIndex將返回該項目的索引。在多重選擇中,ListIndex返回焦點矩形中包含的項目的索引,而不管該項目是否被選中。
NewIndex屬性
返回最近添加到組合框或列表框控件中的數據項的索引。在運行時是只讀的。
語法
對象。新指數
對象的位置表示其值為“應用於”列表中的對象的對象表達式。
解釋
當需要與ItemData屬性數組中的每壹項相對應的值列表時,可以將此屬性用於排序列表。當壹項添加到排序列表中時,Visual Basic將在列表中按字母順序插入壹項。此屬性指示該項的插入位置,以便可以在ItemData屬性中的相同索引處插入相應的值。
如果列表中沒有更多的項目或在添加最後壹個項目後刪除了壹個項目,則NewIndex屬性將返回-1。
AddItem方法
用於向列表框或組合框控件添加項,或者向MS Flex網格控件添加行。不支持命名參數。
語法
對象。AddItem項目,索引
AddItem方法的語法包含以下部分:
部分描述
需要對象。其值為“應用於”列表中的對象的對象表達式。
必需的項目。字符串表達式,指定要添加到對象中的項。這僅適用於MS Flex網格控件。您可以使用制表符(字符代碼09)來分隔要插入到新添加行的每壹列中的多個字符串。
索引是可選的。是壹個整數,指定新項或新行在對象中的位置。對於ListBox或ComboBox控件的第壹項或MS Flex Grid控件的第壹行,索引為0。
解釋
如果給定的索引值有效,該項將被放置在對象中的相應位置。如果省略index,當Sorted屬性設置為True時,item將被添加到適當的排序位置,當Sorted屬性設置為False時,item將被添加到列表的末尾。
綁定到數據控件的ListBox或ComboBox控件不支持AddItem方法。
清除方法(ActiveX控件)
刪除集合中的所有對象。
語法
對象。清楚的
對象的位置代表壹個對象表達式,其值是“應用於”列表中的壹個對象。
移除項目方法
用於從ListBox或ComboBox控件中刪除壹項,或從MS Flex Grid控件中刪除壹行。不支持命名參數。
語法
對象。移除項目索引
RemoveItem方法的語法包含以下部分:
部分描述
需要對象。其值為“應用於”列表中的對象的對象表達式。
需要索引。壹個整數,表示對象中要刪除的項或行的位置。對於ListBox或ComboBox中的第壹項或MS Flex網格控件中的第壹行,Index = 0。
解釋
綁定到數據控件的ListBox或ComboBox不支持RemoveItem方法。