QDesignerPropertySheetExtension Class

QDesignerPropertySheetExtension *propertySheet = nullptr;
QExtensionManager manager = formEditor->extensionManager();

propertySheet = qt_extension<QDesignerPropertySheetExtension*>(manager, widget);
int index = propertySheet->indexOf(u"margin"_s);

propertySheet->setProperty(index, 10);
propertySheet->setChanged(index, true);

delete propertySheet;

class MyPropertySheetExtension : public QObject,
        public QDesignerPropertySheetExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerPropertySheetExtension)

public:
    ...
}

QObject *ANewExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    if (iid != Q_TYPEID(QDesignerPropertySheetExtension))
        return 0;

    if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>
           (object))
        return new MyPropertySheetExtension(widget, parent);

    return 0;
}

QObject *AGeneralExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object);

    if (widget && (iid == Q_TYPEID(QDesignerTaskMenuExtension))) {
        return new MyTaskMenuExtension(widget, parent);

    } else if (widget && (iid == Q_TYPEID(QDesignerPropertySheetExtension))) {
        return new MyPropertySheetExtension(widget, parent);

    } else {
        return 0;
    }
}

成员函数文档

[constexpr noexcept default] QDesignerPropertySheetExtension::QDesignerPropertySheetExtension()

默认——构造一个QDesignerPropertySheetExtension 的实例。

[delete] QDesignerPropertySheetExtension::QDesignerPropertySheetExtension(const QDesignerPropertySheetExtension &)

复制并构造一个QDesignerPropertySheetExtension 实例。该函数已被删除。

[delete] QDesignerPropertySheetExtension::QDesignerPropertySheetExtension(QDesignerPropertySheetExtension &&)

通过移动构造一个QDesignerPropertySheetExtension 实例。该函数已被删除。

[virtual constexpr noexcept default] QDesignerPropertySheetExtension::~QDesignerPropertySheetExtension()

删除属性表扩展。

[pure virtual] int QDesignerPropertySheetExtension::count() const

返回所选控件的属性数量。

[pure virtual] bool QDesignerPropertySheetExtension::hasReset(int index) const

如果位于给定index 的属性在Qt Widgets Designer 的属性编辑器中带有“重置”按钮，则返回 true；否则返回 false。

另请参阅 indexOf() 和reset()。

[pure virtual] int QDesignerPropertySheetExtension::indexOf(const QString &name) const

返回给定属性name 的索引。

另请参阅 propertyName()。

[pure virtual] bool QDesignerPropertySheetExtension::isAttribute(int index) const

如果指定位置index 处的属性是属性（attribute），则返回 true，该属性将从 UI 文件中排除；否则返回 false。

另请参阅 indexOf() 和setAttribute()。

[pure virtual] bool QDesignerPropertySheetExtension::isChanged(int index) const

如果给定index 处的属性值与该属性的默认值不同，则返回 true；否则返回 false。

另请参阅 indexOf()、setChanged() 和reset()。

[pure virtual] bool QDesignerPropertySheetExtension::isEnabled(int index) const

如果位于index 的属性在Qt Widgets Designer 的属性编辑器中已启用，则返回 true；否则返回 false。

另请参阅 indexOf()。

[pure virtual] bool QDesignerPropertySheetExtension::isVisible(int index) const

如果位于给定index 处的属性在Qt Widgets Designer 的属性编辑器中可见，则返回true；否则返回false。

另请参阅 indexOf() 和setVisible()。

[pure virtual] QVariant QDesignerPropertySheetExtension::property(int index) const

返回指定index 处的属性值。

另请参阅 indexOf()、setProperty() 和propertyGroup()。

[pure virtual] QString QDesignerPropertySheetExtension::propertyGroup(int index) const

返回位于给定index 处的属性的属性组。

Qt Widgets Designer的属性编辑器支持属性组，即相关属性的分组。可以通过setPropertyGroup()函数将属性与一个组相关联。任何属性的默认组是定义该属性的类的名称。例如，QObject::objectName 属性出现在QObject 属性组中。

另请参阅 indexOf() 和setPropertyGroup()。

[pure virtual] QString QDesignerPropertySheetExtension::propertyName(int index) const

返回位于给定index 处的属性名称。

另请参阅 indexOf()。

[pure virtual] bool QDesignerPropertySheetExtension::reset(int index)

将指定位置index 处的属性值重置为默认值。如果找到了默认值，则返回true；否则返回false。

另请参阅 indexOf()、hasReset() 和isChanged()。

[pure virtual] void QDesignerPropertySheetExtension::setAttribute(int index, bool attribute)

如果attribute 为真，则位于指定index 处的属性将被设为属性，从而从 UI 文件中排除；否则将被包含在内。

另请参阅 indexOf() 和isAttribute()。

[pure virtual] void QDesignerPropertySheetExtension::setChanged(int index, bool changed)

根据changed 参数，设置指定index 处的属性是否与默认值不同。

另请参阅 indexOf() 和isChanged()。

[pure virtual] void QDesignerPropertySheetExtension::setProperty(int index, const QVariant &value)

将该属性的value 属性设置为给定的index 。

另请参阅 indexOf()、property() 和propertyGroup()。

[pure virtual] void QDesignerPropertySheetExtension::setPropertyGroup(int index, const QString &group)

将位于指定位置index 的属性的属性组设置为group 。

将属性与组相关联后，该属性将显示在属性编辑器中该组的相应部分内。任何属性的默认属性组即为定义该属性的类名。例如，QObject::objectName 属性会显示在QObject 属性组中。

另请参阅 indexOf()、property() 和propertyGroup()。

[pure virtual] void QDesignerPropertySheetExtension::setVisible(int index, bool visible)

如果visible 为真，则位于指定index 的属性在Qt Widgets Designer 的属性编辑器中可见；否则该属性被隐藏。

另请参阅 indexOf() 和isVisible()。

[delete] QDesignerPropertySheetExtension &QDesignerPropertySheetExtension::operator=(QDesignerPropertySheetExtension &&)

将other 按移动赋值方式赋值给此QDesignerPropertySheetExtension 实例。此函数已被删除。

[delete] QDesignerPropertySheetExtension &QDesignerPropertySheetExtension::operator=(const QDesignerPropertySheetExtension &)

将other 复制并赋值给此QDesignerPropertySheetExtension 实例。该函数已被删除。