QApplication Class

Documentación de las funciones miembro

QApplication::QApplication(int &argc, char **argv)

Inicializa el sistema de ventanas y construye un objeto de aplicación con argc argumentos de línea de comandos en argv.

El puntero global qApp hace referencia a este objeto de aplicación. Sólo debe crearse un objeto de aplicación.

Este objeto de aplicación debe construirse antes que cualquier paint devices (incluyendo widgets, pixmaps, bitmaps, etc.).

Todos los programas Qt soportan automáticamente las siguientes opciones de línea de comandos:

• -style= style, establece el estilo GUI de la aplicación. Los valores posibles dependen de la configuración de su sistema. Si has compilado Qt con estilos adicionales o tienes estilos adicionales como plugins estos estarán disponibles para la opción de línea de comandos -style. También puede establecer el estilo para todas las aplicaciones Qt estableciendo la variable de entorno QT_STYLE_OVERRIDE.
• -style estilo, es el mismo que el listado arriba.
• -stylesheet= stylesheet, establece el styleSheet de la aplicación. El valor debe ser una ruta a un archivo que contenga la hoja de estilo.

  Nota: Las URLs relativas en el archivo de la Hoja de Estilo son relativas a la ruta del archivo de la Hoja de Estilo.

• -stylesheet stylesheet, es el mismo que el indicado anteriormente.
• -widgetcount, imprime un mensaje de depuración al final sobre el número de widgets que quedan sin destruir y el número máximo de widgets existentes al mismo tiempo
• -reverse, establece la dirección de diseño de la aplicación a Qt::RightToLeft
• -qmljsdebugger=, activa el depurador QML/JS con un puerto especificado. El valor debe tener el formato port:1234[,block], donde block es opcional y hará que la aplicación espere hasta que un depurador se conecte a ella.

Véase también QCoreApplication::arguments().

[virtual noexcept] QApplication::~QApplication()

Limpia cualquier recurso del sistema de ventanas que haya sido asignado por esta aplicación. Establece la variable global qApp en nullptr.

[static slot] void QApplication::aboutQt()

Muestra un sencillo cuadro de mensaje sobre Qt. 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.

Esta función es una ranura de conveniencia para QMessageBox::aboutQt().

[static] QWidget *QApplication::activeModalWidget()

Devuelve el widget modal activo.

Un widget modal es un widget especial de nivel superior que es una subclase de QDialog que especifica el parámetro modal del constructor como true. Un widget modal debe cerrarse antes de que el usuario pueda continuar con otras partes del programa.

Los widgets modales se organizan en una pila. Esta función devuelve el widget modal activo en la parte superior de la pila.

Véase también activePopupWidget() y topLevelWidgets().

[static] QWidget *QApplication::activePopupWidget()

Devuelve el widget emergente activo.

Un widget emergente es un widget especial de nivel superior que establece el indicador de widget Qt::WType_Popup, por ejemplo, el widget QMenu. Cuando la aplicación abre un widget emergente, todos los eventos se envían al mismo. No se puede acceder a los widgets normales ni a los widgets modales antes de que se cierre el widget emergente.

Sólo se pueden abrir otros widgets emergentes cuando se muestra un widget emergente. Los widgets popup se organizan en una pila. Esta función devuelve el widget emergente activo en la parte superior de la pila.

Véase también activeModalWidget() y topLevelWidgets().

[static] QWidget *QApplication::activeWindow()

Devuelve la ventana de nivel superior de la aplicación que tiene el foco de entrada de teclado, o nullptr si ninguna ventana de la aplicación tiene el foco. Puede haber una activeWindow() aunque no exista focusWidget(), por ejemplo si ningún widget de esa ventana acepta eventos de teclado.

Véase también QWidget::setFocus(), QWidget::hasFocus() y focusWidget().

[static] void QApplication::alert(QWidget *widget, int msec = 0)

Hace que se muestre una alerta durante widget si la ventana no es la ventana activa. La alerta se muestra durante msec milisegundos. Si msec es cero (por defecto), entonces la alerta se muestra indefinidamente hasta que la ventana vuelve a estar activa.

Actualmente esta función no hace nada en Qt for Embedded Linux.

En macOS, esto funciona más a nivel de aplicación y hará que el icono de la aplicación rebote en el dock.

En Windows, esto hace que la entrada de la barra de tareas de la ventana parpadee durante un tiempo. Si msec es cero, el parpadeo se detendrá y la entrada de la barra de tareas cambiará de color (actualmente naranja).

En X11, esto hará que la ventana sea marcada como "requiere atención", la ventana no debe estar oculta (es decir, no tener hide() llamado en ella, pero ser visible de alguna manera) para que esto funcione.

[static] QWidgetList QApplication::allWidgets()

Devuelve una lista de todos los widgets de la aplicación.

La lista está vacía (QList::isEmpty()) si no hay widgets.

Ejemplo:

void updateAllWidgets()
{
    const QWidgetList allWidgets = QApplication::allWidgets();
    for (QWidget *widget : allWidgets)
        widget->update();
}

