IResultData::ModifyItemState メソッド (mmc.h)

IResultData::ModifyItemState メソッドを使用すると、スナップインでアイテムの状態を変更できます。

構文

HRESULT ModifyItemState(
  [in] int         nIndex,
  [in] HRESULTITEM itemID,
  [in] UINT        uAdd,
  [in] UINT        uRemove
);

[in] nIndex

状態が変更されるアイテムのインデックスを示す値です。このパラメーターは、itemID パラメーターが 0 の場合にのみ使用されます。仮想リストに適用する場合は、nIndex を使用し、itemID を 0 に設定する必要があります。

[in] itemID

状態が変更されるアイテムの一意識別子。仮想リストに適用する場合は、itemID = 0 を設定します。

[in] uAdd

設定できる Windows リストビューの状態フラグを指定する値。仮想リストに適用すると、フォーカスと選択状態のみを変更できます。この値には、次の任意の有効な組み合わせを指定できます。

項目は、切り取りと貼り付けの操作でマークされます。

項目はドラッグアンドドロップターゲットとして強調表示されます。

項目にはフォーカスがあるため、標準のフォーカス四角形で囲まれています。複数の項目を選択できますが、フォーカスを持つことは 1 つの項目だけです。

項目が選択されています。選択した項目の外観は、フォーカスがあるかどうかと、選択に使用されるシステムの色によって異なります。

[in] uRemove

削除できるリストビュー項目の状態フラグを示す値です。この値には、uAdd パラメーターに対して表示される上記の Win32 LVIS_* フラグの任意の有効な組み合わせを指定できます。

このメソッドは、これらの値のいずれかを返すことができます。