PB控件属性之dropdownlistbox和dropdownpicturelistbox

下拉列表框-dropdownlistbox、图形下拉列表框-dropdownpicturelistbox

【属性】
下拉列表框提供了37个属性,图形下拉列表框除了这37个属性外,还有5个专门与图形有关的属性。因为具有列表框的特性,所以很多同名属性和Listbox的含义相同

▲AllowEdit
该属性设置是否允许用户输入新的项目,缺省为不允许

▲AutoHScroll
该属性设置当录入新项目或者删除数据时是否允许自动滚动编辑框,缺省不允许。下拉列表框的宽度大于Limit规定的数值,则没有必要设置该属性;否则就应该设置该属性为True。该属性实际上是单行编辑器的特征。

▲Enabled
该属性设置是否允许进行选择,缺省值是True

▲Limit
该属性用来规定用户可以输入的字符的最大宽度,0表示没有限制,最大是32 766个,缺省是0。该属性是单行编辑器的特征。

▲ShowList
该属性规定是否总显示下拉列表

▲Sorted
和列表框的属性相同,该属性定义各个项目是否自动排序显示,缺省为False。当该属性为True时,动态添加到下拉列表框中的项目会自动排序显示到适当的位置

▲ItemPictureIndex[]
integer类型的只读数组,使用该数组可以获取每个图片项目的索引。该数组通过AddItem()和DeleteItem()函数修改。

▲PictureHeight
integer类型,标识图片在控件中显示的高度。只有当前在控件列表中没有项目时才能设置该属性。

▲PictureWidth
Integer类型,图片在控件中显示的宽度。该属性缺省值为0,表示使用添加图片时图片的缺省宽度。在添加图片之前应该首先设置好该属性,这样添加的图片才能按照该尺寸显示。

▲PictureMaskColor
long类型,图片的标志颜色,当使用AddPicture函数添加图片时,新添加的图片使用该颜色。

▲PictureName[]
数组类型,保存的是在初始化时添加的图片文件名称。注意,这里保存的是初始化时的文件名,运行过程中删除或者添加的图片不会影响该数组的内容。


【事件】
这两个控件的事件完全相同,都提供了14个事件。缺省事件是SelectionChanged,它和Modified事件是两个经常使用的事件。

◆SelectionChanged
在重新选择了下拉列表中的项目时触发。参数index可以直接引用,是当前选中项目的索引号。典型编程是获取用户当前所选项目的内容,然后根据用户所选内容进行其他相关的处理

◆Modified
在输入了新的项目后按下Enter或者Tab键而使下拉列表框失去焦点时触发。
典型编程是获取用户当前输入的内容,然后使用函数将其添加到当前的下拉列表框中,以便用户在退出应用程序之前无需再重新输入该项目。

◆DoubleClicked
双击时触发,很少在该事件下编写脚本

*其他事件和命令按钮的同名事件完全相同


【函数】
下拉列表框提供了37个函数,图形下拉列表框除此之外又增加了3个用户图形处理的函数。在这37个函数中,经常使用的有AddItem、DeleteItem、DirList、DirSelect、FindItem、InsertItem、Reset、SelectItem、Text、TotalItems、SelectedLength、SelectedText、SelectText、ReplaceText等14个函数,其中,前面的10个和列表框的同名函数用法相同,下面介绍后面的4个函数

★SelectedLength
语法:editname.SelectedLength ( )
功能:获取在editname中选中项目的字符数目,包括空格。注意,该函数只有在下拉列表框选中项目并且没有失去焦点时,才能正确获得所选项目的字符数目,所以在很多的事件或控件中编程使用该函数都返回0,因为这些事件触发时,下拉列表框失去了焦点,所以一般在下拉列表框的SelectionChanged事件中使用该函数。另外,下拉列表框的AllowEdit属性必须为True,才能正确执行该函数,否则该函数执行错误。
返回值:-1表示执行过程中发生了错误,0表示没有选中的项目,Null表示editname为Null,其他正整数表示选中项目的字符数目。

★SelectedText
语法:editname.SelectedText ( )
功能:返回editname中选中项目的内容。该函数在下拉列表框选中项目并且没有失去焦点时,可以正确返回选中项目的内容。
返回值:当有错误发生或者没有选中项目时返回空值(“”),当editname为Null返回Null,正确执行时返回选中项目的内容。

★SelectText
语法:editname.SelectText ( start, length )
功能:在editname的编辑框中,从第start字符开始选中length个字符。
返回值:返回选中的字符个数,如果发生了错误则返回-1,如果有参数为Null则返回Null。

★ReplaceText
语法:editname.ReplaceText (string )
功能:在editname中用指定的字符串string来替换选中的字符。?
返回值:返回string字符串的长度,如果发生错误则返回-1,如果有参数为Null则返回Null。

*除了上面介绍的4个常用函数外,图形下拉列表框还提供了3个专门用于图形的函数,它们是AddPicture、DeletePicture和DeletePictures。

转载,地址为:https://blog.csdn.net/u012369435/article/details/36633829

猜你喜欢

转载自www.cnblogs.com/thomasbc/p/9645038.html