PySide6.QtDesigner.QFormBuilder¶

class QFormBuilder¶

QFormBuilder 类用于在运行时从UI文件动态构建用户界面。更多…

概要¶

方法¶

• def __init__()

• def addPluginPath()

• def clearPluginPaths()

• def customWidgets()

• def pluginPaths()

• def setPluginPath()

虚拟方法¶

• def updateCustomWidgets()

静态函数¶

• def widgetByName()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

QFormBuilder 类提供了一种机制，用于在运行时基于使用 Qt Widgets Designer 创建的 UI 文件动态创建用户界面。例如：

    MyForm::MyForm(QWidget parent)
super().__init__(parent)

        builder = QFormBuilder()
        file = QFile(":/forms/myWidget.ui")
        file.open(QFile.ReadOnly)
        myWidget = builder.load(file, self)
        file.close()
        layout = QVBoxLayout(self)
        layout.addWidget(myWidget)

通过将用户界面包含在示例的资源中（myForm.qrc），我们确保在运行示例时它会存在：

<not 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 的自定义组件和应用程序使用。需要在运行时动态生成用户界面的独立应用程序使用 QUiLoader 类，该类位于 QtUiTools 模块中。

另请参阅

QAbstractFormBuilder Qt UI 工具

__init__()¶

构建一个新的表单构建器。

addPluginPath(pluginPath)¶

Parameters:

pluginPath – str

将pluginPath指定的新插件路径添加到表单构建器加载自定义小部件插件时将搜索的路径列表中。

另请参阅

setPluginPath() clearPluginPaths()

clearPluginPaths()¶

清除表单构建器用于搜索自定义小部件插件的路径列表。

另请参阅

pluginPaths()

customWidgets()¶

Return type:

QDesignerCustomWidgetInterface的列表

返回可用插件的列表。

pluginPaths()¶

Return type:

字符串列表

返回表单构建器搜索插件的路径列表。

另请参阅

addPluginPath()

setPluginPath(pluginPaths)¶

Parameters:

pluginPaths – 字符串列表

将插件路径列表设置为由pluginPaths指定的列表。

另请参阅

addPluginPath()

updateCustomWidgets()¶

static widgetByName(topLevel, name)¶

Parameters:

• topLevel – QWidget

• name – str

Return type:

QWidget