En esta página

QGuiApplication Class

La clase QGuiApplication gestiona el flujo de control y la configuración principal de la aplicación GUI. Más información...

Encabezado: #include <QGuiApplication>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QCoreApplication
Heredado por:

QApplication

Propiedades

Funciones públicas

QGuiApplication(int &argc, char **argv)
virtual ~QGuiApplication()
qreal devicePixelRatio() const
bool isSavingSession() const
bool isSessionRestored() const
QNativeInterface *nativeInterface() const
QString sessionId() const
QString sessionKey() const

Funciones públicas reimplementadas

virtual bool notify(QObject *object, QEvent *event) override

Ranuras públicas

(since 6.5) void setBadgeNumber(qint64 number)

Señales

void applicationDisplayNameChanged()
void applicationStateChanged(Qt::ApplicationState state)
void commitDataRequest(QSessionManager &manager)
void focusObjectChanged(QObject *focusObject)
void focusWindowChanged(QWindow *focusWindow)
void fontDatabaseChanged()
void lastWindowClosed()
void layoutDirectionChanged(Qt::LayoutDirection direction)
void primaryScreenChanged(QScreen *screen)
void saveStateRequest(QSessionManager &manager)
void screenAdded(QScreen *screen)
void screenRemoved(QScreen *screen)

Miembros públicos estáticos

QWindowList allWindows()
QString applicationDisplayName()
Qt::ApplicationState applicationState()
void changeOverrideCursor(const QCursor &cursor)
QClipboard *clipboard()
QString desktopFileName()
bool desktopSettingsAware()
int exec()
QObject *focusObject()
QWindow *focusWindow()
QFont font()
Qt::HighDpiScaleFactorRoundingPolicy highDpiScaleFactorRoundingPolicy()
QInputMethod *inputMethod()
bool isLeftToRight()
bool isRightToLeft()
Qt::KeyboardModifiers keyboardModifiers()
Qt::LayoutDirection layoutDirection()
QWindow *modalWindow()
Qt::MouseButtons mouseButtons()
QCursor *overrideCursor()
QPalette palette()
QString platformName()
QScreen *primaryScreen()
Qt::KeyboardModifiers queryKeyboardModifiers()
bool quitOnLastWindowClosed()
void restoreOverrideCursor()
QScreen *screenAt(const QPoint &point)
QList<QScreen *> screens()
void setApplicationDisplayName(const QString &name)
void setDesktopFileName(const QString &name)
void setDesktopSettingsAware(bool on)
void setFont(const QFont &font)
void setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy policy)
void setLayoutDirection(Qt::LayoutDirection direction)
void setOverrideCursor(const QCursor &cursor)
void setPalette(const QPalette &pal)
void setQuitOnLastWindowClosed(bool quit)
void setWindowIcon(const QIcon &icon)
QStyleHints *styleHints()
void sync()
QWindow *topLevelAt(const QPoint &pos)
QWindowList topLevelWindows()
QIcon windowIcon()

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Macros

Descripción detallada

QGuiApplication contiene el bucle de eventos principal, donde se procesan y distribuyen todos los eventos procedentes del sistema de ventanas y de otras fuentes. También se encarga de la inicialización y finalización de la aplicación, y proporciona la gestión de sesiones. Además, QGuiApplication gestiona la mayoría de los ajustes a nivel de sistema y de aplicación.

Para cualquier aplicación GUI que utilice Qt, existe exactamente un objeto QGuiApplication, independientemente de si la aplicación tiene 0, 1, 2 o más ventanas en un momento dado. Para aplicaciones Qt sin interfaz gráfica de usuario, utilice en su lugar ` QCoreApplication `, ya que no depende del módulo ` Qt GUI `. Para aplicaciones Qt basadas en ` QWidget `, utilice en su lugar ` QApplication `, ya que proporciona algunas funcionalidades necesarias para crear instancias de ` QWidget `.

Se puede acceder al objeto `QGuiApplication` a través de la función ` instance()`, que devuelve un puntero equivalente al puntero global ` qApp `.

Las principales áreas de responsabilidad de QGuiApplication son:

  • Inicializa la aplicación con la configuración del escritorio del usuario, como palette(), font() y styleHints(). Realiza un seguimiento de estas propiedades por si el usuario modifica la configuración del escritorio a nivel global, por ejemplo, a través de algún tipo de panel de control.
  • Se encarga de la gestión de eventos, lo que significa que recibe eventos del sistema de ventanas subyacente y los distribuye a los widgets pertinentes. Puedes enviar tus propios eventos a las ventanas utilizando sendEvent() y postEvent().
  • Analiza los argumentos comunes de la línea de comandos y establece su estado interno en consecuencia. Consulte la función ` constructor documentation ` más abajo para obtener más detalles.
  • Permite la localización de las cadenas visibles para el usuario mediante translate().
  • Proporciona algunos objetos «mágicos» como el clipboard().
  • Tiene conocimiento de las ventanas de la aplicación. Puedes consultar qué ventana se encuentra en una posición determinada mediante ` topLevelAt()`, obtener una lista de ` topLevelWindows()`, etc.
  • Gestiona el manejo del cursor del ratón de la aplicación; véase setOverrideCursor().
  • Ofrece soporte para una gestión sofisticada de sesiones. Esto permite que las aplicaciones se cierren de forma controlada cuando el usuario cierre la sesión, que se cancele un proceso de apagado si no es posible el cierre e incluso que se conserve todo el estado de la aplicación para una sesión futura. Véanse isSessionRestored(), sessionId() y commitDataRequest() y saveStateRequest() para más detalles.

