ListView_GetItem マクロ (commctrl.h)

リスト ビュー アイテムの属性の一部またはすべてを取得します。 このマクロを使用することも、 LVM_GETITEM メッセージを明示的に送信することもできます。

構文

void ListView_GetItem(
   hwnd,
   pitem
);

パラメーター

hwnd

種類: HWND

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

pitem

種類: LPLVITEM

リスト ビュー アイテムに関する情報を取得および受信する情報を指定する LVITEM 構造体へのポインター。

戻り値

なし

解説

LVM_GETITEM メッセージが送信されると、iItem メンバーと iSubItem メンバーは、情報を取得するアイテムまたはサブアイテムを識別し、mask メンバーは取得する属性を指定します。 使用可能な値の一覧については、 LVITEM 構造体の説明を参照してください。

LVIF_TEXT フラグが LVITEM 構造体のマスク メンバーに設定されている場合、pszText メンバーは有効なバッファーをポイントする必要があり、cchTextMax メンバーはそのバッファー内の文字数に設定する必要があります。 アプリケーションでは、テキストが必ずしも指定されたバッファーに配置されることを想定しないでください。 コントロールは、バッファーに配置するのではなく、新しいテキストを指すように構造体の pszText メンバーを変更できます。

mask メンバーがLVIF_STATE値を指定する場合、stateMask メンバーは取得する項目状態ビットを指定する必要があります。 出力時に、 状態 メンバーには、指定された状態ビットの値が含まれます。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	commctrl.h