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。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章