次の方法で共有


List-View でグループを使用する方法

このトピックでは、グループのインスタンスを作成し、リストビュー コントロールに追加する方法について説明します。 グループ化を使用すると、水平分割とグループ タイトルを使用して、ページ上で視覚的に分割されたアイテムのグループにリストを配置できます。

知っておくべきこと

テクノロジ

前提条件

  • 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 コントロールの使用