QStatusTipEvent Class

The QStatusTipEvent class provides an event that is used to show messages in a status bar. More...

Header:	`#include <QStatusTipEvent>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake:	`QT += gui`
Inherits:	QEvent

List of all members, including inherited members
QStatusTipEvent is part of Event Classes and Help System.

Public Functions

	QStatusTipEvent(const QString &tip)
QString	tip() const

Protected Functions

	QStatusTipEvent(QStatusTipEvent &&)
QStatusTipEvent &	operator=(QStatusTipEvent &&)
QStatusTipEvent &	operator=(const QStatusTipEvent &other)

Detailed Description

Status tips can be set on a widget using the QWidget::setStatusTip() function. They are shown in the status bar when the mouse cursor enters the widget. For example:

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    QWidget *myWidget = new QWidget;
    myWidget->setStatusTip(tr("This is my widget."));

    setCentralWidget(myWidget);
    ...
}

Status tips can also be set on actions using the QAction::setStatusTip() function:

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    QMenu *fileMenu = menuBar()->addMenu(tr("File"));

    QAction *newAct = new QAction(tr("&New"), this);
    newAct->setStatusTip(tr("Create a new file."));
    fileMenu->addAction(newAct);
    ...
}

Action with status tip.

Finally, status tips are supported for the item view classes through the Qt::StatusTipRole enum value.

See also QStatusBar, QHelpEvent, and QWhatsThisClickedEvent.

Member Function Documentation

`[explicit]` QStatusTipEvent::QStatusTipEvent(const QString &tip)

Constructs a status tip event with the text specified by tip.

See also tip().

`[protected delete]` QStatusTipEvent::QStatusTipEvent(QStatusTipEvent &&)

Move-constructs an instance of QStatusTipEvent. This function is deleted.

QString QStatusTipEvent::tip() const

Returns the message to show in the status bar.

See also QStatusBar::showMessage().

`[protected delete]` QStatusTipEvent &QStatusTipEvent::operator=(QStatusTipEvent &&)

Move-assigns other to this QStatusTipEvent instance. This function is deleted.

`[noexcept protected default]` QStatusTipEvent &QStatusTipEvent::operator=(const QStatusTipEvent &other)

Copy-assigns other to this QStatusTipEvent instance.

© 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.