Dado que el objeto `QGuiApplication` realiza una gran cantidad de tareas de inicialización, debe crearse antes de que se creen cualquier otro objeto relacionado con la interfaz de usuario. `QGuiApplication` también gestiona los argumentos comunes de la línea de comandos. Por lo tanto, suele ser recomendable crearlo antes de que se realice cualquier interpretación o modificación de ` argv ` en la propia aplicación.

Grupos de funciones
Configuración del sistemadesktopSettingsAware(), setDesktopSettingsAware(), styleHints(), palette(), setPalette(), font(), setFont().
Gestión de eventosexec(), processEvents(), exit(), quit(). sendEvent(), postEvent(), sendPostedEvents(), removePostedEvents(), notify().
WindowsallWindows(), topLevelWindows(), focusWindow(), clipboard(), topLevelAt().
Manejo avanzado del cursoroverrideCursor(), setOverrideCursor(), restoreOverrideCursor().
Gestión de sesionesisSessionRestored(), sessionId(), commitDataRequest(), saveStateRequest().
VariosstartingUp(), closingDown().

Véase también QCoreApplication, QAbstractEventDispatcher y QEventLoop.

Documentación de propiedades

applicationDisplayName : QString

Esta propiedad contiene el nombre de esta aplicación tal y como lo ve el usuario

Este nombre se muestra al usuario, por ejemplo, en los títulos de las ventanas. Se puede traducir, si es necesario.

Si no se configura, el nombre que se muestra de la aplicación será, por defecto, el nombre de la aplicación.

Funciones de acceso:

QString applicationDisplayName()
void setApplicationDisplayName(const QString &name)

Señal de notificación:

void applicationDisplayNameChanged()

Véase también applicationName.

desktopFileName : QString

Esta propiedad contiene el nombre base de la entrada de escritorio de esta aplicación

Se trata del nombre del archivo, sin la ruta completa ni la extensión «.desktop» al final, de la entrada de escritorio que representa a esta aplicación según la especificación de entradas de escritorio de freedesktop.

Esta propiedad indica con precisión qué entrada de escritorio representa a la aplicación y es necesaria para que el sistema de ventanas pueda recuperar dicha información sin recurrir a heurísticas imprecisas.

La última versión de la especificación de entradas de escritorio de freedesktop se puede obtener aquí.

Funciones de acceso:

QString desktopFileName()
void setDesktopFileName(const QString &name)

layoutDirection : Qt::LayoutDirection

Esta propiedad establece la dirección de diseño predeterminada para esta aplicación

Al iniciar el sistema, o cuando la dirección se establece explícitamente en « Qt::LayoutDirectionAuto », la dirección de diseño predeterminada depende del idioma de la aplicación.

La señal notifier se introdujo en Qt 5.4.

Funciones de acceso:

Qt::LayoutDirection layoutDirection()
void setLayoutDirection(Qt::LayoutDirection direction)

Señal «notifier»:

void layoutDirectionChanged(Qt::LayoutDirection direction)

Véase también QWidget::layoutDirection, isLeftToRight() y isRightToLeft().

[read-only] platformName : const QString

Esta propiedad contiene el nombre del complemento de la plataforma subyacente.

Los complementos de plataforma de QPA se encuentran en qtbase\src\plugins\platforms. En el momento de redactar este documento, se admiten los siguientes nombres de complementos de plataforma:

  • android
  • cocoa es un complemento de plataforma para macOS.
  • directfb
  • eglfs es un complemento de plataforma para ejecutar aplicaciones Qt5 sobre EGL y OpenGL ES 2.0 sin un sistema de ventanas propiamente dicho (como X11 o Wayland). Para obtener más información, consulta EGLFS.
  • ios (también se utiliza para tvOS)
  • linuxfb escribe directamente en el búfer de fotogramas. Para obtener más información, consulta LinuxFB.
  • minimal Se proporciona como ejemplo para los desarrolladores que deseen crear sus propios complementos de plataforma. No obstante, puedes utilizar el complemento para ejecutar aplicaciones con interfaz gráfica de usuario (GUI) en entornos que carecen de ella, como los servidores.
  • minimalegl Es un complemento de ejemplo.
  • offscreen
  • qnx
  • windows
  • wayland Es un complemento de plataforma para el protocolo del servidor de pantalla Wayland, utilizado en algunos escritorios Linux y sistemas embebidos.
  • xcb es un complemento para el sistema de ventanas X11, utilizado en algunas plataformas de escritorio Linux.

