QDialog Class

Descripción detallada

Una ventana de diálogo es una ventana de nivel superior utilizada principalmente para tareas a corto plazo y breves comunicaciones con el usuario. Los QDialogs pueden ser modales o no modales. Los QDialogs pueden proporcionar un return value, y pueden tener default buttons. Los QDialogs también pueden tener un QSizeGrip en su esquina inferior derecha, usando setSizeGripEnabled().

Ten en cuenta que QDialog (y cualquier otro widget que tenga el tipo Qt::Dialog) usa el widget padre de forma ligeramente diferente a otras clases en Qt. Un diálogo es siempre un widget de nivel superior, pero si tiene un padre, su ubicación por defecto está centrada encima del widget de nivel superior del padre (si no es él mismo de nivel superior). También compartirá la entrada de la barra de tareas del padre.

Usa la sobrecarga de la función QWidget::setParent() para cambiar la propiedad de un widget QDialog. Esta función te permite establecer explícitamente las banderas de ventana del widget reparentado; usar la función sobrecargada borrará las banderas de ventana que especifican las propiedades del sistema de ventanas para el widget (en particular reiniciará la bandera Qt::Dialog ).

Diálogos modales

Un diálogo modal es un diálogo que bloquea la entrada a otras ventanas visibles en la misma aplicación. Los cuadros de diálogo que se utilizan para solicitar un nombre de archivo al usuario o para establecer las preferencias de la aplicación suelen ser modales. Los cuadros de diálogo pueden ser application modal (por defecto) o window modal.

Cuando se abre un diálogo modal de aplicación, el usuario debe terminar de interactuar con el diálogo y cerrarlo antes de poder acceder a cualquier otra ventana de la aplicación. Los diálogos modales de ventana sólo bloquean el acceso a la ventana asociada al diálogo, permitiendo al usuario seguir utilizando otras ventanas de una aplicación.

La forma más común de mostrar un diálogo modal es llamar a su función open(). Alternativamente, se puede llamar a setModal(true) o setWindowModality(), y luego a show(). En ambos casos, una vez que se muestra el diálogo, el control se devuelve inmediatamente a la persona que llama. Debe conectarse a la señal finished() para saber cuándo se cierra el diálogo y cuál es su return value. Alternativamente, puede conectarse a las señales accepted() y rejected().

Cuando implemente un diálogo personalizado, para cerrar el diálogo y devolver un valor apropiado, conecte un botón predeterminado, por ejemplo, un botón Aceptar, a la ranura accept(), y un botón Cancelar a la ranura reject(). Alternativamente, puede llamar a la ranura done() con Accepted o Rejected.

Si muestra el cuadro de diálogo modal para realizar una operación de larga duración, se recomienda realizar la operación en un subproceso trabajador en segundo plano, para que no interfiera con el subproceso GUI.

Diálogos sin modelo

Un diálogo sin modelo es un diálogo que funciona independientemente de otras ventanas de la misma aplicación. Los cuadros de diálogo de búsqueda y reemplazo en los procesadores de texto suelen ser no modelizados para permitir al usuario interactuar tanto con la ventana principal de la aplicación como con el cuadro de diálogo.

Los cuadros de diálogo sin modelo se muestran utilizando show(), que devuelve el control a quien lo invoca inmediatamente.

Si se invoca la función show() después de ocultar un diálogo, éste se mostrará en su posición original. Esto se debe a que el gestor de ventanas decide la posición de las ventanas que no han sido colocadas explícitamente por el programador. Para preservar la posición de un diálogo que ha sido movido por el usuario, guarde su posición en su manejador closeEvent() y luego mueva el diálogo a esa posición, antes de mostrarlo de nuevo.

Botón por defecto

El botón por defecto de un diálogo es el botón que se pulsa cuando el usuario pulsa Intro (Retorno). Este botón se utiliza para indicar que el usuario acepta la configuración del diálogo y desea cerrarlo. Utilice QPushButton::setDefault(), QPushButton::isDefault() y QPushButton::autoDefault() para configurar y controlar el botón predeterminado del cuadro de diálogo.

Tecla Escape

Si el usuario pulsa la tecla Esc en un diálogo, se llamará a QDialog::reject(). Esto hará que la ventana se cierre: El close event no puede ser ignored.

Extensibilidad

La extensibilidad es la capacidad de mostrar el diálogo de dos maneras: un diálogo parcial que muestra las opciones más utilizadas, y un diálogo completo que muestra todas las opciones. Normalmente, un diálogo extensible aparecerá inicialmente como un diálogo parcial, pero con un botón de alternancia More. Si el usuario pulsa el botón More, el diálogo se expande.

Valor de retorno (diálogos modales)

Los diálogos modales se utilizan a menudo en situaciones en las que se requiere un valor de retorno, por ejemplo, para indicar si el usuario ha pulsado OK o Cancel. Un diálogo puede cerrarse llamando a las ranuras accept() o reject(), y exec() devolverá Accepted o Rejected según corresponda. La llamada a exec() devuelve el resultado del diálogo. El resultado también está disponible desde result() si el diálogo no ha sido destruido.

Para modificar el comportamiento de cierre de su diálogo, puede reimplementar las funciones accept(), reject() o done(). La función closeEvent() sólo debe reimplementarse para conservar la posición del diálogo o para anular el comportamiento estándar de cierre o rechazo.

Ejemplos de código

Un diálogo modal:

void EditorWindow::countWords()
{
    WordCountDialog dialog(this);
    dialog.setWordCount(document().wordCount());
    dialog.exec();
}

Un diálogo sin modelo:

void EditorWindow::find()
{
    if (!findDialog) {
        findDialog = new FindDialog(this);
        connect(findDialog, &FindDialog::findNext,
                this, &EditorWindow::findNext);
    }

    findDialog->show();
    findDialog->raise();
    findDialog->activateWindow();
}

Un diálogo con una extensión:

mainLayout->setSizeConstraint(QLayout::SetFixedSize);

findButton = new QPushButton(tr("&Find"));
moreButton = new QPushButton(tr("&More..."));
moreButton->setCheckable(true);

extension = new ExtendedControls;
mainLayout->addWidget(extension);
extension->hide();

connect(moreButton, &QAbstractButton::toggled, extension, &QWidget::setVisible);

Estableciendo la propiedad sizeConstraint del diseño del diálogo a SetFixedSize, el diálogo no será redimensionable por el usuario, y se encogerá automáticamente cuando la extensión se oculte.