Véase también topLevelWidgets() y QWidget::isVisible().

[static] void QApplication::beep()

Hace sonar el timbre, utilizando el volumen y el sonido predeterminados. La función no está disponible en Qt for Embedded Linux.

[static slot] void QApplication::closeAllWindows()

Cierra todas las ventanas de nivel superior.

Esta función es especialmente útil para aplicaciones con muchas ventanas de nivel superior.

Las ventanas se cierran en orden aleatorio, hasta que una ventana no acepta el evento de cierre. La aplicación se cierra cuando la última ventana se ha cerrado correctamente, a menos que quitOnLastWindowClosed se establezca en false. Para activar la finalización de la aplicación desde, por ejemplo, un menú, utilice QCoreApplication::quit() en lugar de esta función.

Véase también quitOnLastWindowClosed, lastWindowClosed(), QWidget::close(), QWidget::closeEvent(), QCoreApplication::quit(), topLevelWidgets(), y QWidget::isWindow().

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

Reimplementa: QGuiApplication::event(QEvent *e).

[static] int QApplication::exec()

Entra en el bucle principal de eventos y espera hasta que se llama a exit(), luego devuelve el valor que se estableció en exit() (que es 0 si exit() se llama a través de quit()).

Es necesario llamar a esta función para iniciar el manejo de eventos. El bucle principal de eventos recibe eventos del sistema de ventanas y los envía a los widgets de la aplicación.

Generalmente, ninguna interacción del usuario puede tener lugar antes de llamar a exec(). Como caso especial, los widgets modales como QMessageBox pueden utilizarse antes de llamar a exec(), porque los widgets modales llaman a exec() para iniciar un bucle de eventos local.

Para que su aplicación realice un procesamiento en reposo, es decir, ejecute una función especial siempre que no haya eventos pendientes, utilice QChronoTimer con un tiempo de espera de 0ns. Se pueden conseguir esquemas de procesamiento inactivo más avanzados utilizando processEvents().

Te recomendamos que conectes el código de limpieza a la señal aboutToQuit(), en lugar de ponerlo en la función main() de tu aplicación. Esto se debe a que, en algunas plataformas la llamada a QApplication::exec() puede no retornar. Por ejemplo, en la plataforma Windows, cuando el usuario cierra la sesión, el sistema termina el proceso después de que Qt cierre todas las ventanas de nivel superior. Por lo tanto, no hay garantía de que la aplicación tenga tiempo de salir de su bucle de eventos y ejecutar código al final de la función main(), después de la llamada a QApplication::exec().

Ver también quitOnLastWindowClosed, QCoreApplication::quit(), QCoreApplication::exit(), QCoreApplication::processEvents(), y QCoreApplication::exec().

[signal] void QApplication::focusChanged(QWidget *old, QWidget *now)

Esta señal se emite cuando el widget que tiene el foco del teclado cambia de old a now, es decir, porque el usuario pulsa la tecla de tabulación, hace clic en un widget o cambia la ventana activa. Tanto old como now pueden ser nullptr.

La señal se emite después de que ambos widgets hayan sido notificados del cambio a través de QFocusEvent.

Véase también QWidget::setFocus(), QWidget::clearFocus(), y Qt::FocusReason.

[static] QWidget *QApplication::focusWidget()

Devuelve el widget de la aplicación que tiene el foco de entrada de teclado, o nullptr si ningún widget de esta aplicación tiene el foco.

Véase también QWidget::setFocus(), QWidget::hasFocus(), activeWindow() y focusChanged().

[static] QFont QApplication::font()

Devuelve la fuente por defecto de la aplicación.

Véase también setFont(), fontMetrics() y QWidget::font().

[static] QFont QApplication::font(const QWidget *widget)

Devuelve la fuente predeterminada para widget. Si no se ha registrado una fuente predeterminada para la clase de widget, devuelve la fuente predeterminada de su superclase registrada más cercana.

Véase también fontMetrics(), setFont(), y QWidget::setFont().

[static] QFont QApplication::font(const char *className)

Devuelve el tipo de letra de los widgets de la dirección className.

Véase también setFont() y QWidget::font().

[static] bool QApplication::isEffectEnabled(Qt::UIEffect effect)

Devuelve true si effect está habilitado; en caso contrario devuelve false.

Por defecto, Qt intentará utilizar la configuración del escritorio. Para evitarlo, llame a setDesktopSettingsAware(false).

Véase también setEffectEnabled() y Qt::UIEffect.

[static] Qt::NavigationMode QApplication::navigationMode()

Devuelve qué tipo de navegación de enfoque está usando Qt.

Esta característica sólo está disponible en Qt para Embedded Linux.

Véase también setNavigationMode().

[override virtual] bool QApplication::notify(QObject *receiver, QEvent *e)

Reimplementa: QGuiApplication::notify(QObject *object, QEvent *event).

[static] QPalette QApplication::palette(const QWidget *widget)

