QMessageBox Class

Documentación de las funciones miembro

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

Construye un cuadro de mensaje application modal sin texto ni botones. parent se pasa al constructor QDialog.

La modalidad de la ventana puede anularse mediante setWindowModality() antes de llamar a show().

En macOS, si desea que su cuadro de mensaje aparezca como un Qt::Sheet de su parent, establezca el window modality del cuadro de mensaje en Qt::WindowModal o utilice open(). De lo contrario, el cuadro de mensaje será un cuadro de diálogo estándar.

Véase también setWindowTitle(), setText(), setIcon(), setStandardButtons() y setWindowModality().

QMessageBox::QMessageBox(QMessageBox::Icon icon, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = NoButton, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint)

Construye un cuadro de mensaje application modal con los campos icon, title, text, y estándar buttons. Se pueden añadir botones estándar o personalizados en cualquier momento utilizando addButton(). Los argumentos parent y f se pasan al constructor QDialog.

La modalidad de la ventana puede anularse mediante setWindowModality() antes de llamar a show().

En macOS, si parent no es nullptr y desea que su cuadro de mensaje aparezca como un Qt::Sheet de ese padre, establezca el window modality del cuadro de mensaje en Qt::WindowModal (por defecto). De lo contrario, el cuadro de mensaje será un cuadro de diálogo estándar.

Véase también setWindowTitle(), setText(), setIcon(), setStandardButtons() y setWindowModality().

[virtual noexcept] QMessageBox::~QMessageBox()

Destruye el buzón de mensajes.

[static] void QMessageBox::about(QWidget *parent, const QString &title, const QString &text)

Muestra un simple cuadro "Acerca de" con el título title y el texto text. El padre de la caja about es parent.

about() busca un icono adecuado en cuatro ubicaciones:

1. Prefiere parent->icon() si existe.
2. Si no, lo intenta en el widget de nivel superior que contiene parent.
3. Si falla, lo intenta con el widget active window.
4. Como último recurso, utiliza el icono Información.

El cuadro "Acerca de" tiene un único botón llamado "Aceptar".

En macOS, el cuadro "Acerca de" aparece como una ventana sin modelo; en otras plataformas, actualmente es una aplicación modal.

Véase también QWidget::windowIcon() y QApplication::activeWindow().

[static] void QMessageBox::aboutQt(QWidget *parent, const QString &title = QString())

Muestra un cuadro de mensaje simple sobre Qt, con el title dado y centrado sobre parent (si parent no es nullptr). El mensaje incluye el número de versión de Qt que utiliza la aplicación.

Esto es útil para incluirlo en el menú Help de una aplicación, como se muestra en el ejemplo Menús.

QApplication proporciona esta funcionalidad como una ranura.

En macOS, el cuadro aboutQt aparece como una ventana sin modelo; en otras plataformas, actualmente es modal de la aplicación.

Véase también QApplication::aboutQt().

void QMessageBox::addButton(QAbstractButton *button, QMessageBox::ButtonRole role)

Añade el button dado al cuadro de mensaje con el role especificado.

Véase también removeButton(), button() y setStandardButtons().

QPushButton *QMessageBox::addButton(QMessageBox::StandardButton button)

Añade un button estándar al cuadro de mensaje si es válido hacerlo, y devuelve el pulsador.

Véase también setStandardButtons().

QPushButton *QMessageBox::addButton(const QString &text, QMessageBox::ButtonRole role)

Crea un botón con el text dado , lo añade al cuadro de mensaje para el role especificado , y lo devuelve.

QAbstractButton *QMessageBox::button(QMessageBox::StandardButton which) const

Devuelve un puntero correspondiente al botón estándar which, o nullptr si el botón estándar no existe en este cuadro de mensaje.

Véase también standardButtons y standardButton().

[signal] void QMessageBox::buttonClicked(QAbstractButton *button)

Esta señal se emite cada vez que se pulsa un botón dentro de QMessageBox. El botón pulsado se devuelve en button.

QMessageBox::ButtonRole QMessageBox::buttonRole(QAbstractButton *button) const

Devuelve la función de botón para el button especificado. Esta función devuelve InvalidRole si button es nullptr o no se ha añadido al cuadro de mensaje.

Véase también buttons() y addButton().

QList<QAbstractButton *> QMessageBox::buttons() const

Devuelve una lista de todos los botones que se han añadido al cuadro de mensaje.

Véase también buttonRole(), addButton() y removeButton().

[override virtual protected] void QMessageBox::changeEvent(QEvent *ev)

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

QCheckBox *QMessageBox::checkBox() const

