Delphi TlistView功能及常用屬性介紹

1,、TlistView功能介紹：

• TListView 控件可以用來顯示各項(xiàng)帶圖標(biāo)的列表,，包括大圖標(biāo)和小圖標(biāo)的；也可以用來顯示帶有子項(xiàng)的列表,，Windows操作系統(tǒng)的資源管理器中文件夾窗口就是最好的應(yīng)用例子,，打開"我的電腦"后能夠看到各個(gè)盤符的界面
• TListView控件基本能實(shí)現(xiàn)和DBGrid控件一樣的功能，很多時(shí)候根據(jù)程序需要可以完全用TListView來替換DBGrid,；只要將TListView的ViewStyle屬性設(shè)為vsReport,，然后再配合其他幾個(gè)屬性（這個(gè)稍后說明），就可以實(shí)現(xiàn)DBGrid中的綁定數(shù)據(jù)庫(kù),、數(shù)據(jù)添加,、修改、刪除,、不同列的不同顏色顯示及單擊標(biāo)題排序等等一系列常用的功能,；

2、TListView 常用屬性

（1）BoundingRect 屬性：此屬性返回一個(gè)能把列表視圖中所有項(xiàng)包住的矩形,。此屬性僅在ViewStyle 屬性設(shè)為vsIcon 或vsSmallIcon 時(shí)有效,。

（2）CheckBoxed 屬性：當(dāng)ViewStyle 屬性設(shè)為vsList 或vsReport 時(shí)，如果把CheckBoxes 屬性設(shè)為True,，列表視圖中項(xiàng)的旁邊將顯示復(fù)選框,，如同TCheckListBox 組件一樣。

（3）Column 屬性：此屬性可以訪問列表視圖中每一欄，Index 指定欄的序號(hào),。此屬性僅當(dāng)ViewStyle 屬性設(shè)為vsReport時(shí)有效,。

（4）ColumnClick 屬性：如果此屬性設(shè)為True，欄的表頭（如果有的話）將同時(shí)作為按鈕用,，按下這些按鈕,，將觸發(fā)OnColumnClick 事件，通常用于對(duì)列表視圖中的項(xiàng)進(jìn)行重新排序,。

（5）Columns 屬性：如果ViewStyle 屬性設(shè)為vsReport,，列表視圖的每一項(xiàng)將分成多欄，每一欄都是一個(gè)TListColumn對(duì)象,，所有的欄構(gòu)成TListColumn 對(duì)象,。在設(shè)計(jì)期，可以單擊Columns 屬性旁的省略號(hào)"…"按鈕打開"Editing Columns"窗口,，然后建立和編輯欄的屬性,。例如：

（6）HideSelection 屬性：如果此屬性設(shè)為True，當(dāng)輸入焦點(diǎn)從列表視圖移到其他組件上時(shí),，原先選擇的節(jié)點(diǎn)將不再處于被選擇狀態(tài),。如果此屬性設(shè)為False，當(dāng)輸入焦點(diǎn)移走時(shí)仍然保持選擇狀態(tài),。

（7）ItemFocused 屬性：此屬性指定或返回列表視圖中具有輸入焦點(diǎn)的項(xiàng),。一個(gè)列表視圖中可以同時(shí)有多個(gè)項(xiàng)被選擇，但只能有一個(gè)項(xiàng)具有輸入焦點(diǎn),。

（8）Items 屬性：此屬性代表列表視圖中的所有項(xiàng),。列表視圖中的每一項(xiàng)是一個(gè)TListItem 對(duì)象。在設(shè)計(jì)期,，可以按下Items 屬性旁的"..."按鈕打開"ListView Items"編輯器,，然后建立和編輯列表視圖中的每一項(xiàng).

（9）MultiSelect 屬性：如果此屬性設(shè)為True，用戶可以同時(shí)選擇多個(gè)項(xiàng),。

（10）RowSelect 屬性：在ViewStyle 屬性設(shè)為vsReport 的前提下,，如果把此屬性設(shè)為True，用戶可以一次選擇一整行,。

（11）Selected 屬性：此屬性用于設(shè)置返回列表視圖中被選擇的項(xiàng),。如果有多項(xiàng)被選擇，返回的是當(dāng)前有輸入焦點(diǎn)的項(xiàng),。

（12）ShowWorkAreas 屬性：在ViewStyle 屬性設(shè)為vsIcon 或vsSmallIcon 的情況下,，通過定義工作區(qū)，可以把圖標(biāo)分組,，如果ShowWorkAreas 屬性設(shè)為True,，列表視圖將把客戶區(qū)分成幾個(gè)工作區(qū),，每個(gè)工作區(qū)的顏色由TWorkArea的Color 屬性指定，標(biāo)簽由TWorkArea 的DisplayName 屬性指定,。

