CListCtrl::SetItem
リスト ビューの項目の属性の一部またはすべてを設定します。
BOOL SetItem(
const LVITEM* pItem
);
BOOL SetItem(
int nItem,
int nSubItem,
UINT nMask,
LPCTSTR lpszItem,
int nImage,
UINT nState,
UINT nStateMask,
LPARAM lParam
);
BOOL SetItem(
int nItem,
int nSubItem,
UINT nMask,
LPCTSTR lpszItem,
int nImage,
UINT nState,
UINT nStateMask,
LPARAM lParam,
int nIndent
);
パラメーター
pItem
新しいアイテムの属性を含む Windows SDKに説明されているように LVITEM の構造体のアドレス。構造体の iItem と iSubItem のメンバーは、項目またはサブ項目を識別し、設定する属性の mask 構造体のメンバーを指定します。mask のメンバーの詳細については、**[コメント]**を参照してください。nItem
属性が設定されている項目のインデックス。nSubItem
属性が設定されるサブ項目のインデックス。nMask
すべての属性を設定する必要があるかを指定します。"解説"を参照してください。lpszItem
項目のラベルを指定する NULL で終わる文字列のアドレス。nImage
イメージ リスト内の項目のイメージのインデックス。nState
変更する状態の値を指定します。"解説"を参照)。nStateMask
どの状態が変化するか指定します ("解説"を参照)。lParam
項目に関連付けられる 32 ビット アプリケーション固有の値。nIndent
インデントの幅 (ピクセル単位)。nIndent がシステム定義の最小幅よりも小さい場合、新しい幅、システム定義の最小値に設定されます
戻り値
成功した場合は; それ以外の場合は。
解説
LVITEM の構造と nItem と nSubItem のパラメーターの iItem と iSubItem のメンバーは、属性が設定されるサブ項目と項目を識別します。
どの項目の属性を設定する必要があるか LVITEM の構造体の mask のメンバーと nMask のパラメーターに指定します:
LVIF_TEXT は pszText のメンバー、またはパラメーター lpszItem の null で終わる文字列のアドレスです; cchTextMax のメンバーは無視されます。
LVIF_STATE は nStateMask の stateMask のメンバー、またはパラメーターを変更する項目の状態と nState の state のメンバーまたはパラメーターがそれらの状態の値を含むかを指定します。
使用例
CListCtrl::HitTestの例を参照してください。
必要条件
ヘッダー: afxcmn.h