![]() |
Home · Overviews · Examples |
The QToolTip class provides tool tips (balloon help) for any widget. More...
The QToolTip class provides tool tips (balloon help) for any widget.
The tip is a short piece of text reminding the user of the widget's function. It is drawn immediately below the given position in a distinctive black-on-yellow color combination. The tip can be any rich text formatted string.
Rich text displayed in a tool tip is implicitly word-wrapped unless specified differently with <p style='white-space:pre'>.
The simplest and most common way to set a widget's tool tip is by calling its QWidget::setToolTip() function.
It is also possible to show different tool tips for different regions of a widget, by using a QHelpEvent of type QEvent::ToolTip. Intercept the help event in your widget's event() function and call QToolTip::showText() with the text you want to display. The Tooltips example illustrates this technique.
Note that, if you want to show tooltips in an item view, the model/view architecture provides functionality to set an item's tool tip; e.g., the QTableWidgetItem::setToolTip() function. However, if you want to provide custom tool tips in an item view, you must intercept the help event in the QAbstractItemView::viewportEvent() function and handle it yourself.
The default tool tip color and font can be customized with setPalette and setFont.
See also QWidget::toolTip, QAction::toolTip, and Tool Tips Example.
Copyright © 2007 Trolltech | Trademarks | Qt Jambi 4.3.2_01 |