이 페이지에서

QFormBuilder Class

QFormBuilder 클래스는 실행 시점에 UI 파일을 기반으로 사용자 인터페이스를 동적으로 생성하는 데 사용됩니다. 더 보기...

헤더: #include <QFormBuilder>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
상속: QAbstractFormBuilder

공개 함수

QFormBuilder()
virtual ~QFormBuilder() override
void addPluginPath(const QString &pluginPath)
void clearPluginPaths()
QList<QDesignerCustomWidgetInterface *> customWidgets() const
QStringList pluginPaths() const
void setPluginPath(const QStringList &pluginPaths)

상세 설명

QFormBuilder 클래스는 Qt Widgets Designer 로 생성된 UI 파일을 기반으로 런타임에 사용자 인터페이스를 동적으로 생성하는 메커니즘을 제공합니다. 예를 들어:

        MyForm::MyForm(QWidget *parent)
            : QWidget(parent)
        {
            QFormBuilder builder;
            QFile file(":/forms/myWidget.ui");
            file.open(QFile::ReadOnly);
            QWidget *myWidget = builder.load(&file, this);
            file.close();

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

예제의 리소스(myForm.qrc)에 사용자 인터페이스를 포함시킴으로써, 예제가 실행될 때 해당 인터페이스가 확실히 존재하도록 보장합니다:

    <!DOCTYPE RCC><RCC version="1.0">
    <qresource prefix="/forms">
       <file>mywidget.ui</file>
    </qresource>
    </RCC>

QFormBuilder는 사용자 정의 위젯 플러그인을 지원하기 위해 사용되는 여러 함수를 통해 QAbstractFormBuilder 기본 클래스를 확장합니다:

  • pluginPaths()는 폼 빌더가 사용자 정의 위젯 플러그인을 로드할 때 검색하는 경로 목록을 반환합니다.
  • addPluginPath()는 폼 빌더에 추가 경로를 등록할 수 있게 합니다.
  • setPluginPath()는 기존 경로 목록을 다른 출처에서 가져온 목록으로 대체하는 데 사용됩니다.
  • clearPluginPaths()는 폼 빌더에 등록된 모든 경로를 제거합니다.
  • customWidgets()는 등록된 사용자 정의 위젯의 새 인스턴스를 생성하는 데 사용할 수 있는 플러그인 인터페이스 목록을 반환합니다.

QFormBuilder 클래스는 일반적으로 Qt Widgets Designer 를 임베드하는 사용자 정의 컴포넌트 및 애플리케이션에서 사용됩니다. 실행 시점에 사용자 인터페이스를 동적으로 생성해야 하는 독립형 애플리케이션은 QtUiTools 모듈에 있는 QUiLoader 클래스를 사용합니다.

QAbstractFormBuilder 및 Qt UI Tools.

멤버 함수 설명서

QFormBuilder::QFormBuilder()

새로운 양식 생성기를 생성합니다.

[override virtual noexcept] QFormBuilder::~QFormBuilder()

폼 빌더를 삭제합니다.

void QFormBuilder::addPluginPath(const QString &pluginPath)

pluginPath 로 지정된 새로운 플러그인 경로를, 사용자 정의 위젯 플러그인을 불러올 때 폼 빌더가 검색할 경로 목록에 추가합니다.

setPluginPath() 및 clearPluginPaths()도 참조하십시오 .

void QFormBuilder::clearPluginPaths()

폼 빌더가 사용자 정의 위젯 플러그인을 검색하는 데 사용하는 경로 목록을 지웁니다.

pluginPaths()도 참조하십시오 .

QList<QDesignerCustomWidgetInterface *> QFormBuilder::customWidgets() const

사용 가능한 플러그인 목록을 반환합니다.

QStringList QFormBuilder::pluginPaths() const

폼 빌더가 플러그인을 검색하는 경로 목록을 반환합니다.

addPluginPath()도 참조하십시오 .

void QFormBuilder::setPluginPath(const QStringList &pluginPaths)

플러그인 경로 목록을 pluginPaths 에서 지정한 목록으로 설정합니다.

addPluginPath()도 참조하십시오 .

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