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: |
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 sistema | desktopSettingsAware(), setDesktopSettingsAware(), styleHints(), palette(), setPalette(), font(), setFont(). |
| Gestión de eventos | exec(), processEvents(), exit(), quit(). sendEvent(), postEvent(), sendPostedEvents(), removePostedEvents(), notify(). |
| Windows | allWindows(), topLevelWindows(), focusWindow(), clipboard(), topLevelAt(). |
| Manejo avanzado del cursor | overrideCursor(), setOverrideCursor(), restoreOverrideCursor(). |
| Gestión de sesiones | isSessionRestored(), sessionId(), commitDataRequest(), saveStateRequest(). |
| Varios | startingUp(), 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:
androidcocoaes un complemento de plataforma para macOS.directfbeglfses 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)linuxfbescribe directamente en el búfer de fotogramas. Para obtener más información, consulta LinuxFB.minimalSe 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.minimaleglEs un complemento de ejemplo.offscreenqnxwindowswaylandEs un complemento de plataforma para el protocolo del servidor de pantalla Wayland, utilizado en algunos escritorios Linux y sistemas embebidos.xcbes 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`.-platformpluginpathpath: especifica la ruta a los complementos de la plataforma.Anula la variable de entorno `
QT_QPA_PLATFORM_PLUGIN_PATH`.-platformthemeplatformTheme: especifica el tema de la plataforma.Anula la variable de entorno «
QT_QPA_PLATFORMTHEME».-pluginplugin: 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 formatoport:1234[,block], donde block es opcional y hará que la aplicación espere hasta que un depurador se conecte a ella.-qwindowgeometrygeometry, 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()).-sessionsession, 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:
-displaynombre_del_host:número_de_pantalla, cambia de pantalla en X11.Anula la variable de entorno `
DISPLAY`.-geometrygeometrí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],xputiliza cuadros de diálogo nativos al estilo XP ynonelos 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).
nocolorfontsDesactivar las fuentes DirectWrite Color (desde Qt 5.8).nodirectwriteDesactiva las fuentes DirectWrite (desde Qt 5.8). Esto también selecciona implícitamente el motor de fuentes GDI.nomousefromtouchIgnora los eventos de ratón sintetizados a partir de eventos táctiles por el sistema operativo.nowmpointerCambia del manejo de mensajes de entrada del puntero al manejo tradicional del ratón (desde Qt 5.12).reverseActiva 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().
[static] QWindow *QGuiApplication::modalWindow()
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:
Interfaz nativa para una aplicación Wayland | |
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.