リスト コントロール (CListCtrl) に項目を追加するには、持っている情報に応じて、複数のバージョンの InsertItem メンバー関数のいずれかを呼び出します。 あるバージョンは、あなたが準備した LVITEM 構造体を受け取ります。
LVITEM構造体には多数のメンバーが含まれているため、リスト コントロール項目の属性をより大きく制御できます。
LVITEM構造の 2 つの重要なメンバー (レポート ビューに関して) は、iItemメンバーと iSubItem メンバーです。
iItem メンバーは、構造体が参照している項目の 0 から始まるインデックスで、iSubItem メンバーはサブ項目の 1 から始まるインデックスです。構造体に項目に関する情報が含まれている場合は 0 です。 これら 2 つのメンバーを使用して、リスト コントロールがレポート ビューにあるときに表示されるサブ項目情報の種類と値を、アイテムごとに決定します。 詳細については、「 CListCtrl::SetItem」を参照してください。
追加のメンバーは、アイテムのテキスト、アイコン、状態、および項目データを指定します。 "項目データ" は、リスト ビューアイテムに関連付けられたアプリケーション定義の値です。
LVITEM構造体の詳細については、「CListCtrl::GetItem」を参照してください。
他のバージョンの InsertItem は、 LVITEM 構造体のメンバーに対応する 1 つ以上の個別の値を受け取り、サポートするメンバーのみを初期化できます。 一般に、リスト コントロールはリスト アイテムのストレージを管理しますが、代わりに "コールバック項目" を使用して、一部の情報をアプリケーションに格納できます。詳細については、このトピックの コールバック項目とコールバック マスク 、および Windows SDK の コールバック項目とコールバック マスク を参照してください。
詳細については、「 List-View 項目およびサブ項目の追加」を参照してください。