Nota: Si se llama a esta función sin un ` QGuiApplication `, se devolverá el nombre de plataforma predeterminado, si está disponible. El nombre de plataforma predeterminado no se ve afectado por la opción de línea de comandos ` -platform ` ni por la variable de entorno ` QT_QPA_PLATFORM `.

Para obtener más información sobre los complementos de plataforma para dispositivos Linux embebidos, consulta Qt para Linux embebido.

Funciones de acceso:

QString platformName()

[read-only] primaryScreen : QScreen*

Esta propiedad define la pantalla principal (o predeterminada) de la aplicación.

Esta será la pantalla en la que se mostrarán inicialmente las ventanas QWindows, salvo que se especifique lo contrario.

La señal `primaryScreenChanged` se introdujo en Qt 5.6.

Funciones de acceso:

QScreen *primaryScreen()

Señal Notifier:

void primaryScreenChanged(QScreen *screen)

Véase también ` screens()`.

quitOnLastWindowClosed : bool

Esta propiedad indica si la aplicación se cierra implícitamente al cerrar la última ventana.

El valor predeterminado es « true ».

Si esta propiedad es « true », la aplicación intentará cerrarse cuando se cierre la última ventana primaria visible (es decir, la ventana de nivel superior sin ninguna ventana padre transitoria).

Ten en cuenta que intentar cerrar la aplicación no implica necesariamente que esta se cierre, por ejemplo, si aún hay instancias activas de « QEventLoopLocker » o si se ignora el evento « QEvent::Quit ».

Funciones de acceso:

bool quitOnLastWindowClosed()
void setQuitOnLastWindowClosed(bool quit)

Véase también quit() y QWindow::close().

windowIcon : QIcon

Esta propiedad contiene el icono predeterminado de la ventana

Funciones de acceso:

QIcon windowIcon()
void setWindowIcon(const QIcon &icon)

Véase también QWindow::setIcon() y Configuración del icono de la aplicación.

Documentación de las funciones de miembro

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

Inicializa el sistema de ventanas y crea un objeto de aplicación con los argumentos de la línea de comandos de argc que se indican en argv.

Advertencia: Los datos a los que hacen referencia argc y argv deben permanecer válidos durante toda la vida útil del objeto QGuiApplication. Además, argc debe ser mayor que cero y argv debe contener al menos una cadena de caracteres válida.

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

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

Nota: « argc » y « argv » pueden cambiar, ya que Qt elimina los argumentos de la línea de comandos que reconoce.

Opciones de línea de comandos admitidas

Todos los programas Qt admiten automáticamente un conjunto de opciones de línea de comandos que permiten modificar la forma en que Qt interactúa con el sistema de ventanas. También se puede acceder a algunas de estas opciones a través de variables de entorno, que son la forma preferida si la aplicación puede iniciar subprocesos de interfaz gráfica de usuario u otras aplicaciones (los procesos hijos heredarán las variables de entorno). En caso de duda, utiliza las variables de entorno.

Las opciones compatibles actualmente son las siguientes:

  • -platformplatformName[ :options], especifica el complemento Qt Platform Abstraction (QPA).

    Anula la variable de entorno ` QT_QPA_PLATFORM `.

  • -platformpluginpath path: especifica la ruta a los complementos de la plataforma.

    Anula la variable de entorno ` QT_QPA_PLATFORM_PLUGIN_PATH `.

  • -platformtheme platformTheme: especifica el tema de la plataforma.

    Anula la variable de entorno « QT_QPA_PLATFORMTHEME ».

  • -plugin plugin: especifica los complementos adicionales que se deben cargar. El argumento puede aparecer varias veces.

    Se concatena con los complementos de la variable de entorno « QT_QPA_GENERIC_PLUGINS ».

  • -qmljsdebugger=, activa el depurador de 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.
  • -qwindowgeometry geometry, especifica la geometría de la ventana principal utilizando la sintaxis de X11. Por ejemplo: -qwindowgeometry 100x100+50+50
  • -qwindowicon, establece el icono predeterminado de la ventana
  • -qwindowtitle, establece el título de la primera ventana
  • -reverse, establece la dirección de disposición de la aplicación en Qt::RightToLeft. Esta opción está pensada para facilitar la depuración y no debe utilizarse en entornos de producción. El valor por defecto se detecta automáticamente a partir de la configuración regional del usuario (véase también QLocale::textDirection()).
  • -session session, restaura la aplicación a partir de una sesión anterior.

Las siguientes opciones estándar de la línea de comandos están disponibles para X11:

  • -display nombre_del_host:número_de_pantalla, cambia de pantalla en X11.

    Anula la variable de entorno ` DISPLAY `.

  • -geometry geometría, igual que -qwindowgeometry.

Argumentos específicos de la plataforma

