The Property System

Qt提供一个类似于其他编译器供应商提供的精致的属性系统。然而,作为一个编译器和平台独立的库,Qt并不依赖于非标准编译器特性,如__property 或 [property]。Qt解决方案能在支持Qt的平台上与任何标准C++编译器一起工作。它依赖于 Meta-Object System 。

Requirements for DeclaringProperties

要声明一个属性,在继承Qobject的类中用 Q_PROPERTY()宏。

Q_PROPERTY(type name

READ getFunction

[WRITE setFunction]

[RESET resetFunction]

[NOTIFY notifySignal]

[REVISION int]

[DESIGNABLE bool]

[SCRIPTABLE bool]

[STORED bool]

[USER bool]

[CONSTANT]

[FINAL])

以下是摘自 QWidget类的典型的属性声明:

Q_PROPERTY(bool focus READ hasFocus)
Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
Q_PROPERTY(QCursor cursor READ cursor WRITE setCursor RESET unsetCursor)

属性的行为跟数据成员一样,但是它有通过Meta-Object System.的额外特性。

·         需要有READ 函数.用来读取属性的值. 理想的,为此最好是const函数 ,必须返回属性的类型或者属性类型一个指针或引用 , QWidget::focus 是只读属性, 读取函数QWidget::hasFocus().

·         WRITE 函数是可选的.它用来设置属性值.。它必须返回void和带一个参数,参数为属性的类型或者类型的引用或指针。如 QWidget::enabled有一个  WRITE 函数QWidget::setEnabled().。只读属性不需要有WRITE 函数,如 QWidget::focus没有WRITE 函数。

·         RESET函数也是可选的。它用来设置属性值为上下文指定的默认值。 QWidget::cursor有典型的 READ 和 WRITE 函数, QWidget::cursor() 和 QWidget::setCursor(), 并且它有 RESET 函数,QWidget::unsetCursor(),。因为没有调用QWidget::setCursor() 可以设置,上下文指定的光标。RESET函数必须返回void和不带参数。

·        NOTIFY 信号是可选的。如果定义,它指定为类中已经存在的信号,如果属性值发生变化则发出该信号。

·        REVISION 数是可选的。如果包含,它定义了属性和它的通知信号,被用在特定的公开给QML的API版本。

·        DESIGNABLE 属性指明在属性编辑的GUI设计工具是否可见。大多数属性是DESIGNABLE (默认true),取代true或false,你可以指定一个布尔成员函数。

·        SCRIPTABLE 属性指示脚本引擎是否可以访问该属性(默认true)。取代true或false,你可以指定一个布尔成员函数。

·        STORED 属性指示属性是否应该认为是自身有的还是依赖于其他值的,也指明了当存储对象的状态是必须保存属性值。大部分的属性是STORED (默认true),但是QWidget::minimumWidth() 的STORED 是false,因为它的值是从属性 QWidget::minimumSize(), 取得的。

USER属性指示属性是否认定为面向用户或用户可用编辑的。通常,每个类只有一个USER属性,如对于按钮 QAbstractButton::checked是用户可编辑的属性。注意: QItemDelegate 获取和设置widget 的 USER 属性。

·        CONSTANT 属性指明属性值是常量。对于给定的对象实例,READ 函数每次调用返回的值是一样的。不同的对象实例的常量值可能不一样,常量属性不能有 WRITE 函数 NOTIFY 信号。

FINAL属性指明.属性不能被子类重写。在某些情况下可以用于性能优化,但是moc并不强制进行。小心不能重写FINAL 属性。

READWRITE, 和 RESET 函数可以被继承,也可以是虚函数。如果是在多继承的类,它们必须是来自第一个被继承的类。

属性类型是QVariant支持的任意类型,也可以是用户自定义类型。在这个例子中,QDate类被当成是自定义类型。

Q_PROPERTY(QDate date READ getDate WRITE setDate)

由于QDate是用户自定义的,在声明属性时必须包含头文件<QDate>。

对于 QMapQList,和QValueList属性,属性的值是一个包含整个list或map的QVariant。注意:Q_PROPERTY 字符串不能包含逗号,因为逗号分割了宏参数。因此,你必须用Qmap替代 QMap<QString,QVariant>做属性类型。一致的,用 QList 和QvalueList取代QList<QVariant> 和 QValueList<QVariant>.。

Reading and WritingProperties with the Meta-Object System

可以用同用的函数 QObject::property()和QObject::setProperty(),来读写属性。除了属性的名称以为不用知道类的其他信息。下面的代码段,调用QAbstractButton::setDown() 和QObject::setProperty()都是设置"down"属性。

QPushButton*button =new QPushButton;
QObject*object = button;
 
button->setDown(true);
object->setProperty("down",true);

