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