Se pueden especificar argumentos específicos de la plataforma para la opción « -platform ». Colócalos después del nombre del complemento de la plataforma, seguidos de dos puntos, en forma de lista separada por comas. Por ejemplo: « -platform windows:dialogs=xp,fontengine=freetype ».

Los siguientes parámetros están disponibles para -platform windows:

  • altgr, detecta la tecla « AltGr » presente en algunos teclados como « Qt::GroupSwitchModifier » (desde Qt 5.12).
  • darkmode=[0|1|2] controla cómo responde Qt a la activación del modo oscuro para aplicaciones introducido en Windows 10 1903 (desde Qt 5.15).

    Un valor de 0 desactiva la compatibilidad con el modo oscuro.

    Un valor de 1 hace que Qt cambie los bordes de las ventanas a negro cuando se activa el modo oscuro para aplicaciones y no se está utilizando ningún tema de alto contraste. Está pensado para aplicaciones que implementan su propia personalización de temas.

    Además, un valor de 2 provocará que se desactive el estilo de Windows Vista y se cambie al estilo de Windows utilizando una paleta simplificada en el modo oscuro. Actualmente, esta opción es experimental a la espera de la introducción de un nuevo estilo que se adapte adecuadamente al modo oscuro.

    A partir de Qt 6.5, el valor por defecto es 2; para desactivar la compatibilidad con el modo oscuro, establece el valor en 0 o 1.

  • dialogs=[xp|none], xp utiliza cuadros de diálogo nativos al estilo XP y none los desactiva.
  • fontengine=freetype, utiliza el motor de fuentes FreeType.
  • fontengine=gdi, utiliza la base de datos de fuentes heredada basada en GDI y, por defecto, utiliza el motor de fuentes GDI (que, por lo demás, solo se utiliza para algunos tipos de fuentes o propiedades de fuentes). (Desde Qt 6.8).
  • menus=[native|none], controla el uso de los menús nativos.

    Los menús nativos se implementan mediante la API de Win32 y son más sencillos que los menús basados en « QMenu », por ejemplo, en que permiten colocar widgets en ellos o cambiar propiedades como las fuentes, y no proporcionan señales al pasar el cursor por encima. Están pensados principalmente para Qt Quick. Por defecto, se utilizarán si la aplicación no es una instancia de QApplication o para Qt Quick Controls 2 (desde Qt 5.10).

  • nocolorfonts Desactivar las fuentes DirectWrite Color (desde Qt 5.8).
  • nodirectwrite Desactiva las fuentes DirectWrite (desde Qt 5.8). Esto también selecciona implícitamente el motor de fuentes GDI.
  • nomousefromtouch Ignora los eventos de ratón sintetizados a partir de eventos táctiles por el sistema operativo.
  • nowmpointer Cambia del manejo de mensajes de entrada del puntero al manejo tradicional del ratón (desde Qt 5.12).
  • reverse Activa el modo de escritura de derecha a izquierda (experimental). Las barras de título de Windows se mostrarán en consecuencia en las configuraciones regionales de escritura de derecha a izquierda (desde Qt 5.13).
  • tabletabsoluterange=<value> Establece un valor para la detección del modo de ratón de las tabletas WinTab (heredado, desde Qt 5.3).

El siguiente parámetro está disponible para « -platform cocoa » (en macOS):

  • fontengine=freetype, utiliza el motor de fuentes FreeType.

Para obtener más información sobre los argumentos específicos de la plataforma disponibles para plataformas Linux embebidas, consulta Qt para Linux embebido.

Véase también « arguments » () y « QGuiApplication::platformName ».

[virtual noexcept] QGuiApplication::~QGuiApplication()

Cierra la aplicación.

[static] QWindowList QGuiApplication::allWindows()

Devuelve una lista de todas las ventanas de la aplicación.

La lista estará vacía si no hay ventanas.

Véase también topLevelWindows().

[static] Qt::ApplicationState QGuiApplication::applicationState()

Devuelve el estado actual de la aplicación.

Puedes reaccionar ante los cambios en el estado de la aplicación para realizar acciones como detener o reanudar tareas que consumen muchos recursos de la CPU, liberar o cargar recursos, o guardar o restaurar datos de la aplicación.

[signal] void QGuiApplication::applicationStateChanged(Qt::ApplicationState state)

Esta señal se emite cuando cambia la propiedad « state » de la aplicación.

Véase también applicationState().

[static] void QGuiApplication::changeOverrideCursor(const QCursor &cursor)

Cambia el cursor de anulación de la aplicación actualmente activa por cursor.

Esta función no tiene ningún efecto si no se ha llamado a setOverrideCursor().

Véase también setOverrideCursor(), overrideCursor(), restoreOverrideCursor() y QWidget::setCursor().

[static] QClipboard *QGuiApplication::clipboard()

Devuelve el objeto que permite interactuar con el portapapeles.

[signal] void QGuiApplication::commitDataRequest(QSessionManager &manager)