用 WRITE函数访问属性是最好的,因为.它更快而且编译时更好判断,但是用这种方法设置属性你需要知道运行时中的类。通过属性名称访问属性使你可以访问在运行时不知道的类。你可以通过查询 它的 QObjectQMetaObject, 和 QMetaProperties.获取类在运行时的属性。

QObject*object =...
const QMetaObject *metaobject = object->metaObject();
int count = metaobject->propertyCount();
for (int i=0; i<count; ++i) {
    QMetaProperty metaproperty = metaobject->property(i);
    const char *name = metaproperty.name();
    QVariant value = object->property(name);
    ...
}

在以上代码, QMetaObject::property() 用来获取位置类中定义的每个属性的元数据。从元数据中获取属性名并传给QObject::property() 以获得当前对象的该属性的值。

A Simple Example

假定我们有一个类MyClass ,它继承了 QObject 并在private段声明了 Q_OBJECT 宏。我们想在MyClass中声明一个属性来跟着一个优先级值。属性名为priority,它的类型为在 MyClass 定义的枚举Priority,类型。

我们用Q_PROPERTY()宏在private段声明该属性, READ函数为 priorityWRITE 函数为 setPriority. 。枚举类型必须用 Q_ENUMS()宏进行注册。注册一个枚举类型使得枚举类型名对于 QObject::setProperty().调用是有效的。我们必须为 READ and WRITE函数提供自己的声明。MyClass 的声明可能如下:

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(Priority priority READ priority WRITE setPriority NOTIFY priorityChanged)
    Q_ENUMS(Priority)
 
public:
    MyClass(QObject *parent =0);
    ~MyClass();
 
    enum Priority { High, Low, VeryHigh, VeryLow };
 
    void setPriority(Priority priority)
    {
        m_priority = priority;
        emit priorityChanged(priority);
    }
    Priority priority() const
    { return m_priority; }
 
signals:
    void priorityChanged(Priority);
 
private:
    Priority m_priority;
};

READ 函数是const并且返回属性的类型,WRITE 返回void并带有属性类型的一个参数。元对象编译器执行这些要求。

给定一个指向MyClass 对象的指针或者一个指向MyClass 实例的QObject 指针,我们有两种方法设置它的属性:

MyClass *myinstance =new MyClass;
QObject*object = myinstance;
 
myinstance->setPriority(MyClass::VeryHigh);
object->setProperty("priority","VeryHigh");

在例子中,在MyClass 中定义并用 Q_ENUMS()注册的枚举类型是属性的类型,这使得枚举值在 setProperty()调用中是有效的字符串。如果枚举类型在另外的类中声明,则需要它的完全限定名,而且那个类必须继承 QObject和用 Q_ENUMS() 宏注册枚举类型。

一个类似的宏, Q_FLAGS(),。跟Q_ENUMS(),宏一样,它注册一个枚举类型,但是它标记类型为一组标记,值可以用OR操作。一个IO类可能有Read 和 Write枚举值, QObject::setProperty() 可以接收 Read | Write.。应该用 Q_FLAGS() 注册该枚举值。

Dynamic Properties

QObject::setProperty() 也可以用来为运行时的类实例添加新的属性。当用一个name 和value调用该函数,如果给定的name属性存在于QObject,中而且给定的value值与属性的类型兼容,则value被存储到属性中并返回true。如果value和属性的类型不兼容,属性的值不变并返回false。但是如果给定的name属性不存在于QObject中,则新的属性name和值value被自动添加到QObject,但是依旧返回false。这意味着返回false不能用来确定特定的属性是否被设置,除非你事先知道属性存在于QObject

注意:dynamic 属性被添加到每个实例的根,它们被添加到 QObject而不是QMetaObject.。通过该QObject::setProperty()传一个属性名和非法的QVariant值可以掉一个实例属性。 QVariant的默认构造函数构造一个非法的值。

Q_PROPERTY()声明的属性一样,Dynamic 属性可以用 QObject::property(),进行查询。

Properties and CustomTypes

属性类型是自定义类型的需要用Q_DECLARE_METATYPE()宏注册以使自定义类型的值可以存储在一个 QVariant对象中。这使得它们适合用于Q_PROPERTY()宏声明的静态属性和运行时创建的属性。

Adding AdditionalInformation to a Class

Q_CLASSINFO()是连接到属性系统的额外的宏,它可以添加额外的name--value 信息到类的元数据,如:

Q_CLASSINFO("Version","3.0.0")

和其他元数据一样,类信息也可以通过运行时的元数据对象获取。

http://blog.csdn.net/hai200501019/article/details/9204215

