# QDesignerPropertySheetExtension Class Reference ## [[QtDesigner](index.htm) module] 該QDesignerPropertySheetExtension類允許你操作并顯示在Qt設計器的屬性編輯器窗口小部件的屬性。[More...](#details) 通過繼承[QPyDesignerPropertySheetExtension](qpydesignerpropertysheetextension.html)。 ### Methods * `__init__ (self)` * `__init__ (self, QDesignerPropertySheetExtension)` * `int count (self)` * `bool hasReset (self, int?index)` * `int indexOf (self, QString?name)` * `bool isAttribute (self, int?index)` * `bool isChanged (self, int?index)` * `bool isVisible (self, int?index)` * `QVariant property (self, int?index)` * `QString propertyGroup (self, int?index)` * `QString propertyName (self, int?index)` * `bool reset (self, int?index)` * `setAttribute (self, int?index, bool?b)` * `setChanged (self, int?index, bool?changed)` * `setProperty (self, int?index, QVariant?value)` * `setPropertyGroup (self, int?index, QString?group)` * `setVisible (self, int?index, bool?b)` ### Special Methods * `__len__ (self)` * * * ## Detailed Description 該QDesignerPropertySheetExtension類允許你操作并顯示在Qt設計器的屬性編輯器窗口小部件的屬性。 QDesignerPropertySheetExtension規定，通常用于查詢窗口小部件的屬性，操縱性能“出現在屬性編輯器的功能的集合。例如： ``` QDesignerPropertySheetExtension *propertySheet = 0; [QExtensionManager](qextensionmanager.html) manager = formEditor->extensionManager(); propertySheet = qt_extension<QDesignerPropertySheetExtension*>(manager, widget); int index = propertySheet->indexOf(QLatin1String("margin")); propertySheet->setProperty(index, 10); propertySheet->setChanged(index, true); delete propertySheet; ``` 請注意，如果您使用更改屬性的值[QDesignerPropertySheetExtension.setProperty](qdesignerpropertysheetextension.html#setProperty)（ ）函數，撤消堆棧沒有更新。為了確保一個屬性的值可以使用撤消堆棧被還原，則必須使用[QDesignerFormWindowCursorInterface.setProperty](qdesignerformwindowcursorinterface.html#setProperty)（ ）函數，或者它的夥伴[setWidgetProperty()](qdesignerformwindowcursorinterface.html#setWidgetProperty)代替。 當實現一個自定義的widget插件，一個指向_Qt Designer_目前的[QDesignerFormEditorInterface](qdesignerformeditorinterface.html)對象（`formEditor`在上面的例子）是由提供[QDesignerCustomWidgetInterface.initialize](qdesignercustomwidgetinterface.html#initialize)（ ）函數的參數。 屬性表，或任何其他分機，可以通過查詢檢索_Qt Designer_使用的擴展管理器[qt_extension](qextensionmanager.html#qt_extension)（）函數。當你要釋放的擴展，你只需要刪除的指針。 所有的部件都有一個默認的屬性表的填充_Qt Designer_的屬性編輯器的控件的屬性（即與所定義的那些[Q_PROPERTY](qobject.html#Q_PROPERTY)（）宏） 。但QDesignerPropertySheetExtension還提供了用于創建自定義屬性表擴展的接口。 **Warning:** _Qt Designer_使用QDesignerPropertySheetExtension養活它的屬性編輯器。每當一個小部件中選擇其工作區，_Qt Designer_將查詢窗口小部件的屬性表擴展。如果選定部件有一個實現屬性表的擴展，這個擴展將復蓋默認的屬性表。 要創建一個屬性表的擴展，你的擴展類必須繼承自兩個[QObject](qobject.html)和QDesignerPropertySheetExtension 。然后，因為我們正在實現一個接口，我們必須確保它是由已知的元對象系統中使用[Q_INTERFACES](qobject.html#Q_INTERFACES)（）宏： ``` class MyPropertySheetExtension : public [QObject](qobject.html), public QDesignerPropertySheetExtension { Q_OBJECT Q_INTERFACES(QDesignerPropertySheetExtension) public: ... } ``` 這使_Qt Designer_使用[qobject_cast](qobject.html#qobject_cast)（）來查詢只是用一個接口支持[QObject](qobject.html)指針。 In _Qt Designer_未創建的擴展，直到你需要它們。出于這個原因，實現屬性表擴展時，您還必須創建一個[QExtensionFactory](qextensionfactory.html)，即一個類，它能夠讓你的擴展的一個實例，并使用它注冊_Qt Designer_的[extension manager](qextensionmanager.html)。 當一個屬性表擴展是必需的，_Qt Designer_的[extension manager](qextensionmanager.html)將通過其所有已注冊的工廠運行要求[QExtensionFactory.createExtension](qextensionfactory.html#createExtension)（ ）對每一直到第一個是能夠創造一個屬性表擴展選定控件，被找到。這家工廠將使這個擴展的實例。如果沒有這樣的工廠，可以發現，_Qt Designer_將使用默認的屬性表。 有擴展的四個可用的類型_Qt Designer_：[QDesignerContainerExtension](qdesignercontainerextension.html)，[QDesignerMemberSheetExtension](qdesignermembersheetextension.html)， QDesignerPropertySheetExtension和[QDesignerTaskMenuExtension](qdesignertaskmenuextension.html)。 Qt設計器的行為是一樣的具有多頁的容器，一個成員表，屬性表或任務菜單中的延期申請是否相關。 該[QExtensionFactory](qextensionfactory.html)類提供了一個標準的擴展工廠，并且也可以用作用于定義擴展工廠的接口。您可以創建一個新的[QExtensionFactory](qextensionfactory.html)并重新實現[QExtensionFactory.createExtension](qextensionfactory.html#createExtension)（）函數。例如： ``` [QObject](qobject.html) *ANewExtensionFactory.createExtension([QObject](qobject.html) *object, const [QString](qstring.html) &iid, [QObject](qobject.html) *parent) const { if (iid != Q_TYPEID(QDesignerPropertySheetExtension)) return 0; if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*> (object)) return new MyPropertySheetExtension(widget, parent); return 0; } ``` 或者您可以使用現有的工廠，擴大[QExtensionFactory.createExtension](qextensionfactory.html#createExtension)（ ）函數，使工廠能夠創建一個屬性表擴展延伸為好。例如： ``` [QObject](qobject.html) *AGeneralExtensionFactory.createExtension([QObject](qobject.html) *object, const [QString](qstring.html) &iid, [QObject](qobject.html) *parent) const { MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object); if (widget && (iid == Q_TYPEID([QDesignerTaskMenuExtension](qdesignertaskmenuextension.html)))) { return new MyTaskMenuExtension(widget, parent); } else if (widget && (iid == Q_TYPEID(QDesignerPropertySheetExtension))) { return new MyPropertySheetExtension(widget, parent); } else { return 0; } } ``` 對于使用擴展類的完整示例，請參見[Task Menu Extension example](index.htm)。該示例顯示了如何創建一個自定義的widget插件Qt Designer中，以及如何使用[QDesignerTaskMenuExtension](qdesignertaskmenuextension.html)類的自定義項添加到_Qt Designer_的任務菜單。 * * * ## Method Documentation ``` QDesignerPropertySheetExtension.__init__ (self) ``` ``` QDesignerPropertySheetExtension.__init__ (self, QDesignerPropertySheetExtension) ``` ``` int QDesignerPropertySheetExtension.count (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回的屬性所選部件的數量。 ``` bool QDesignerPropertySheetExtension.hasReset (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回True如果給定的酒店在_index_有一個復位按鈕_Qt Designer_的屬性編輯器，否則為False 。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[reset](qdesignerpropertysheetextension.html#reset)（ ） 。 ``` int QDesignerPropertySheetExtension.indexOf (self, QString?name) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回索引對于給定的屬性_name_。 **See also** [propertyName](qdesignerpropertysheetextension.html#propertyName)（ ） 。 ``` bool QDesignerPropertySheetExtension.isAttribute (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回True如果給定的酒店在_index_是一個屬性，這將是_excluded_從UI文件，否則為False。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[setAttribute](qdesignerpropertysheetextension.html#setAttribute)（ ） 。 ``` bool QDesignerPropertySheetExtension.isChanged (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回True如果給定的屬性的值_index_不同于屬性的默認值，否則返回False 。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（ ）[setChanged](qdesignerpropertysheetextension.html#setChanged)（）和[reset](qdesignerpropertysheetextension.html#reset)（ ） 。 ``` bool QDesignerPropertySheetExtension.isVisible (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回True如果給定的酒店在_index_在可見_Qt Designer_的屬性編輯器，否則為False 。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[setVisible](qdesignerpropertysheetextension.html#setVisible)（ ） 。 ``` QVariant QDesignerPropertySheetExtension.property (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 在給定的返回屬性的值_index_。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（ ）[setProperty](qdesignerpropertysheetextension.html#setProperty)（）和[propertyGroup](qdesignerpropertysheetextension.html#propertyGroup)（ ） 。 ``` QString QDesignerPropertySheetExtension.propertyGroup (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 在給定的返回屬性組屬性_index_。 _Qt Designer_的屬性編輯器支持屬性組，相關性，即部分。一個屬性可以使用上與一組[setPropertyGroup](qdesignerpropertysheetextension.html#setPropertyGroup)（）函數。任何屬性的默認組是定義它的類的名稱。例如，本[QObject.objectName](qobject.html#objectName-prop)物業內出現的[QObject](qobject.html)屬性組。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[setPropertyGroup](qdesignerpropertysheetextension.html#setPropertyGroup)（ ） 。 ``` QString QDesignerPropertySheetExtension.propertyName (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回屬性的名稱在給定的_index_。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（ ） 。 ``` bool QDesignerPropertySheetExtension.reset (self, int?index) ``` 這種方法是抽象的，應在任何子類中重新實現。 復位在給定的屬性的值_index_，為默認值。返回True如果默認值可以發現，否則為False 。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（ ）[hasReset](qdesignerpropertysheetextension.html#hasReset)（）和[isChanged](qdesignerpropertysheetextension.html#isChanged)（ ） 。 ``` QDesignerPropertySheetExtension.setAttribute (self, int?index, bool?b) ``` 這種方法是抽象的，應在任何子類中重新實現。 If _attribute_誠然，該物業在給定的_index_由這將是一個屬性_excluded_從UI文件，否則將被納入。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[isAttribute](qdesignerpropertysheetextension.html#isAttribute)（ ） 。 ``` QDesignerPropertySheetExtension.setChanged (self, int?index, bool?changed) ``` 這種方法是抽象的，應在任何子類中重新實現。 設置該屬性是否在給定的_index_從它的默認值，或沒有，根據不同的_changed_參數。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[isChanged](qdesignerpropertysheetextension.html#isChanged)（ ） 。 ``` QDesignerPropertySheetExtension.setProperty (self, int?index, QVariant?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 設置_value_酒店在給定的_index_。 **Warning:**如果更改使用此功能的屬性的值，撤消堆棧沒有更新。為了確保一個屬性的值可以使用撤消堆棧被還原，則必須使用[QDesignerFormWindowCursorInterface.setProperty](qdesignerformwindowcursorinterface.html#setProperty)（ ）函數，或者它的夥伴[setWidgetProperty()](qdesignerformwindowcursorinterface.html#setWidgetProperty)代替。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（ ）[property](qdesignerpropertysheetextension.html#property)（）和[propertyGroup](qdesignerpropertysheetextension.html#propertyGroup)（ ） 。 ``` QDesignerPropertySheetExtension.setPropertyGroup (self, int?index, QString?group) ``` 這種方法是抽象的，應在任何子類中重新實現。 設置屬性組的屬性在給定_index_至_group_。 有關物業為一組使得在屬性編輯器該組的部分中也出現。默認屬性組中的任何財產是定義它的類的名稱。例如，本[QObject.objectName](qobject.html#objectName-prop)物業內出現的[QObject](qobject.html)屬性組。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（ ）[property](qdesignerpropertysheetextension.html#property)（）和[propertyGroup](qdesignerpropertysheetextension.html#propertyGroup)（ ） 。 ``` QDesignerPropertySheetExtension.setVisible (self, int?index, bool?b) ``` 這種方法是抽象的，應在任何子類中重新實現。 If _visible_誠然，該物業在給定的_index_在可見_Qt Designer_的屬性編輯器，否則該屬性是隱藏的。 **See also** [indexOf](qdesignerpropertysheetextension.html#indexOf)（）和[isVisible](qdesignerpropertysheetextension.html#isVisible)（ ） 。 ``` QDesignerPropertySheetExtension.__len__ (self) ```