Qt/Qt Quick宏浅议

请尊重原创作品和译文。转载请保持文章完整性，并以超链接形式注明原始作者地址http://blog.csdn.net/changsheng230，方便其他朋友提问和指正。

刚开始接触Qt的朋友可能对Qt在使用当中需要声明的各色各样的宏感到神秘而又陌生，本文将介绍Qt中经常使用的几个宏： Q_OBJECT, SIGNAL与SLOT, Q_SIGNALS 与 Q_SLOTS, Q_EMIT ,Q_INVOKABLE, Q_PROPERTY：

宏的头文件出处：$QTDIR/src/corelib/kernel/qobjectdefs.h

Q_OBJECT

#define Q_OBJECT / 
public: / 
  Q_OBJECT_CHECK / 
  static const QMetaObject staticMetaObject; / 
  Q_OBJECT_GETSTATICMETAOBJECT / 
  virtual const QMetaObject *metaObject() const; / 
  virtual void *qt_metacast(const char *); / 
  QT_TR_FUNCTIONS / 
  virtual int qt_metacall(QMetaObject::Call, int, void **); /

宏 Q_OBJECT 是 Qt 所有宏中最为重要的一个，Q_OBJECT是使用信号槽机制以及其他所有元对象系统提供的服务（内省、invokeMethod，元对象property系统等等）的前提条件。有关 Q_OBJECT 的讨论请参考Qt源码分析之QObject。

SIGNAL与SLOT

这两个宏是调用connect方法时用到:

QObject::connect(myButton, SIGNAL(clicked()),label,  SLOT(showText())); 

那么宏SIGNAL和SLOT为我们做了那些事情呢，看一下源代码：

//$QTDIR/src/corelib/kernel/qobjectdefs.h
# define SLOT(a)     qFlagLocation("1"#a QLOCATION) 
# define SIGNAL(a)   qFlagLocation("2"#a QLOCATION) 
//$QTDIR/src/corelib/kernel/qobject.cpp 
const char *qFlagLocation(const char *method)  {     
    static int idx = 0;    
    flagged_locations[idx] = method;     
    idx = (idx+1) % flagged_locations_count;    
    return method;  
} 

原来它会基于把我们定义的信号、槽的名称返回一个字符串，比如 SIGNAL(clicked()) 返回字符串 “2clicked()”, SLOT(showText()) 返回字符串 “1showText()”

Q_SIGNALS 与 Q_SLOTS

# define slots  
# define signals protected  
# define Q_SLOTS 
# define Q_SIGNALS protected

Q_SIGNALS 与 Q_SLOTS是Qt 4.1引入的，它们用来替换关键字 signals 和 slots，原因是更好的与第三方信号槽机制兼容，比如 boos t库。尽管 Q_SIGNALS 与 Q_SLOTS 看起来没有做什么。其实不然，QT的元对象编译器 moc 会识别声明在头文件中的宏 Q_SIGNALS，Q_SLOTS。并做为依据，生成元对象模型数据，详见文中最后所示代码实例

Q_EMIT

#define Q_EMIT
#define emit

Q_EMIT 用来替换关键字 emit,原因也是更好的与第三方信号槽机制兼容，比如boost库。

这里要注意，我们看到Q_EMIT看起来同样的简单， 但它们是有区别的！表面的区别在于 Q_SIGNALS 与 Q_SLOTS 用在头文件中，而 Q_EMIT 用在代码视线中。 本质的区别的在于，Q_SIGNALS 与 Q_SLOTS将被moc识别，是必须使用的。而Q_EMIT或者emit是可有可无的。它不会被moc识别，它存在的唯一理由是：增加代码的可读性。 也就是说如下代码都能正常工作，但2）的写法也许会惹怒你的同事。

void method() 
{  
	1） emit signalA();    
    2） signalA();  
} 

Q_INVOKABLE

#define Q_INVOKABLE

使用Q_INVOKABLE来修饰成员函数，目的在于被修饰的成员函数能够被元对象系统所唤起。这一机制在Qt C++/QML混合编程，Qt service framework, 以及Qt/ HTML5混合编程里广泛使用。我会随后另撰写一文做深入探讨 。

Q_PROPERTY

#define Q_PROPERTY(text)  

使用Q_PROPERTY用以声明属性，属性类似于成员变量，但它能够被元对象系统所访问。QML的属性便是利用该机制得以实现的。 Q_PROPERTY的用法如下：

Q_PROPERTY(QString title READ title WRITE setTitle USER true)

接下来，让我们结合代码来看一下上述宏的使用以及元对象编译器是如何利用这些宏的。

#include <QDeclarativeItem > 
class EllipseItem : public QDeclarativeItem  {   
    Q_OBJECT   
    Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged) 
public:   
    EllipseItem(QDeclarativeItem *parent = 0);    
    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,  QWidget *widget = 0);   
    const QColor &color() const;     
    void setColor(const QColor &newColor);  
    Q_INVOKABLE QColor randomColor() const;
public Q_SLOTS:    
    void try1();    
    void try2() {} 
Q_SIGNALS:    
    void colorChanged();   
    void ready();
private:    
    QColor m_color;  
}; 

以下代码由元对象编译器moc根据上述头文件自动生成：

static const uint qt_meta_data_EllipseItem[] = {
 // content:
       7,       // revision
       0,       // classname
       0,    0, // classinfo
       5,   14, // methods
       1,   44, // properties
       0,    0, // enums/sets
       0,    0, // constructors
       0,       // flags
       2,       // signalCount

 // signals: name, argc, parameters, tag, flags
       1,    0,   39,    2, 0x06 /* Public */,
       3,    0,   40,    2, 0x06 /* Public */,

 // slots: name, argc, parameters, tag, flags
       4,    0,   41,    2, 0x0a /* Public */,
       5,    0,   42,    2, 0x0a /* Public */,

 // methods: name, argc, parameters, tag, flags
       6,    0,   43,    2, 0x02 /* Public */,

 // signals: parameters
    QMetaType::Void,
    QMetaType::Void,

 // slots: parameters
    QMetaType::Void,
    QMetaType::Void,

 // methods: parameters
    QMetaType::QColor,

 // properties: name, type, flags
       7, QMetaType::QColor, 0x00495103,

 // properties: notify_signal_id
       0,

       0        // eod
};

从上面代码实例我们可以看到， QT的元对象编译器moc会识别声明在头文件中的宏Q_SIGNALS，Q_SLOTS, Q_PROPERTY, Q_PROPERTY。并以此做为依据，生成了元对象数据表。在这张元对象数据表中，我们已可以看到，moc根据头文件所声明的宏定义，识别出:

• 两个信号：colorChanged(), ready(); (Q_SIGNALS）
• 两个槽: try1(), try2() (Q_SLOTS)
• 五个方法，其中被标记为Q_INVOKABLE的方法randomColor()被记录在元对象字符串数组qt_meta_stringdata_EllipseItem中。
• 一个属性：color (Q_PROPERTY)