En esta página

QApplication Class

La clase `QApplication` gestiona el flujo de control y la configuración principal de la aplicación con interfaz gráfica de usuario. Más información...

Encabezado: #include <QApplication>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QGuiApplication

Propiedades

Funciones públicas

QApplication(int &argc, char **argv)
virtual ~QApplication()
bool autoSipEnabled() const
QString styleSheet() const

Funciones públicas reimplementadas

virtual bool notify(QObject *receiver, QEvent *e) override

Ranuras públicas

void aboutQt()
void closeAllWindows()
void setAutoSipEnabled(const bool enabled)
void setStyleSheet(const QString &sheet)

Señales

void focusChanged(QWidget *old, QWidget *now)

Miembros públicos estáticos

QWidget *activeModalWidget()
QWidget *activePopupWidget()
QWidget *activeWindow()
void alert(QWidget *widget, int msec = 0)
QWidgetList allWidgets()
void beep()
int cursorFlashTime()
int doubleClickInterval()
int exec()
QWidget *focusWidget()
QFont font()
QFont font(const QWidget *widget)
QFont font(const char *className)
bool isEffectEnabled(Qt::UIEffect effect)
int keyboardInputInterval()
QPalette palette(const QWidget *widget)
QPalette palette(const char *className)
void setCursorFlashTime(int)
void setDoubleClickInterval(int)
void setEffectEnabled(Qt::UIEffect effect, bool enable = true)
void setFont(const QFont &font, const char *className = nullptr)
void setKeyboardInputInterval(int)
void setPalette(const QPalette &palette, const char *className = nullptr)
void setStartDragDistance(int l)
void setStartDragTime(int ms)
void setStyle(QStyle *style)
QStyle *setStyle(const QString &style)
void setWheelScrollLines(int)
int startDragDistance()
int startDragTime()
QStyle *style()
QWidget *topLevelAt(const QPoint &point)
QWidget *topLevelAt(int x, int y)
QWidgetList topLevelWidgets()
int wheelScrollLines()
QWidget *widgetAt(const QPoint &point)
QWidget *widgetAt(int x, int y)

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Macros

Descripción detallada

QApplication especializ QGuiApplication, añadiéndole algunas funcionalidades necesarias para las aplicaciones basadas en QWidget. Se encarga de la inicialización y finalización específicas de los widgets.

Para cualquier aplicación GUI que utilice Qt, existe exactamente un objeto QApplication, independientemente de si la aplicación tiene 0, 1, 2 o más ventanas en un momento dado. Para aplicaciones Qt que no estén basadas enQWidget, utilice QGuiApplication en su lugar, ya que no depende de la biblioteca QtWidgets.

Algunas aplicaciones con interfaz gráfica de usuario (GUI) ofrecen un modo por lotes especial, es decir, admiten argumentos de línea de comandos para ejecutar tareas sin intervención manual. En dicho modo sin interfaz gráfica, suele bastar con instanciar un simple ` QCoreApplication ` para evitar la inicialización innecesaria de los recursos necesarios para una interfaz gráfica de usuario. El siguiente ejemplo muestra cómo crear dinámicamente una instancia de aplicación del tipo adecuado:

QCoreApplication* createApplication(int &argc, char *argv[])
{
    for (int i = 1; i < argc; ++i) {
        if (!qstrcmp(argv[i], "-no-gui"))
            return new QCoreApplication(argc, argv);
    }
    return new QApplication(argc, argv);
}

int main(int argc, char* argv[])
{
    QScopedPointer<QCoreApplication> app(createApplication(argc, argv));

    if (qobject_cast<QApplication *>(app.data())) {
       // start GUI version...
    } else {
       // start non-GUI version...
    }

    return app->exec();
}

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

