本節為大家詳解列表檢視控制元件List Control的使用。

     列表檢視控制元件簡介

       列表檢視控制元件List Control同樣比較常見，它能夠把任何字串內容以列表的方式顯示出來，這種顯示方式的特點是整潔、直觀，在實際應用中能為使用者帶來方便。

       列表檢視控制元件是對前面講到的列表框控制元件List Box的改進和延伸。列表檢視控制元件的列表項一般有圖示（Icon）和標籤（Label）兩部分。圖示是對列表項的圖形描述，標籤是文字描述。當然列表項可以只包含圖示也可以只包含標籤。

       列表檢視控制元件有4種風格：Icon、Small Icon、List和Report。下面簡單說下4種風格各自的特點：

       Icon大圖示風格：列表項的圖示通常為32×32畫素，在圖示的下面顯示標籤。

       Small Icon小圖示風格：列表項的圖示通常為16×16畫素，在圖示的右面顯示標籤。

       List列表風格：與小圖示風格類似，圖示和文字的對齊方式不同。

       Report報表風格：列表檢視控制元件可以包含一個列表頭來描述各列的含義。每行顯示一個列表項，通常可以包含多個列表子項。最左邊的列表子項的標籤左邊可以新增一個圖示，而它右邊的所有子項則只能顯示文字。這種風格的列表檢視控制元件很適合做各種報表。

       列表檢視控制元件的通知訊息

       在

       本教程在這裡給出下一節中將要演示的列表檢視控制元件例項中，通知碼為NM_CLICK的通知訊息的訊息對映入口：

       ON_NOTIFY(NM_CLICK, IDC_PROGRAM_LANG_LIST, &CExample28Dlg::OnNMClickProgramLangList)

       還有訊息處理函式自動生成時的形式：

1. void CExample28Dlg::OnNMClickProgramLangList(NMHDR *pNMHDR, LRESULT *pResult)   
2. {   
3.     LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR);   
4. // TODO: Add your control notification handler code here 
5.     *pResult = 0;   
6. }  

       我們看到，上面的程式碼中將NMHDR指標型別的pNMHDR強制轉換為LPNMITEMACTIVATE型別的pNMItemActivate，那麼我們就可以在函式中通過pNMHDR來訪問NMHDR結構，也可以通過pNMItemActive指標變數來訪問第一個元素為NMHDR結構體變數的擴充結構。

       當然列表檢視控制元件還有一些自己特有的通知訊息，下面就介紹幾個其中比較常用的。

       LVN_ITEMCHANGING 和LVN_ITEMCHANGED：當列表檢視的狀態發生變化時，會發送這兩個通知訊息。例如，當用戶選擇了新的列表項時，程式就會收到這兩個訊息。
訊息會附帶一個指向NMLISTVIEW 結構的指標，訊息處理函式可從該結構中獲得狀態資訊。兩個訊息的不同之處在於，前者的訊息處理函式如果返回TRUE，那麼就阻
止選擇的改變，如果返回FALSE，則允許改變。

       LVN_KEYDOWN：該訊息表明了一個鍵盤事件。訊息會附帶一個指向NMLVKEYDOWN結構的指標，通過該結構程式可以獲得按鍵的資訊。

       LVN_BEGINLABELEDIT 和LVN_ENDLABELEDIT：分別在使用者開始編輯和結束編輯標題時傳送。訊息會附帶一個指向NMLVDISPINFO結構的指標。在前者的訊息處理函式中，可以呼叫GetEditControl成員函式返回一個指向用於編輯標題的編輯框的指標，如果處理函式返回FALSE，則允許編輯，如果返回TRUE，則禁止編輯。在後者的訊息處理函式中，NMLVDISPINFO結構中的item.pszText指向編輯後的新標題，如果pszText 為NULL，那麼說明使用者放棄了編輯，否則，程式應負責更新表項的標題，這可以由SetItem或SetItemText函式來完成。

       列表檢視控制元件的相關結構體

       下面我們來介紹一下與列表檢視控制元件有關的一些結構體。

       1. NMHDR結構體

1. typedefstruct tagNMHDR {   
2. HWND hwndFrom;     // 控制元件視窗的控制代碼 
3. UINT_PTR idFrom;   // 控制元件ID 
4. UINT code;         // 控制元件的通知訊息碼 
5. } NMHDR;  

        此結構體在很多情況下都是其他擴充結構體的第一個元素，比如上面的NMITEMACTIVATE結構體：

