HDM_GETITEM メッセージ

  • [アーティクル]

ヘッダー コントロール内の項目に関する情報を取得します。 このメッセージは、明示的に送信することも、 Header_GetItem マクロを使用することもできます。

パラメーター

wParam

情報を取得するアイテムのインデックス。

lParam

HDITEM 構造体へのポインター。 メッセージが送信されると、 マスク メンバーは要求される情報の種類を示します。 メッセージが返されると、他のメンバーは要求された情報を受け取ります。 マスク メンバーが 0 を指定した場合、メッセージは TRUE を返しますが、構造体に情報をコピーしません。

戻り値

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

解説

HDITEM 構造体のマスク メンバーに HDI_TEXT フラグが設定されている場合、コントロールは、要求されたテキストでバッファーを埋めるのではなく、新しいテキストを指すように構造体の pszText メンバーを変更できます。 アプリケーションでは、テキストが常に要求されたバッファーに配置されることを想定しないでください。

必要条件

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