Home · Overviews · Examples 

QStatusTipEvent Class Reference
[com.trolltech.qt.gui module]

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

Inherits QEvent.


Detailed Description

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

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);
        ...
    }

Widget with status tip.

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.


Copyright © 2008 Trolltech Trademarks
Qt Jambi 4.3.4_01