En esta página

QStatusBar Class

La clase QStatusBar proporciona una barra horizontal adecuada para mostrar información de estado. Más...

Encabezado: #include <QStatusBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QWidget

Propiedades

Funciones públicas

QStatusBar(QWidget *parent = nullptr)
virtual ~QStatusBar()
void addPermanentWidget(QWidget *widget, int stretch = 0)
void addWidget(QWidget *widget, int stretch = 0)
QString currentMessage() const
int insertPermanentWidget(int index, QWidget *widget, int stretch = 0)
int insertWidget(int index, QWidget *widget, int stretch = 0)
bool isSizeGripEnabled() const
void removeWidget(QWidget *widget)
void setSizeGripEnabled(bool)

Ranuras públicas

void clearMessage()
void showMessage(const QString &message, int timeout = 0)

Señales

void messageChanged(const QString &message)

Funciones protegidas

void hideOrShow()
void reformat()

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual void paintEvent(QPaintEvent *event) override
virtual void resizeEvent(QResizeEvent *e) override
virtual void showEvent(QShowEvent *) override

Descripción detallada

Cada indicador de estado se clasifica en una de estas tres categorías:

  • Temporal: ocupa brevemente la mayor parte de la barra de estado. Se utiliza, por ejemplo, para explicar los textos de las descripciones emergentes o las entradas de menú.
  • Normal: ocupa parte de la barra de estado y puede quedar oculto por mensajes temporales. Se utiliza, por ejemplo, para mostrar el número de página y de línea en un procesador de textos.
  • Permanente: nunca se oculta. Se utiliza para indicaciones importantes sobre el modo; por ejemplo, algunas aplicaciones colocan un indicador de Bloq Mayús en la barra de estado.

QStatusBar te permite mostrar los tres tipos de indicadores.

Normalmente, la solicitud de la funcionalidad de la barra de estado se produce en relación con un objeto ` QMainWindow `. ` QMainWindow ` proporciona una ventana principal de la aplicación, con una barra de menús, barras de herramientas, widgets acoplados y una barra de estado alrededor de un widget central de gran tamaño. La barra de estado se puede recuperar mediante la función ` QMainWindow::statusBar()` y se puede sustituir mediante la función ` QMainWindow::setStatusBar()`.

Utiliza la ranura ` showMessage()` para mostrar un mensaje temporal:

statusBar()->showMessage(tr("Ready"));

Para eliminar un mensaje temporal, utiliza la ranura clearMessage() o establece un límite de tiempo al llamar a showMessage(). Por ejemplo:

statusBar()->showMessage(tr("Ready"), 2000);

Utiliza la función currentMessage() para recuperar el mensaje temporal que se muestra actualmente. La clase QStatusBar también proporciona la señal messageChanged(), que se emite cada vez que cambia el mensaje de estado temporal.

Los mensajesnormales y permanentes se muestran creando un pequeño widget (QLabel, QProgressBar o incluso QToolButton) y añadiéndolo a la barra de estado mediante la función addWidget() o addPermanentWidget(). Utiliza la función removeWidget() para eliminar dichos mensajes de la barra de estado.

statusBar()->addWidget(new MyReadWriteIndication);

Por defecto, QStatusBar muestra un controlador de tamaño ( QSizeGrip ) en la esquina inferior derecha. Puedes desactivarlo mediante la función setSizeGripEnabled(). Utiliza la función isSizeGripEnabled() para determinar el estado actual del controlador de tamaño.

Una barra de estado con el estilo del widget Fusion

Véase también « QMainWindow » y « QStatusTipEvent ».

Documentación de propiedades

sizeGripEnabled : bool

Esta propiedad determina si el « QSizeGrip » de la esquina inferior derecha de la barra de estado está activado

El controlador de tamaño está activado por defecto.

Funciones de acceso:

bool isSizeGripEnabled() const
void setSizeGripEnabled(bool)

Documentación de las funciones de miembro

[explicit] QStatusBar::QStatusBar(QWidget *parent = nullptr)

Crea una barra de estado con un control de tamaño y el elemento « parent » especificado.

Véase también setSizeGripEnabled().

[virtual noexcept] QStatusBar::~QStatusBar()

Elimina esta barra de estado y libera todos los recursos asignados y los widgets secundarios.

void QStatusBar::addPermanentWidget(QWidget *widget, int stretch = 0)

Añade de forma permanente el objeto ` widget ` especificado a esta barra de estado, reasignando el widget a este objeto ` QStatusBar ` si aún no es un elemento secundario del mismo. El parámetro ` stretch ` se utiliza para calcular un tamaño adecuado para el objeto ` widget ` especificado a medida que la barra de estado se amplía o se reduce. El factor de estiramiento predeterminado es 0, es decir, se asigna al widget el mínimo espacio posible.

«Permanente» significa que el widget no puede quedar oculto por mensajes temporales. Se sitúa en el extremo derecho de la barra de estado.

Véase también insertPermanentWidget(), removeWidget() y addWidget().

