Freigeben über


Handhabung von Tooltip-Benachrichtigungen

Wenn Sie den Stil TBSTYLE_TOOLTIPS angeben, erstellt und steuert die Toolbar ein Tooltip-Steuerelement. Ein Tooltip ist ein kleines Popup-Fenster, das eine Textzeile zur Beschreibung einer Schaltfläche der Symbolleiste enthält. Der Tooltip ist verborgen und erscheint nur, wenn der Benutzer den Cursor auf eine Schaltfläche der Symbolleiste setzt und ihn dort etwa eine halbe Sekunde lang stehen lässt. Der Tooltip wird in der Nähe des Mauszeigers angezeigt.

Bevor der Tooltip angezeigt wird, wird die Nachricht TTN_NEEDTEXT an das Besitzerfenster der Symbolleiste gesendet, um den beschreibenden Text für die Schaltfläche abzurufen. Wenn das Besitzerfenster der Symbolleiste ein CFrameWnd Fenster ist, werden die Tooltips ohne Aufwand angezeigt, da CFrameWnd einen Standardhandler für die TTN_NEEDTEXT-Benachrichtigung hat. Wenn das Besitzerfenster der Symbolleiste nicht von CFrameWnd abgeleitet ist, wie z. B. ein Dialogfenster oder eine Formularansicht, müssen Sie einen Eintrag in die Message-Map Ihres Besitzerfensters einfügen und einen Handler für die Benachrichtigung in der Message-Map bereitstellen. Der Eintrag in der Message-Map Ihres Besitzerfensters lautet wie folgt:

ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)

Bemerkungen

memberFxn
Die Member-Funktion, die aufgerufen wird, wenn ein Text für diese Schaltfläche angefordert wird.

Beachten Sie, dass die Kennung eines Tooltips immer 0 ist.

Zusätzlich zur TTN_NEEDTEXT-Benachrichtigung kann ein Toolleisten-Steuerelement die folgenden Benachrichtigungen an ein Symbolleisten-Steuerelement senden:

Benachrichtigung Bedeutung
TTN_NEEDTEXTA Das Tooltip-Steuerelement erfordert ASCII-Text (nur unter Windows 95)
TTN_NEEDTEXTW Tooltip-Steuerelement benötigt UNICODE-Text (nur Windows NT)
TBN_HOTITEMCHANGE Gibt an, dass sich das heiße (hervorgehobene) Element geändert hat.
NM_RCLICK Gibt an, dass der Benutzer mit der rechten Maustaste auf eine Schaltfläche geklickt hat.
TBN_DRAGOUT Gibt an, dass der Benutzer auf die Schaltfläche geklickt und den Mauszeiger aus der Schaltfläche gezogen hat. Es bietet einer Anwendung die Möglichkeit, Drag & Drop von einer Schaltfläche der Symbolleiste aus zu implementieren. Beim Empfang dieser Benachrichtigung beginnt die Anwendung die Drag-and-Drop-Operation.
TBN_DROPDOWN Gibt an, dass der Benutzer auf eine Schaltfläche geklickt hat, die die TBSTYLE_DROPDOWN Formatvorlage verwendet.
TBN_GETOBJECT Gibt an, dass der Benutzer den Mauszeiger über eine Schaltfläche verschoben hat, die die TBSTYLE_DROPPABLE Formatvorlage verwendet.

Ein Beispiel für eine Handler-Funktion und weitere Informationen zur Aktivierung von Tooltips finden Sie unter Tool Tips.

Siehe auch

Verwenden von CToolBarCtrl
Steuerung