QFormBuilder Class

QFormBuilder 클래스는 런타임에 UI 파일에서 사용자 인터페이스를 동적으로 구성하는 데 사용됩니다. 더 보기...

Header: #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 클래스를 사용합니다.

QAbstractFormBuilderQt 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()도 참조하세요 .

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