TBSTYLE_TOOLTIPS スタイルを指定すると、ツール バーによってツール ヒント コントロールが作成および管理されます。 ツール ヒントは、ツール バー ボタンを説明するテキスト行を含む小さなポップアップ ウィンドウです。 ツール ヒントは非表示になり、ユーザーがツール バー ボタンにカーソルを置き、約 5 分の 1 秒だけそこに残っている場合にのみ表示されます。 カーソルの近くにツール ヒントが表示されます。
ツール ヒントが表示される前に、 TTN_NEEDTEXT 通知メッセージがツール バーの所有者ウィンドウに送信され、ボタンの説明テキストが取得されます。 ツール バーの所有者ウィンドウが CFrameWnd ウィンドウの場合、 CFrameWnd には TTN_NEEDTEXT通知の 既定のハンドラーがあるため、追加の作業なしでツール ヒントが表示されます。 ツールバーの所有者ウィンドウがダイアログ ボックスやフォーム ビューなどの CFrameWndから派生していない場合は、所有者ウィンドウのメッセージ マップにエントリを追加し、メッセージ マップに通知ハンドラーを指定する必要があります。 所有者ウィンドウのメッセージ マップへのエントリは次のとおりです。
ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
注釈
memberFxn
このボタンにテキストが必要な場合に呼び出されるメンバー関数。
ツール ヒントの ID は常に 0 であることに注意してください。
ツール ヒント コントロールは、 TTN_NEEDTEXT 通知に加えて、ツール バー コントロールに次の通知を送信できます。
| 通知 | 意味 |
|---|---|
| TTN_NEEDTEXTA | ツール ヒント コントロールには ASCII テキストが必要です (Windows 95 のみ) |
| TTN_NEEDTEXTW | ツール ヒント コントロールには UNICODE テキストが必要です (Windows NT のみ) |
| TBN_HOTITEMCHANGE | ホット (強調表示) 項目が変更されたことを示します。 |
| NM_RCLICK | ユーザーがボタンを右クリックしたことを示します。 |
| TBN_DRAGOUT | ユーザーがボタンをクリックし、ポインターをボタンの外にドラッグしたことを示します。 これにより、アプリケーションはツール バー ボタンからドラッグ アンド ドロップを実装できます。 この通知を受信すると、アプリケーションはドラッグ アンド ドロップ操作を開始します。 |
| TBN_DROPDOWN | ユーザーが TBSTYLE_DROPDOWN スタイルを使用するボタンをクリックしたことを示します。 |
| TBN_GETOBJECT | ユーザーが TBSTYLE_DROPPABLE スタイルを 使用するボタンの上にポインターを移動したことを示します。 |
ハンドラー関数の例とツール ヒントの有効化の詳細については、「 ツール ヒント」を参照してください。