LVM_GETITEM メッセージ

  • [アーティクル]

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

パラメーター

wParam

ゼロを指定してください。

lParam

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

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

解説

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

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

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

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Commctrl.h
Unicode 名と ANSI 名
 LVM_GETITEMW (Unicode) と LVM_GETITEMA (ANSI)