PySide6.QtDesigner.QDesignerWidgetBoxInterface¶

class QDesignerWidgetBoxInterface¶

QDesignerWidgetBoxInterface 类允许你控制 Qt Widgets Designer 的小部件框的内容。More_…

概要¶

方法¶

def __init__()
def findOrInsertCategory()

虚拟方法¶

def addCategory()
def addWidget()
def category()
def categoryCount()
def dropWidgets()
def fileName()
def load()
def removeCategory()
def removeWidget()
def save()
def setFileName()
def widget()
def widgetCount()

注意

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

详细描述¶

警告

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

QDesignerWidgetBoxInterface 包含一组通常用于操作 Qt Widgets Designer 的小部件框内容的函数。

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

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

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

QDesignerWidgetBoxInterface 类不打算直接实例化。您可以使用 widgetBox() 函数来获取 Qt Designer 的小部件盒的接口。Qt Widgets Designer 当前的 QDesignerFormEditorInterface 对象的指针（在上面的示例中为 formEditor）由 initialize() 函数的参数提供。在实现自定义小部件插件时，您必须子类化 QDesignerCustomWidgetInterface 以将您的插件暴露给 Qt Widgets 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()]])¶

Parameters:

parent – QWidget
flags – WindowType 的组合

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

abstract addCategory(cat)¶

Parameters:: cat – 类别

abstract addWidget(cat_idx, wgt)¶

Parameters:

cat_idx – int
wgt – Widget

abstract category(cat_idx)¶

Parameters:: cat_idx – 整数
Return type:: 类别

abstract categoryCount()¶

Return type:: 整数

abstract dropWidgets(item_list, global_mouse_pos)¶

Parameters:

item_list – QDesignerDnDItemInterface 的列表
global_mouse_pos – QPoint

abstract fileName()¶

Return type:: 字符串

返回Qt Widgets Designer当前用于填充其小部件框的XML文件的名称。

另请参阅

setFileName()

findOrInsertCategory(categoryName)¶

Parameters:: categoryName – str
Return type:: 整数

abstract load()¶

Return type:: 布尔

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

另请参阅

setFileName()

abstract removeCategory(cat_idx)¶

Parameters:: cat_idx – 整数

abstract removeWidget(cat_idx, wgt_idx)¶

Parameters:

cat_idx – int
wgt_idx – int

abstract save()¶

Return type:: 布尔

将Qt Widgets Designer的小部件框的内容保存在由fileName()函数指定的文件中。如果内容成功保存，则返回true；否则返回false。

另请参阅

fileName() setFileName()

abstract setFileName(file_name)¶

Parameters:: file_name – str

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

另请参阅

fileName() load()

abstract widget(cat_idx, wgt_idx)¶

Parameters:

cat_idx – int
wgt_idx – 整数

Return type:

Widget

abstract widgetCount(cat_idx)¶

Parameters:: cat_idx – 整数
Return type:: 整数

class Widget¶

概要¶

方法¶

def __init__()
def domXml()
def iconName()
def isNull()
def name()
def setDomXml()
def setIconName()
def setName()
def setType()
def type()

注意

详细描述¶

class Type¶

__init__(w)¶

Parameters:: w – Widget

__init__([aname=""[, xml=""[, icon_name=""[, atype=QDesignerWidgetBoxInterface.Widget.Type.Default]]]])

Parameters:

aname – str
xml – 字符串
icon_name – str
atype – 类型

domXml()¶

Return type:: 字符串

iconName()¶

Return type:: 字符串

isNull()¶

Return type:: 布尔

name()¶

Return type:: 字符串

setDomXml(xml)¶

Parameters:: xml – str

setIconName(icon_name)¶

Parameters:: icon_name – str

setName(aname)¶

Parameters:: aname – str

setType(atype)¶

Parameters:: atype – Type

type()¶

Return type:: 类型

class Category¶

概要¶

方法¶

def __init__()
def addWidget()
def isNull()
def name()
def removeWidget()
def setName()
def setType()
def type()
def widget()
def widgetCount()

注意

详细描述¶

class Type¶

__init__([aname=""[, atype=QDesignerWidgetBoxInterface.Category.Type.Default]])¶

Parameters:

aname – str
atype – 类型

addWidget(awidget)¶

Parameters:: awidget – Widget

isNull()¶

Return type:: 布尔

name()¶

Return type:: 字符串

removeWidget(idx)¶

Parameters:: idx – 整数

setName(aname)¶

Parameters:: aname – str

setType(atype)¶

Parameters:: atype – 类型

type()¶

Return type:: 类型

widget(idx)¶

Parameters:: idx – 整数
Return type:: Widget

widgetCount()¶

Return type:: 整数