Qt属性系统的更多相关文章

  1. Qt属性系统(Qt Property System)

    Qt提供了巧妙的属性系统,它与某些编译器支持的属性系统相似.然而,作为平台和编译器无关的库,Qt不能够依赖于那些非标准的编译器特性,比如__property 或者 [property].Qt的解决方案 ...

  2. Qt 中的属性系统(Property System)

    21 人赞同了该文章 本节内容主要讲解我对 Qt 属性系统的理解.官方文档参考 The Property System. 如何理解"属性系统"这个概念? 一般我们说一个类有什么属性 ...

  3. Qt之属性系统

    简述 Qt提供一个类似于其它编译器供应商提供的复杂属性系统(Property System).然而,作为一个编译器和平台无关的库,Qt不能够依赖于那些非标准的编译器特性,比如:__property或者 ...

  4. QtCore是Qt的精髓(包括五大模块:元对象系统,属性系统,对象模型,对象树,信号槽)

    作者:小豆君的干货铺链接:https://www.zhihu.com/question/27040542/answer/218384474来源:知乎著作权归作者所有.商业转载请联系作者获得授权,非商业 ...

  5. 解析Qt元对象系统(四) 属性系统(确实比较方便)

    官方解释 我们在Qt源码中可以看到一个QObject的子类经常会用到一些Q_开头的宏,例如QMainWindow类开始部分代码是这样的: Q_PROPERTY(QSize iconSize READ ...

  6. Qt元对象和属性系统详解

    Qt 是一个用标准 C++ 编写的跨平台开发类库,它对标准 C++ 进行了扩展,引入了元对象系统.信号与槽.属性等特性,使应用程序的开发变得更高效. 本节将介绍 Qt 的这些核心特点,对于理解和编写高 ...

  7. Qt 属性

      Qt提供了一套和一些编译器提供商也提供的属性系统类似的完善的属性系统.然而,作为一个不依赖编译器和平台的库,Qt不能依赖像__property或者[property]那样的非标准编译器特征.我们的 ...

  8. 深度探索QT窗口系统(五篇)

    窗口作为界面编程中最重要的部分,没有窗口就没有界面,是窗口让我们摆脱了DOS时代,按钮是一个窗口,文本框是一个窗口,标签页是一个窗口,...一个窗口可以由多个窗口组成,每天我们都在与窗口打交道,当你打 ...

  9. 界面编程之QT窗口系统20180726

    /*******************************************************************************************/ 一.坐标系统 ...

随机推荐

  1. EF使用时异常:对一个或多个实体的验证失败。有关详细信息

    //最顶级异常中是不提示具体哪个字段验证失败,必须到详细异常类型中查看 try { //EF操作 } catch (System.Data.Entity.Validation.DbEntityVali ...

  2. javascripts小结

    1 NAN-isNaN():判断是否数值 2 数值转换 Number()-任何数据类型,parseInt(),parseFloat()-字符串 3数组转字符串 var a=["red&quo ...

  3. Setting property 'source' to 'org.eclipse.jst.jee.server [问题点数:40分]

    链接地址:http://bbs.csdn.net/topics/390131469 警告: [SetContextPropertiesRule]{Context} Setting property ' ...

  4. uml笔记

    把进度放在好了: 活动图与业务流程 对业务流程支持的主要图形就是活动图,活动图的主要目的在陈述活动与活动之间流程控制的转移.

  5. Spring AOP基于xml配置实例

    SpringAOP里的几个术语,什么切面,切点之类的,官方的说明太抽象.为了更好地理解记忆,这里几下我自己的通俗的理解. 切面:就是日记类,什么前置通知后置通知(这些都是所谓的Advice)的具体方法 ...

  6. Python网络编程——设备名和IPv4地址

    1.快速查看主机名和对应的IP地址小程序 import socket def print_machine_info(): # 定义print_machine_info()类 host_name = s ...

  7. MVC3 Razor @RenderSection

    Mvc3的Razor视图引擎还提供了@RenderSection @RenderSection在母版页中占个位,然后让使用此母版页的子页自己去呈现他们的Section. 在母版页_Layout.csh ...

  8. 数据切分——Mysql分区表的建立及性能分析

    Mysql的安装方法可以参考: http://blog.csdn.net/jhq0113/article/details/43812895 Mysql分区表的介绍可以参考: http://blog.c ...

  9. Java学习之开篇—个人随想

    现在大三上学期了,家里希望考研,不然觉得我这学校不好找工作,我自己觉得工作还是靠自己,学校就像给人第一眼感觉那样,虽然重要但也只会吸引HR多看两眼,真正留得住HR的还是要有拿的出手的技能. 当初凭着对 ...

  10. 数据结构——AVL平衡树

    1.是二叉搜索树(Binary Search Tree) 2.树和所有左右子树高度之差为-1,0,1 平衡因子(balance factor) =右子树高度-左子树高度 平衡化旋转: 1.从插入位置向 ...