Esta señal se encarga de la gestión de sesiones. Se emite cuando el servidor de la aplicación ( QSessionManager ) desea que la aplicación guarde todos sus datos.

Normalmente, esto implica guardar todos los archivos abiertos, tras obtener el permiso del usuario. Además, es posible que quieras ofrecer al usuario un medio para cancelar el cierre.

No debes cerrar la aplicación dentro de esta señal. En su lugar, el gestor de sesiones puede hacerlo o no posteriormente, dependiendo del contexto.

Advertencia: Dentro de esta señal, no es posible ninguna interacción con el usuario, a menos que se solicite permiso explícito al « manager ». Consulte QSessionManager::allowsInteraction() y QSessionManager::allowsErrorInteraction() para obtener más detalles y ejemplos de uso.

Nota: Debe utilizar Qt::DirectConnection al conectarse a esta señal.

Véase también isSessionRestored(), sessionId(), saveStateRequest() y «Gestión de sesiones».

[static] bool QGuiApplication::desktopSettingsAware()

Devuelve « true » si Qt está configurado para utilizar los colores, fuentes, etc., estándar del sistema; en caso contrario, devuelve « false ». El valor por defecto es « true ».

Véase también setDesktopSettingsAware().

qreal QGuiApplication::devicePixelRatio() const

Devuelve la relación de píxeles de pantalla más alta detectada en el sistema. Se trata de la relación entre los píxeles físicos y los píxeles independientes del dispositivo.

Utiliza esta función solo cuando no sepas a qué ventana te diriges. Si conoces la ventana de destino, utiliza en su lugar QWindow::devicePixelRatio() .

Véase también QWindow::devicePixelRatio().

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

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

[static] int QGuiApplication::exec()

Entra en el bucle de eventos principal y espera hasta que se llame a ` exit()`, tras lo cual devuelve el valor que se había establecido en ` exit()` (que es 0 si se llama a ` exit()` a través de ` quit()`).

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

Por lo general, no puede producirse ninguna interacción del usuario antes de llamar a `exec()`.

Para que tu aplicación realice un procesamiento en espera, por ejemplo, ejecutando una función especial siempre que no haya eventos pendientes, utiliza un QChronoTimer con un tiempo de espera de 0 ns. Se pueden lograr esquemas de procesamiento en espera más avanzados utilizando processEvents().

Recomendamos conectar el código de limpieza a la señal aboutToQuit(), en lugar de incluirlo en la función main() de su aplicación. Esto se debe a que, en algunas plataformas, es posible que la llamada QApplication::exec() no devuelva ningún resultado.

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

[static] QObject *QGuiApplication::focusObject()

Devuelve el objeto ` QObject ` de la ventana actualmente activa que será el receptor final de los eventos relacionados con el foco, como los eventos de teclas.

[signal] void QGuiApplication::focusObjectChanged(QObject *focusObject)

Esta señal se emite cuando cambia el receptor final de los eventos vinculados al foco. focusObject es el nuevo receptor.

Véase también focusObject().

[static] QWindow *QGuiApplication::focusWindow()

Devuelve el objeto ` QWindow ` que recibe los eventos relacionados con el foco, como los eventos de teclado.

Véase también QWindow::requestActivate().

[signal] void QGuiApplication::focusWindowChanged(QWindow *focusWindow)

Esta señal se emite cuando cambia la ventana activa. ` focusWindow ` es la nueva ventana activa.

Véase también focusWindow().

[static] QFont QGuiApplication::font()

Devuelve la fuente predeterminada de la aplicación.

Véase también setFont().

[signal] void QGuiApplication::fontDatabaseChanged()

Esta señal se emite cuando cambian las fuentes disponibles.

Esto puede ocurrir cuando se añaden o eliminan fuentes de la aplicación, o cuando cambian las fuentes del sistema.

Véase también QFontDatabase::addApplicationFont(), QFontDatabase::addApplicationFontFromData(), QFontDatabase::removeAllApplicationFonts() y QFontDatabase::removeApplicationFont().

[static] Qt::HighDpiScaleFactorRoundingPolicy QGuiApplication::highDpiScaleFactorRoundingPolicy()

Devuelve la política de redondeo del factor de escala para alta resolución (DPI).

Véase también setHighDpiScaleFactorRoundingPolicy().

[static] QInputMethod *QGuiApplication::inputMethod()

devuelve el método de entrada.

El método de entrada devuelve propiedades sobre el estado y la posición del teclado virtual. También proporciona información sobre la posición del elemento de entrada que tiene el foco en ese momento.

Véase también QInputMethod.

[static] bool QGuiApplication::isLeftToRight()

Devuelve true si la dirección de diseño de la aplicación es Qt::LeftToRight; en caso contrario, devuelve false.

Véase también layoutDirection() y isRightToLeft().

[static] bool QGuiApplication::isRightToLeft()

