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