内容

公共类型
公共函数
静态公共成员
详细描述

QDeclarativeProperty Class

The QDeclarativeProperty class abstracts accessing properties on objects created from QML. 更多...

头：	#include <QDeclarativeProperty>
Since:	Qt 4.7

所有成员列表，包括继承成员

公共类型

enum	PropertyTypeCategory { InvalidCategory, List, Object, Normal }
enum	Type { Invalid, Property, SignalProperty }

公共函数

	QDeclarativeProperty ()
	QDeclarativeProperty (QObject * obj )
	QDeclarativeProperty (QObject * obj , QDeclarativeContext * ctxt )
	QDeclarativeProperty (QObject * obj , QDeclarativeEngine * engine )
	QDeclarativeProperty (QObject * obj , const QString & name )
	QDeclarativeProperty (QObject * obj , const QString & name , QDeclarativeContext * ctxt )
	QDeclarativeProperty (QObject * obj , const QString & name , QDeclarativeEngine * engine )
	QDeclarativeProperty (const QDeclarativeProperty & other )
bool	connectNotifySignal (QObject * dest , const char * slot ) const
bool	connectNotifySignal (QObject * dest , int method ) const
bool	hasNotifySignal () const
int	index () const
bool	isDesignable () const
bool	isProperty () const
bool	isResettable () const
bool	isSignalProperty () const
bool	isValid () const
bool	isWritable () const
QMetaMethod	方法 () const
QString	name () const
bool	needsNotifySignal () const
QObject *	对象 () const
QMetaProperty	property () const
int	propertyType () const
PropertyTypeCategory	propertyTypeCategory () const
const char *	propertyTypeName () const
QVariant	read () const
bool	reset () const
类型	type () const
bool	write (const QVariant & value ) const
QDeclarativeProperty &	operator= (const QDeclarativeProperty & other )
bool	operator== (const QDeclarativeProperty & other ) const

静态公共成员

QVariant	read (QObject * object , const QString & name )
QVariant	read (QObject * object , const QString & name , QDeclarativeContext * ctxt )
QVariant	read (QObject * object , const QString & name , QDeclarativeEngine * engine )
bool	write (QObject * object , const QString & name , const QVariant & value )
bool	write (QObject * object , const QString & name , const QVariant & value , QDeclarativeContext * ctxt )
bool	write (QObject * object , const QString & name , const QVariant & value , QDeclarativeEngine * engine )

详细描述

The QDeclarativeProperty class abstracts accessing properties on objects created from QML.

As QML uses Qt's meta-type system all of the existing QMetaObject classes can be used to introspect and interact with objects created by QML. However, some of the new features provided by QML - such as type safety and attached properties - are most easily used through the QDeclarativeProperty class that simplifies some of their natural complexity.

不像 QMetaProperty which represents a property on a class type, QDeclarativeProperty encapsulates a property on a specific object instance. To read a property's value, programmers create a QDeclarativeProperty instance and call the read () method. Likewise to write a property value the write () method is used.

For example, for the following QML code:

// MyItem.qml
import QtQuick 1.0
Text { text: "A bit of text" }

The Text object's properties could be accessed using QDeclarativeProperty ，像这样：

#include <QDeclarativeProperty>
#include <QGraphicsObject>
...
QDeclarativeView view(QUrl::fromLocalFile("MyItem.qml"));
QDeclarativeProperty property(view.rootObject(), "font.pixelSize");
qWarning() << "Current pixel size:" << property.read().toInt();
property.write(24);
qWarning() << "Pixel size should now be 24:" << property.read().toInt();

成员类型文档编制

enum QDeclarativeProperty:: PropertyTypeCategory

This enum specifies a category of QML property.

常量	值	描述
`QDeclarativeProperty::InvalidCategory`	`0`	The property is invalid, or is a signal property.
`QDeclarativeProperty::List`	`1`	The property is a QDeclarativeListProperty list property
`QDeclarativeProperty::Object`	`2`	The property is a QObject derived type pointer
`QDeclarativeProperty::Normal`	`3`	The property is a normal value property.

enum QDeclarativeProperty:: Type

This enum specifies a type of QML property.

常量	值	描述
`QDeclarativeProperty::Invalid`	`0`	The property is invalid.
`QDeclarativeProperty::Property`	`1`	The property is a regular Qt property.
`QDeclarativeProperty::SignalProperty`	`2`	The property is a signal property.

成员函数文档编制

QDeclarativeProperty:: QDeclarativeProperty ()

Create an invalid QDeclarativeProperty .

QDeclarativeProperty:: QDeclarativeProperty ( QObject * obj )

创建 QDeclarativeProperty for the default property of obj . If there is no default property, an invalid QDeclarativeProperty will be created.

QDeclarativeProperty:: QDeclarativeProperty ( QObject * obj , QDeclarativeContext * ctxt )

创建 QDeclarativeProperty for the default property of obj 使用 context ctxt . If there is no default property, an invalid QDeclarativeProperty will be created.

QDeclarativeProperty:: QDeclarativeProperty ( QObject * obj , QDeclarativeEngine * engine )

创建 QDeclarativeProperty for the default property of obj using the environment for instantiating QML components that is provided by engine . If there is no default property, an invalid QDeclarativeProperty will be created.

QDeclarativeProperty:: QDeclarativeProperty ( QObject * obj , const QString & name )

创建 QDeclarativeProperty for the property name of obj .