1. typedefstruct tagNMITEMACTIVATE {   
2.     NMHDR hdr;   
3. int iItem;   
4. int iSubItem;   
5. UINT uNewState;   
6. UINT uOldState;   
7. UINT uChanged;   
8.     POINT ptAction;   
9. LPARAM lParam;   
10. UINT uKeyFlags;   
11. } NMITEMACTIVATE, *LPNMITEMACTIVATE;  

       2. LVITEM 結構體

       該結構體包含了列表檢視控制元件中列表項或列表子項的各種屬性。

1. typedefstruct _LVITEM {    
2. UINT mask;           // 掩碼位的組合（下面有對應掩碼的元素都已在括號中標出掩碼），表明哪些元素是有效的 
3. int iItem;           // 列表項的索引 
4. int iSubItem;        // 列表子項的索引 
5. UINT state;          // 狀態，下面會列出。（LVIF_STATE） 
6. UINT stateMask;      // 狀態掩碼，用來說明要獲取或設定哪些狀態。下面會列出
7. LPTSTR pszText;      // 指向列表項或列表子項的標籤字串。（LVIF_TEXT）
8. int cchTextMax;      // pszText指向緩衝區的字元的個數，包括字串結束符。（LVIF_TEXT） 
9. int iImage;          // 圖示的索引。(LVIF_IMAGE) 
10. LPARAM lParam;       // 32位的附加資料。(LVIF_PARAM) 
11. #if (_WIN32_IE >= 0x0300) 
12. int iIndent;   
13. #endif 
14. #if (_WIN32_WINNT >= 0x501) 
15. int iGroupId;   
16. UINT cColumns; // tile view columns 
17. PUINT puColumns;   
18. #endif 
19. #if (_WIN32_WINNT >= 0x0600) 
20. int* piColFmt;   
21. int iGroup;   
22. #endif 
23. } LVITEM, *LPLVITEM;  

        下面是state和stateMask的取值及含義：

        狀態                     對應的狀態掩碼                   含義
        LVIS_CUT                      同左                 列表項或列表子項被選擇用來進行剪下和貼上操作
        LVIS_DROPHILITED      同左                 列表項或列表子項成為拖動操作的目標
        LVIS_FOCUSED             同左                 列表項或列表子項具有輸入焦點
        LVIS_SELECTED           同左                 列表項或列表子項被選中

        3. LVCOLUMN結構體

        該結構體僅適用於Report報表式列表檢視控制元件。在向列表控制元件中插入一列時需要用到此結構體。它包含了列表控制元件某列的各種屬性。

1. typedefstruct _LVCOLUMN {    
2. UINT mask;              // 掩碼位的組合（下面有對應掩碼的元素都已在括號中標出掩碼），表明哪些元素是有效的 
3. int fmt;                    // 該列的表頭和列表子項的標籤正文顯示格式，可以是LVCFMT_CENTER、LVCFMT_LEFT或LVCFMT_RIGHT。（LVCF_FMT） 
4. int cx;                     // 以畫素為單位的列的寬度。（LVCF_FMT） 
5. LPTSTR pszText;    // 指向列表頭標題正文的字串。（LVCF_TEXT） 
6. int cchTextMax;     // pszText指向緩衝區的字元的個數，包括字串結束符。（LVCF_TEXT） 
7. int iSubItem;          // 該列的索引。（LVCF_SUBITEM） 
8. #if (_WIN32_IE >= 0x0300) 
9. int iImage;   
10. int iOrder;   
11. #endif 
12. #if (_WIN32_WINNT >= 0x0600) 
13. int cxMin;   
14. int cxDefault;   
15. int cxIdeal;   
16. #endif 
17. } LVCOLUMN, *LPLVCOLUMN;  

       4. NMLISTVIEW結構體

       該結構體存放了列表檢視控制元件通知訊息的相關資訊。列表檢視控制元件的大部分通知訊息都會附帶指向該結構體的指標。

1. typedefstruct tagNMLISTVIEW {   
2.     NMHDR hdr;       // 標準的NMHDR 結構 
3. int iItem;       // 列表項的索引 
4. int iSubItem;    // 列表子項的索引 
5. UINT uNewState;  // 列表項或列表子項的新狀態 
6. UINT uOldState;  // 列表項或列表子項原來的狀態 
7. UINT uChanged;   // 取值與LVITEM的mask成員相同，用來表明哪些狀態發生了變化 
8.      POINT ptAction;  // 事件發生時滑鼠的客戶區座標 
9. LPARAM lParam;   //32位的附加資料 
10. } NMLISTVIEW, *LPNMLISTVIEW;  

       有關列表檢視控制元件的內容本節先講這些，下節繼續講列表控制元件類CListCtrl的一些成員函式和應用例項，歡迎繼續關注VS2013/MFC教程。