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)