Devuelve « true » si la dirección de diseño de la aplicación es « Qt::RightToLeft »; en caso contrario, devuelve « false ».

Véase también layoutDirection() y isLeftToRight().

bool QGuiApplication::isSavingSession() const

Devuelve « true » si la aplicación está guardando la sesión en ese momento; en caso contrario, devuelve « false ».

Este valor es true cuando se emiten commitDataRequest() y saveStateRequest(), pero también cuando la gestión de sesiones cierra posteriormente las ventanas.

Véase también sessionId(), commitDataRequest() y saveStateRequest().

bool QGuiApplication::isSessionRestored() const

Devuelve « true » si la aplicación se ha restaurado a partir de una sesión anterior; en caso contrario, devuelve « false ».

Véase también sessionId(), commitDataRequest() y saveStateRequest().

[static] Qt::KeyboardModifiers QGuiApplication::keyboardModifiers()

Devuelve el estado actual de las teclas modificadoras del teclado. El estado actual se actualiza de forma sincrónica a medida que se vacía la cola de eventos de aquellos que modifican espontáneamente el estado del teclado (eventos «QEvent::KeyPress » y « QEvent::KeyRelease »).

Cabe señalar que es posible que esto no refleje las teclas que se mantienen pulsadas en el dispositivo de entrada en el momento de la llamada, sino más bien los modificadores tal y como se indicaron por última vez en uno de los eventos mencionados anteriormente. Si no hay ninguna tecla pulsada, se devuelve Qt::NoModifier.

Véanse también mouseButtons() y queryKeyboardModifiers().

[signal] void QGuiApplication::lastWindowClosed()

exec() emite esta señal cuando se cierra la última ventana principal visible (es decir, una ventana de nivel superior sin ventana padre transitoria).

Por defecto, QGuiApplication se cierra tras la emisión de esta señal. Esta característica se puede desactivar configurando quitOnLastWindowClosed como false.

Véase también QWindow::close(), QWindow::isTopLevel() y QWindow::transientParent().

Devuelve la ventana modal que se ha mostrado más recientemente. Si no hay ninguna ventana modal visible, esta función devuelve cero.

Una ventana modal es aquella cuya propiedad ` modality ` está establecida en ` Qt::WindowModal ` o ` Qt::ApplicationModal`. Una ventana modal debe cerrarse antes de que el usuario pueda continuar con otras partes del programa.

Las ventanas modales se organizan en una pila. Esta función devuelve la ventana modal situada en la parte superior de la pila.

Véase también Qt::WindowModality y QWindow::setModality().

[static] Qt::MouseButtons QGuiApplication::mouseButtons()

Devuelve el estado actual de los botones del ratón. El estado actual se actualiza de forma sincrónica a medida que se vacía la cola de eventos de aquellos que modifican espontáneamente el estado del ratón (eventos «QEvent::MouseButtonPress » y « QEvent::MouseButtonRelease »).

Cabe señalar que es posible que esto no refleje los botones realmente pulsados en el dispositivo de entrada en el momento de la llamada, sino más bien los botones del ratón tal y como se indicaron por última vez en uno de los eventos mencionados anteriormente. Si no hay ningún botón del ratón pulsado, se devuelve Qt::NoButton.

Véase también keyboardModifiers().

template <typename QNativeInterface> QNativeInterface *QGuiApplication::nativeInterface() const

Devuelve una interfaz nativa del tipo indicado para la aplicación.

Esta función proporciona acceso a la funcionalidad específica de la plataforma de QGuiApplication, tal y como se define en el espacio de nombres QNativeInterface:

QNativeInterface::QWaylandApplication

Interfaz nativa para una aplicación Wayland

QNativeInterface::QX11Application

Interfaz nativa para una aplicación X11

Si la interfaz solicitada no está disponible, se devuelve un objeto ` nullptr `.

[override virtual] bool QGuiApplication::notify(QObject *object, QEvent *event)

