En esta página

Buscador de texto

Carga dinámica de archivos .ui mediante QUiLoader.

El ejemplo TextFinder muestra cómo cargar y configurar un archivo « .ui » de forma dinámica utilizando la clase « QUiLoader », que forma parte de la Qt UI Tools biblioteca.

El programa permite al usuario buscar una palabra concreta dentro del contenido de un texto. Los elementos visuales y el diseño de la interfaz de usuario se cargan en tiempo de ejecución a partir de los recursos del programa.

Botón «Buscar» y campo de entrada de TextFinderTextFinder: Resultados resaltados

Configuración del archivo de recursos

Los recursos necesarios para el ejemplo son:

  • textfinder.ui - el archivo de interfaz de usuario creado en Qt Widgets Designer
  • input.txt - un archivo de texto que contiene el texto que se mostrará en un QTextEdit

textfinder.ui contiene todos los objetos « QWidget » necesarios para el «Text Finder». Se utiliza un « QLineEdit » para la entrada del usuario, un « QTextEdit » para mostrar el contenido de « input.txt », un « QLabel » para mostrar el texto «Keyword» y un « QPushButton » para el botón « Find ». Ten en cuenta que a todos los widgets se les han asignado « objectName » significativos. Estos se utilizan en el código para identificarlos.

La siguiente captura de pantalla muestra la vista previa obtenida en Qt Widgets Designer.

Captura de pantalla de la interfaz de usuario de TestFinder

En este ejemplo, almacenamos ambos recursos en el ejecutable de la aplicación incluyendo el archivo textfinder.qrc. Como alternativa, los archivos también podrían cargarse en tiempo de ejecución desde el sistema de archivos o desde un archivo de recursos binarios externo .rcc. Para obtener más información sobre los archivos de recursos, consulte El sistema de recursos de Qt XML.

El archivo textfinder.qrc enumera todos los archivos que deben incluirse como recursos:

<!DOCTYPE RCC><RCC version="1.0">
<qresource>
    <file>forms/textfinder.ui</file>
    <file>forms/input.txt</file>
</qresource>
</RCC>

Para generar un formulario en tiempo de ejecución, el ejemplo se vincula a la biblioteca Qt UI Tools. Esto se hace en el archivo textfinder.pro:

QT += widgets uitools

HEADERS = textfinder.h
SOURCES = textfinder.cpp main.cpp
RESOURCES = textfinder.qrc

Definición de la clase TextFinder

La clase ` TextFinder ` contiene la interfaz de usuario principal. Declara punteros a los elementos ` QPushButton`, ` QTextEdit ` y ` QLineEdit ` descritos anteriormente. El elemento ` QLabel ` de la interfaz de usuario no se declara aquí, ya que no necesitamos acceder a él desde el código.

class TextFinder : public QWidget
{
    Q_OBJECT

public:
    explicit TextFinder(QWidget *parent = nullptr);

private slots:
    void on_findButton_clicked();

private:
    QPushButton *ui_findButton;
    QTextEdit *ui_textEdit;
    QLineEdit *ui_lineEdit;
};

La ranura on_findButton_clicked() es una ranura cuyo nombre se ajusta a la convención de nomenclatura de conexión automática exigida por uic.

Carga de los recursos

Utilizamos QFile para cargar los datos de los recursos del programa en tiempo de ejecución. El código correspondiente se encuentra en dos métodos de la clase textfinder.cpp: loadUiFile y loadTextFile.

La función ` loadUiFile ` carga el archivo de interfaz de usuario creado previamente en Qt Widgets Designer. En primer lugar, se localiza y se abre el archivo ` textfinder.ui ` desde el sistema de recursos. A continuación, se crea una instancia de ` QUiLoader ` y se llama a la función ` QUiLoader::load()`, siendo el primer argumento el archivo abierto y el segundo, el puntero al widget que debe establecerse como padre. Se devuelve el objeto ` QWidget ` creado.

estático QWidget*loadUiFile(QWidget*parent)
{
    QFile file(u":/forms/textfinder.ui"_s);
    if (!file.open(QIODevice::ReadOnly))
        qFatal("Cannot open resource file");

   return QUiLoader().load(&file, parent);
}

