QMetaProperty ¶

函数 ¶

Property Meta-Data ¶

A property has a name() 和 type() , as well as various attributes that specify its behavior: isReadable() , isWritable() , isDesignable() , isScriptable() , revision() ，和 isStored() .

If the property is an enumeration, isEnumType() 返回 true ; if the property is an enumeration that is also a flag (i.e. its values can be combined using the OR operator), isEnumType() and isFlagType() both return true. The enumerator for these types is available from enumerator() .

The property’s values are set and retrieved with read() , write() ，和 reset() ; they can also be changed through QObject ‘s set and get functions. See setProperty() and property() 了解细节。

Copying and Assignment ¶

QMetaProperty objects can be copied by value. However, each copy will refer to the same underlying property meta-data.

另请参阅

QMetaObject QMetaEnum QMetaMethod Qt’s Property System

class QMetaProperty ¶

QMetaProperty(QMetaProperty)

参数

QMetaProperty – QMetaProperty

PySide2.QtCore.QMetaProperty. enumerator ( ) ¶

返回类型

QMetaEnum

Returns the enumerator if this property’s type is an enumerator type; otherwise the returned value is undefined.

另请参阅

isEnumType() isFlagType()

PySide2.QtCore.QMetaProperty. hasNotifySignal ( ) ¶

返回类型

bool

返回 true if this property has a corresponding change notify signal; otherwise returns false .

另请参阅

notifySignal()

PySide2.QtCore.QMetaProperty. hasStdCppSet ( ) ¶

返回类型

bool

返回 true if the property has a C++ setter function that follows Qt’s standard “name” / “setName” pattern. Designer and uic query in order to avoid expensive setProperty() calls. All properties in Qt [should] follow this pattern.

PySide2.QtCore.QMetaProperty. isConstant ( ) ¶

返回类型

bool

返回 true if the property is constant; otherwise returns false .

A property is constant if the Q_PROPERTY() ‘s CONSTANT attribute is set.

PySide2.QtCore.QMetaProperty. isDesignable ( [ obj=None ] ) ¶

参数

obj – QObject

返回类型

bool

返回 true if this property is designable for the given object ；否则返回 false .

若无 object is given, the function returns false 若 Q_PROPERTY() ‘s DESIGNABLE attribute is false; otherwise returns true (if the attribute is true or is a function or expression).

另请参阅

isScriptable() isStored()

PySide2.QtCore.QMetaProperty. isEditable ( [ obj=None ] ) ¶

参数

obj – QObject

返回类型

bool

注意

此函数被弃用。

返回 true if the property is editable for the given object ；否则返回 false .

若无 object is given, the function returns false 若 Q_PROPERTY() ‘s EDITABLE attribute is false; otherwise returns true (if the attribute is true or is a function or expression).

另请参阅

isDesignable() isScriptable() isStored()

PySide2.QtCore.QMetaProperty. isEnumType ( ) ¶

返回类型

bool

返回 true if the property’s type is an enumeration value; otherwise returns false .

另请参阅

enumerator() isFlagType()

PySide2.QtCore.QMetaProperty. isFinal ( ) ¶

返回类型

bool

返回 true if the property is final; otherwise returns false .

A property is final if the Q_PROPERTY() ‘s FINAL attribute is set.

PySide2.QtCore.QMetaProperty. isFlagType ( ) ¶

返回类型

bool

返回 true if the property’s type is an enumeration value that is used as a flag; otherwise returns false .

Flags can be combined using the OR operator. A flag type is implicitly also an enum type.

另请参阅

isEnumType() enumerator() isFlag()

PySide2.QtCore.QMetaProperty. isReadable ( ) ¶

返回类型

bool

返回 true if this property is readable; otherwise returns false .

另请参阅

isWritable() read() isValid()

PySide2.QtCore.QMetaProperty. isRequired ( ) ¶

返回类型

bool

返回 true if the property is required; otherwise returns false .

A property is final if the Q_PROPERTY() ‘s REQUIRED attribute is set.

PySide2.QtCore.QMetaProperty. isResettable ( ) ¶

返回类型

bool

返回 true if this property can be reset to a default value; otherwise returns false .

另请参阅

reset()

PySide2.QtCore.QMetaProperty. isScriptable ( [ obj=None ] ) ¶

参数

obj – QObject

返回类型

bool

返回 true if the property is scriptable for the given object ；否则返回 false .

若无 object is given, the function returns false 若 Q_PROPERTY() ‘s SCRIPTABLE attribute is false; otherwise returns true (if the attribute is true or is a function or expression).

另请参阅

isDesignable() isStored()

PySide2.QtCore.QMetaProperty. isStored ( [ obj=None ] ) ¶

参数

obj – QObject