void QStatusBar::addWidget(QWidget *widget, int stretch = 0)

Añade el widget especificado a esta barra de estado, reasignando el widget como hijo si aún no lo es de este objeto QStatusBar. El parámetro stretch se utiliza para calcular un tamaño adecuado para el widget especificado a medida que la barra de estado se amplía o se reduce. El factor de estiramiento por defecto es 0, es decir, se asigna al widget el mínimo espacio posible.

El widget se sitúa en el extremo izquierdo del primer widget permanente (véase addPermanentWidget()) y puede quedar oculto por mensajes temporales.

Véase también insertWidget(), removeWidget() y addPermanentWidget().

[slot] void QStatusBar::clearMessage()

Elimina cualquier mensaje temporal que se esté mostrando.

Véase también currentMessage(), showMessage() y removeWidget().

QString QStatusBar::currentMessage() const

Devuelve el mensaje temporal que se muestra actualmente, o una cadena vacía si no existe dicho mensaje.

Véase también showMessage().

[override virtual protected] bool QStatusBar::event(QEvent *e)

Reimplementa: ` QWidget::event(QEvent *event)`.

[protected] void QStatusBar::hideOrShow()

Garantiza que se muestren los widgets correctos.

Lo utilizan las funciones showMessage() y clearMessage().

int QStatusBar::insertPermanentWidget(int index, QWidget *widget, int stretch = 0)

Inserta de forma permanente el elemento « widget » especificado en la posición « index » de esta barra de estado, asignando un nuevo padre al widget si aún no es hijo del objeto « QStatusBar ». Si « index » está fuera de rango, el widget se añade al final (en cuyo caso se devuelve el índice real del widget).

El parámetro stretch se utiliza para calcular un tamaño adecuado para el widget dado a medida que la barra de estado se amplía y se reduce. El factor de estiramiento predeterminado es 0, es decir, se asigna al widget un espacio mínimo.

«Permanente» significa que el widget no puede quedar oculto por mensajes temporales. Se sitúa en el extremo derecho de la barra de estado.

Véanse también addPermanentWidget(), removeWidget() y addWidget().

int QStatusBar::insertWidget(int index, QWidget *widget, int stretch = 0)

Inserta el widget especificado en el index indicado en esta barra de estado, reasignando la relación de padre-hijo del widget si aún no es hijo de este objeto QStatusBar. Si index está fuera de rango, el widget se añade al final (en cuyo caso se devuelve el índice real del widget).

El parámetro stretch se utiliza para calcular un tamaño adecuado para el widget dado a medida que la barra de estado se amplía y se reduce. El factor de estiramiento por defecto es 0, es decir, se asigna al widget el mínimo espacio posible.

El widget se sitúa en el extremo izquierdo del primer widget permanente (véase addPermanentWidget()) y puede quedar oculto por mensajes temporales.

Véanse también addWidget(), removeWidget() y addPermanentWidget().

[signal] void QStatusBar::messageChanged(const QString &message)

Esta señal se emite cada vez que cambia el mensaje de estado temporal. El nuevo mensaje temporal se pasa en el parámetro message, que es una cadena nula cuando se ha eliminado el mensaje.

Véanse también showMessage() y clearMessage().

[override virtual protected] void QStatusBar::paintEvent(QPaintEvent *event)

Reimplementa: ` QWidget::paintEvent` (`QPaintEvent *event`).

Muestra el mensaje temporal, si procede, en respuesta al evento de pintura event.

[protected] void QStatusBar::reformat()

Modifica el aspecto de la barra de estado para reflejar los cambios en los elementos.

Es posible que algunas subclases especiales necesiten esta función, pero la gestión de la geometría suele encargarse de cualquier reordenación necesaria.

void QStatusBar::removeWidget(QWidget *widget)

Elimina el « widget » especificado de la barra de estado.

Nota: Esta función no elimina el widget, sino que lo oculta. Para volver a añadir el widget, debes llamar tanto a la función addWidget() como a la función show().

Véase también addWidget(), addPermanentWidget() y clearMessage().

[override virtual protected] void QStatusBar::resizeEvent(QResizeEvent *e)

Reimplementa: QWidget::resizeEvent(QResizeEvent *event).

[override virtual protected] void QStatusBar::showEvent(QShowEvent *)

Reimplementa: ` QWidget::showEvent(QShowEvent *event)`.

[slot] void QStatusBar::showMessage(const QString &message, int timeout = 0)

Oculta las indicaciones de estado normales y muestra el « message » indicado durante el número de milisegundos especificado (timeout). Si « timeout » es 0 (valor por defecto), el « message » permanece visible hasta que se llama a la ranura « clearMessage()» o hasta que se vuelve a llamar a la ranura «showMessage()» para cambiar el mensaje.

Ten en cuenta que showMessage() se invoca para mostrar explicaciones temporales de los textos de las descripciones emergentes, por lo que pasar un valor de timeout igual a 0 no es suficiente para mostrar un permanent message.

Véanse también messageChanged(), currentMessage() y clearMessage().

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