En esta página

qt_add_ui

Añade archivos .ui a un destino.

El comando está definido en el componente « Widgets » del paquete « Qt6 ». Carga el paquete con:

find_package(Qt6 REQUIRED COMPONENTS Widgets)

Sintaxis

qt_add_ui(<TARGET>
          SOURCES file1.ui [file2.ui ...]
          [INCLUDE_PREFIX <PREFIX>]
          [OPTIONS ...])

Si los comandos sin versión están desactivados, utiliza qt6_add_ui() en su lugar. Admite el mismo conjunto de argumentos que este comando.

Este comando se introdujo en Qt 6.8.

Descripción

Crea reglas para llamar a la herramienta User Interface Compiler (uic) sobre los archivos de .ui. Para cada archivo de entrada, se genera un archivo de cabecera en el directorio de compilación. Los archivos de cabecera generados se añaden a las fuentes del objetivo.

Argumentos

TARGET

El argumento « TARGET » especifica el objetivo de CMake al que se añadirán los archivos de cabecera generados.

SOURCES

El argumento « SOURCES » especifica la lista de archivos « .ui » que se van a procesar.

INCLUDE_PREFIX

INCLUDE_PREFIX Especifica el prefijo de inclusión para los archivos de cabecera generados. Utiliza el mismo prefijo de inclusión que en la directiva « #include » de los archivos fuente. Si se incluye « ui_<basename>.h » sin prefijo, este argumento puede omitirse.

OPCIONES

Se pueden establecer opciones adicionales de ` OPTIONS ` que se añadirán a las llamadas a ` uic `. Las opciones disponibles se pueden consultar en la documentación de uic.

Ejemplos

Sin INCLUDE_PREFIX

En el siguiente fragmento de código, el archivo mainwindow.cpp incluye ui_mainwindow.h y mainwindow.h.

#include "mainwindow.h"
#include "ui_mainwindow.h"

CMakeLists.txt se implementa de la siguiente manera y llama a qt_add_ui para añadir ui_mainwindow.h al objetivo myapp.

qt_add_executable(myapp mainwindow.cpp main.cpp)
qt_add_ui(myapp SOURCES mainwindow.ui)

En el ejemplo anterior, se incluye ui_mainwindow.h sin prefijo. Por lo tanto, no se especifica el argumento INCLUDE_PREFIX.

Con INCLUDE_PREFIX

#include "mainwindow.h"
#include "src/files/ui_mainwindow.h"

En el fragmento de código anterior, mainwindow.cpp incluye ui_mainwindow.h con un prefijo.

qt_add_executable(myapp mainwindow.cpp main.cpp)
qt_add_ui(myapp INCLUDE_PREFIX "src/files" SOURCES mainwindow.ui)

Dado que ui_mainwindow.h se incluye con un prefijo, el argumento INCLUDE_PREFIX se especifica como src/files en el ejemplo anterior.

Varios archivos .ui

En los siguientes fragmentos de código, tanto widget1.cpp como widget2.cpp incluyen ui_widget1.h y ui_widget2.h, respectivamente.

widget1.cpp:

#include "src/files/ui_widget1.h"

widget2.cpp:

#include "src/files/ui_widget2.h"

Tanto ui_widget1.h como ui_widget2.h se incluyen con el mismo prefijo

qt_add_executable(myapp widget1.cpp widget2.cpp main.cpp)
qt_add_ui(myapp INCLUDE_PREFIX "src/files" SOURCES widget1.ui widget2.ui)

En este caso, el argumento INCLUDE_PREFIX puede especificarse como src/files para ambos archivos en el fragmento de código anterior.

¿Cuándo es preferible utilizar « qt_add_ui » en lugar de « AUTOUIC »?

qt_add_ui Presenta algunas ventajas respecto a AUTOUIC:

  • qt_add_ui garantiza que los archivos « .ui » se generen correctamente durante la primera compilación, tanto para los generadores « Ninja » como para « Ninja Multi-Config ».
  • qt_add_ui garantiza que los archivos .h generados no se filtren fuera del directorio de compilación.
  • Dado que qt_add_ui no analiza los archivos fuente, ofrece una compilación más rápida que AUTOUIC.

¿Cuándo es preferible utilizar qt_add_ui en lugar de qt_wrap_ui?

qt_add_ui tiene el argumento INCLUDE_PREFIX, que se puede utilizar para especificar el prefijo de inclusión de los archivos de cabecera generados.

Nota: Nose recomienda utilizar tanto qt_add_ui como AUTOUIC para el mismo objetivo.

Véase también qt_wrap_ui().

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