|
Home · All Classes · Main Classes · Grouped Classes · Modules · Functions | |
The QStatusBar class provides a horizontal bar suitable for presenting status information. More...
#include <QStatusBar>
Inherits QWidget.
The QStatusBar class provides a horizontal bar suitable for presenting status information.
Each status indicator falls into one of three categories:
QStatusBar lets you display all three types of indicators.
Typically, a request for the status bar functionality occurs in relation to a QMainWindow object. QMainWindow provides a main application window, with a menu bar, tool bars, dock widgets and a status bar around a large central widget. The status bar can be retrieved using the QMainWindow::statusBar() function, and replaced using the QMainWindow::setStatusBar() function.
Use the showMessage() slot to display a temporary message:
void MainWindow::createStatusBar()
{
statusBar()->showMessage(tr("Ready"));
}
To remove a temporary message, use the clearMessage() slot, or set a time limit when calling showMessage(). For example:
void MainWindow::print()
{
QTextDocument *document = textEdit->document();
QPrinter printer;
QPrintDialog *dlg = new QPrintDialog(&printer, this);
if (dlg->exec() != QDialog::Accepted)
return;
document->print(&printer);
statusBar()->showMessage(tr("Ready"), 2000);
}
Use the currentMessage() function to retrieve the temporary message currently shown. The QStatusBar class also provide the messageChanged() signal which is emitted whenever the temporary status message changes.
Normal and Permanent messages are displayed by creating a small widget (QLabel, QProgressBar or even QToolButton) and then adding it to the status bar using the addWidget() or the addPermanentWidget() function. Use the removeWidget() function to remove such messages from the status bar.
statusBar()->addWidget(new MyReadWriteIndication);
By default QStatusBar provides a QSizeGrip in the lower-right corner. You can disable it using the setSizeGripEnabled() function. Use the isSizeGripEnabled() function to determine the current status of the size grip.
See also QMainWindow, QStatusTipEvent, GUI Design Handbook: Status Bar, and Application Example.
This property holds whether the QSizeGrip in the bottom-right corner of the status bar is enabled.
The size grip is enabled by default.
Access functions:
Constructs a status bar with a size grip and the given parent.
See also setSizeGripEnabled().
Destroys this status bar and frees any allocated resources and child widgets.
Adds the given widget permanently to this status bar, reparenting the widget if it isn't already a child of this QStatusBar object. The stretch parameter is used to compute a suitable size for the given widget as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.
Permanently means that the widget may not be obscured by temporary messages. It is is located at the far right of the status bar.
See also insertPermanentWidget(), removeWidget(), and addWidget().
Adds the given widget to this status bar, reparenting the widget if it isn't already a child of this QStatusBar object. The stretch parameter is used to compute a suitable size for the given widget as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.
The widget is located to the far left of the first permanent widget (see addPermanentWidget()) and may be obscured by temporary messages.
See also insertWidget(), removeWidget(), and addPermanentWidget().
Removes any temporary message being shown.
See also currentMessage(), showMessage(), and removeWidget().
Returns the temporary message currently shown, or an empty string if there is no such message.
See also showMessage().
Ensures that the right widgets are visible.
Used by the showMessage() and clearMessage() functions.
Inserts the given widget at the given index permanently to this status bar, reparenting the widget if it isn't already a child of this QStatusBar object. If index is out of range, the widget is appended (in which case it is the actual index of the widget that is returned).
The stretch parameter is used to compute a suitable size for the given widget as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.
Permanently means that the widget may not be obscured by temporary messages. It is is located at the far right of the status bar.
This function was introduced in Qt 4.2.
See also addPermanentWidget(), removeWidget(), and addWidget().
Inserts the given widget at the given index to this status bar, reparenting the widget if it isn't already a child of this QStatusBar object. If index is out of range, the widget is appended (in which case it is the actual index of the widget that is returned).
The stretch parameter is used to compute a suitable size for the given widget as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.
The widget is located to the far left of the first permanent widget (see addPermanentWidget()) and may be obscured by temporary messages.
This function was introduced in Qt 4.2.
See also addWidget(), removeWidget(), and addPermanentWidget().
This signal is emitted whenever the temporary status message changes. The new temporary message is passed in the message parameter which is a null-string when the message has been removed.
See also showMessage() and clearMessage().
Changes the status bar's appearance to account for item changes.
Special subclasses may need this function, but geometry management will usually take care of any necessary rearrangements.
Removes the specified widget from the status bar (without deleting it).
See also addWidget(), addPermanentWidget(), and clearMessage().
Hides the normal status indications and displays the given message for the specified timeout milli-seconds (if non-zero), or until clearMessage() or another showMessage() is called, whichever occurs first.
See also messageChanged(), currentMessage(), and clearMessage().
Constructs a status bar with a size grip and the given parent and object name.
Use the QStatusBar() constructor and the QObject::setObjectName() function instead.
For example, if you have code like
QStatusBar *myStatusBar = new QStatusBar(parent, name);
you can rewrite it as
QStatusBar *myStatusBar = new QStatusBar(parent); myStatusBar->setObjectName(name);
This is an overloaded member function, provided for convenience.
Use addWidget() or addPermanentWidget() instead, depending on the value of the permanent parameter.
For example, if you have code like
QStatusBar *myStatusBar; myStatusBar->addWidget(widget, stretch, permanent); // permanent == true
you can rewrite it as
QStatusBar *myStatusBar; myStatusBar->addPermanentWidget(widget, stretch);
Use the clearMessage() function instead.
Use the showMessage() function instead.
| Copyright © 2007 Trolltech | Trademarks | Qt 4.2.3 |