通过

如何使用磁贴视图

  • 项目

本主题演示如何为列表视图控件设置磁贴视图。 在磁贴视图中，每个项目都有一个大图标，并配有一行或多行文字。 有关插图，请参阅关于列表视图控件。

需要了解的事项

技术

先决条件

  • C/C++
  • Windows 用户界面编程

说明

使用 ListView_SetTileViewInfo 宏设置磁贴视图的常规显示参数。 使用传递给此宏的 LVTILEVIEWINFO 结构来指定文本相对于图标的位置、每个磁贴的大小（包括随附文本）以及文本的最大行数。

如果不想自动调整磁贴大小，则必须在 dwFlags 成员中设置 LVTVIF_FIXEDSIZE 和在 LVTILEVIEWINFO 的 dwMask 成员中设置 LVTVIM_TILESIZE，并在 sizeTile 成员中提供维度。

下面的 C++ 代码示例为列表视图控件设置了磁贴视图信息，让每个项目最多显示两个子项目。 它还可以设置每个磁贴的大小。

    SIZE size = { 100, 50 };
    LVTILEVIEWINFO tileViewInfo = {0};

    tileViewInfo.cbSize   = sizeof(tileViewInfo);
    tileViewInfo.dwFlags  = LVTVIF_FIXEDSIZE;
    tileViewInfo.dwMask   = LVTVIM_COLUMNS | LVTVIM_TILESIZE;
    tileViewInfo.cLines   = 2;
    tileViewInfo.sizeTile = size;

    ListView_SetTileViewInfo(hWndListView, &tileViewInfo);

对于列表中的每个项目，可以在项目插入列表时或稍后设置更多参数。 与 ListView_InsertItem 一起使用的 LVITEM 结构包含指定要在项目下方显示的数据列及其对齐方式的成员。 这些显示参数同样存在于与 ListView_SetTileInfo 一起使用的 LVTILEINFO 结构中。

注意

这里的“列”指的不是磁贴视图中的显示列，而是子项目，它们在详细信息视图中以列的形式显示。

 

列表视图控件参考

关于列表视图控件

使用列表视图控件