Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

QFormBuilder Class Reference
[QtDesigner module]

The QFormBuilder class is used to dynamically construct user interfaces from .ui files at run-time. More...

 #include <QFormBuilder>

Inherits QAbstractFormBuilder.

Public Functions


Detailed Description

The QFormBuilder class is used to dynamically construct user interfaces from .ui files at run-time.

The QFormBuilder class provides a mechanism for dynamically creating user interfaces at run-time, based on .ui files created with Qt Designer. For example:

 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();

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

By including the user interface in the example's resources (myForm.grc), we ensure that it will be present when the example is run:

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

QFormBuilder extends the QAbstractFormBuilder base class with a number of functions that are used to support custom widget plugins:

The QFormBuilder class is typically used by custom components and applications that embed Qt Designer. Standalone applications that need to dynamically generate user interfaces at run-time use the QUiLoader class, found in the QtUiTools module.

See also QAbstractFormBuilder and QtUiTools Module.


Member Function Documentation

QFormBuilder::QFormBuilder ()

Constructs a new form builder.

QFormBuilder::~QFormBuilder ()   [virtual]

Destroys the form builder.

void QFormBuilder::addPluginPath ( const QString & pluginPath )

Adds a new plugin path specified by pluginPath to the list of paths that will be searched by the form builder when loading a custom widget plugin.

See also setPluginPath() and clearPluginPaths().

void QFormBuilder::clearPluginPaths ()

Clears the list of paths that the form builder uses to search for custom widget plugins.

See also pluginPaths().

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

Returns a list of the available plugins.

QStringList QFormBuilder::pluginPaths () const

Returns the list of paths the form builder searches for plugins.

See also addPluginPath().

void QFormBuilder::setPluginPath ( const QStringList & pluginPaths )

Sets the list of plugin paths to the list specified by pluginPaths.

See also addPluginPath().


Copyright © 2007 Trolltech Trademarks
Qt 4.2.3