（13）SortType 屬性：此屬性用于設(shè)置什么情況下列表視圖中的項(xiàng)將重新排列。它設(shè)定了如下4 個(gè)用戶可選值,。

• stNone：不重新排序,。
• stData：項(xiàng)的Data 屬性發(fā)生變化時(shí)重新排序。
• stText：項(xiàng)的Caption 屬性發(fā)生變化時(shí)重新排序,。
• stBoth：項(xiàng)的Data 屬性或Caption 屬性發(fā)生變化時(shí)重新排序,。

（14）ViewStyle 屬性：ListView 控件作為一個(gè)可以顯示圖標(biāo)或者子項(xiàng)的列表控件，它最重要的屬性就是 ViewStyle 屬性,，該屬性決定了以哪種視圖模式顯示控件的項(xiàng),，這四種視圖模式分別如下：

• 1. vsIcon：大圖標(biāo)視圖模式，在項(xiàng)的文本旁顯示大的圖標(biāo),，在控件寬度足夠的情況下,，項(xiàng)是優(yōu)先以平行排列的，排列不完的則自動(dòng)換行顯示在新行中,。這個(gè)屬性要和TListView的LargeImages屬性一起使用,；
• 2. vsSmallIcon：小圖標(biāo)視圖模式，與大圖標(biāo)模式一樣,，但是顯示的是小的圖標(biāo),；要和TListView的SmallImages屬性一起使用；
• 3. vsList：列表視圖模式,，可以顯示小圖標(biāo),，但是項(xiàng)是垂直排列的，只顯示單列,，不能進(jìn)行拖放操作,；
• 4. vsReport：詳細(xì)資料視圖模式，是最豐富的選項(xiàng),，可以基本實(shí)現(xiàn)DBGrid的所有功能,；它不但允許您查看項(xiàng)，還允許您查看為各項(xiàng)指定的任何子項(xiàng),。各項(xiàng)在網(wǎng)格中顯示,，它們垂直排列且其子項(xiàng)會(huì)顯示在列中（帶有列標(biāo)頭）。對(duì)應(yīng)地,，只有在Details 視圖模式中起作用的控件屬性為：GridLines 和 FullRowSelect,，GridLines 屬性指示在包含控件中項(xiàng)及其子項(xiàng)的行和列之間是否顯示網(wǎng)格線。FullRowSelect 屬性指示單擊某項(xiàng)是否選擇其所有子項(xiàng)(即整行選中)

3,、TListView 事件

（1）OnColumnClick 事件：當(dāng)用戶單擊欄的表頭時(shí),，將觸發(fā)該事件,。這樣就可以對(duì)項(xiàng)進(jìn)行排序。在OnColumnClick 事件中有一個(gè)TListColumn 類型的參數(shù)Column,，此參數(shù)返回用戶單擊的欄,，利用Column 參數(shù)可以對(duì)用戶選中的欄進(jìn)行訪問及設(shè)置。

（2）OnColumnDragged 事件：當(dāng)用戶用鼠標(biāo)左鍵拖動(dòng)某一欄到一個(gè)新的位置時(shí),，將觸發(fā)該事件,。在使用此事件之前必須將TListView 組件的FullTrag 屬性設(shè)置為True，表示可以拖動(dòng)欄的位置,，否則不能拖動(dòng),，也就不能觸發(fā)此事件。

（3）OnEdited 事件：當(dāng)用戶直接編輯修改了項(xiàng)的標(biāo)簽后,，將觸發(fā)該事件,。OnEdited 事件中有一個(gè)TListItem 類型的參數(shù)Item，利用此參數(shù)可以對(duì)用戶編輯的項(xiàng)進(jìn)行訪問,；OnEdited 事件中還有一個(gè)String 類型的參數(shù)S,，它是用戶更改項(xiàng)的標(biāo)簽后，顯示標(biāo)簽的內(nèi)容,。

（4）OnInfoTip 事件：通過這個(gè)事件可以為列表視圖中的每一項(xiàng)加上提示,。OnInfoTip 事件中有一個(gè)TListItem 類型的參數(shù)Item，利用此參數(shù)可以對(duì)用戶編輯的項(xiàng)進(jìn)行訪問,；OnInfoTip 事件中還有一個(gè)String 類型的參數(shù)InfoTip,，更改它的值就可以為每一項(xiàng)加上提示。例如將每一項(xiàng)的提示設(shè)置為項(xiàng)的標(biāo)簽內(nèi)容,，就可以在OnInfoTip 事件中添加如下代碼：InfoTip:=Item.Caption;如果要顯示提示信息,，必須將TListView 組件的ShowHind 屬性設(shè)置為True。