Las principales funciones de QApplication son:

  • Inicializa la aplicación con la configuración del escritorio del usuario, como palette(), font() y doubleClickInterval(). Realiza un seguimiento de estas propiedades por si el usuario cambia la configuración global del escritorio, 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. Mediante el uso de sendEvent() y postEvent() puedes enviar tus propios eventos a los widgets.
  • Analiza los argumentos comunes de la línea de comandos y establece su estado interno en consecuencia. Consulte el método constructor documentation más abajo para obtener más detalles.
  • Define la apariencia de la aplicación, que está encapsulada en un objeto ` QStyle `. Esto se puede modificar en tiempo de ejecución con ` setStyle()`.
  • Proporciona la localización de las cadenas visibles para el usuario a través de ` translate()`.
  • Proporciona algunos objetos «mágicos» como el clipboard().
  • Conoce las ventanas de la aplicación. Puedes averiguar qué widget se encuentra en una posición determinada utilizando widgetAt(), obtener una lista de topLevelWidgets() y closeAllWindows(), etc.
  • Gestiona el manejo del cursor del ratón de la aplicación; véase setOverrideCursor().

Dado que el objeto `QApplication` realiza gran parte de la inicialización, debe crearse antes de que se creen otros objetos relacionados con la interfaz de usuario. `QApplication` también se encarga de los argumentos comunes de la línea de comandos. Por lo tanto, suele ser una buena idea crearlo antes de que se realice cualquier interpretación o modificación de ` argv ` en la propia aplicación.

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

Documentación de propiedades

autoSipEnabled : bool

activa o desactiva la visibilidad automática del SIP (panel de entrada de software)

Establezca esta propiedad en « true » para que el SIP se muestre automáticamente al introducir datos en widgets que acepten entradas de teclado. Esta propiedad solo afecta a los widgets que tengan activado el atributo WA_InputMethodEnabled y se utiliza normalmente para abrir un teclado virtual en dispositivos que tienen muy pocas teclas o ninguna.

La propiedad solo surte efecto en plataformas que utilizan paneles de entrada de software.

El valor por defecto depende de la plataforma.

Funciones de acceso:

bool autoSipEnabled() const
void setAutoSipEnabled(const bool enabled)

cursorFlashTime : int

Esta propiedad contiene el tiempo de parpadeo del cursor de texto en milisegundos

El tiempo de parpadeo es el tiempo necesario para mostrar, invertir y restablecer la visualización del cursor. Normalmente, el cursor de texto se muestra durante la mitad del tiempo de parpadeo del cursor y, a continuación, se oculta durante el mismo tiempo, aunque esto puede variar.

El valor por defecto en X11 es de 1000 milisegundos. En Windows, se utiliza el valor « Control Panel » y al configurar esta propiedad se establece el tiempo de parpadeo del cursor para todas las aplicaciones.

Recomendamos que los widgets no almacenen este valor en caché, ya que puede cambiar en cualquier momento si el usuario modifica la configuración global del escritorio.

Nota: Esta propiedad puede tener un valor negativo, por ejemplo, si el parpadeo del cursor está desactivado.

Funciones de acceso:

int cursorFlashTime()
void setCursorFlashTime(int)

doubleClickInterval : int

Esta propiedad establece el intervalo de tiempo, en milisegundos, que distingue un doble clic de dos clics consecutivos del ratón

El valor por defecto en X11 es de 400 milisegundos. En Windows y Mac OS, se utiliza el valor del sistema operativo.

Funciones de acceso:

int doubleClickInterval()
void setDoubleClickInterval(int)

keyboardInputInterval : int

Esta propiedad establece el intervalo de tiempo, en milisegundos, que distingue una pulsación de tecla de dos pulsaciones consecutivas

El valor por defecto en X11 es de 400 milisegundos. En Windows y Mac OS, se utiliza el valor del sistema operativo.

Funciones de acceso:

int keyboardInputInterval()
void setKeyboardInputInterval(int)

startDragDistance : int

Esta propiedad establece la distancia mínima necesaria para que se inicie una operación de arrastrar y soltar.

Si tu aplicación admite la función de arrastrar y soltar, y deseas que la operación comience una vez que el usuario haya desplazado el cursor una distancia determinada con un botón pulsado, debes utilizar el valor de esta propiedad como la distancia mínima necesaria.

