The QDesignerWidgetBoxInterface class allows you to control the contents of Qt Designer's widget box. More…

简介

方法

• def __init__()

• def findOrInsertCategory()

虚函数

• def addCategory()

• 定义 addWidget()

• 定义 category()

• 定义 categoryCount()

• 定义 dropWidgets()

• 定义 fileName()

• 定义 load()

• 定义 removeCategory()

• 定义 removeWidget()

• 定义 save()

• 定义 setFileName()

• 定义 widget()

• 定义 widgetCount()

说明

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

详细描述

警告

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

QDesignerWidgetBoxInterface 包含一系列函数，通常用于操作 Qt Designer 的控件框的内容。

Qt Designer 使用一个XML文件来填充其控件框。该文件的名称是控件框的一个属性，您可以使用 fileName() 函数检索它。

QDesignerWidgetBoxInterface 还提供了保存小部件框内容的 save() 函数，该内容的文件由小部件框的文件名属性指定。如果您更改了小部件框，例如通过将小部件拖入小部件框，而没有调用 save() 函数，可以通过简单地调用 load() 函数来恢复原始内容。

widgetBox = formEditor.widgetBox()
widgetBox.load()

QDesignerWidgetBoxInterface 类不建议直接实例化。您可以使用 widgetBox() 函数获取到 Qt Designer 小部件框的接口。在上面的示例中，通过 initialize() 函数的参数提供了对当前 QDesignerFormEditorInterface 对象（例如，示例中的 formEditor）的指针。实现自定义小部件插件时，必须继承 QDesignerCustomWidgetInterface 以将您的插件暴露给 Qt Designer。

如果您想保存更改，同时保留原始内容，您可以组合使用 save() 函数和 setFileName() 函数将更改保存到另一个文件。请记住首先保存原始文件名。

originalFile = widgetBox.fileName()
widgetBox.setFileName("myWidgetBox.xml")
widgetBox.save()

然后，您可以重置文件名为原始文件，并调用 load() 来恢复小部件框的原始内容。

widgetBox.setFileName(originalFile)
widgetBox.load()

以类似的方式，您可以稍后使用定制的 XML 文件

if widgetBox.filename() != "myWidgetBox.xml":
    widgetBox.setFileName("myWidgetBox.xml")
    widgetBox.load()

另请参阅

QDesignerFormEditorInterface

__init__([parent=None[, flags=Qt.WindowFlags()]])

参数:

• parent – QWidget

• flags – 结合 WindowType

使用指定的 parent 和窗口 flags 构建一个小部件框界面。

abstract addCategory(cat)

参数:

cat – Category

abstract addWidget(cat_idx, wgt)

参数:

• cat_idx – int

• wgt – Widget

abstract category(cat_idx)

参数:

cat_idx – int

返回类型：

类别

abstract categoryCount()

返回类型：

int

abstract dropWidgets(item_list, global_mouse_pos)

参数:

• item_list – .list of QDesignerDnDItemInterface

• global_mouse_pos – QPoint

abstract fileName()

返回类型：

str

返回现在是 Qt Designer 使用以填充其小部件框的 XML 文件的名称。

另请参阅

setFileName()

findOrInsertCategory(categoryName)

参数:

categoryName – str

返回类型：

int

abstract load()

返回类型：

bool

通过加载（或重新加载）当前指定的 XML 文件来填充 Qt Designer 的小部件框。如果文件成功加载，则返回 true；否则返回 false。

另请参阅

setFileName()

abstract removeCategory(cat_idx)

参数:

cat_idx – int

抽象 removeWidget(cat_idx, wgt_idx)

参数:

• cat_idx – int

• wgt_idx – int

抽象 save()

返回类型：

bool

保存 Qt Designer 的部件盒内容到由 fileName() 函数指定的文件中。如果内容保存成功则返回 true，否则返回 false。

另请参阅

fileName() setFileName()

抽象 setFileName(file_name)

参数:

file_name – str

将 Qt Designer 用于填充部件盒的 XML 文件设置为 fileName。您必须调用 load() 以更新部件盒。

另请参阅

fileName() load()

抽象 widget(cat_idx, wgt_idx)

参数:

• cat_idx – int

• wgt_idx – int

返回类型：

小部件

抽象 widgetCount(cat_idx)

参数:

cat_idx – int

返回类型：

int