Reimplementa: ` QCoreApplication::notify` (`QObject *receiver, QEvent *event)`.

[static] QCursor *QGuiApplication::overrideCursor()

Devuelve el cursor de anulación de la aplicación activa.

Esta función devuelve un valor de tipo « nullptr » si no se ha definido ningún cursor de aplicación (es decir, si la pila interna de cursores está vacía).

Véanse también setOverrideCursor() y restoreOverrideCursor().

[static] QPalette QGuiApplication::palette()

Devuelve la paleta de la aplicación actual.

Los roles que no se hayan establecido explícitamente reflejarán el tema de la plataforma del sistema.

Véase también setPalette().

[static] Qt::KeyboardModifiers QGuiApplication::queryKeyboardModifiers()

Consulta y devuelve el estado de las teclas modificadoras del teclado. A diferencia de ` keyboardModifiers`, este método devuelve las teclas que están realmente pulsadas en el dispositivo de entrada en el momento de llamar al método.

No depende de que este proceso haya recibido los eventos de pulsación de teclas, lo que permite comprobar los modificadores mientras se desplaza una ventana, por ejemplo. Ten en cuenta que, en la mayoría de los casos, debes utilizar keyboardModifiers(), que es más rápido y preciso, ya que contiene el estado de los modificadores tal y como estaban cuando se recibió el evento que se está procesando actualmente.

Véase también ` keyboardModifiers()`.

[static] void QGuiApplication::restoreOverrideCursor()

Anula la última llamada a setOverrideCursor().

Si se ha llamado dos veces a setOverrideCursor(), al llamar a restoreOverrideCursor() se activará el primer conjunto de cursores. Al llamar a esta función por segunda vez, se restablecen los cursores originales de los widgets.

Véanse también setOverrideCursor() y overrideCursor().

[signal] void QGuiApplication::saveStateRequest(QSessionManager &manager)

Esta señal se encarga de la gestión de sesiones. Se activa cuando el « session manager » desea que la aplicación conserve su estado para una sesión futura.

Por ejemplo, un editor de texto crearía un archivo temporal que incluyera el contenido actual de sus búferes de edición, la posición del cursor y otros aspectos de la sesión de edición en curso.

Nunca debes salir de la aplicación dentro de esta señal. En su lugar, el gestor de sesiones puede hacerlo o no posteriormente, dependiendo del contexto. Además, es muy probable que la mayoría de los gestores de sesiones soliciten un estado guardado inmediatamente después de que se haya iniciado la aplicación. Esto permite al gestor de sesiones conocer la política de reinicio de la aplicación.

Advertencia: Dentro de esta señal, no es posible ninguna interacción con el usuario, a menos que se solicite permiso explícito a la función ` manager `. Consulte ` QSessionManager::allowsInteraction()` y ` QSessionManager::allowsErrorInteraction()` para obtener más detalles.

Nota: Debe utilizar Qt::DirectConnection al conectarse a esta señal.

Véase también isSessionRestored(), sessionId(), commitDataRequest() y «Gestión de sesiones».

[signal] void QGuiApplication::screenAdded(QScreen *screen)

Esta señal se emite cada vez que se añade una nueva pantalla screen al sistema.

Véase también screens(), primaryScreen y screenRemoved().

[static] QScreen *QGuiApplication::screenAt(const QPoint &point)

Devuelve la pantalla en point, o nullptr si se encuentra fuera de cualquier pantalla.

La point está relacionada con la virtualGeometry() de cada conjunto de elementos hermanos virtuales. Si el punto se corresponde con más de un conjunto de elementos hermanos virtuales, se devuelve la primera coincidencia. Si deseas buscar únicamente entre los elementos hermanos del escritorio virtual de una pantalla conocida (por ejemplo, los elementos hermanos de la pantalla de la ventana de tu aplicación QWidget::windowHandle()->screen()), utiliza QScreen::virtualSiblingAt().

[signal] void QGuiApplication::screenRemoved(QScreen *screen)

Esta señal se emite cada vez que se elimina un « screen » del sistema. Ofrece la oportunidad de gestionar las ventanas de la pantalla antes de que Qt recurra a moverlas a la pantalla principal.

Véanse también screens(), screenAdded(), QObject::destroyed() y QWindow::setScreen().

[static] QList<QScreen *> QGuiApplication::screens()

Devuelve una lista de todas las pantallas asociadas al sistema de ventanas al que está conectada la aplicación.

QString QGuiApplication::sessionId() const

Devuelve el identificador de la sesión actual.

Si la aplicación se ha restaurado a partir de una sesión anterior, este identificador es el mismo que el de dicha sesión anterior. Se garantiza que el identificador de sesión es único tanto para diferentes aplicaciones como para diferentes instancias de la misma aplicación.

Véase también isSessionRestored(), sessionKey(), commitDataRequest() y saveStateRequest().

QString QGuiApplication::sessionKey() const

Devuelve la clave de sesión de la sesión actual.

Si la aplicación se ha restaurado a partir de una sesión anterior, esta clave es la misma que había cuando finalizó la sesión anterior.

La clave de sesión cambia cada vez que se guarda la sesión. Si se cancela el proceso de apagado, se utilizará otra clave de sesión al volver a apagar el sistema.

Véase también isSessionRestored(), sessionId(), commitDataRequest() y saveStateRequest().

[slot, since 6.5] void QGuiApplication::setBadgeNumber(qint64 number)

Establece la insignia de la aplicación en « number ».

Resulta útil para informar al usuario sobre el número de mensajes no leídos o aspectos similares.

La insignia se superpondrá al icono de la aplicación en el Dock de macOS, en el icono de la pantalla de inicio de iOS o en la barra de tareas de Windows y Linux.

Si el número está fuera del rango admitido por la plataforma, se ajustará al rango admitido. Si el número no cabe en la insignia, es posible que se elida visualmente.

Si se establece el número en 0, se borrará la insignia.

Esta función se introdujo en Qt 6.5.

Véase también applicationName.

[static] void QGuiApplication::setDesktopSettingsAware(bool on)

Establece si Qt debe utilizar los colores, fuentes, etc., estándar del sistema en ` on`. Por defecto, el valor es ` true`.

Esta función debe llamarse antes de crear el objeto ` QGuiApplication `, de la siguiente manera:

int main(int argc, char *argv[])
{
    QApplication::setDesktopSettingsAware(false);
    QApplication app(argc, argv);
    // ...
    return app.exec();
}

Véase también desktopSettingsAware().

[static] void QGuiApplication::setFont(const QFont &font)

Cambia la fuente predeterminada de la aplicación a « font ».

Véase también font().

[static] void QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy policy)

