TTM_SETTOOLINFO メッセージ

  • [アーティクル]

ツールに対してツールヒント コントロールが保持する情報を設定します。

パラメーター

wParam

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

lParam

設定する情報を指定する TOOLINFO 構造体へのポインター。 この構造体の cbSize メンバーは、このメッセージを送信する前に設定する必要があります。

戻り値

戻り値はありません。

解説

ツールの内部プロパティの一部は、ツールの作成時に確立され、 TTM_SETTOOLINFO メッセージが送信されたときに再計算されません。 値を TOOLINFO 構造体に割り当てて、TTM_SETTOOLINFO メッセージを含むツールヒント コントロールに渡すだけで、これらのプロパティが失われる可能性があります。 代わりに、アプリケーションはまず、ツールヒント コントロールにTTM_GETTOOLINFO メッセージを送信して、ツールの現在の TOOLINFO 構造を要求する必要があります。 次に、必要に応じてこの構造体のメンバーを変更し、 TTM_SETTOOLINFOを使用してツールヒント コントロールに渡します。

TTM_SETTOOLINFOを呼び出すとき、TOOLINFO 構造体の lpszText メンバーが指す文字列は、終端の NULL を含め、80 TCHAR を超えることはできません。

要件

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