De manera similar, la función ` loadTextFile ` localiza y abre ` input.txt ` desde los recursos. A continuación, devuelve el contenido del archivo mediante la función ` QTextStream::readAll()`.

static QString loadTextFile()
{
    QFile inputFile(u":/forms/input.txt"_s);
    if (!inputFile.open(QIODevice::ReadOnly))
        qFatal("Cannot open resource file");

   return QTextStream(&inputFile).readAll();
}

Implementación de la clase TextFinder

El constructor de la clase ` TextFinder ` no instancia directamente ningún widget secundario. En su lugar, llama a la función ` loadUiFile() ` y, a continuación, utiliza ` QObject::findChild()` para localizar los objetos ` QWidget` creados por su nombre.

TextFinder::TextFinder(QWidget *parent)
    : QWidget(parent)
{
    QWidget *formWidget = loadUiFile(this);

    ui_findButton = findChild<QPushButton*>("findButton");
    ui_textEdit = findChild<QTextEdit*>("textEdit");
    ui_lineEdit = findChild<QLineEdit*>("lineEdit");

A continuación, utilizamos QMetaObject::connectSlotsByName() para habilitar la llamada automática a la ranura on_findButton_clicked().

    QMetaObject::connectSlotsByName(this);

La función ` loadTextFile ` se invoca para obtener el texto que se mostrará en ` QTextEdit`.

    ui_textEdit->setText(loadTextFile());

La interfaz de usuario cargada dinámicamente en formWidget ya está correctamente configurada. Ahora incorporamos formWidget a través de un QVBoxLayout.

    auto *layout = new QVBoxLayout(this);
    layout->addWidget(formWidget);

Al final del constructor, establecemos el título de la ventana.

    setWindowTitle(tr("Text Finder"));
}

La función « on_findButton_clicked() » es una ranura conectada a la señal « clicked() » de « ui_findButton ». El « searchString » se extrae de « ui_lineEdit » y el « document » se extrae de « ui_textEdit ». Si el « searchString » está vacío, se utiliza un « QMessageBox » para solicitar al usuario que introduzca una palabra. De lo contrario, recorremos las palabras de ui_textEdit y resaltamos todas las apariciones de searchString. Se utilizan dos objetos QTextCursor: uno para recorrer las palabras de line y otro para realizar un seguimiento de los bloques de edición.

void TextFinder::on_findButton_clicked()
{
    QString searchString = ui_lineEdit->text();
    QTextDocument *document = ui_textEdit->document();

    bool found = false;

    // undo previous change (if any)
    document->undo();

    if (searchString.isEmpty()) {
        QMessageBox::information(this, tr("Empty Search Field"),
                                 tr("The search field is empty. "
                                    "Please enter a word and click Find."));
    } else {
        QTextCursor highlightCursor(document);
        QTextCursor cursor(document);

        cursor.beginEditBlock();

        QTextCharFormat plainFormat(highlightCursor.charFormat());
        QTextCharFormat colorFormat = plainFormat;
        colorFormat.setForeground(Qt::red);

        while (!highlightCursor.isNull() && !highlightCursor.atEnd()) {
            highlightCursor = document->find(searchString, highlightCursor,
                                             QTextDocument::FindWholeWords);

            if (!highlightCursor.isNull()) {
                found = true;
                highlightCursor.movePosition(QTextCursor::WordRight,
                                             QTextCursor::KeepAnchor);
                highlightCursor.mergeCharFormat(colorFormat);
            }
        }

        cursor.endEditBlock();

El indicador « found » se utiliza para indicar si se ha encontrado el « searchString » dentro del contenido de « ui_textEdit ». Si no se ha encontrado, se utiliza un « QMessageBox » para informar al usuario.

        if (found == false) {
            QMessageBox::information(this, tr("Word Not Found"),
                                     tr("Sorry, the word cannot be found."));
        }
    }
}

main() Función

La función main() crea una instancia de TextFinder y la muestra.

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    TextFinder textFinder;
    textFinder.show();

    return app.exec();
}

Existen varios métodos para incluir formularios en las aplicaciones. El uso de ` QUiLoader ` es solo uno de ellos. Consulte «Uso de un archivo de interfaz de usuario de Qt Widgets Designer en su aplicación» para obtener más información sobre los demás métodos disponibles.

Proyecto de ejemplo en @code.qt.io

Véase también Calculator Builder.

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