（5）OnSelectItem 事件：當(dāng)列表視圖中一個(gè)項(xiàng)被選擇時(shí),，將觸發(fā)這個(gè)事件,。OnSelectItem 事件中有一個(gè)TListItem 類型的參數(shù)Item，利用此參數(shù)可以對(duì)用戶編輯的項(xiàng)進(jìn)行訪問,；OnSelectItem 事件中還有一個(gè)Boolean 類型的參數(shù)Selected,。每次選擇一個(gè)新項(xiàng)時(shí)將兩次觸發(fā)此事件，一次是釋放以前被選擇的項(xiàng),，Selected 參數(shù)取值為False,，代表釋放Item 參數(shù)指定的項(xiàng)；另外一次是選擇新的項(xiàng),，Selected 參數(shù)取值為True,，代表選擇Item 參數(shù)指定的項(xiàng)。

4,、TListView 常用的方法

（1）AlphaSort 方法：此方法可以將列表視圖中的項(xiàng)按標(biāo)簽的字母順序排序,。例如使用下面的代碼就能夠?qū)istView1組件的項(xiàng)按標(biāo)簽的字母順序排序：ListView1.AlphaSort;

（2）Arrange 方法：此方法用于重排圖標(biāo),。Arrange 方法只有在ViewStyle 屬性為vsIcon 或vsSmallIcon 時(shí)才起作用。

　　Arrange 方法中有一個(gè)TListArrangement 類型的參數(shù)Code,，此參數(shù)用于指定圖標(biāo)的排列方式,，其取值及功能如下。

• 　arAlignBottom：圖標(biāo)底部對(duì)齊排列,。
• 　arAlignLeft：圖標(biāo)左側(cè)對(duì)齊排列,。
• 　arAlignRight：圖標(biāo)右側(cè)對(duì)齊排列。
• 　arAlignTop：圖標(biāo)頂部對(duì)齊排列,。
• 　arDefault：按照窗口剛建立時(shí)的風(fēng)格將圖標(biāo)從頂部排列。
• 　arSnapToGrid：將圖標(biāo)對(duì)齊到最近的網(wǎng)格,，此值不支持虛擬模式,。

（3）FindCaption 方法：此方法的調(diào)用可以搜索并返回一個(gè)TListItem 類型的項(xiàng)。FindCaption 方法中有5 個(gè)參數(shù),，功能如下,。

• 　StartIndex：Integer 類型，用于指定開始搜索的起始位置,。
• 　Value：String 類型,，指定要搜索的項(xiàng)的標(biāo)題符合的內(nèi)容。
• 　Partial：Boolean 類型,，取True 值,，查找標(biāo)題開頭為Value 參數(shù)指定的項(xiàng)；取False 值,，查找標(biāo)題與Value 參數(shù)指定的內(nèi)容相同的項(xiàng),。
• 　Inclusive：Boolean 類型，取True 值,，被StartIndex 指定的項(xiàng)是第1 個(gè)被選中的,；取False 值，開始查找的位置從StartIndex 擬定的下一個(gè)位置開始,。
• 　Warp：Boolean 類型,，取True 值，搜索將從開始找到最后,；取False 值,，搜索從StartIndex 位開始查找，找到最后,。

　　FindCaption 方法返回的是第1 個(gè)被找到的符合條件的項(xiàng),，如果沒找到符合條件的，則返回列表中的第1 項(xiàng),。

（4）Scroll 方法：此方法可以使列表視圖滾動(dòng),。Scroll 方法有兩個(gè)Integer 類型的參數(shù),。

• 　DX：控制視圖的左右一次移動(dòng)的像素?cái)?shù)，正數(shù)代表向右移動(dòng),，負(fù)數(shù)代表向左移動(dòng),。
• 　DY：控制視圖的上下一次移動(dòng)的像素?cái)?shù)，正數(shù)代表向下移動(dòng),，負(fù)數(shù)代表向上移動(dòng),。

（5）StringWidth 方法：此方法用于返回字符串的寬度。StringWidth 方法中用到一個(gè)String 類型的參數(shù)S,，StringWidth 方法是根據(jù)當(dāng)前TListView 組件的字體,、字號(hào)返回參數(shù)S 指定的字符串寬度的像素?cái)?shù)。

（6）UpdateItems 方法：此方法可以重畫指定范圍內(nèi)的項(xiàng),。UpdateItems 有兩個(gè)Integer 類型的參數(shù)：

• FirstIndex：用于指定重畫項(xiàng)的開始位置,。
• LastIndex：用于指定重畫項(xiàng)的最后位置。

創(chuàng)建時(shí)間：2020.03.20　　更新時(shí)間：