Qt——元对象和属性机制

一、元对象

元对象(meta object)意思是描述另一个对象结构的对象,比如获得一个对象有多少成员函数,有哪些属性。在Qt中,我们将要用到的是QMetaObject这个类。

元对象系统基于以下3点:

  • 以QObject作为基类
  • 类声明的私有区域中,Q_Object宏指令使我们能够使用元对象的特性,比如动态属性、信号、槽等
  • 元对象编译器(Meta-Object Compiler  moc)为QObject子类生成具有元对象特性的代码

我们可以通过QObject类的一个成员函数获得该类的元对象:

 QMetaObject *QObject::metaObject() const  

通过这个元对象,进而可以获取一个QObject对象的更多信息:

 QMetaObject::className() 返回运行时类的名称(不需要C++中的运行时类型识别机制RTTI)

 QMetaObject::methodCount() 返回类中方法的个数

以上只是元对象的简单介绍,记住元对象系统的3点特性。之所以要介绍元对象,因为Qt中很多用法是基于元对象的,如果不支持元对象,比如没有继承自QObject,那么很多东西将无法使用,下面对此作进一步介绍。

 

二、类型识别

众所周知,C++中使用dynamic_cast和typeid这两个运算符进行运行时类型识别(RTII),但是Qt提供另外两种运行时类型识别方法:

 qobject_cast 和 QObject::inherits() 

看名字就可以知道,这两个方法都是基于QObject的,也就是元对象系统。

if (QLabel *label = qobject_cast<QLabel *>(obj))
{
	label->setText(tr("Ping"));
}
else if (QPushButton *button = qobject_cast<QPushButton *>(obj))
{
	button->setText(tr("Pong!"));
}

据说,qobject_cast的速度比dynamic_cast的速度快很多。

QObject::inherits(const char *className)的速度相对慢一些,所以尽可能使用qobject_cast。

 

三、Qt中的属性

1.自定义属性

我们可能已经接触到很多Qt中的属性了,比如qreal类型的opacity属性表示“透明度”,QRect类型的geometry表示“几何位置和大小”,QPoint类型的pos属性代表“位置”。

所谓属性,也就是类中的一个数据成员,我们可以获取(get)和设置(set)。

除了Qt中一些类已经具备的属性,我们还可以自定义属性,也就是定义一种访问数据成员的方式。

在一个继承自QObject的类中使用 Q_PROPERTY 宏指令,比如:

Q_PROPERTY(bool focus READ hasFocus)
Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
Q_PROPERTY(QColor color MEMBER m_color NOTIFY colorChanged)

不要被这个用法搞晕了,其实很简单,刚开始指定属性类型和名称,然后READ表示获取属性值的方法,一般这两点是必须的。其他都是可选的,比如WRITE表示设置属性值得方法,MEMBER表示这个属性在类中数据成员的名称,NOTIFY表示属性改变发出的信号。

2.属性的类型

由上可知,属性的类型可以是bool、QString、QRect等等,我们可以通过 QVariant::Type 的枚举值获得所有可用于属性的类型。

可以查到,它不支持枚举类型,但可以通过 Q_ENUM 来设置:

enum Priority { High, Low, VeryHigh, VeryLow };
Q_ENUM(Priority)

Q_PROPERTY(Priority priority READ priority WRITE setPriority NOTIFY priorityChanged)

当然,自定义的类型也是不支持的,需要通过 Q_DECLARE_METATYPE 注册元类型:

struct MyStruct
{
	int i;
	...
};
Q_DECLARE_METATYPE(MyStruct)

3.属性的读与写

我们可以直接使用get和set方法来读写属性,也可以通过QObject与QMetaObject来间接地读写属性。

首先是设置属性值

比如类QAbstractButton有一个“down”的属性,表示按钮是否被按下,它有一个成员函数 QAbstractButton::setDown() 来改变属性值,同时,我们也可以通过 QObject::setProperty() 对其进行设置:

QPushButton *button = new QPushButton;
QObject *object = button;

button->setDown(true);
object->setProperty("down", true);

值得注意的是,setProperty()这个函数不但可以改变属性值,也可以在运行时动态地为对象添加属性。

接下来是读取属性值

如果有get函数,可以直接调用它,当然也可以通过 QObject::property() 来获取属性,它的返回值是 QVariant 类型的,通过 canConvert() 进行判断,然后将其转换为所需的类型。

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);
	...
}

 

四、自定义属性有什么用