Si se pasa un widget, se devuelve la paleta por defecto para la clase del widget. Esta puede o no ser la paleta de la aplicación. En la mayoría de los casos no hay una paleta especial para ciertos tipos de widgets, pero una excepción notable es el menú emergente en Windows, si el usuario ha definido un color de fondo especial para los menús en la configuración de pantalla.

Véase también setPalette() y QWidget::palette().

[static] QPalette QApplication::palette(const char *className)

Devuelve la paleta de widgets de la dirección className.

Véase también setPalette() y QWidget::palette().

[static] void QApplication::setEffectEnabled(Qt::UIEffect effect, bool enable = true)

Activa el efecto de interfaz de usuario effect si enable es verdadero; de lo contrario, el efecto no se utilizará.

Véase también isEffectEnabled(), Qt::UIEffect, y setDesktopSettingsAware().

[static] void QApplication::setFont(const QFont &font, const char *className = nullptr)

Cambia el tipo de letra por defecto de la aplicación a font. Si se pasa className, el cambio se aplica sólo a las clases que heredan className (tal y como informa QObject::inherits()).

Al iniciarse la aplicación, la fuente por defecto depende del sistema de ventanas. Puede variar en función de la versión del sistema de ventanas y de la configuración regional. Esta función te permite sobreescribir la fuente por defecto; pero sobreescribirla puede ser una mala idea porque, por ejemplo, algunas localizaciones necesitan fuentes extra grandes para soportar sus caracteres especiales.

Ver también font(), fontMetrics(), y QWidget::setFont().

[static] void QApplication::setNavigationMode(Qt::NavigationMode mode)

Establece el tipo de navegación de enfoque que Qt debe utilizar para mode.

Esta característica sólo está disponible en Qt para Embedded Linux.

Véase también navigationMode().

[static] void QApplication::setPalette(const QPalette &palette, const char *className = nullptr)

Cambia la paleta de la aplicación a palette.

Si se pasa className, el cambio se aplica sólo a los widgets que heredan className (tal y como informa QObject::inherits()). Si se deja className a 0, el cambio afecta a todos los widgets, anulando así cualquier paleta específica de clase establecida previamente.

La paleta puede cambiarse según el estilo GUI actual en QStyle::polish().

Véase también QWidget::setPalette(), palette() y QStyle::polish().

[static] void QApplication::setStyle(QStyle *style)

Establece el estilo GUI de la aplicación en style. La propiedad del objeto de estilo se transfiere a QApplication, por lo que QApplication borrará el objeto de estilo al salir de la aplicación o cuando se establezca un nuevo estilo y el estilo antiguo siga siendo el padre del objeto de la aplicación.

Ejemplo de uso:

QApplication::setStyle(QStyleFactory::create("Fusion"));

Cuando se cambian los estilos de la aplicación, la paleta de colores vuelve a los colores iniciales o a los predeterminados del sistema. Esto es necesario ya que ciertos estilos tienen que adaptar la paleta de colores para ser totalmente compatibles con la guía de estilo.

Establecer el estilo antes de que se haya establecido una paleta, es decir, antes de crear QApplication, hará que la aplicación utilice QStyle::standardPalette() para la paleta.

Ver también style(), QStyle, setPalette(), y desktopSettingsAware().

[static] QStyle *QApplication::setStyle(const QString &style)

Solicita un objeto QStyle para style desde QStyleFactory.

La cadena debe ser una de las QStyleFactory::keys(), normalmente una de "windows", "windowsvista", "fusion" o "macos". Los nombres de estilo no distinguen mayúsculas de minúsculas.

Devuelve nullptr si se pasa un style desconocido, de lo contrario el objeto QStyle devuelto se establece como el estilo GUI de la aplicación.

[static] QStyle *QApplication::style()

Devuelve el objeto de estilo de la aplicación.

Véase también setStyle() y QStyle.

[static] QWidget *QApplication::topLevelAt(const QPoint &point)

Devuelve el widget de nivel superior en el point dado ; devuelve nullptr si no existe tal widget.

[static] QWidget *QApplication::topLevelAt(int x, int y)

Devuelve el widget de nivel superior en el punto (x, y); devuelve 0 si no existe tal widget.

[static] QWidgetList QApplication::topLevelWidgets()

Devuelve una lista de los widgets de nivel superior (ventanas) de la aplicación.

Ejemplo:

void showAllHiddenTopLevelWidgets()
{
    const QWidgetList topLevelWidgets = QApplication::topLevelWidgets();
    for (QWidget *widget : topLevelWidgets) {
        if (widget->isHidden())
            widget->show();
    }
}

Véase también allWidgets(), QWidget::isWindow(), y QWidget::isHidden().

[static] QWidget *QApplication::widgetAt(const QPoint &point)

Devuelve el widget en la posición global de pantalla point, o nullptr si no hay ningún widget Qt allí.

Esta función puede ser lenta.

Véase también QCursor::pos(), QWidget::grabMouse(), y QWidget::grabKeyboard().

[static] QWidget *QApplication::widgetAt(int x, int y)

Devuelve el widget en la posición global de la pantalla (x, y), o nullptr si no hay ningún widget Qt allí.