返回类型

bool

返回 true if the property is stored for object ；否则返回 false。

若无 object is given, the function returns false 若 Q_PROPERTY() ‘s STORED attribute is false; otherwise returns true (if the attribute is true or is a function or expression).

另请参阅

isDesignable() isScriptable()

PySide2.QtCore.QMetaProperty. isUser ( [ obj=None ] ) ¶

参数

obj – QObject

返回类型

bool

返回 true if this property is designated as the USER property, i.e., the one that the user can edit for object or that is significant in some other way. Otherwise it returns false. e.g., the text property is the USER editable property of a QLineEdit .

若 object is None , the function returns false 若 Q_PROPERTY() ‘s USER attribute is false. Otherwise it returns true.

另请参阅

userProperty() isDesignable() isScriptable()

PySide2.QtCore.QMetaProperty. isValid ( ) ¶

返回类型

bool

返回 true if this property is valid (readable); otherwise returns false .

另请参阅

isReadable()

PySide2.QtCore.QMetaProperty. isWritable ( ) ¶

返回类型

bool

返回 true if this property is writable; otherwise returns false.

另请参阅

isReadable() write()

PySide2.QtCore.QMetaProperty. name ( ) ¶

返回类型

str

Returns this property’s name.

另请参阅

type() typeName()

PySide2.QtCore.QMetaProperty. notifySignal ( ) ¶

返回类型

QMetaMethod

返回 QMetaMethod instance of the property change notifying signal if one was specified, otherwise returns an invalid QMetaMethod .

另请参阅

hasNotifySignal()

PySide2.QtCore.QMetaProperty. notifySignalIndex ( ) ¶

返回类型

int

Returns the index of the property change notifying signal if one was specified, otherwise returns -1.

另请参阅

hasNotifySignal()

PySide2.QtCore.QMetaProperty. propertyIndex ( ) ¶

返回类型

int

Returns this property’s index.

PySide2.QtCore.QMetaProperty. read ( obj ) ¶

参数

obj – QObject

返回类型

object

Reads the property’s value from the given object . Returns the value if it was able to read it; otherwise returns an invalid variant.

另请参阅

write() reset() isReadable()

PySide2.QtCore.QMetaProperty. readOnGadget ( gadget ) ¶

参数

gadget – void

返回类型

object

Reads the property’s value from the given gadget . Returns the value if it was able to read it; otherwise returns an invalid variant.

This function should only be used if this is a property of a Q_GADGET

PySide2.QtCore.QMetaProperty. relativePropertyIndex ( ) ¶

返回类型

int

Returns this property’s index relative within the enclosing meta object.

PySide2.QtCore.QMetaProperty. reset ( obj ) ¶

参数

obj – QObject

返回类型

bool

Resets the property for the given object with a reset method. Returns true if the reset worked; otherwise returns false .

Reset methods are optional; only a few properties support them.

另请参阅

read() write()

PySide2.QtCore.QMetaProperty. resetOnGadget ( gadget ) ¶

参数

gadget – void

返回类型

bool

Resets the property for the given gadget with a reset method. Returns true if the reset worked; otherwise returns false .

Reset methods are optional; only a few properties support them.

This function should only be used if this is a property of a Q_GADGET

PySide2.QtCore.QMetaProperty. revision ( ) ¶

返回类型

int

Returns the property revision if one was specified by REVISION, otherwise returns 0.

PySide2.QtCore.QMetaProperty. type ( ) ¶

返回类型

QVariant::Type

Returns this property’s type. The return value is one of the values of the Type enumeration.

另请参阅

userType() typeName() name()

PySide2.QtCore.QMetaProperty. typeName ( ) ¶

返回类型

str

Returns the name of this property’s type.

另请参阅

type() name()

PySide2.QtCore.QMetaProperty. userType ( ) ¶

返回类型

int

Returns this property’s user type. The return value is one of the values that are registered with QMetaType ，或 UnknownType if the type is not registered.

另请参阅

type() QMetaType typeName()

PySide2.QtCore.QMetaProperty. write ( obj , value ) ¶

参数

• obj – QObject

• value – object

返回类型

bool

写入 value as the property’s value to the given object . Returns true if the write succeeded; otherwise returns false .

若 value is not of the same type type as the property, a conversion is attempted. An empty QVariant() is equivalent to a call to reset() if this property is resetable, or setting a default-constructed object otherwise.

另请参阅

read() reset() isWritable()

PySide2.QtCore.QMetaProperty. writeOnGadget ( gadget , value ) ¶

参数

• gadget – void

• value – object

返回类型

bool

写入 value as the property’s value to the given gadget . Returns true if the write succeeded; otherwise returns false .

This function should only be used if this is a property of a Q_GADGET