ListView_SetItemCountEx マクロ (commctrl.h)

  • [アーティクル]

仮想 リスト ビュー内の項目の仮想数を設定します。 このマクロを使用することも、 LVM_SETITEMCOUNT メッセージを明示的に送信することもできます。

構文

void ListView_SetItemCountEx(
   hwndLV,
   cItems,
   dwFlags
);

パラメーター

hwndLV

種類: HWND

仮想リスト ビュー コントロールへのハンドル。

cItems

型: int

リスト ビュー コントロールに含まれる項目の数。

dwFlags

型: DWORD

項目数をリセットした後のリスト ビュー コントロールの動作を指定する値。 この値には、次の組み合わせを指定できます。

値 意味
LVSICF_NOINVALIDATEALL
 リスト ビュー コントロールは、影響を受ける項目が現在表示されている場合を除き、再描画されません。
LVSICF_NOSCROLL
 リスト ビュー コントロールは、アイテム数が変更されたときにスクロール位置を変更しません。

戻り値

なし

解説

このマクロは、LVS_OWNERDATAおよびLVS_REPORTまたはLVS_LISTスタイルを使用するリスト ビュー コントロールのみを対象としています。

リスト ビュー コントロールが LVS_OWNERDATA スタイルで作成された場合、このマクロはコントロールに含まれる項目の仮想数を設定します。

リスト ビュー コントロールが LVS_OWNERDATA スタイルなしで作成された場合は、 ListView_SetItemCount マクロを使用する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h