QDeclarativeProperty:: QDeclarativeProperty ( QObject * obj , const QString & name , QDeclarativeContext * ctxt )

创建 QDeclarativeProperty for the property name of obj 使用 context ctxt .

Creating a QDeclarativeProperty without a context will render some properties - like attached properties - inaccessible.

QDeclarativeProperty:: QDeclarativeProperty ( QObject * obj , const QString & name , QDeclarativeEngine * engine )

创建 QDeclarativeProperty for the property name of obj using the environment for instantiating QML components that is provided by engine .

QDeclarativeProperty:: QDeclarativeProperty (const QDeclarativeProperty & other )

Create a copy of other .

bool QDeclarativeProperty:: connectNotifySignal ( QObject * dest , const char * slot ) const

Connects the property's change notifier signal to the specified slot 的 dest object and returns true. Returns false if this metaproperty does not represent a regular Qt property or if it has no change notifier signal, or if the dest object does not have the specified slot .

bool QDeclarativeProperty:: connectNotifySignal ( QObject * dest , int method ) const

Connects the property's change notifier signal to the specified method 的 dest object and returns true. Returns false if this metaproperty does not represent a regular Qt property or if it has no change notifier signal, or if the dest object does not have the specified method .

bool QDeclarativeProperty:: hasNotifySignal () const

Returns true if the property has a change notifier signal, otherwise false.

int QDeclarativeProperty:: index () const

Return the Qt metaobject index of the property.

bool QDeclarativeProperty:: isDesignable () const

Returns true if the property is designable, otherwise false.

bool QDeclarativeProperty:: isProperty () const

返回 true，若此 QDeclarativeProperty represents a regular Qt property.

bool QDeclarativeProperty:: isResettable () const

Returns true if the property is resettable, otherwise false.

bool QDeclarativeProperty:: isSignalProperty () const

返回 true，若此 QDeclarativeProperty represents a QML signal property.

bool QDeclarativeProperty:: isValid () const

返回 true 若 QDeclarativeProperty refers to a valid property, otherwise false.

bool QDeclarativeProperty:: isWritable () const

Returns true if the property is writable, otherwise false.

QMetaMethod QDeclarativeProperty:: 方法 () const

返回 QMetaMethod for this property if it is a SignalProperty , otherwise returns an invalid QMetaMethod .

QString QDeclarativeProperty:: name () const

Return the name of this QML property.

bool QDeclarativeProperty:: needsNotifySignal () const

Returns true if the property needs a change notifier signal for bindings to remain upto date, false otherwise.

Some properties, such as attached properties or those whose value never changes, do not require a change notifier.

QObject * QDeclarativeProperty:: 对象 () const

返回 QDeclarativeProperty 's QObject .

QMetaProperty QDeclarativeProperty:: property () const

返回 Qt 特性 associated with this QML property.

int QDeclarativeProperty:: propertyType () const

返回 QVariant type of the property, or QVariant::Invalid if the property has no QVariant 类型。

PropertyTypeCategory QDeclarativeProperty:: propertyTypeCategory () const

Returns the property category.

const char * QDeclarativeProperty:: propertyTypeName () const

Returns the type name of the property, or 0 if the property has no type name.

QVariant QDeclarativeProperty:: read () const

Returns the property value.

`[static]` QVariant QDeclarativeProperty:: read ( QObject * object , const QString & name )

返回 name property value of object . This method is equivalent to:

QDeclarativeProperty p(object, name);
p.read();

`[static]` QVariant QDeclarativeProperty:: read ( QObject * object , const QString & name , QDeclarativeContext * ctxt )

返回 name property value of object 使用 context ctxt . This method is equivalent to:

QDeclarativeProperty p(object, name, context);
p.read();

`[static]` QVariant QDeclarativeProperty:: read ( QObject * object , const QString & name , QDeclarativeEngine * engine )

返回 name property value of object using the environment for instantiating QML components that is provided by engine . . This method is equivalent to:

QDeclarativeProperty p(object, name, engine);
p.read();

bool QDeclarativeProperty:: reset () const

Resets the property and returns true if the property is resettable. If the property is not resettable, nothing happens and false is returned.

Type QDeclarativeProperty:: type () const

Returns the type of the property.

bool QDeclarativeProperty:: write (const QVariant & value ) const

Sets the property value to value and returns true. Returns false if the property can't be set because the value is the wrong type, for example.

`[static]` bool QDeclarativeProperty:: write ( QObject * object , const QString & name , const QVariant & value )

写入 value 到 name property of object . This method is equivalent to:

QDeclarativeProperty p(object, name);
p.write(value);

`[static]` bool QDeclarativeProperty:: write ( QObject * object , const QString & name , const QVariant & value , QDeclarativeContext * ctxt )

写入 value 到 name property of object 使用 context ctxt . This method is equivalent to:

QDeclarativeProperty p(object, name, ctxt);
p.write(value);

`[static]` bool QDeclarativeProperty:: write ( QObject * object , const QString & name , const QVariant & value , QDeclarativeEngine * engine )

写入 value 到 name property of object using the environment for instantiating QML components that is provided by engine . This method is equivalent to:

QDeclarativeProperty p(object, name, engine);
p.write(value);

QDeclarativeProperty & QDeclarativeProperty:: operator= (const QDeclarativeProperty & other )

赋值 other 到此 QDeclarativeProperty .

bool QDeclarativeProperty:: operator== (const QDeclarativeProperty & other ) const

返回 true 若 other 和此 QDeclarativeProperty represent the same property.

内容