QCoreApplication Class
La clase QCoreApplication proporciona un bucle de eventos para aplicaciones Qt sin interfaz de usuario. Más información...
| Encabezado: | #include <QCoreApplication> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QObject |
| Heredado por: |
Propiedades
|
|
Funciones públicas
| QCoreApplication(int &argc, char **argv) | |
| virtual | ~QCoreApplication() |
(since 6.5) Qt::PermissionStatus | checkPermission(const QPermission &permission) |
| void | installNativeEventFilter(QAbstractNativeEventFilter *filterObj) |
| virtual bool | notify(QObject *receiver, QEvent *event) |
| void | removeNativeEventFilter(QAbstractNativeEventFilter *filterObject) |
(since 6.5) void | requestPermission(const QPermission &permission, Functor &&functor) |
(since 6.5) void | requestPermission(const QPermission &permission, const QObject *context, Functor functor) |
Ranuras públicas
Señales
| void | aboutToQuit() |
Miembros públicos estáticos
| void | addLibraryPath(const QString &path) |
| QString | applicationDirPath() |
| QString | applicationFilePath() |
| QString | applicationName() |
| qint64 | applicationPid() |
| QString | applicationVersion() |
| QStringList | arguments() |
| bool | closingDown() |
| QAbstractEventDispatcher * | eventDispatcher() |
| int | exec() |
| bool | installTranslator(QTranslator *translationFile) |
| QCoreApplication * | instance() |
| bool | isQuitLockEnabled() |
| bool | isSetuidAllowed() |
| QStringList | libraryPaths() |
| QString | organizationDomain() |
| QString | organizationName() |
| void | postEvent(QObject *receiver, QEvent *event, int priority = Qt::NormalEventPriority) |
| void | processEvents(QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents) |
(since 6.7) void | processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline) |
| void | processEvents(QEventLoop::ProcessEventsFlags flags, int ms) |
| void | removeLibraryPath(const QString &path) |
| void | removePostedEvents(QObject *receiver, int eventType = 0) |
| bool | removeTranslator(QTranslator *translationFile) |
| bool | sendEvent(QObject *receiver, QEvent *event) |
| void | sendPostedEvents(QObject *receiver = nullptr, int event_type = 0) |
| void | setApplicationName(const QString &application) |
| void | setApplicationVersion(const QString &version) |
| void | setAttribute(Qt::ApplicationAttribute attribute, bool on = true) |
| void | setEventDispatcher(QAbstractEventDispatcher *eventDispatcher) |
| void | setLibraryPaths(const QStringList &paths) |
| void | setOrganizationDomain(const QString &orgDomain) |
| void | setOrganizationName(const QString &orgName) |
| void | setQuitLockEnabled(bool enabled) |
| void | setSetuidAllowed(bool allow) |
| bool | startingUp() |
| bool | testAttribute(Qt::ApplicationAttribute attribute) |
| QString | translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1) |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *e) override |
Elementos no miembros relacionados
| void | qAddPostRoutine(QtCleanUpFunction ptr) |
| void | qRemovePostRoutine(QtCleanUpFunction ptr) |
Macros
| Q_COREAPP_STARTUP_FUNCTION(QtStartUpFunction ptr) | |
| Q_DECLARE_TR_FUNCTIONS(context) |
Descripción detallada
Esta clase es utilizada por aplicaciones sin interfaz gráfica de usuario (GUI) para proporcionar su bucle de eventos. En el caso de las aplicaciones sin GUI que utilizan Qt, debe haber exactamente un objeto QCoreApplication. Para aplicaciones con GUI, véase QGuiApplication. Para aplicaciones que utilizan el módulo Qt Widgets, véase QApplication.
QCoreApplication contiene el bucle de eventos principal, donde se procesan y distribuyen todos los eventos del sistema operativo (por ejemplo, eventos de temporizador y de red) y de otras fuentes. También se encarga de la inicialización y finalización de la aplicación, así como de la configuración a nivel del sistema y de la aplicación.
El bucle de eventos y la gestión de eventos
El bucle de eventos se inicia con una llamada a ` exec()`. Las operaciones de larga duración pueden llamar a ` processEvents()` para mantener la capacidad de respuesta de la aplicación.
En general, se recomienda crear un objeto `QCoreApplication`, ` QGuiApplication ` o ` QApplication ` en la función ` main() ` lo antes posible. La función ` exec()` no devolverá ningún resultado hasta que el bucle de eventos finalice; por ejemplo, cuando se llame a ` quit()`.
También se proporcionan varias funciones estáticas de conveniencia. El objeto QCoreApplication está disponible a través de instance(). Los eventos se pueden enviar con sendEvent() o colocar en una cola de eventos con postEvent(). Los eventos pendientes se pueden eliminar con removePostedEvents() o despachar con sendPostedEvents().
La clase proporciona una ranura « quit()» y una señal « aboutToQuit()».
Rutas de la aplicación y de la biblioteca
Una aplicación tiene un applicationDirPath() y un applicationFilePath(). Las rutas de las bibliotecas (véase QLibrary) pueden recuperarse con libraryPaths() y modificarse mediante setLibraryPaths(), addLibraryPath() y removeLibraryPath().
Internacionalización y traducciones
Los archivos de traducción se pueden añadir o eliminar mediante installTranslator() y removeTranslator(). Las cadenas de la aplicación se pueden traducir mediante translate(). La función QObject::tr() se implementa mediante translate().
Acceso a los argumentos de la línea de comandos
Se debe acceder a los argumentos de la línea de comandos que se pasan al constructor de QCoreApplication mediante la función arguments().
Nota: QCoreApplication elimina la opción -qmljsdebugger="...". Analiza el argumento de qmljsdebugger y, a continuación, elimina esta opción junto con su argumento.
Para un manejo más avanzado de las opciones de la línea de comandos, crea un ` QCommandLineParser`.
Configuración regional
En Unix/Linux, Qt está configurado para utilizar la configuración de configuración regional del sistema de forma predeterminada. Esto puede provocar un conflicto al utilizar funciones POSIX, por ejemplo, al convertir entre tipos de datos como números flotantes y cadenas, ya que la notación puede diferir entre configuraciones regionales. Para solucionar este problema, llama a la función POSIX ` setlocale(LC_NUMERIC,"C") ` justo después de inicializar ` QApplication`, ` QGuiApplication ` o `QCoreApplication` para restablecer la configuración regional utilizada para el formato numérico a la configuración regional «C».
Véase también QGuiApplication, QAbstractEventDispatcher, QEventLoop, «Productor y consumidor mediante semáforos» y «Productor y consumidor mediante condiciones de espera».
Documentación de propiedades
applicationName : QString
Esta propiedad contiene el nombre de esta aplicación
El nombre de la aplicación se utiliza en diversas clases y módulos de Qt, sobre todo en ` QSettings ` cuando se crea mediante el constructor por defecto. Otros usos se dan en la salida de registro formateada (véase ` qSetMessagePattern()`), en la salida de ` QCommandLineParser`, en las rutas predeterminadas de ` QTemporaryDir ` y ` QTemporaryFile `, y en algunas ubicaciones de archivos de ` QStandardPaths`. Qt D-Bus, Accesibilidad y la integración de la plataforma XCB también utilizan el nombre de la aplicación.
Si no se configura, el nombre de la aplicación se establece por defecto como el nombre del ejecutable.
Funciones de Access:
| QString | applicationName() |
| void | setApplicationName(const QString &application) |
Véase también organizationName, organizationDomain, applicationVersion y applicationFilePath().
applicationVersion : QString
Esta propiedad contiene la versión de esta aplicación
Si no se configura, la versión de la aplicación se establece por defecto en un valor específico de la plataforma determinado a partir del ejecutable principal de la aplicación o del paquete (desde Qt 5.9):
| Plataforma | Fuente |
|---|---|
| Windows (escritorio clásico) | Parámetro PRODUCTVERSION del recurso VERSIONINFO |
| macOS, iOS, tvOS, watchOS | Propiedad CFBundleVersion de la lista de propiedades de información |
| Android | Propiedad «android:versionName» del elemento de manifiesto AndroidManifest.xml |
| HarmonyOS | Campo «versionName» del archivo de configuración app.json5 |
En otras plataformas, el valor predeterminado es una cadena vacía.
Funciones de acceso:
| QString | applicationVersion() |
| void | setApplicationVersion(const QString &version) |
Véase también applicationName, organizationName y organizationDomain.
organizationDomain : QString
Esta propiedad contiene el dominio de Internet de la organización que ha desarrollado esta aplicación
La clase ` QSettings ` utiliza este valor cuando se crea mediante el constructor por defecto. De este modo, se evita tener que repetir esta información cada vez que se crea un objeto ` QSettings `.
En Mac, ` QSettings ` utiliza `organizationDomain()` como nombre de la organización si no es una cadena vacía; en caso contrario, utiliza ` organizationName()`. En el resto de plataformas, ` QSettings ` utiliza ` organizationName()` como nombre de la organización.
Funciones de acceso:
| QString | organizationDomain() |
| void | setOrganizationDomain(const QString &orgDomain) |
Véase también organizationName, applicationName y applicationVersion.
organizationName : QString
Esta propiedad contiene el nombre de la organización que ha desarrollado esta aplicación
La clase ` QSettings ` utiliza este valor cuando se crea mediante el constructor predeterminado. Esto evita tener que repetir esta información cada vez que se crea un objeto ` QSettings `.
En Mac, ` QSettings ` utiliza ` organizationDomain()` como nombre de la organización si no es una cadena vacía; en caso contrario, utiliza `organizationName()`. En el resto de plataformas, ` QSettings ` utiliza `organizationName()` como nombre de la organización.
Funciones de acceso:
| QString | organizationName() |
| void | setOrganizationName(const QString &orgName) |
Véase también organizationDomain y applicationName.
quitLockEnabled : bool
Esta propiedad indica si el uso de la función « QEventLoopLocker » puede provocar que la aplicación se cierre.
Cuando esta propiedad tiene el valor « true », la liberación del último « QEventLoopLocker » restante que opera en la aplicación intentará cerrarla.
Ten en cuenta que intentar cerrar la aplicación no tiene por qué dar lugar a que esta se cierre, por ejemplo, si aún hay ventanas abiertas o si se ignora el evento « QEvent::Quit ».
El valor predeterminado es « true ».
Funciones de acceso:
| bool | isQuitLockEnabled() |
| void | setQuitLockEnabled(bool enabled) |
Véase también ` QEventLoopLocker`.
Documentación de funciones de miembro
QCoreApplication::QCoreApplication(int &argc, char **argv)
Crea una aplicación Qt Core. Las aplicaciones Qt Core son aquellas que carecen de interfaz gráfica de usuario. Estas aplicaciones se utilizan en la consola o como procesos de servidor.
Los argumentos argc y argv son procesados por la aplicación y la función arguments() los pone a disposición en un formato más práctico.
Advertencia: Los datos a los que hacen referencia argc y argv deben permanecer válidos durante toda la vida útil del objeto QCoreApplication. Además, argc debe ser mayor que cero y argv debe contener al menos una cadena de caracteres válida.
[virtual noexcept] QCoreApplication::~QCoreApplication()
Elimina el objeto « QCoreApplication ».
[private signal] void QCoreApplication::aboutToQuit()
Esta señal se emite cuando la aplicación está a punto de salir del bucle de eventos principal, por ejemplo, cuando el nivel del bucle de eventos desciende a cero. Esto puede ocurrir bien tras una llamada a ` quit()` desde el interior de la aplicación, bien cuando el usuario cierra toda la sesión de escritorio.
La señal resulta especialmente útil si tu aplicación tiene que realizar alguna limpieza de última hora. Ten en cuenta que en este estado no es posible ninguna interacción por parte del usuario.
Nota: En este momento, el bucle de eventos principal sigue en ejecución, pero no procesará más eventos al volver, salvo los eventos ` QEvent::DeferredDelete ` correspondientes a los objetos eliminados mediante ` deleteLater()`. Si es necesario procesar eventos, utiliza un bucle de eventos anidado o llama manualmente a ` QCoreApplication::processEvents()`.
Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.
Véase también quit().
[static] void QCoreApplication::addLibraryPath(const QString &path)
Añade path al principio de la lista de rutas de bibliotecas, lo que garantiza que se busquen las bibliotecas en ese directorio en primer lugar. Si path está vacío o ya figura en la lista de rutas, esta no se modifica.
La lista de rutas por defecto consta de una o dos entradas. La primera es el directorio de instalación de los complementos, que es INSTALL/plugins, donde INSTALL es el directorio en el que se instaló Qt. La segunda es el propio directorio de la aplicación (no el directorio actual), pero solo después de que se haya instanciado el objeto QCoreApplication.
Las rutas de las bibliotecas se restablecen a los valores predeterminados cuando se destruye una instancia de QCoreApplication.
Advertencia: Actualmente,` QLibrary ` no utiliza la ruta indicada para buscar rutas de bibliotecas no absolutas.
Véase también removeLibraryPath(), libraryPaths() y setLibraryPaths().
[static] QString QCoreApplication::applicationDirPath()
Devuelve el directorio que contiene el ejecutable de la aplicación.
Por ejemplo, si has instalado Qt en el directorio C:\Qt y ejecutas el ejemplo regexp, esta función devolverá «C:/Qt/examples/tools/regexp».
En macOS e iOS, esto apuntará al directorio que contiene realmente el ejecutable, que puede estar dentro de un paquete de aplicación (si la aplicación está empaquetada).
En Android, apuntará al directorio que contenga realmente el ejecutable, que puede encontrarse dentro del APK de la aplicación (si se ha compilado con soporte para bibliotecas sin comprimir).
Advertencia: En Linux, esta función intentará obtener la ruta a partir del sistema de archivos /proc. Si eso falla, asume que argv[0] contiene el nombre de archivo absoluto del ejecutable. La función también asume que la aplicación no ha cambiado el directorio actual.
Véase también applicationFilePath().
[static] QString QCoreApplication::applicationFilePath()
Devuelve la ruta del archivo ejecutable de la aplicación.
Por ejemplo, si has instalado Qt en el directorio /usr/local/qt y ejecutas el ejemplo regexp, esta función devolverá «/usr/local/qt/examples/tools/regexp/regexp».
Advertencia: En Linux, esta función intentará obtener la ruta del sistema de archivos /proc. Si falla, da por hecho que argv[0] contiene el nombre de archivo absoluto del ejecutable. La función también da por hecho que la aplicación no ha cambiado el directorio actual.
Véase también applicationDirPath().
[static noexcept] qint64 QCoreApplication::applicationPid()
Devuelve el ID de proceso actual de la aplicación.
[static] QStringList QCoreApplication::arguments()
Devuelve la lista de argumentos de la línea de comandos.
Normalmente, arguments().at(0) es el nombre del programa, arguments().at(1) es el primer argumento y arguments().last() es el último argumento. Consulta la nota que aparece a continuación sobre Windows.
La llamada a esta función es lenta; se recomienda almacenar el resultado en una variable al analizar la línea de comandos.
Advertencia: En Unix, esta lista se construye a partir de los parámetros argc y argv pasados al constructor en la función main(). Los datos de cadena en argv se interpretan mediante QString::fromLocal8Bit(); por lo tanto, no es posible pasar, por ejemplo, argumentos de línea de comandos en japonés en un sistema que se ejecute en una configuración regional Latin1. La mayoría de los sistemas Unix modernos no tienen esta limitación, ya que están basados en Unicode.
En Windows, la lista se crea a partir de los parámetros argc y argv únicamente si se pasan parámetros argv/argc modificados al constructor. En ese caso, podrían producirse problemas de codificación.
De lo contrario, los argumentos de `arguments()` se construyen a partir del valor de retorno de `GetCommandLine()`. Como consecuencia de ello, es posible que la cadena devuelta por `arguments().at(0)` no sea exactamente el programa utilizado para iniciar la aplicación en Windows.
Véase también applicationFilePath() y QCommandLineParser.
[since 6.5] Qt::PermissionStatus QCoreApplication::checkPermission(const QPermission &permission)
Comprueba el estado del permission
Si el resultado es « Qt::PermissionStatus::Undetermined », se debe solicitar permiso mediante requestPermission() para determinar la intención del usuario.
Esta función se introdujo en Qt 6.5.
Véase también requestPermission() y Permisos de la aplicación.
[static] bool QCoreApplication::closingDown()
Devuelve « true » si se están destruyendo los objetos de la aplicación; en caso contrario, devuelve « false ».
Véase también startingUp().
[override virtual protected] bool QCoreApplication::event(QEvent *e)
Reimplementa: ` QObject::event(QEvent *e)`.
[static] QAbstractEventDispatcher *QCoreApplication::eventDispatcher()
Devuelve un puntero al objeto distribuidor de eventos del hilo principal. Si no existe ningún distribuidor de eventos para el hilo, esta función devuelve ` nullptr`.
Véase también setEventDispatcher().
[static] int QCoreApplication::exec()
Entra en el bucle de eventos principal y espera hasta que se llame a ` exit()`. Devuelve el valor que se pasó a ` 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.
Para que tu aplicación realice un procesamiento en reposo (ejecutando 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 reposo 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, ya que en algunas plataformas es posible que la llamada a exec() no devuelva ningún valor. Por ejemplo, en 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 exec().
Véase también quit(), exit(), processEvents() y QApplication::exec().
[static slot] void QCoreApplication::exit(int returnCode = 0)
Indica a la aplicación que finalice con un código de retorno.
Una vez llamada esta función, la aplicación abandona el bucle de eventos principal y sale de la llamada a ` exec()`. La función ` exec()` devuelve ` returnCode`. Si el bucle de eventos no está en ejecución, esta función no realiza ninguna acción.
Por convención, un ` returnCode ` igual a 0 significa éxito, y cualquier valor distinto de cero indica un error.
Es una buena práctica conectar siempre las señales a esta ranura utilizando un ` QueuedConnection`. Si se emite una señal conectada (no en cola) a esta ranura antes de que el control entre en el bucle de eventos principal (por ejemplo, antes de que «int main» llame a ` exec()`), la ranura no tiene ningún efecto y la aplicación nunca se cierra. El uso de una conexión en cola garantiza que la ranura no se invocará hasta que el control entre en el bucle de eventos principal.
Ten en cuenta que, a diferencia de la función de la biblioteca C del mismo nombre, esta función sí que vuelve al llamante: lo que se detiene es el procesamiento de eventos.
Tenga en cuenta también que esta función no es segura para subprocesos. Solo debe llamarse desde el subproceso principal (el subproceso en el que el objeto ` QCoreApplication ` está procesando eventos). Para solicitar que la aplicación se cierre desde otro subproceso, utilice ` QCoreApplication::quit()` o, en su lugar, llame a esta función desde el subproceso principal con `QMetaMethod::invokeMethod()`.
Véanse también quit() y exec().
void QCoreApplication::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)
Instala un filtro de eventos filterObj para todos los eventos nativos que recibe la aplicación en el hilo principal.
El filtro de eventos ` filterObj ` recibe eventos a través de su función ` nativeEventFilter()`, que se invoca para todos los eventos nativos recibidos en el hilo principal.
La función QAbstractNativeEventFilter::nativeEventFilter() debe devolver «true» si el evento debe filtrarse, es decir, detenerse. Debe devolver «false» para permitir que continúe el procesamiento normal de Qt: el evento nativo puede entonces traducirse a un QEvent y ser gestionado por el filtrado estándar de Qt event, por ejemplo, QObject::installEventFilter().
Si hay varios filtros de eventos instalados, se activa primero el filtro que se haya instalado en último lugar.
Nota: La función de filtro definida aquí recibe mensajes nativos, es decir, estructuras de eventos MSG o XCB.
Nota: Los filtros de eventosnativos se desactivarán en la aplicación cuando se establezca el atributo Qt::AA_PluginApplication.
Para garantizar la máxima portabilidad, se debe intentar utilizar siempre QEvent y QObject::installEventFilter() siempre que sea posible.
Véase también ` QObject::installEventFilter()`.
[static] bool QCoreApplication::installTranslator(QTranslator *translationFile)
Añade el archivo de traducción « translationFile » a la lista de archivos de traducción que se utilizarán para las traducciones.
Se pueden instalar varios archivos de traducción. Las traducciones se buscan en el orden inverso al de su instalación, de modo que se busca primero el archivo de traducción instalado más recientemente y se busca en último lugar el primero de los instalados. La búsqueda se detiene en cuanto se encuentra una traducción que contenga una cadena coincidente.
La instalación o eliminación de un QTranslator, o la modificación de un QTranslator ya instalado, genera un evento LanguageChange para la instancia QCoreApplication. Una instancia QApplication propagará el evento a todos los widgets de nivel superior, donde una reimplementación de changeEvent puede volver a traducir la interfaz de usuario pasando las cadenas visibles para el usuario a través de la función tr() a los correspondientes setters de propiedades. Las clases de interfaz de usuario generadas por Qt Widgets Designer proporcionan una función retranslateUi() que se puede invocar.
La función devuelve « true » en caso de éxito y « false » en caso de fallo.
Nota: QCoreApplication no asume la propiedad de translationFile. Es responsabilidad de la aplicación garantizar que, si la función devuelve true, el objeto translationFile permanezca activo hasta que se llame a removeTranslator() para él o hasta que la aplicación finalice.
Véase también removeTranslator(), translate(), QTranslator::load() y «Prepararse para los cambios en los lenguajes dinámicos».
[static noexcept] QCoreApplication *QCoreApplication::instance()
Devuelve un puntero a la instancia de ` QCoreApplication ` (o ` QGuiApplication` / `QApplication`) de la aplicación.
Si no se ha asignado ninguna instancia, se devuelve nullptr.
Aviso sobre conflictos de datos: esta función no debe utilizarse para comprobar la existencia de la instancia de QCoreApplication desde subprocesos auxiliares, a menos que el código que la invoca esté compilado como C++20.
[static] bool QCoreApplication::isSetuidAllowed()
Devuelve «true» si la aplicación tiene permiso para ejecutarse con setuid en plataformas UNIX.
Véase también QCoreApplication::setSetuidAllowed().
[static] QStringList QCoreApplication::libraryPaths()
Devuelve una lista de rutas en las que la aplicación buscará al cargar bibliotecas de forma dinámica.
El valor devuelto por esta función puede cambiar cuando se crea un ` QCoreApplication `. No se recomienda llamarla antes de crear un ` QCoreApplication`. El directorio del ejecutable de la aplicación (no el directorio de trabajo) forma parte de la lista si se conoce. Para que se conozca, es necesario crear un ` QCoreApplication `, ya que utilizará ` argv[0] ` para localizarlo.
Qt proporciona rutas de biblioteca predeterminadas, pero también se pueden configurar mediante un archivo qt.conf. Las rutas especificadas en este archivo anularán los valores predeterminados. Ten en cuenta que, si el archivo qt.conf se encuentra en el directorio del ejecutable de la aplicación, es posible que no se encuentre hasta que se cree un objeto QCoreApplication. Si no se encuentra al llamar a esta función, se utilizarán las rutas de biblioteca predeterminadas.
La lista incluirá los directorios de instalación de los complementos si existen (el directorio de instalación predeterminado para los complementos es INSTALL/plugins, donde INSTALL es el directorio en el que se instaló Qt). Siempre se añaden las entradas separadas por dos puntos de la variable de entorno QT_PLUGIN_PATH. El directorio de instalación de los complementos (y su existencia) puede cambiar cuando se conozca el directorio del ejecutable de la aplicación.
Advertencia: Actualmente,esta función no incluye QLibraryInfo::LibrariesPath en sus rutas predeterminadas, y QLibrary no utiliza esta función para buscar rutas de bibliotecas no absolutas.
Véase también setLibraryPaths(), addLibraryPath(), removeLibraryPath(), QLibrary y Cómo crear complementos de Qt.
[virtual] bool QCoreApplication::notify(QObject *receiver, QEvent *event)
Envía event a receiver: receiver->event(event). Devuelve el valor que devuelve el controlador de eventos del receptor. Ten en cuenta que esta función se invoca para todos los eventos enviados a cualquier objeto en cualquier hilo.
En el caso de determinados tipos de eventos (por ejemplo, eventos de ratón y teclado), el evento se propagará al padre del receptor y así sucesivamente hasta el objeto de nivel superior si el receptor no está interesado en el evento (es decir, si devuelve ` false`).
Existen cinco formas diferentes de procesar los eventos; la reimplementación de esta función virtual es solo una de ellas. A continuación se enumeran los cinco enfoques:
- Reimplementar ` paintEvent()`, ` mousePressEvent()` y así sucesivamente. Esta es la forma más habitual, más sencilla y menos potente.
- Reimplementar esta función. Es una forma muy potente que ofrece un control total; sin embargo, solo puede estar activa una subclase a la vez.
- Instalar un filtro de eventos en ` QCoreApplication::instance()`. Dicho filtro de eventos es capaz de procesar todos los eventos de todos los widgets, por lo que resulta tan potente como reimplementar `notify()`; además, es posible tener más de un filtro de eventos global para la aplicación. Los filtros de eventos globales detectan incluso los eventos del ratón para disabled widgets. Ten en cuenta que los filtros de eventos de la aplicación solo se invocan para objetos que residen en el hilo principal.
- Reimplementar ` QObject::event()` (tal y como hace ` QWidget `). Si se hace esto, se captan las pulsaciones de la tecla Tab y se pueden ver los eventos antes que cualquier filtro de eventos específico de un widget.
- Instalando un filtro de eventos en el objeto. Dicho filtro de eventos recibe todos los eventos, incluidos los de pulsación de las teclas Tab y Mayús+Tab, siempre y cuando no cambien el widget de foco.
Perspectivas futuras: En Qt 7, esta función no se invocará para los objetos que se ejecuten fuera del hilo principal. Las aplicaciones que necesiten esta funcionalidad deberán buscar otras soluciones para sus necesidades de inspección de eventos mientras tanto. Es posible que este cambio se extienda al hilo principal, lo que provocaría que esta función quedara obsoleta.
Advertencia: Si sobrescribes esta función, debes asegurarte de que todos los hilos que procesan eventos dejen de hacerlo antes de que el objeto de tu aplicación comience su destrucción. Esto incluye los hilos iniciados por otras bibliotecas que puedas estar utilizando, pero no se aplica a los propios hilos de Qt.
Véase también QObject::event() y installNativeEventFilter().
[static] void QCoreApplication::postEvent(QObject *receiver, QEvent *event, int priority = Qt::NormalEventPriority)
Añade el evento « event », con el objeto « receiver » como receptor del evento, a una cola de eventos y devuelve el resultado de inmediato.
El evento debe asignarse en el montón, ya que la cola de eventos se hará cargo del mismo y lo eliminará una vez que se haya enviado. No es seguro acceder al evento una vez que se ha enviado.
Cuando el control vuelve al bucle de eventos principal, todos los eventos almacenados en la cola se enviarán mediante la función notify().
Los eventos se ordenan en orden descendente según su priority, es decir, los eventos con un priority alto se colocan en la cola antes que los eventos con un priority más bajo. El priority puede ser cualquier valor entero, es decir, entre INT_MAX e INT_MIN, ambos inclusive; consulta Qt::EventPriority para obtener más detalles. Los eventos con un priority igual se procesarán en el orden en que se hayan enviado.
Nota: ` QObject::deleteLater()` programa el objeto para su eliminación diferida, lo que normalmente gestiona el bucle de eventos del receptor. Si no hay ningún bucle de eventos en ejecución en el hilo, la eliminación se llevará a cabo cuando el hilo finalice. Un patrón habitual y seguro consiste en conectar la señal `finished()` del hilo a la ranura ` deleteLater()` del objeto:
Nota: Esta función es segura para subprocesos.
Véase también sendEvent(), notify(), sendPostedEvents() y Qt::EventPriority.
[static] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents)
Procesa algunos eventos pendientes para el hilo de llamada según el ` flags` especificado.
Se desaconseja el uso de esta función. En su lugar, es preferible trasladar las operaciones largas del hilo de la interfaz gráfica de usuario a un hilo auxiliar y evitar por completo el procesamiento anidado de bucles de eventos. Si el procesamiento de eventos es realmente necesario, considera utilizar QEventLoop en su lugar.
En caso de que se esté ejecutando un bucle local que llame a esta función de forma continua, sin un bucle de eventos, los eventos DeferredDelete no se procesarán. Esto puede afectar al comportamiento de los widgets, por ejemplo, QToolTip, que dependen de los eventos DeferredDelete para funcionar correctamente. Una alternativa sería llamar a sendPostedEvents() desde dentro de ese bucle local.
Al llamar a esta función, solo se procesan los eventos del hilo que la invoca, y la función devuelve el control una vez que se han procesado todos los eventos disponibles. Los eventos disponibles son aquellos que se han puesto en cola antes de la llamada a la función. Esto significa que los eventos que se envíen mientras se ejecuta la función se pondrán en cola hasta una ronda posterior de procesamiento de eventos.
Nota: Esta función es segura para subprocesos.
Véase también exec(), QTimer, QChronoTimer, QEventLoop::processEvents() y sendPostedEvents().
[static, since 6.7] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline)
Procesa los eventos pendientes del hilo de llamada hasta que caduque ` deadline ` o hasta que no queden más eventos por procesar, lo que ocurra primero.
Se desaconseja el uso de esta función. En su lugar, es preferible trasladar las operaciones largas del hilo de la interfaz gráfica de usuario a un hilo auxiliar y evitar por completo el procesamiento anidado de bucles de eventos. Si el procesamiento de eventos es realmente necesario, considera utilizar « QEventLoop » en su lugar.
Al llamar a esta función, solo se procesan los eventos del hilo que la invoca.
Nota: A diferencia de la sobrecarga de ` processEvents()`, esta función también procesa los eventos que se envían mientras se ejecuta la función.
Nota: Se procesarántodos los eventos que se hayan puesto en cola antes de que se agote el tiempo de espera, independientemente del tiempo que lleve.
Esta es una función sobrecargada.
Nota: Esta función es segura para subprocesos.
Esta función se introdujo en Qt 6.7.
Véase también ` exec()`, ` QTimer`, ` QChronoTimer` y ` QEventLoop::processEvents()`.
[static] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags, int ms)
Procesa los eventos pendientes del hilo que realiza la llamada durante ms milisegundos o hasta que no queden más eventos por procesar, lo que sea más corto.
Esto equivale a llamar a:
QCoreApplication::processEvents(flags, QDeadlineTimer(ms));Se trata de una función sobrecargada.
[static slot] void QCoreApplication::quit()
Solicita a la aplicación que se cierre.
La solicitud puede ser ignorada si la aplicación impide el cierre, por ejemplo, si no es posible cerrar una de sus ventanas. La aplicación puede influir en ello gestionando el evento « QEvent::Quit » a nivel de la aplicación, o los eventos « QEvent::Close » para cada una de las ventanas.
Si el cierre no se interrumpe, la aplicación se cerrará con el código de retorno 0 (éxito).
Para salir de la aplicación sin riesgo de que se interrumpa el proceso, llama directamente a ` exit()`. Ten en cuenta que este método no es seguro para subprocesos.
Es una buena práctica conectar siempre las señales a este slot utilizando un ` QueuedConnection`. Si se emite una señal conectada (no en cola) a este slot antes de que el control entre en el bucle de eventos principal (por ejemplo, antes de que «int main» llame a ` exec()`), el slot no tiene ningún efecto y la aplicación nunca se cierra. El uso de una conexión en cola garantiza que el slot no se invocará hasta que el control entre en el bucle de eventos principal.
Ejemplo:
QPushButton *quitButton = new QPushButton("Quit");
QObject::connect(quitButton, &QPushButton::clicked, &app, &QCoreApplication::quit, Qt::QueuedConnection);Nota sobre seguridad de subprocesos: esta función puede llamarse desde cualquier subproceso para provocar, de forma segura para los subprocesos, que el bucle principal de la aplicación que se está ejecutando en ese momento finalice. Sin embargo, la seguridad de subprocesos no está garantizada si el objeto ` QCoreApplication ` se está destruyendo al mismo tiempo.
Nota: Esta función es segura para subprocesos.
Véase también exit() y aboutToQuit().
[static] void QCoreApplication::removeLibraryPath(const QString &path)
Elimina « path » de la lista de rutas de la biblioteca. Si « path » está vacía o no figura en la lista de rutas, la lista no se modifica.
Las rutas de las bibliotecas se restablecen a los valores predeterminados cuando se destruye una instancia de ` QCoreApplication `.
Advertencia: Actualmente,QLibrary no utiliza libraryPaths() para buscar rutas de bibliotecas no absolutas.
Véanse también addLibraryPath(), libraryPaths() y setLibraryPaths().
void QCoreApplication::removeNativeEventFilter(QAbstractNativeEventFilter *filterObject)
Elimina un filtro de eventos filterObject de este objeto. La solicitud se ignora si no se ha instalado dicho filtro de eventos.
Todos los filtros de eventos de este objeto se eliminan automáticamente cuando se destruye dicho objeto.
Siempre es seguro eliminar un filtro de eventos, incluso durante la activación del filtro de eventos (es decir, desde la función nativeEventFilter()).
Véase también installNativeEventFilter().
[static] void QCoreApplication::removePostedEvents(QObject *receiver, int eventType = 0)
Elimina todos los eventos del eventType especificado que se publicaron mediante postEvent() para receiver.
Los eventos no se envían, sino que se eliminan de la cola. En principio, nunca deberías necesitar llamar a esta función. Si la llamas, ten en cuenta que eliminar eventos puede provocar que receiver incumpla una o más invariantes.
Si receiver es nullptr, los eventos de eventType se eliminan para todos los objetos. Si eventType es 0, todos los eventos se eliminan para receiver. Nunca debes llamar a esta función con eventType igual a 0.
Nota: Esta función es segura para subprocesos.
[static] bool QCoreApplication::removeTranslator(QTranslator *translationFile)
Elimina el archivo de traducción translationFile de la lista de archivos de traducción que utiliza esta aplicación. (No borra el archivo de traducción del sistema de archivos.)
La función devuelve true si se ejecuta correctamente y false en caso de fallo.
Véase también installTranslator(), translate() y QObject::tr().
[since 6.5] template <typename Functor> void QCoreApplication::requestPermission(const QPermission &permission, Functor &&functor)
Solicita el permission indicado.
Cuando la solicitud esté lista, se llamará a functor como functor(const QPermission &permission), donde permission describe el resultado de la solicitud.
La función functor puede ser una función independiente o una función miembro estática:
qApp->requestPermission(QCameraPermission{}, &permissionUpdated);o una lambda:
qApp->requestPermission(QCameraPermission{}, [](const QPermission &permission) {
});Si el usuario concede explícitamente a la aplicación el permission solicitado, o si se sabe que el permission no requiere autorización del usuario en la plataforma en cuestión, el estado será Qt::PermissionStatus::Granted.
Si el usuario deniega explícitamente a la aplicación el permission solicitado, o si se sabe que el permission no es accesible o aplicable a las aplicaciones en la plataforma en cuestión, el estado será Qt::PermissionStatus::Denied.
El resultado de una solicitud nunca será « Qt::PermissionStatus::Undetermined ».
Nota: Los permisos solo se pueden solicitar desde el hilo principal.
Esta función se introdujo en Qt 6.5.
Véase también checkPermission() y Permisos de la aplicación.
[since 6.5] template <typename Functor> void QCoreApplication::requestPermission(const QPermission &permission, const QObject *context, Functor functor)
Solicita la URL permission, en el contexto de context.
Cuando la solicitud esté lista, se llamará a functor como functor(const QPermission &permission), y permission describirá el resultado de la solicitud.
La función functor puede ser una función independiente o una función miembro estática:
qApp->requestPermission(QCameraPermission{}, context, &permissionUpdated);una lambda:
qApp->requestPermission(QCameraPermission{}, context, [](const QPermission &permission) {
});o una ranura en el objeto ` context `:
qApp->requestPermission(QCameraPermission{}, this, &CamerWidget::permissionUpdated);La « functor » se invocará en el hilo del objeto « context ». Si « context » se destruye antes de que se complete la solicitud, la « functor » no se invocará.
Si el usuario concede explícitamente a la aplicación el permission solicitado, o si se sabe que el permission no requiere autorización del usuario en la plataforma en cuestión, el estado será Qt::PermissionStatus::Granted.
Si el usuario deniega explícitamente a la aplicación la permission solicitada, o si se sabe que la permission no es accesible o aplicable a las aplicaciones en la plataforma en cuestión, el estado será Qt::PermissionStatus::Denied.
El resultado de una solicitud nunca será « Qt::PermissionStatus::Undetermined ».
Nota: Los permisos solo se pueden solicitar desde el hilo principal.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.5.
Véase también checkPermission() y Permisos de la aplicación.
[static] bool QCoreApplication::sendEvent(QObject *receiver, QEvent *event)
Envía el evento event directamente al receptor receiver, utilizando la función notify(). Devuelve el valor que devolvió el controlador de eventos.
El evento no se elimina una vez enviado. Lo habitual es crear el evento en la pila, por ejemplo:
QMouseEvent event(QEvent::MouseButtonPress, localPos, globalPos, Qt::LeftButton, Qt::LeftButton, Qt::NoModifier);
QCoreApplication::sendEvent(mainWindow, &event);Véase también postEvent() y notify().
[static] void QCoreApplication::sendPostedEvents(QObject *receiver = nullptr, int event_type = 0)
Envía inmediatamente todos los eventos que se hayan puesto previamente en cola con ` QCoreApplication::postEvent()` y que correspondan al objeto ` receiver ` y tengan el tipo de evento ` event_type`.
Los eventos del sistema de ventanas no son enviados por esta función, sino por processEvents().
Si receiver es nullptr, se envían los eventos de event_type para todos los objetos. Si event_type es 0, se envían todos los eventos para receiver.
Nota: Este método debe invocarse desde el hilo en el que reside su parámetro QObject, receiver.
Véase también postEvent().
[static] void QCoreApplication::setAttribute(Qt::ApplicationAttribute attribute, bool on = true)
Establece el atributo « attribute » si « on » es «true»; en caso contrario, borra el atributo.
Nota: Algunos atributos de la aplicación deben configurarse antes de crear una instancia de ` QCoreApplication `. Consulta la documentación de ` Qt::ApplicationAttribute ` para obtener más información.
Véase también testAttribute().
[static] void QCoreApplication::setEventDispatcher(QAbstractEventDispatcher *eventDispatcher)
Establece el distribuidor de eventos del hilo principal en eventDispatcher. Esto solo es posible siempre y cuando aún no se haya instalado ningún distribuidor de eventos. Es decir, antes de que se haya instanciado QCoreApplication. Este método toma la propiedad del objeto.
Véase también eventDispatcher().
[static] void QCoreApplication::setLibraryPaths(const QStringList &paths)
Establece la lista de directorios en los que se debe buscar al cargar complementos con QLibrary en paths. Se eliminarán todas las rutas existentes y la lista de rutas estará formada por las rutas indicadas en paths y la ruta a la aplicación.
Las rutas de las bibliotecas se restablecen a los valores predeterminados cuando se destruye una instancia de QCoreApplication.
Advertencia: Actualmente,QLibrary no utiliza las rutas indicadas para buscar rutas de bibliotecas no absolutas.
Véase también libraryPaths(), addLibraryPath(), removeLibraryPath() y QLibrary.
[static] void QCoreApplication::setSetuidAllowed(bool allow)
Permite que la aplicación se ejecute con setuid en plataformas UNIX si allow es verdadero.
Si allow es false (valor por defecto) y Qt detecta que la aplicación se está ejecutando con un ID de usuario efectivo diferente al ID de usuario real, la aplicación se interrumpirá cuando se cree una instancia de ` QCoreApplication `.
Qt no es una solución adecuada para programas setuid debido a su amplia superficie de ataque. Sin embargo, es posible que algunas aplicaciones deban ejecutarse de esta manera por razones históricas. Este indicador impedirá que Qt interrumpa la aplicación cuando se detecte esta situación, y debe configurarse antes de crear una instancia de ` QCoreApplication `.
Nota: Se recomienda encarecidamente no habilitar esta opción, ya que conlleva riesgos de seguridad. Si esta aplicación habilita el indicador e inicia procesos hijos, debería renunciar a los privilegios lo antes posible llamando a ` setuid(2) ` para sí misma o, a más tardar, utilizando el indicador `QProcess::UnixProcessParameters::ResetIds`.
Véase también isSetuidAllowed().
[static] bool QCoreApplication::startingUp()
Devuelve « true » si aún no se ha creado ningún objeto de aplicación; en caso contrario, devuelve « false ».
Véase también closingDown().
[static] bool QCoreApplication::testAttribute(Qt::ApplicationAttribute attribute)
Devuelve ` true ` si el atributo ` attribute ` está establecido; en caso contrario, devuelve ` false`.
Véase también setAttribute().
[static] QString QCoreApplication::translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1)
Devuelve el texto traducido de « sourceText », consultando los archivos de traducción instalados. La búsqueda en los archivos de traducción se realiza desde el archivo instalado más recientemente hasta el primero de ellos.
QObject::tr() ofrece esta funcionalidad de forma más cómoda.
context suele ser un nombre de clase (p. ej., «MyDialog») y sourceText puede ser texto en inglés o un texto breve identificativo.
disambiguation es una cadena identificativa, para cuando se utiliza el mismo « sourceText » en diferentes roles dentro del mismo contexto. Por defecto, es « nullptr ».
Consulte la documentación de QTranslator y QObject::tr() para obtener más información sobre contextos, desambiguaciones y comentarios.
n Se utiliza junto con %n para admitir formas plurales. Consulte QObject::tr() para obtener más detalles.
Si ninguno de los archivos de traducción contiene una traducción para sourceText en context, esta función devuelve un equivalente QString de sourceText.
Esta función no es virtual. Se pueden utilizar técnicas de traducción alternativas creando subclases de QTranslator.
Nota: Esta función es segura para subprocesos.
Véase también QObject::tr(), installTranslator(), removeTranslator() y Internationalization and Translations.
Elementos no miembros relacionados
void qAddPostRoutine(QtCleanUpFunction ptr)
Añade una rutina global que se invocará desde el destructor de ` QCoreApplication `. Esta función se utiliza normalmente para añadir rutinas de limpieza para funcionalidades que afectan a todo el programa.
Las rutinas de limpieza se invocan en el orden inverso al de su incorporación.
La función especificada por ptr no debe tomar ningún argumento ni devolver ningún valor. Por ejemplo:
static int *global_ptr = nullptr;
static void cleanup_ptr()
{
delete [] global_ptr;
global_ptr = nullptr;
}
void init_ptr()
{
global_ptr = new int[100]; // allocate data
qAddPostRoutine(cleanup_ptr); // delete later
}Ten en cuenta que, para una limpieza a nivel de aplicación o de módulo, qAddPostRoutine() no suele ser adecuada. Por ejemplo, si el programa se divide en módulos cargados dinámicamente, es posible que el módulo en cuestión se descargue mucho antes de que se llame al destructor de QCoreApplication. En tales casos, si aún así se prefiere utilizar `qAddPostRoutine()`, se puede recurrir a ` qRemovePostRoutine()` para evitar que el destructor ` QCoreApplication ` llame a una rutina. Por ejemplo, si dicha rutina se llamara antes de que se descargara el módulo.
Para módulos y bibliotecas, puede ser mejor utilizar un gestor de inicialización con recuento de referencias o el mecanismo de eliminación padre-hijo de Qt. A continuación se muestra un ejemplo de una clase privada que utiliza el mecanismo padre-hijo para llamar a una función de limpieza en el momento adecuado:
class MyPrivateInitStuff : public QObject
{
public:
static MyPrivateInitStuff *initStuff(QObject *parent)
{
if (!p)
p = new MyPrivateInitStuff(parent);
return p;
}
~MyPrivateInitStuff()
{
// cleanup goes here
}
private:
MyPrivateInitStuff(QObject *parent)
: QObject(parent)
{
// initialization goes here
}
static MyPrivateInitStuff *p;
};Al seleccionar el objeto padre adecuado, a menudo se consigue que se limpien los datos del módulo en el momento oportuno.
Nota: Esta función es segura para subprocesos desde Qt 5.10.
Nota: Esta función es segura para subprocesos.
Véase también qRemovePostRoutine().
void qRemovePostRoutine(QtCleanUpFunction ptr)
Elimina la rutina de limpieza especificada por ` ptr ` de la lista de rutinas a las que recurre el destructor de ` QCoreApplication `. La rutina debe haberse añadido previamente a la lista mediante una llamada a ` qAddPostRoutine()`, de lo contrario esta función no tiene ningún efecto.
Nota: Esta función es segura para subprocesos desde Qt 5.10.
Nota: Esta función es segura para subprocesos.
Véase también qAddPostRoutine().
Documentación de macros
Q_COREAPP_STARTUP_FUNCTION(QtStartUpFunction ptr)
Añade una función global a la que se llamará desde el constructor de ` QCoreApplication `. Esta macro se utiliza normalmente para inicializar bibliotecas que proporcionan funcionalidad a nivel de todo el programa, sin que la aplicación tenga que llamar a la biblioteca para su inicialización.
La función especificada por ` ptr ` no debe tomar argumentos ni devolver ningún valor. Por ejemplo:
// Called once QCoreApplication exists
static void preRoutineMyDebugTool()
{
MyDebugTool* tool = new MyDebugTool(QCoreApplication::instance());
QCoreApplication::instance()->installEventFilter(tool);
}
Q_COREAPP_STARTUP_FUNCTION(preRoutineMyDebugTool)Ten en cuenta que la función de inicio se ejecutará al final del constructor de ` QCoreApplication `, antes de cualquier inicialización de la interfaz gráfica de usuario (GUI). Si se requiere código de la GUI en la función, utiliza un temporizador (o una invocación en cola) para realizar la inicialización más adelante, desde el bucle de eventos.
Si se elimina ` QCoreApplication ` y se crea otro ` QCoreApplication `, la función de inicio se invocará de nuevo.
Nota: Esta macro no es adecuada para su uso en código de biblioteca que posteriormente se enlace estáticamente a una aplicación, ya que es posible que la función no se llame en absoluto al ser eliminada por el enlazador.
Nota: Esta macro es reentrante.
Q_DECLARE_TR_FUNCTIONS(context)
La macro Q_DECLARE_TR_FUNCTIONS() declara e implementa la función de traducción tr() con esta firma:
static inline QString tr(const char *sourceText,
const char *comment = nullptr);Esta macro resulta útil si se desea utilizar ` QObject::tr()` en clases que no heredan de ` QObject`.
Q_DECLARE_TR_FUNCTIONS() debe aparecer justo al principio de la definición de la clase (antes del primer public: o protected:). Por ejemplo:
class MyMfcView : public CView
{
Q_DECLARE_TR_FUNCTIONS(MyMfcView)
public:
MyMfcView();
//...
};El parámetro de context suele ser el nombre de la clase, pero puede ser cualquier texto.
Véase también Q_OBJECT y QObject::tr().
© 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.