Establece la política de redondeo del factor de escala de alta resolución (DPI) para la aplicación. El « policy » determina cómo se gestionan los factores de escala no enteros (como el 150 % de Windows).

Las dos opciones principales son si los factores de escala fraccionarios deben redondearse a un número entero o no. Mantener el factor de escala tal cual hará que el tamaño de la interfaz de usuario coincida exactamente con la configuración del sistema operativo, pero puede provocar errores de renderizado, por ejemplo, con el estilo de Windows.

Si se desea aplicar el redondeo, a continuación hay que decidir qué tipo de redondeo se debe utilizar. Se admite el redondeo matemáticamente correcto, pero puede que no ofrezca los mejores resultados visuales: considera si deseas representar 1,5x como 1x («interfaz de usuario pequeña») o como 2x («interfaz de usuario grande»). Consulta la enumeración ` Qt::HighDpiScaleFactorRoundingPolicy ` para obtener una lista completa de todas las opciones.

Esta función debe llamarse antes de crear el objeto de la aplicación. El accesor QGuiApplication::highDpiScaleFactorRoundingPolicy() reflejará la configuración del entorno, si está definida.

El valor por defecto es Qt::HighDpiScaleFactorRoundingPolicy::PassThrough.

Véase también highDpiScaleFactorRoundingPolicy().

[static] void QGuiApplication::setOverrideCursor(const QCursor &cursor)

Establece el cursor de anulación de la aplicación en « cursor ».

Los cursores de anulación de la aplicación están pensados para indicar al usuario que la aplicación se encuentra en un estado especial, por ejemplo, durante una operación que puede tardar algún tiempo.

Este cursor se mostrará en todos los widgets de la aplicación hasta que se llame a ` restoreOverrideCursor()` u otra llamada a `setOverrideCursor()`.

Los cursores de la aplicación se almacenan en una pila interna. setOverrideCursor() inserta el cursor en la pila, y restoreOverrideCursor() extrae el cursor activo de la pila. changeOverrideCursor() cambia el cursor de anulación de la aplicación actualmente activo.

Cada llamada a `setOverrideCursor()` debe ir seguida, en algún momento, de la correspondiente llamada a ` restoreOverrideCursor()`, ya que, de lo contrario, la pila nunca se vaciará.

Ejemplo:

QGuiApplication::setOverrideCursor(QCursor(Qt::WaitCursor));
calculateHugeMandelbrot();              // lunch time...
QGuiApplication::restoreOverrideCursor();

Véanse también overrideCursor(), restoreOverrideCursor(), changeOverrideCursor() y QWidget::setCursor().

[static] void QGuiApplication::setPalette(const QPalette &pal)

Cambia la paleta de la aplicación a pal.

Los colores de esta paleta se combinan con el tema de la plataforma del sistema para formar la paleta definitiva de la aplicación.

Véase también palette().

[static] QStyleHints *QGuiApplication::styleHints()

Devuelve las sugerencias de estilo de la aplicación.

Las sugerencias de estilo engloban un conjunto de propiedades dependientes de la plataforma, como los intervalos entre clics dobles, la selección a ancho completo y otras.

Estas sugerencias pueden utilizarse para lograr una integración más estrecha con la plataforma subyacente.

Véase también QStyleHints.

[static] void QGuiApplication::sync()

Función que se puede utilizar para sincronizar el estado de Qt con el estado del sistema de ventanas.

Esta función vaciará primero los eventos de Qt llamando a ` QCoreApplication::processEvents()`, a continuación el complemento de la plataforma se sincronizará con el sistema de ventanas y, por último, los eventos de Qt se entregarán mediante otra llamada a ` QCoreApplication::processEvents()`;

Esta función requiere mucho tiempo y no se recomienda su uso.

[static] QWindow *QGuiApplication::topLevelAt(const QPoint &pos)

Devuelve la ventana de nivel superior situada en la posición indicada pos, si existe.

[static] QWindowList QGuiApplication::topLevelWindows()

Devuelve una lista de las ventanas de nivel superior de la aplicación.

Véase también allWindows().

Documentación de macros

qGuiApp

Un puntero global que hace referencia al objeto único de la aplicación. Solo es válido cuando dicho objeto es un ` QGuiApplication`.

Véase también ` QCoreApplication::instance()` y ` qApp`.

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