次の方法で共有


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 の構造体のアドレス。構造体の iItemiSubItem のメンバーは、項目またはサブ項目を識別し、設定する属性の mask 構造体のメンバーを指定します。mask のメンバーの詳細については、**[コメント]**を参照してください。

  • nItem
    属性が設定されている項目のインデックス。

  • nSubItem
    属性が設定されるサブ項目のインデックス。

  • nMask
    すべての属性を設定する必要があるかを指定します。"解説"を参照してください。

  • lpszItem
    項目のラベルを指定する NULL で終わる文字列のアドレス。

  • nImage
    イメージ リスト内の項目のイメージのインデックス。

  • nState
    変更する状態の値を指定します。"解説"を参照)。

  • nStateMask
    どの状態が変化するか指定します ("解説"を参照)。

  • lParam
    項目に関連付けられる 32 ビット アプリケーション固有の値。

  • nIndent
    インデントの幅 (ピクセル単位)。nIndent がシステム定義の最小幅よりも小さい場合、新しい幅、システム定義の最小値に設定されます

戻り値

成功した場合は; それ以外の場合は。

解説

LVITEM の構造と nItem と nSubItem のパラメーターの iItemiSubItem のメンバーは、属性が設定されるサブ項目と項目を識別します。

どの項目の属性を設定する必要があるか LVITEM の構造体の mask のメンバーと nMask のパラメーターに指定します:

  • LVIF_TEXTpszText のメンバー、またはパラメーター lpszItem の null で終わる文字列のアドレスです; cchTextMax のメンバーは無視されます。

  • LVIF_STATE は nStateMask の stateMask のメンバー、またはパラメーターを変更する項目の状態と nState の state のメンバーまたはパラメーターがそれらの状態の値を含むかを指定します。

使用例

CListCtrl::HitTestの例を参照してください。

必要条件

ヘッダー: afxcmn.h

参照

関連項目

CListCtrl クラス

階層図

CListCtrl::GetItem