Home · All Classes · Modules

QFormBuilder Class Reference
[QtDesigner module]

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

Inherits QAbstractFormBuilder.

Methods


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.qrc), 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.


Method Documentation

QFormBuilder.__init__ (self)

Constructs a new form builder.

QFormBuilder.addPluginPath (self, 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().

QFormBuilder.clearPluginPaths (self)

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

See also pluginPaths().

list-of-QDesignerCustomWidgetInterface QFormBuilder.customWidgets (self)

Returns a list of the available plugins.

QStringList QFormBuilder.pluginPaths (self)

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

See also addPluginPath().

QFormBuilder.setPluginPath (self, QStringList pluginPaths)

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

See also addPluginPath().


PyQt 4.9.4 for WindowsCopyright © Riverbank Computing Ltd and Nokia 2012Qt 4.8.2