CListCtrl::SetItemState

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

リストビューコントロールのアイテムの状態を変更します。

BOOL SetItemState(
   int nItem,
   LVITEM* pItem 
);
BOOL SetItemState(
   int nItem,
   UINT nState,
   UINT nMask 
);

パラメータ

nItem
状態が設定されるアイテムのインデックス。
pItem
Windows SDK に記述されている、LVITEM 構造体のアドレス。構造体の stateMask メンバはどの状態ビットが変更されるかを指定します。構造体の state メンバはビットを変更する新しい値を保持します。ほかのメンバは無視されます。
nState
状態ビットの新しい値。
nMask
どの状態ビットを変更するかを指定するマスク。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

アイテムの "状態" は、アイテムの有効性を示すか、ユーザーの動作を示すか、またはそれ以外のアイテムの状態を反映する値です。リストビューコントロールは、ユーザーがアイテムを選択したときなどのように、いくつかの状態ビットを変更します。アプリケーションはその他の状態ビットを変更して、アイテムを無効または非表示にしたり、オーバーレイイメージや状態イメージを指定したりできます。