TTM_SETTITLE メッセージ

標準のアイコンとタイトル文字列をヒントに追加します。

パラメーター

wParam

wParam を次のいずれかの値に設定して、表示するアイコンを指定します。 Windows Vista 以降では、このパラメーターには HICON 値を含めることもできます。 TTI_ERROR_LARGEより大きい値はすべて HICON と見なされます。

値	意味
TTI_NONE	アイコンなし。
TTI_INFO	情報アイコン。
TTI_WARNING	警告アイコン
TTI_ERROR	エラー アイコン
TTI_INFO_LARGE	大きなエラー アイコン
TTI_WARNING_LARGE	大きなエラー アイコン
TTI_ERROR_LARGE	大きなエラー アイコン

lParam

タイトル文字列へのポインター。 lParam に値を割り当てる必要があります。

戻り値

成功した場合は TRUE 、そうでない場合は FALSE を 返します。

注釈

ヒントのタイトルは、テキストの上に別のフォントで表示されます。 タイトルを持つだけでは十分ではありません。ツールヒントにもテキストが含まれている必要があります。または、表示されません。

wParam に HICON が含まれている場合は、ヒント ウィンドウによってアイコンのコピーが作成されます。

TTM_SETTITLEを呼び出すとき、lParam が指す文字列の長さは、終端の NULL を含めて 100 TCHAR を超えることはできません。

例

次の例は、タイトルとシステム アイコンをツールヒントに追加する方法を示しています。

// hwndTip is the handle of the tooltip window.
HICON hIcon = LoadIcon(NULL, IDI_INFORMATION);
SendMessage(hwndTip, TTM_SETTITLE, (WPARAM)hIcon, L"Title text");
DestroyIcon(hIcon);

必要条件

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

こちらもご覧ください

ツールヒント コントロールについて