Por ejemplo, si la posición del ratón en el momento del clic se almacena en startPos y la posición actual (por ejemplo, en el evento de movimiento del ratón) es currentPos, puede determinar si debe iniciarse un arrastre con un código como este:

if ((startPos - currentPos).manhattanLength() >=
        QApplication::startDragDistance())
    startTheDrag();

Qt utiliza este valor internamente, p. ej., en QFileDialog.

El valor por defecto (si la plataforma no proporciona otro valor por defecto) es de 10 píxeles.

Funciones de acceso:

int startDragDistance()
void setStartDragDistance(int l)

Véase también startDragTime(), QPoint::manhattanLength() y Arrastrar y soltar.

startDragTime : int

Esta propiedad indica el tiempo, en milisegundos, que debe mantenerse pulsado un botón del ratón antes de que comience una operación de arrastrar y soltar

Si tu aplicación admite la función de arrastrar y soltar y deseas que la operación comience una vez que el usuario haya mantenido pulsado un botón del ratón durante un tiempo determinado, debes utilizar el valor de esta propiedad como retardo.

Qt también utiliza este retraso internamente, por ejemplo, en QTextEdit y QLineEdit, para iniciar un arrastre.

El valor por defecto es de 500 ms.

Funciones de acceso:

int startDragTime()
void setStartDragTime(int ms)

Véase también startDragDistance() y Arrastrar y soltar.

styleSheet : QString

Esta propiedad contiene la hoja de estilos de la aplicación

La hoja de estilos de la aplicación se aplica a todos los widgets de la aplicación, además de cualquier hoja de estilos definida en widgets individuales. Consulta «Hojas de estilos de Qt» para conocer las reglas de cascada.

Al establecer esta propiedad, el estilo de la aplicación se sustituye por el estilo de la hoja de estilo que envuelve la ventana actual ( style), y cada cambio posterior actualiza el aspecto de todos los widgets de la aplicación. Establece la hoja de estilo una sola vez, antes de que se muestre la primera ventana, y no la utilices para cambiar de tema en tiempo de ejecución. Para saber cuándo utilizar hojas de estilo, consulta «Enfoques de estilo» en Qt Widgets.

Si el valor es una URL de file:///, Qt carga la hoja de estilos desde el archivo indicado y resuelve las URL relativas que contiene, como las referencias a imágenes, en relación con el directorio de dicho archivo. Solo la hoja de estilos de la aplicación admite una URL de file:///; QWidget::styleSheet no la admite.

Por defecto, esta propiedad es una cadena vacía, a menos que el usuario especifique la opción -stylesheet en la línea de comandos al ejecutar la aplicación; dicha opción establece esta propiedad en una URL file:/// para el archivo indicado.

Funciones de acceso:

QString styleSheet() const
void setStyleSheet(const QString &sheet)

Véase también QWidget::styleSheet, setStyle(), Hojas de estilo de Qt y Enfoques de estilo para Qt Widgets.

wheelScrollLines : int

Esta propiedad indica el número de líneas que debe desplazarse un widget al girar la rueda del ratón.

Si el valor supera el número de líneas visibles del widget, este debe interpretar la operación de desplazamiento como un único movimiento hacia arriba o hacia abajo. Si el widget es de tipo « item view class », el resultado de desplazar una línea dependerá de la configuración de la propiedad « scroll mode » del widget. Desplazar una línea puede significar « scroll one item » o « scroll one pixel ».

Por defecto, esta propiedad tiene un valor de 3.

Funciones de acceso:

int wheelScrollLines()
void setWheelScrollLines(int)

Véase también QStyleHints::wheelScrollLines().

Documentación de funciones de miembro

