Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

QToolTip Class

Die Klasse „QToolTip“ stellt Tooltips (Hilfe-Sprechblasen) für beliebige Widgets bereit. Mehr...

Header: #include <QToolTip>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Statische öffentliche Mitglieder

QFont font()
void hideText()
bool isVisible()
QPalette palette()
void setFont(const QFont &font)
void setPalette(const QPalette &palette)
void showText(const QPoint &pos, const QString &text, QWidget *w = nullptr, const QRect &rect = {}, int msecDisplayTime = -1)
QString text()

Ausführliche Beschreibung

Der Tooltip ist ein kurzer Text, der den Benutzer an die Funktion des Widgets erinnert. Er wird unmittelbar unterhalb der angegebenen Position in einer auffälligen Farbkombination aus Schwarz auf Gelb angezeigt. Der Tooltip kann eine beliebige, mit rich text formatierte Zeichenkette sein.

In einem Tooltip angezeigter Rich-Text wird implizit umgebrochen, sofern nicht anders mit ` <p style='white-space:pre'>` festgelegt.

UI-Elemente, die über ` QAction ` erstellt werden, verwenden die Eigenschaft `tooltip` des ` QAction`. Daher ist für die meisten interaktiven UI-Elemente die Festlegung dieser Eigenschaft der einfachste Weg, Tooltips bereitzustellen.

QAction *openAction = new QAction(tr("&Open..."));
openAction->setToolTip(tr("Open an existing file"));

fileMenu = menuBar()->addMenu(tr("&File"));
fileToolBar = addToolBar(tr("&File"));

fileMenu->addAction(openAction);
fileToolBar->addAction(openAction);

Bei allen anderen Widgets ist der einfachste und gängigste Weg, den Tooltip eines Widgets festzulegen, der Aufruf seiner Funktion ` QWidget::setToolTip()`.

searchBar = new SearchBar;
searchBar->setToolTip(tr("Search in the current document"));

Es ist auch möglich, für verschiedene Bereiche eines Widgets unterschiedliche Tooltips anzuzeigen, indem Sie eine ` QHelpEvent ` vom Typ ` QEvent::ToolTip` verwenden. Fangen Sie das `help`-Ereignis in der Funktion ` event()` Ihres Widgets ab und rufen Sie ` QToolTip::showText()` mit dem Text auf, den Sie anzeigen möchten.

bool Window::event(QEvent *event)
{
    if (event->type() == QEvent::ToolTip) {
        auto *helpEvent = static_cast<QHelpEvent *>(event);
        if (Element *element = elementAt(helpEvent->pos())) {
            QToolTip::showText(helpEvent->globalPos(), element->toolTip(), this);
        } else {
            QToolTip::hideText();
            event->ignore();
        }

        return true;
    }
    return QWidget::event(event);
}

Wenn Sie ` QToolTip::hideText()` oder ` QToolTip::showText()` mit einer leeren Zeichenkette aufrufen – beispielsweise als Folge eines ` ToolTip`-Ereignisses –, sollten Sie zusätzlich ` ignore()` für dieses Ereignis aufrufen, um zu signalisieren, dass Sie keine Tooltip-spezifischen Modi starten möchten.

Beachten Sie, dass die Model-View-Architektur Funktionen zum Festlegen des Tooltips eines Elements bereitstellt, wenn Sie Tooltips in einer Elementansicht anzeigen möchten; z. B. die Funktion ` QTableWidgetItem::setToolTip()`. Wenn Sie jedoch benutzerdefinierte Tooltips in einer Elementansicht bereitstellen möchten, müssen Sie das Hilfe-Ereignis in der Funktion ` QAbstractItemView::viewportEvent()` abfangen und selbst verarbeiten.

Die Standardfarbe und -schriftart von Tooltips können mit ` setPalette()` und ` setFont()` angepasst werden. Wenn gerade ein Tooltip angezeigt wird, gibt ` isVisible()` den Wert ` true ` und ` text()` den aktuell sichtbaren Text zurück.

Hinweis: Tooltips verwenden die inaktive Farbgruppe von QPalette, da Tooltips keine aktiven Fenster sind.

Siehe auch QWidget::toolTip und QAction::toolTip.

Dokumentation zu Mitgliedsfunktionen

[static] QFont QToolTip::font()

Gibt die Schriftart zurück, die zum Darstellen von Tooltips verwendet wird.

Siehe auch ` setFont()`.

[static] void QToolTip::hideText()

Blendet den Tooltip aus. Dies entspricht dem Aufruf von ` showText()` mit einer leeren Zeichenkette.

Siehe auch ` showText()`.

[static] bool QToolTip::isVisible()

Gibt „ true “ zurück, wenn derzeit ein Tooltip angezeigt wird.

Siehe auch showText().

[static] QPalette QToolTip::palette()

Gibt die Palette zurück, die zum Rendern von Tooltips verwendet wird.

Hinweis: Tooltips verwenden die inaktive Farbgruppe von ` QPalette`, da Tooltips keine aktiven Fenster sind.

Siehe auch ` setPalette()`

[static] void QToolTip::setFont(const QFont &font)

Legt das „ font “ fest, das zum Darstellen von Tooltips verwendet wird.

Siehe auch font().

[static] void QToolTip::setPalette(const QPalette &palette)

Legt die „ palette “ fest, die zum Darstellen von Tooltips verwendet wird.

Hinweis: Tooltips verwenden die inaktive Farbgruppe von ` QPalette`, da Tooltips keine aktiven Fenster sind.

Siehe auch ` palette()`.

[static] void QToolTip::showText(const QPoint &pos, const QString &text, QWidget *w = nullptr, const QRect &rect = {}, int msecDisplayTime = -1)

Zeigt „ text “ als Tooltip an, wobei die globale Position pos als Bezugspunkt dient. Der Tooltip wird mit einem plattformspezifischen Versatz zu diesem Bezugspunkt angezeigt.

Wenn Sie ein nicht leeres Rechteck angeben, wird der Tooltip ausgeblendet, sobald Sie den Mauszeiger aus diesem Bereich bewegen.

rect gibt die Koordinaten des Widgets an, das Sie mit w angeben. Wenn rect nicht leer ist, müssen Sie ein Widget angeben. Andernfalls kann dieses Argument den Wert nullptr annehmen, wird jedoch auf Multi-Head-Systemen zur Bestimmung des entsprechenden Bildschirms verwendet.

Der Parameter „ msecDisplayTime “ gibt an, wie lange der Tooltip in Millisekunden angezeigt wird. Bei dem Standardwert -1 richtet sich die Dauer nach der Länge des Textes.

Ist „ text “ leer, wird der Tooltip ausgeblendet. Stimmt der Text mit dem aktuell angezeigten Tooltip überein, wird der Tooltip nicht verschoben. Sie können eine Verschiebung erzwingen, indem Sie den Tooltip zunächst mit einem leeren Text ausblenden und anschließend den neuen Tooltip an der neuen Position anzeigen.

[static] QString QToolTip::text()

Gibt den Tooltip-Text zurück, sofern ein Tooltip sichtbar ist, oder eine leere Zeichenkette, wenn kein Tooltip sichtbar ist.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.