如何在 List-View 中使用群組

本主題描述如何建立群組的實例，並將其新增至清單檢視控件。 群組功能可讓使用者將清單排列成群組，這些群組在頁面上透過水準分隔線和群組標題進行視覺上的劃分。

您需要知道的事項

技術

• Windows 控制項

先決條件

• C/C++
• Windows 使用者介面程序設計

指示

若要在清單檢視控件中使用群組，請確定控件包含 LVS_ALIGNTOP 視窗樣式。

當您將專案新增至清單中時，您透過將專案的 LVITEM 結構中的 iGroupId 成員設定為群組 LVGROUP 結構中的 iGroupId 成員的值來將其分配到一個群組。 啟用群組檢視時，未指派給群組的專案不會出現在清單中。 若要啟用或停用群組檢視，請使用 ListView_EnableGroupView 巨集。

下列範例示範如何使用標頭建立群組，並將其新增至清單檢視控件。

    LVGROUP group;

    group.cbSize    = sizeof(LVGROUP);
    group.mask      = LVGF_HEADER | LVGF_GROUPID;
    group.pszHeader = TEXT("Dogs");
    group.iGroupId  = 1;

    ListView_InsertGroup(hWndListView, -1, &group);

相關主題

List-View 控件參考

關於 List-View 控件

使用 List-View 控件