QApplication::QApplication(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 QApplication. 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 widgets, mapas de píxeles, mapas de bits, etc.).

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

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

  • -style= estilo: establece el estilo de la interfaz gráfica de usuario (GUI) de la aplicación. Los valores posibles dependen de la configuración de tu sistema. Si has compilado Qt con estilos adicionales o dispones de estilos adicionales como complementos, estos estarán disponibles para la opción de línea de comandos -style. También puedes establecer el estilo para todas las aplicaciones Qt configurando la variable de entorno QT_STYLE_OVERRIDE.
  • -style estilo: es lo mismo que lo indicado anteriormente.
  • -stylesheet= hoja de estilos, establece la hoja de estilos de la aplicación. El valor debe ser una ruta a un archivo que contenga la hoja de estilos.

    Nota: Las URLrelativas del archivo de hoja de estilo son relativas a la ruta del propio archivo de hoja de estilo.

  • -stylesheet hoja de estilos, es lo mismo que se ha indicado anteriormente.
  • -widgetcount: muestra al final un mensaje de depuración sobre el número de widgets que quedan sin destruir y el número máximo de widgets que han existido al mismo tiempo
  • -reverse, establece la dirección de diseño de la aplicación en Qt::RightToLeft
  • -qmljsdebugger=, activa el depurador de QML/JS con un puerto especificado. El valor debe tener el formato puerto:1234[,bloque], donde «bloque» 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()

Libera los recursos del sistema de ventanas que esta aplicación haya asignado. Establece la variable global « qApp » en « nullptr ».

[static slot] void QApplication::aboutQt()

Muestra un cuadro de mensaje sencillo sobre Qt. El mensaje incluye el número de versión de Qt que utiliza la aplicación.

Esto resulta útil para incluirlo en el menú « Help » de una aplicación, tal y 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 ` y 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 situado 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 « Qt::WType_Popup », por ejemplo, el widget « QMenu ». Cuando la aplicación abre un widget emergente, todos los eventos se envían a dicho widget. No se puede acceder a los widgets normales ni a los modales hasta que se cierre el widget emergente.

Solo se pueden abrir otros widgets emergentes cuando se muestra un widget emergente. Los widgets emergentes se organizan en una pila. Esta función devuelve el widget emergente activo situado 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 del teclado, o ` nullptr ` si ninguna ventana de la aplicación tiene el foco. Puede que haya un valor para `activeWindow()` incluso si no hay ningún ` focusWidget()`, por ejemplo, si ningún widget de esa ventana acepta eventos de teclas.

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

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

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

Actualmente, esta función no tiene ningún efecto en Qt para Linux embebido.

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 ventana en la barra de tareas parpadee durante un tiempo. Si msec es cero, el parpadeo se detendrá y la entrada de la barra de tareas cambiará a un color diferente (actualmente naranja).

En X11, esto hará que la ventana se marque como «requiere atención»; para que esto funcione, la ventana no debe estar oculta (es decir, no debe haberse llamado a hide() sobre ella, sino que debe estar visible de alguna forma).

[static] QWidgetList QApplication::allWidgets()

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

La lista estará vacía (QList::isEmpty()) si no hay ningún widget.

Nota: Es posible quealgunos de los widgets estén ocultos.

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 la campana con el volumen y el sonido predeterminados. Esta función no está disponible en Qt para Linux embebido.

[static slot] void QApplication::closeAllWindows()

Cierra todas las ventanas de nivel superior.

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

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

Véanse 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 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()`. Como caso especial, los widgets modales, como ` QMessageBox `, pueden utilizarse antes de llamar a `exec()`, ya que los widgets modales llaman a `exec()` para iniciar un bucle de eventos local.

Para que tu aplicación realice un procesamiento en espera, es decir, que ejecute una función especial siempre que no haya eventos pendientes, utiliza un ` QChronoTimer ` con un tiempo de espera de 0 ns. Se pueden conseguir 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 la aplicación. Esto se debe a que, en algunas plataformas, es posible que la llamada a QApplication::exec() no devuelva ningún resultado. 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 el código al final de la función main(), tras la llamada a QApplication::exec().

Véase 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 pasa de « old » a « now », es decir, porque el usuario ha pulsado la tecla Tab, ha hecho clic en un widget o ha cambiado de 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 del 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 predeterminada 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 ninguna fuente predeterminada para la clase ` widget`, devuelve la fuente predeterminada de su superclase registrada más cercana.

Esta es una función sobrecargada.

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

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

Devuelve la fuente de los widgets del ` className` indicado.

Esta es una función sobrecargada.

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

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

