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 |