也许你要问,说了这么多废话,不就是读写成员变量吗?好吧,平时确实不会用太多,但是如果做插件开发、qml等,就会经常用到了。不过,在通常的界面开发中,属性也是有用处的,下面举两个例子。

1.改变样式

样式表设置中有一个属性选择器,比如 QPushButton[flat="false"] 意思是当按钮属性flat为false时的样式。

举个栗子,我们有个QWidget类,名字叫PropertyTest,界面中有一个按钮叫pushButton

#pushButton{border:4px solid blue;}
PropertyTest[borderColor="red"] #pushButton{border:4px solid red;}
PropertyTest[borderColor="green"] #pushButton{border:4px solid green;}
PropertyTest[borderColor="blue"] #pushButton{border:4px solid blue;}

按钮默认样式是blue蓝色,通过改变类PropertyTest的属性borderColor值改变按钮的颜色。

在代码中,首先定义属性

Q_PROPERTY(QString borderColor READ getBorderColor WRITE setBorderColor)

使用一个成员变量保存属性的值,并通过set和get函数分别设置和获得该值。

private:
    QString m_strBorderColor;
private:
	void setBorderColor(const QString &strBorderColor){ m_strBorderColor = strBorderColor; }
	QString getBorderColor(){ return m_strBorderColor; }

单击按钮pushButton改变属性值,从而改变按钮pushButton的样式。

void PropertyTest::changeBorderColor()
{
	if (m_iTest % 3 == 0)
	{
		setBorderColor("red");
	}
	else if (m_iTest % 3 == 1)
	{
		setBorderColor("green");
	}
	else
	{
		setBorderColor("blue");
	}
	style()->unpolish(ui.pushButton_3);
	style()->polish(ui.pushButton_3);
	update();
	m_iTest++;
}

最后要注意的是,上面代码中的unpolish和polish部分。

在Qt文档中有个提醒,在使用属性选择器时,如果之前控件有其它样式,那么需要重写设置一下,“旧的不去,新的不来”,通过unpolish和polish抹去旧的样式,涂上新的样式。

2.动画中使用自定义属性

如果我们想通过动画使一个按钮逐渐变透明,思路会是这样:按钮QPushButton继承自QWidget,在QWidget中有个函数setWindowOpacity,所以只需使用动画类QPropertyAnimation,属性那个参数设置为windowOpacity。

然而,实际中,按钮透明度不会有任何改变,继续查看文档才知道——只有调用setWindowFlags函数,将窗口属性设置为Qt::Window,windowOpacity这个属性才能生效。但是这样做pushbutton就不是正常的widget了。

因此,有必要寻求其它方法,在QWidget中有一个函数setGraphicsEffect(QGraphicsEffect *),其中QGraphicsEffect有一个派生类QGraphicsOpacityEffect,可以通过它来设置QWidget的透明度。

m_pOpacityEffect = new QGraphicsOpacityEffect(this);
m_pOpacityEffect->setOpacity(1);
this->setGraphicsEffect(m_pOpacityEffect);
Q_PROPERTY(qreal buttonOpacity READ buttonOpacity WRITE setBtnOpacity)

上面的写法可能不太好,因为qreal精度与机器有关,最好用double或float。

定义属性时,在函数setBtnOpacity中改变QGraphicsOpacityEffect对象,来调整透明度。

好了,现在我们将动画属性名称设置为buttonOpacity—— QPropertyAnimation::setPropertyName("buttonOpacity") ,就能通过动画改变按钮的透明度了。

 

五、invokeMethod()

Qt中的信号槽机制是以元对象为基础的,通过名称以类型安全的方式来间接调用槽函数。

当调用槽函数时,实际是由invokeMethod()完成的。

比如显示一个窗口,一般是通过show()函数来完成,不过我们还能这样做:

MyWidget w;
QMetaObject::invokeMethod(&w, "show");

上面讲了如何将成员变量注册进元对象系统,那么对于成员函数,该怎么做呢?

在声明一个类的成员函数时,通过使用 Q_INVOKABLE 宏进行注册,可以使它们能够被元对象系统调用。

class Window : public QWidget
{
    Q_OBJECT
public:
    Window();
    void normalMethod();
    Q_INVOKABLE void invokableMethod();
};

  

that'a all.

有错误的地方还请指正!

posted @ 2016-06-13 23:58  去冰三分糖  阅读(14103)  评论(5编辑  收藏  举报