Devuelve « true » si « effect » está activado; en caso contrario, devuelve « false ».

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

Nota: Todos los efectos están desactivados en pantallas que funcionan con una profundidad de color inferior a 16 bits.

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

[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 objeto ` widget `, se devuelve la paleta predeterminada de la clase del widget. Esta puede ser o no la paleta de la aplicación. En la mayoría de los casos no existe una paleta especial para determinados tipos de widgets, pero una excepción destacable 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 los widgets del ` className` indicado.

Esta es una función sobrecargada.

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 «true»; de lo contrario, el efecto no se aplicará.

Nota: Todos los efectos están desactivados en pantallas que funcionan con una profundidad de color inferior a 16 bits.

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

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

Cambia la fuente predeterminada de la aplicación a font. Si se pasa className, el cambio solo se aplica a las clases que heredan de className (tal y como indica QObject::inherits()).

Al iniciar la aplicación, la fuente predeterminada depende del sistema de ventanas. Puede variar en función tanto de la versión del sistema de ventanas como de la configuración regional. Esta función permite anular la fuente predeterminada; sin embargo, puede no ser recomendable hacerlo, ya que, por ejemplo, algunas configuraciones regionales necesitan fuentes de tamaño extragrande para mostrar sus caracteres especiales.

Advertencia: No utilices esta función junto con las hojas de estilo de Qt. La fuente de una aplicación se puede personalizar utilizando la propiedad «font» de la hoja de estilo. Para establecer una fuente en negrita para todos los QPushButtons, configura la aplicación styleSheet() como «QPushButton { font: bold }»

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

[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 solo se aplica a los widgets que heredan de className (tal y como indica QObject::inherits()). Si className se deja en 0, el cambio afecta a todos los widgets, anulando así cualquier paleta específica de clase establecida previamente.

La paleta se puede modificar según el estilo actual de la interfaz gráfica de usuario en QStyle::polish().

Advertencia: Noutilices esta función junto con las hojas de estilo de Qt. Al utilizar hojas de estilo, la paleta de un widget se puede personalizar mediante los atributos «color», «background-color», «selection-color», «selection-background-color» y «alternate-background-color».

Nota: Algunos estilos no utilizan la paleta para todo el dibujo; por ejemplo, si hacen uso de motores de temas nativos. Este es el caso de los estilos de Windows Vista y macOS.

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

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

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

Ejemplo de uso:

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

Al cambiar de estilo de la aplicación, la paleta de colores vuelve a los colores iniciales o a los valores predeterminados del sistema. Esto es necesario, ya que ciertos estilos deben adaptar la paleta de colores para cumplir plenamente con la guía de estilo.

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

Véase 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 uno de los valores de QStyleFactory::keys(), normalmente «windows», «windowsvista», «fusion» o «macos». Los nombres de los estilos no distinguen entre mayúsculas y minúsculas.

Devuelve nullptr si se pasa un style desconocido; en caso contrario, el objeto QStyle devuelto se establece como el estilo de la interfaz gráfica de usuario de la aplicación.

Advertencia: Para garantizar que el estilo de la aplicación se establezca correctamente, es recomendable llamar a esta función antes del constructor de QApplication, si es posible.

Esta es una función sobrecargada.

[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 situado en la dirección point; devuelve nullptr si no existe dicho widget.

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

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

Esta es una función sobrecargada.

[static] QWidgetList QApplication::topLevelWidgets()

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

Nota: Es posible quealgunos de los widgets de nivel superior estén ocultos, por ejemplo, una información sobre herramientas si no se muestra ninguna en ese momento.

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 situado en la posición global de la pantalla point, o nullptr si no hay ningún widget de Qt en esa posición.

Esta función puede ser lenta.

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

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

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

Esta es una función sobrecargada.

Documentación de macros

qApp

Un puntero global que hace referencia al objeto único de la aplicación. Es equivalente a ` QCoreApplication::instance()`, pero se convierte a un puntero ` QApplication `, por lo que solo es válido cuando el objeto único de la aplicación es un ` QApplication`.

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

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