ListView_GetItemState マクロ (commctrl.h)

リスト ビュー項目の状態を取得します。 このマクロを使用することも、LVM_GETITEMSTATE メッセージを明示的に送信することもできます。

構文

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

パラメーター

hwndLV

型: HWND

リスト ビュー コントロールのハンドル。

i

型: int

リスト ビュー項目のインデックス。

mask

型: UINT

取得する状態情報。 このパラメーターには、次の値を組み合わせて使用できます。

価値 意味
LVIS_CUT
この項目は、切り取りと貼り付けの操作としてマークされます。
LVIS_DROPHILITED
項目はドラッグ アンド ドロップ ターゲットとして強調表示されます。
LVIS_FOCUSED
項目にはフォーカスがあるため、標準のフォーカス四角形で囲まれています。 複数の項目を選択できますが、フォーカスを持つことは 1 つの項目だけです。
LVIS_SELECTED
項目が選択されています。 選択した項目の外観は、フォーカスがあるかどうかと、選択に使用されるシステムの色によって異なります。
LVIS_OVERLAYMASK
このマスクを使用して、項目のオーバーレイ 画像インデックスを取得します。
LVIS_STATEIMAGEMASK
このマスクを使用して、項目の状態イメージ インデックスを取得します。

戻り値

型: UINT

指定した項目の現在の状態を返します。 戻り値の有効なビットは、mask パラメーターで設定されたビットに対応するビットだけです。

備考

項目の状態情報には、一連のビット フラグと、アイテムの状態イメージとオーバーレイ イメージを示すイメージ リスト インデックスが含まれます。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h

関連項目

ListView_SetItemState