通过

如何在列表视图中使用组

  • 项目

本主题介绍如何创建组实例并将其添加到列表视图控件中。 分组让用户能够使用水平分隔线和组标题，将列表排列为可在页面上直观划分的项目组。

需要了解的事项

技术

先决条件

  • 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);

列表视图控件参考

关于列表视图控件

使用列表视图控件