<class name="QStatusBar" doc="/** <p>The <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> class provides a horizontal bar suitable for presenting status information.</p> <p>Each status indicator falls into one of three categories:</p> <ul> <li><i>Temporary</i> - briefly occupies most of the status bar. Used to explain tool tip texts or menu entries, for example.</li> <li><i>Normal</i> - occupies part of the status bar and may be hidden by temporary messages. Used to display the page and line number in a word processor, for example.</li> <li><i>Permanent</i> - is never hidden. Used for important mode indications, for example, some applications put a Caps Lock indicator in the status bar.</li> </ul> <p><a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> lets you display all three types of indicators.</p> <p>Typically, a request for the status bar functionality occurs in relation to a <a href="QMainWindow.html"><tt>QMainWindow</tt></a> object. <a href="QMainWindow.html"><tt>QMainWindow</tt></a> provides a main application window, with a menu bar, tool bars, dock widgets <i>and</i> 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.</p> <p>Use the <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a> slot to display a <i>temporary</i> message:</p> <pre> void MainWindow::createStatusBar() { statusBar()-&gt;showMessage(tr(&quot;Ready&quot;)); }</pre> <p>To remove a temporary message, use the <a href="QStatusBar.html#clearMessage()"><tt>clearMessage</tt></a> slot, or set a time limit when calling <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a>. For example:</p> <pre> void MainWindow::print() { QTextDocument *document = textEdit-&gt;document(); QPrinter printer; QPrintDialog *dlg = new QPrintDialog(&amp;printer, this); if (dlg-&gt;exec() != QDialog::Accepted) return; document-&gt;print(&amp;printer); statusBar()-&gt;showMessage(tr(&quot;Ready&quot;), 2000); }</pre> <p>Use the <a href="QStatusBar.html#currentMessage()"><tt>currentMessage</tt></a> function to retrieve the temporary message currently shown. The <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> class also provide the <a href="QStatusBar.html#messageChanged(java.lang.String)"><tt>messageChanged</tt></a> signal which is emitted whenever the temporary status message changes.</p> <p><i>Normal</i> and <i>Permanent</i> messages are displayed by creating a small widget (<a href="QLabel.html"><tt>QLabel</tt></a>, <a href="QProgressBar.html"><tt>QProgressBar</tt></a> or even <a href="QToolButton.html"><tt>QToolButton</tt></a>) and then adding it to the status bar using the <a href="QStatusBar.html#addWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addWidget</tt></a> or the <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a> function. Use the <a href="QStatusBar.html#removeWidget(com.trolltech.qt.gui.QWidget)"><tt>removeWidget</tt></a> function to remove such messages from the status bar.</p> <pre> statusBar()-&gt;addWidget(new MyReadWriteIndication);</pre> <p>By default <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> provides a <a href="QSizeGrip.html"><tt>QSizeGrip</tt></a> in the lower-right corner. You can disable it using the <a href="QStatusBar.html#setSizeGripEnabled(boolean)"><tt>setSizeGripEnabled</tt></a> function. Use the <a href="QStatusBar.html#isSizeGripEnabled()"><tt>isSizeGripEnabled</tt></a> function to determine the current status of the size grip.</p> <p align="center"><img src="%2E%2E/images/plastique-statusbar.png" alt="A status bar shown in the Plastique widget style" /></p> @see <a href="QMainWindow.html"><tt>QMainWindow</tt></a> @see <a href="QStatusTipEvent.html"><tt>QStatusTipEvent</tt></a> @see <a href="%2E%2E/guibooks.html#fowler">GUI Design Handbook: Status Bar</tt></a> @see <a href="%2E%2E/qtjambi-application.html">Application Example</tt></a> */"> <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/** <p>This signal is emitted when the widget's <a href="QWidget.html#contextMenuPolicy()"><tt>contextMenuPolicy</tt></a> is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position <tt>pos</tt> is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is <a href="QAbstractScrollArea.html"><tt>QAbstractScrollArea</tt></a> and its subclasses that map the context menu event to coordinates of the viewport()</tt> .</p> <dl> <dt><b>Compatible Slot Signatures:</b></dt> <dd><tt>void mySlot(com.trolltech.qt.core.QPoint pos)</tt></dd> <dd><tt>void mySlot()</tt></dd> </dl> <dl> <dt><b>See Also:</b></dt> <dd><a href="QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)"><tt>mapToGlobal</tt></a>, <a href="QMenu.html"><tt>QMenu</tt></a>, <a href="QWidget.html#contextMenuPolicy()"><tt>contextMenuPolicy</tt></a></dd> </dl> */"/> <signal name="protected final void messageChanged(java.lang.String text)" doc="/** <p>This signal is emitted whenever the temporary status message changes. The new temporary message is passed in the <tt>text</tt> parameter which is a null-string when the message has been removed.</p> <dl> <dt><b>Compatible Slot Signatures:</b></dt> <dd><tt>void mySlot(java.lang.String text)</tt></dd> <dd><tt>void mySlot()</tt></dd> </dl> <dl> <dt><b>See Also:</b></dt> <dd><a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a>, <a href="QStatusBar.html#clearMessage()"><tt>clearMessage</tt></a></dd> </dl> */"/> <method name="public QStatusBar(com.trolltech.qt.gui.QWidget parent)" doc="/** <p>Constructs a status bar with a size grip and the given <tt>parent</tt>.</p> @see <a href="QStatusBar.html#setSizeGripEnabled(boolean)"><tt>setSizeGripEnabled</tt></a> */"/> <method name="public QStatusBar()" doc="/** <p>Equivalent to <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a>(0). */"/> <method name="public final void addPermanentWidget(com.trolltech.qt.gui.QWidget widget, int stretch)" doc="/** <p>Adds the given <tt>widget</tt> permanently to this status bar, reparenting the widget if it isn't already a child of this <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> object. The <tt>stretch</tt> parameter is used to compute a suitable size for the given <tt>widget</tt> as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.</p> <p>Permanently means that the widget may not be obscured by temporary messages. It is is located at the far right of the status bar.</p> @see <a href="QStatusBar.html#insertPermanentWidget(int, com.trolltech.qt.gui.QWidget, int)"><tt>insertPermanentWidget</tt></a> @see <a href="QStatusBar.html#removeWidget(com.trolltech.qt.gui.QWidget)"><tt>removeWidget</tt></a> @see <a href="QStatusBar.html#addWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addWidget</tt></a> */"/> <method name="public final void addPermanentWidget(com.trolltech.qt.gui.QWidget widget)" doc="/** <p>Equivalent to <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a>(<tt>widget</tt>, 0). */"/> <method name="public final void addWidget(com.trolltech.qt.gui.QWidget widget, int stretch)" doc="/** <p>Adds the given <tt>widget</tt> to this status bar, reparenting the widget if it isn't already a child of this <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> object. The <tt>stretch</tt> parameter is used to compute a suitable size for the given <tt>widget</tt> as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.</p> <p>The widget is located to the far left of the first permanent widget (see <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a>) and may be obscured by temporary messages.</p> @see <a href="QStatusBar.html#insertWidget(int, com.trolltech.qt.gui.QWidget, int)"><tt>insertWidget</tt></a> @see <a href="QStatusBar.html#removeWidget(com.trolltech.qt.gui.QWidget)"><tt>removeWidget</tt></a> @see <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a> */"/> <method name="public final void addWidget(com.trolltech.qt.gui.QWidget widget)" doc="/** <p>Equivalent to <a href="QStatusBar.html#addWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addWidget</tt></a>(<tt>widget</tt>, 0). */"/> <method name="public final void clearMessage()" doc="/** <p>Removes any temporary message being shown.</p> @see <a href="QStatusBar.html#currentMessage()"><tt>currentMessage</tt></a> @see <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a> @see <a href="QStatusBar.html#removeWidget(com.trolltech.qt.gui.QWidget)"><tt>removeWidget</tt></a> */"/> <method name="public final java.lang.String currentMessage()" doc="/** <p>Returns the temporary message currently shown, or an empty string if there is no such message.</p> @see <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a> */"/> <method name="protected final void hideOrShow()" doc="/** <p>Ensures that the right widgets are visible.</p> <p>Used by the <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a> and <a href="QStatusBar.html#clearMessage()"><tt>clearMessage</tt></a> functions.</p> */"/> <method name="public final int insertPermanentWidget(int index, com.trolltech.qt.gui.QWidget widget, int stretch)" doc="/** <p>Inserts the given <tt>widget</tt> at the given <tt>index</tt> permanently to this status bar, reparenting the widget if it isn't already a child of this <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> object. If <tt>index</tt> is out of range, the widget is appended (in which case it is the actual index of the widget that is returned).</p> <p>The <tt>stretch</tt> parameter is used to compute a suitable size for the given <tt>widget</tt> as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.</p> <p>Permanently means that the widget may not be obscured by temporary messages. It is is located at the far right of the status bar.</p> @see <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a> @see <a href="QStatusBar.html#removeWidget(com.trolltech.qt.gui.QWidget)"><tt>removeWidget</tt></a> @see <a href="QStatusBar.html#addWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addWidget</tt></a> */"/> <method name="public final int insertPermanentWidget(int index, com.trolltech.qt.gui.QWidget widget)" doc="/** <p>Equivalent to <a href="QStatusBar.html#insertPermanentWidget(int, com.trolltech.qt.gui.QWidget, int)"><tt>insertPermanentWidget</tt></a>(<tt>index</tt>, <tt>widget</tt>, 0). */"/> <method name="public final int insertWidget(int index, com.trolltech.qt.gui.QWidget widget, int stretch)" doc="/** <p>Inserts the given <tt>widget</tt> at the given <tt>index</tt> to this status bar, reparenting the widget if it isn't already a child of this <a href="QStatusBar.html#QStatusBar(com.trolltech.qt.gui.QWidget)"><tt>QStatusBar</tt></a> object. If <tt>index</tt> is out of range, the widget is appended (in which case it is the actual index of the widget that is returned).</p> <p>The <tt>stretch</tt> parameter is used to compute a suitable size for the given <tt>widget</tt> as the status bar grows and shrinks. The default stretch factor is 0, i.e giving the widget a minimum of space.</p> <p>The widget is located to the far left of the first permanent widget (see <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a>) and may be obscured by temporary messages.</p> @see <a href="QStatusBar.html#addWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addWidget</tt></a> @see <a href="QStatusBar.html#removeWidget(com.trolltech.qt.gui.QWidget)"><tt>removeWidget</tt></a> @see <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a> */"/> <method name="public final int insertWidget(int index, com.trolltech.qt.gui.QWidget widget)" doc="/** <p>Equivalent to <a href="QStatusBar.html#insertWidget(int, com.trolltech.qt.gui.QWidget, int)"><tt>insertWidget</tt></a>(<tt>index</tt>, <tt>widget</tt>, 0). */"/> <method name="public final boolean isSizeGripEnabled()" doc="/** <p>Returns whether the <a href="QSizeGrip.html"><tt>QSizeGrip</tt></a> in the bottom-right corner of the status bar is enabled.</p> <p>The size grip is enabled by default.</p> */"/> <method name="protected final void reformat()" doc="/** <p>Changes the status bar's appearance to account for item changes.</p> <p>Special subclasses may need this function, but geometry management will usually take care of any necessary rearrangements.</p> */"/> <method name="public final void removeWidget(com.trolltech.qt.gui.QWidget widget)" doc="/** <p>Removes the specified <tt>widget</tt> from the status bar (without deleting it).</p> @see <a href="QStatusBar.html#addWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addWidget</tt></a> @see <a href="QStatusBar.html#addPermanentWidget(com.trolltech.qt.gui.QWidget, int)"><tt>addPermanentWidget</tt></a> @see <a href="QStatusBar.html#clearMessage()"><tt>clearMessage</tt></a> */"/> <method name="public final void setSizeGripEnabled(boolean arg__1)" doc="/** <p>Sets whether the <a href="QSizeGrip.html"><tt>QSizeGrip</tt></a> in the bottom-right corner of the status bar is enabled to <tt>arg__1</tt>.</p> <p>The size grip is enabled by default.</p> @see <a href="QStatusBar.html#isSizeGripEnabled()"><tt>isSizeGripEnabled</tt></a> */"/> <method name="public final void showMessage(java.lang.String text, int timeout)" doc="/** <p>Hides the normal status indications and displays the given <tt>text</tt> for the specified <tt>timeout</tt> milli-seconds (if non-zero), or until <a href="QStatusBar.html#clearMessage()"><tt>clearMessage</tt></a> or another <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a> is called, whichever occurs first.</p> @see <a href="QStatusBar.html#messageChanged(java.lang.String)"><tt>messageChanged</tt></a> @see <a href="QStatusBar.html#currentMessage()"><tt>currentMessage</tt></a> @see <a href="QStatusBar.html#clearMessage()"><tt>clearMessage</tt></a> */"/> <method name="public final void showMessage(java.lang.String text)" doc="/** <p>Equivalent to <a href="QStatusBar.html#showMessage(java.lang.String, int)"><tt>showMessage</tt></a>(<tt>text</tt>, 0). */"/> <method name="public boolean event(com.trolltech.qt.core.QEvent arg__1)" doc="/** <p>This function is reimplemented for internal reasons.</p> */"/> <method name="protected void paintEvent(com.trolltech.qt.gui.QPaintEvent arg__1)" doc="/** <p>This function is reimplemented for internal reasons.</p> */"/> <method name="protected void resizeEvent(com.trolltech.qt.gui.QResizeEvent arg__1)" doc="/** <p>This function is reimplemented for internal reasons.</p> */"/> </class>