更新时间:2024-01-08 21:23
列表框(ListBox)用于提供一组条目(数据项),用户可以用鼠标选择其中一个或者多个条目,但是不能直接编辑列表框的数据。当列表框不能同时显示所有项目时候,他将自动添加滚动条,使用户可以滚动查阅所有选项。
列表框:选中一项,出现一列列表。
列表框的特点是:列表框中的项目是通过程序插入到其中的,用户无法向清单中输入数据,当选择其中的项目,并在用户单击一个按钮或者执行某个操作时,由应用程序完成对指定项目的具体操作。下面这个例子充分说明了列表框的这个特点,并介绍了列表框(ListBox)的常用属性。
为了学习方便,提供的源码已经作了详细的中文注释,看看源码框中的代码:
Option Explicit
' 简单的列表框ListBox的例子
'------名称-------------作用------------
' List1、List2 列表框
' LefttoRightCmd 移动所选项目到另一个列表框(左到右)
' RighttoLeftCmd 移动所选项目到另一个列表框(右到左)
' LefttoRightCmd 移动所选项目到另一个列表框(左到右)
' RighttoLeftCmd 移动所选项目到另一个列表框(右到左)
' List1.deleteString 删除列表框List1中所选项目
' List2.deleteString 删除列表框List2中所选项目
' List1.AddString 给列表框List1增加新项目
' List2.AddString给列表框List2增加新项目
' List1.ResetContent清空列表框List1
' List2.ResetContent 清空列表框List2
'————名称————属性设置———
' List1列表框 Sorted属性设为“False”
' List2列表框 Sorted属性设为“True”
' MultiSelect属性设置为2
' 即List2控件中的项目总是排序的
'--------------------------------------
Private Sub Form_Load()
'装载窗体时,给列表中的元素赋值
List1.AddItem “China”
List1.AddItem “America”
List1.AddItem “Japan”
List2.AddItem “Soccer”
List2.AddItem “Tennis”
List2.AddItem “Basketball”
End Sub
Private Sub LefttoRightCmd_Click()
'将左边列表中所选元素移动到右边列表中
If List1.ListIndex >;= 0 Then
'在右边列表中增加新元素
List2.AddItem List1.Text
'删除左边列表中的所选元素
List1.RemoveItem List1.ListIndex
End If
End Sub
Private Sub List1AddCmd_Click()
Dim ListItem As String
'
ListItem = InputBox(“在列表中输入新项目”)
'向列表中加入新项目
If Trim(ListItem) <;>; ““ Then
'Trim()作用是清除ListItem字符串内的空格
List1.AddItem ListItem
End If
End Sub
Private Sub List1ClearCmd_Click()
'清空列表
List1.Clear
End Sub
Private Sub List1MoveCmd_Click()
Dim i As Integer
'判断列表框是否只有一个项目被选中
If List1.SelCount = 1 Then
List1.RemoveItem List1.ListIndex
ElseIf List1.ListCount >; 1 Then
'删除列表框中的所选中的多个项目
For i = List1.ListCount - 1 To 0 Step -1
'ListCount返回列表框中的项目总数
'ListCount-1是列表框中最后一个项目的索引号
'判断该项目是否被选中,Selected()返回布尔值
If List1.Selected(i) Then
'删除索引号为i的项目
'偶尔会出现不正常清除选择的情况
List1.RemoveItem i
End If
Next
End If
End Sub
Private Sub List2AddCmd_Click()
'定义变量,以接收输入的字符串
Dim ListItem As String
ListItem = InputBox(”在列表中输入新项目“)
If Trim(ListItem) <;>; ““ Then
'将字符串增加到列表中
List2.AddItem ListItem
End If
End Sub
Private Sub List2ClearCmd_Click()
'清空列表
List2.Clear
End Sub
Private Sub List2MoveCmd_Click()
Dim i As Integer
'判断所选 元素是否只有一个
If List2.SelCount = 1 Then
List2.RemoveItem List2.ListIndex
'如果所选 元素大于1,则按下列操作进行
ElseIf List2.ListCount >; 1 Then
For i = List2.ListCount - 1 To 0 Step -1
If List2.Selected(i) Then
List2.RemoveItem i
End If
Next i
End If
End Sub
Private Sub RighttoLeftCmd_Click()
Dim i As Integer
'判断选中的元素有几个
If List2.SelCount = 1 Then
List1.AddItem List2.Text
List2.RemoveItem List2.ListIndex
'当选中的元素大于一个时
ElseIf List2.SelCount >; 1 Then
For i = List2.ListCount - 1 To 0 Step -1
'如果该元素被选中,则将其从右边移至左边
If List2.Selected(i) Then
List1.AddItem List2.List(i)
List2.RemoveItem i
End If
Next i
End If
End Sub
这个例子包含一个窗体,窗体中有两个列表框(List1、List2)和八个按钮,界面如下:
(图)窗体(FormListBox)
我们首先新建一个标准的EXE工程,添加一个窗体,并把列表框和按钮控件添加到窗体上。各按钮控件的名称如下表:
按钮名称 名称属性 按钮名称 名称属性
删除所选项目(左) List1movecmd 删除所选项目(右) List2movecmd
增加新项目(左) List1addcmd 增加新项目(右) List2addcmd
清除弄表(左) List1clearcmd 清除列表(右) List2clearcmd
右箭头 lefttorightcmd 左箭头 Righttoleftcmd
' List1列表框 Sorted属性设为“False” ' List2列表框 Sorted属性设为“True” ' MultiSelect属性设置为2 ' 即List2控件中的项目总是排序的
在属性窗口中,将List1列表框 Sorted属性设为“False”;List2列表框 Sorted属性设为“True”,MultiSelect属性设置为2,即List2控件中的项目总是排序的。
下一步我们为各控件添加相应的程序。
其中:
List1.AddItem “China” 是将“China”添加到列表框中。
List1.ListIndex 返回的是列表框List1中当前选择项目的索引号码。
List1.ListCount 返回的是列表框List1中项目总数。
List1.ListCount - 1 返回列表框List1中最后一个项目的索引号。
List1.Selected() 返回的是一个项目的选择状态,返回的是布尔值。
代码写好之后,我们就可以保存工程,然后按“Ctrl+F5”键,测试检验一下我们的程序了。在这个小程序中,包含了列表框中的一般常用属性和方法。
Visual Basic 提供了列表框控件(ListBox)以供用户进行多个项目的选择。在工具箱面板上,列表框控件的图标如图一所示:
图一
默认的列表框控件名为 ListX(X为阿拉伯数字 1、2、3,等等),规则的命名方式为:LstX(X为用户自定义的名字,如 LstName、LstUser,等等)。
一、列表框控件的主要属性:
列表框中可以有多个项目供选择,用户通过单击某一项选择自己所需要的项目,如果项目太多,超出了列表框设计时的长度,则自动增加竖向滚动条,如图二:
图二
除了一些常见的诸如 Font 、Height、Left、Width、Enabled、Name 等属性外,列表框还有一些特殊的属性:
1、List(列表)属性:
List 是列表框最重要的属性之一,其作用是罗列或设置表项中的内容。可以在界面设置时直接输入内容,如图三:
图三
在程序运行时,列表框中所有的选项,都可以通过 List(下标值) 的形式表示。比如列表框中的第一项,用 List(0)表示,列表框中的第二项,用 List(1)表示,列表框中的第十项,用 List(9)表示,以此类推。
大家注意,列表框中的第一项,是 List(0) ,而不是 List(1) 。
<1>、List() 属性的使用是非常灵活的,比如我们要从如图二的列表框(Lst1)中取出第三项内容,可以用下面的代码做到:A$ = Lst1.List(2)
其中,A 是一个变量;$ 指明了这个变量的类型:字符串型;这句话的意思是:将 Lst1 列表框中第三项(List(2))取出来然后赋值给字符串变量 A 。
象上面这种赋值办法,在 VB 中是非常普遍的,又如以前我们学到的:
LblShow.Caption = “Visual Basic”,这句话是指将 Visual Basic 这个字符串赋值给 LblShow 标签控件并作为其标题。
紧接上面的内容,假设我们用一个标签显示出刚才取出的表项:
LblShow.Caption = A$
那么显示的结果正是我们取出的选项。
可见,取出某个列表框中的某一表项并将其赋值给某个变量,代码如下:
字符串变量= 列表框名称.List(X) ,其中,X 是下标。
<2>、通过 List() 改变原有表项:假设我们要将如图二的列表框中第三项内容改为“跟我学 VB”,只需输入下面的代码即可:
Lst1.List(2) = “跟我学 VB”
上句话的意思是将“跟我学 VB”字符串赋值给 Lst1 并作为其第三项的内容。
结果如图四:
图四
可见,要修改某个列表框中某一选项:
列表框名称.List(X) = “欲修改成的内容” ,其中,X 是下标。
2、ListCount 属性:
本属性返回列表框表项数量的数值,只能在程序运行时起作用。比如:一个有着四种选项的列表框,那么 ListCount 就为 4 ;一个列表框有五个选项,那么 ListCount 就为 5 。
返回一个列表框的表项数量值并将其赋值给某个变量,代码如下:
数值型变量 = 列表框名称.ListCount
比如要返回图二列表框的 ListCount:
X% = Lst1.ListCount ,其中,X 是变量,% 表示X是整数类型的变量。
3、ListIndex(索引)属性:
本属性用来返回或设置控件中当前选择项目的索引号,只能在程序运行时使用。第一个选项的索引号是 0 ,第二个选项的索引号是 1 ,第三个选项的索引号是 2 ,依此类推,ListCount 始终比最大的 ListIndex 值大 1 。当列表框没有选择项目时, ListIndex 值为 -1 。
在程序中设置 ListIndex 后,被选中的项目呈反相显示,如图五:
图五
在列表框控件的所有属性中,本属性是非常重要的,因为一个列表,事先你并不知道用户将要选择哪一条项目,这时,只有根据 ListIndex 返回的数值,我们才能让程序针对用户的选择做出适当的反应。
返回 ListIndex 的代码如下:
X% = 列表框名称.ListIndex
联想:根据前面的知识我们知道,要取出第三项内容,代码如下:
A$ = Lst1.List(2)
假设选中的是第三项,但我们事先不知道用户要选择这一项,那么又应该如何访问这第三项呢?
代码如下:A$ = Lst1.List(Lst1.ListIndex) 此时,Lst1.ListIndex 等同于 2 。
仔细想一想,为何要如此书写?
4、Columns(列)属性:
本属性用来确定列表框的列数,当值为 0 时,所有项目呈单列显示;当值为 1 或者大于 1 ,项目呈多列显示。Columns 属性只能在界面设置时指定。如图六:
图六
默认状态时,如果项目的总高度大于列表框的高度,那么列表框右边会自动增加一个垂直滚动条,用来上下移动列表框。
5、MultiSelect(多重选择)属性:
本属性决定了选项框中的内容是否可以进行多重选择,只能在界面设置时指定,程序运行时不能予以修改。如图七:
图七
MultiSelect 共有三个值:0 ,不允许多项选择,如果选择了一项就不能选择其他项;1 ,允许多重选择,但功能不如 2 ,可以用鼠标或空格选择;2 ,功能最强大的多重选择,可以结合 Shift 键或 Ctrl 键完成多个表项的多重选择。方法是:单击所要选择的范围的第一项,然后按住 Shift 键,再单击选择范围最后一项。
6、Style(类型)属性:
本属性决定了列表框的外观,共有两个值:1 ,Standard ,即为标准型,如图八:
图八
2 ,CheckBox ,复选框型,如图九:
图九
本属性只能在界面设置时确定。
7、Selected(选中)属性:
本属性返回或设置在列表框控件中某项目是否选中的状态。选中时,值为 True ;未被选中,值为 False 。
代码规则如下: 列表框名称.Selected(索引值) = True/False
注意,索引号其实是项目的下标值,如果是第三项,那么索引值是 2 ,如果是第十项,那么索引值是 9 ,以此类推。
例一:
有如图十这样一个应用程序:
图十
列表框(LstName)中是人物的名称,用户选择不同的名字,下面的标签(LblShow)自动显示此人的相关信息。
源代码如下:
Private Sub LstName_Click()
If LstName.Selected(0) = True Then
LblShow.Caption = “马拉多纳是阿根廷的球星”
ElseIf LstName.Selected(1) = True Then
LblShow.Caption = “贝肯鲍尔是德国的球星”
ElseIf LstName.Selected(2) = True Then
LblShow.Caption = “罗纳尔多是巴西的球星”
Else
LblShow.Caption = “贝克汉姆是英国的球星”
End If
End Sub
本程序是根据用户选择的不同,在标签按件中显示不同的信息;另外,我们用到了前面学到的 If ···Then··· ElseIf··· End If 语法。
8、SelCount(选中项目数量):
只有当 MultiSelect 属性值为 1 或 2 时,本属性才起作用,用来读取列表框中所选项目的数目,通常与 Selected 一起使用,以处理控件中的所选项目。
二、列表框控件的主要事件:
列表框控件主要接收 Click 与 DblClick ,如例一。
三、列表框控件的方法:
1、增加项目:AddItem
用 AddItem 可以为列表框增加项目,代码规则如下:
列表框名称.AddItem 欲增项目[,索引值]
其中,索引值是可选项,是指欲增项目放到原列表框中的第几项,如放在第三项,那么索引值是 2 ,放在第五项,索引值则是 4 。
2、清除所有:Clear
用 Clear 可以清除列表框中所有的内容,代码如下:
列表框名称.Clear
3、删除选项:RemoveItem
此方法可以删除列表框中指定的项目,代码如下:
列表框名称.RemoveItem 索引值
其中,索引值是必须的,表示欲删除哪一个项目。
同样如图十的程序,假设我们要删除第三个项目,代码如下:
LstName.RemoveItem 2
联想:对于任意一个列表框,要删除已经选中的项目,代码如下:
列表框名称.RemoveItem 列表框名称.ListIndex
比如:LstName.RemoveItem LstName.ListIndex
列表框控件在工具箱上的基础控件。很多第三方控件也对列表框做出了扩充,提供了更多地功能,以满足不同的需求。只要将dll添加到工具箱就可以使用。