Devuelve la casilla de verificación mostrada en el diálogo. Es nullptr si no se ha establecido ninguna casilla de verificación.

Véase también setCheckBox().

QAbstractButton *QMessageBox::clickedButton() const

Devuelve el botón que fue pulsado por el usuario, o nullptr si el usuario pulsó la tecla Esc y no se estableció escape button.

Si todavía no se ha llamado a exec(), devuelve nullptr.

Ejemplo:

QMessageBox messageBox(this);
QAbstractButton *disconnectButton =
      messageBox.addButton(tr("Disconnect"), QMessageBox::ActionRole);
//...
messageBox.exec();
if (messageBox.clickedButton() == disconnectButton) {
    //...
}

Véase también standardButton() y button().

[override virtual protected] void QMessageBox::closeEvent(QCloseEvent *e)

Reimplementa: QDialog::closeEvent(QCloseEvent *e).

[static] QMessageBox::StandardButton QMessageBox::critical(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

Abre un cuadro de mensaje crítico con los campos title y text delante del widget parent especificado.

Los botones estándar buttons se añaden al cuadro de mensaje. defaultButton especifica el botón que se utiliza cuando se pulsa Enter. defaultButton debe referirse a un botón que se haya dado en buttons. Si defaultButton es QMessageBox::NoButton, QMessageBox elige automáticamente un predeterminado adecuado.

Devuelve la identidad del botón estándar que se pulsó. Si en su lugar se pulsó Esc, se devuelve escape button.

El cuadro de mensaje es un cuadro de diálogo application modal.

Véase también question(), warning(), y information().

QPushButton *QMessageBox::defaultButton() const

Devuelve el botón que debería ser el del cuadro de mensaje default button. Devuelve nullptr si no se ha establecido ningún botón por defecto.

Véase también setDefaultButton(), addButton() y QPushButton::setDefault().

QAbstractButton *QMessageBox::escapeButton() const

Devuelve el botón que se activa cuando se pulsa escape.

Por defecto, QMessageBox intenta detectar automáticamente un botón de escape de la siguiente manera:

1. Si sólo hay un botón, se convierte en el botón de escape.
2. Si hay un botón Cancel, se convierte en el botón de escape.
3. Sólo en macOS, si hay exactamente un botón con el rol QMessageBox::RejectRole, se convierte en el botón de escape.

Cuando no se puede detectar automáticamente un botón de escape, pulsar Esc no tiene ningún efecto.

Véase también setEscapeButton() y addButton().

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

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

[override virtual slot] int QMessageBox::exec()

Reimplementa: QDialog::exec().

Muestra el cuadro de mensaje como un modal dialog, bloqueándose hasta que el usuario lo cierra.

Cuando se utiliza QMessageBox con botones estándar, esta función devuelve un valor StandardButton que indica el botón estándar sobre el que se ha hecho clic. Cuando se utiliza QMessageBox con botones personalizados, esta función devuelve un valor opaco; utilice clickedButton() para determinar qué botón fue pulsado.

Los usuarios no pueden interactuar con ninguna otra ventana de la misma aplicación hasta que cierren el cuadro de diálogo, ya sea haciendo clic en un botón o utilizando un mecanismo proporcionado por el sistema de ventanas.

Véase también show() y result().

[static] QMessageBox::StandardButton QMessageBox::information(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

Abre un cuadro de mensaje informativo con los campos title y text delante del widget parent especificado.

Los botones estándar buttons se añaden al cuadro de mensaje. defaultButton especifica el botón que se utiliza cuando se pulsa Enter. defaultButton debe referirse a un botón que se haya dado en buttons. Si defaultButton es QMessageBox::NoButton, QMessageBox elige automáticamente un predeterminado adecuado.

Devuelve la identidad del botón estándar que se pulsó. Si en su lugar se pulsó Esc, se devuelve escape button.

El cuadro de mensaje es un cuadro de diálogo application modal.

Véase también question(), warning(), y critical().

[override virtual protected] void QMessageBox::keyPressEvent(QKeyEvent *e)

Reimplementa: QDialog::keyPressEvent(QKeyEvent *e).

void QMessageBox::open(QObject *receiver, const char *member)

Abre el diálogo y conecta su señal finished() o buttonClicked() a la ranura especificada por receiver y member. Si la ranura en member tiene un puntero como primer parámetro, la conexión se realiza a buttonClicked(); en caso contrario, la conexión se realiza a finished().

La señal se desconectará de la ranura cuando se cierre el diálogo.

[static] QMessageBox::StandardButton QMessageBox::question(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = StandardButtons(Yes | No), QMessageBox::StandardButton defaultButton = NoButton)

Abre un cuadro de mensaje de pregunta con los campos title y text delante del widget parent especificado.

Los botones estándar buttons se añaden al cuadro de mensaje. defaultButton especifica el botón que se utiliza cuando se pulsa Enter. defaultButton debe referirse a un botón que se haya dado en buttons. Si defaultButton es QMessageBox::NoButton, QMessageBox elige un predeterminado adecuado automáticamente.

Devuelve la identidad del botón estándar que se pulsó. Si en su lugar se pulsó Esc, se devuelve escape button.

El cuadro de mensaje es un cuadro de diálogo application modal.

Véase también information(), warning(), y critical().

void QMessageBox::removeButton(QAbstractButton *button)

Elimina button de la caja de botones sin borrarlo.

Véase también addButton() y setStandardButtons().

[override virtual protected] void QMessageBox::resizeEvent(QResizeEvent *event)

Reimplementa: QDialog::resizeEvent(QResizeEvent *).

void QMessageBox::setCheckBox(QCheckBox *cb)

Establece la casilla de verificación cb en el cuadro de diálogo de mensaje. El cuadro de mensaje toma posesión de la casilla de verificación. El argumento cb puede ser nullptr para eliminar una casilla de verificación existente del cuadro de mensaje.

Véase también checkBox().

void QMessageBox::setDefaultButton(QMessageBox::StandardButton button)

Establece la dirección default button del cuadro de mensaje en button.

Véase también defaultButton(), addButton() y QPushButton::setDefault().

void QMessageBox::setDefaultButton(QPushButton *button)

Establece la dirección default button del cuadro de mensaje en button.

Véase también addButton() y QPushButton::setDefault().

void QMessageBox::setEscapeButton(QAbstractButton *button)

Establece el botón que se activa cuando se pulsa la tecla Escape en button.

Véase también escapeButton(), addButton() y clickedButton().

void QMessageBox::setEscapeButton(QMessageBox::StandardButton button)

Establece los botones que se activan cuando se pulsa la tecla Escape en button.

Véase también addButton() y clickedButton().

[since 6.6] void QMessageBox::setOption(QMessageBox::Option option, bool on = true)

Habilita la opción option si on es verdadero; en caso contrario, borra la opción option.

Las opciones (en particular la opción Option::DontUseNativeDialog ) deben establecerse antes de mostrar el diálogo.

Si se establecen las opciones mientras el diálogo está visible, no se garantiza que tengan un efecto inmediato en el diálogo.

Establecer opciones después de cambiar otras propiedades puede hacer que estos valores no tengan efecto.

Esta función se introdujo en Qt 6.6.

Véase también options y testOption().

void QMessageBox::setWindowModality(Qt::WindowModality windowModality)

Esta función hace sombra a QWidget::setWindowModality().

Establece la modalidad del cuadro de mensaje en windowModality.

En macOS, si la modalidad se establece en Qt::WindowModal y el cuadro de mensaje tiene un padre, entonces el cuadro de mensaje será un Qt::Sheet, de lo contrario el cuadro de mensaje será un cuadro de diálogo estándar.

void QMessageBox::setWindowTitle(const QString &title)

Esta función hace sombra a QWidget::setWindowTitle().

Establece el título del cuadro de mensaje en title. En macOS, se ignora el título de la ventana (tal y como exigen las Directrices de macOS).

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

Reimplementa: QDialog::showEvent(QShowEvent *event).

QMessageBox::StandardButton QMessageBox::standardButton(QAbstractButton *button) const

Devuelve el valor enum del botón estándar correspondiente a button, o NoButton si button no es un botón estándar.

Véase también button() y standardButtons().

[since 6.6] bool QMessageBox::testOption(QMessageBox::Option option) const

Devuelve true si el option dado está habilitado; en caso contrario, devuelve false.

Esta función se introdujo en Qt 6.6.

Véase también options y setOption().

[static] QMessageBox::StandardButton QMessageBox::warning(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

Abre un cuadro de mensaje de advertencia con los datos title y text delante del widget parent especificado.

Los botones estándar buttons se añaden al cuadro de mensaje. defaultButton especifica el botón que se utiliza cuando se pulsa Enter. defaultButton debe referirse a un botón que se haya dado en buttons. Si defaultButton es QMessageBox::NoButton, QMessageBox elige un predeterminado adecuado automáticamente.

Devuelve la identidad del botón estándar que se pulsó. Si en su lugar se pulsó Esc, se devuelve escape button.

El cuadro de mensaje es un cuadro de diálogo application modal.

Véase también question(), information(), y critical().