解读 Q_D， Q_Q 指针

     见 qglog.h文件定义：   

    #define Q_D(Class) Class##Private * const d = d_func()
    #define Q_Q(Class) Class * const q = q_func()

  d指针是在主类中使用的，来获取私有子类成员指针

  q指针是在私有数据类中使用的，来获取主类对象指针

D-指针 
   私有成员总是不可见的，Qt中私有成员不仅仅是简单封装一下，将访问权限改为private，它将所有私有数据封装在私有类里(命名就是 classname##private), 这样一来连用户都不知道他到底封装了什么，程序中只有这个私有类成员指针，这个指针就是D-指针。

从QObject开始看 

 

[c-sharp]  view plain  copy

 

1. class QObject  
2. {  
3.     Q_DECLARE_PRIVATE(QObject)  
4. public:  
5.     Q_INVOKABLE explicit QObject(QObject *parent=0);  
6. protected:  
7.     QObject(QObjectPrivate &dd, QObject *parent = 0);  
8.     QScopedPointer<QObjectData> d_ptr;  
9.     // others  
10. }  

 

 

 

 

展开后

 

[c-sharp]  view plain  copy

 

1. class QObject  
2. {  
3.         inline QObjectPrivate* d_func() { return reinterpret_cast(qGetPtrHelper(d_ptr)); }  
4.     inline const QObjectPrivate* d_func() const { return reinterpret_cast(qGetPtrHelper(d_ptr)); }  
5.     friend class QObjectPrivate;     
6. public:  
7.     Q_INVOKABLE explicit QObject(QObject *parent=0);  
8. protected:  
9.     QObject(QObjectPrivate &dd, QObject *parent = 0);  
10.     QScopedPointer<QObjectData> d_ptr;  
11.     // others  
12. }  

 

 

 

 

 

QObject的构造函数如下：   

 

[c-sharp]  view plain  copy

 

1. QObject::QObject(QObject *parent)   
2.     : d_ptr(new QObjectPrivate)  
3. {  
4.   // others  
5. }  
6. QObject::QObject(QObjectPrivate &dd, QObject *parent)  
7.     : d_ptr(&dd)  
8. {  
9.    // others  
10. }  

 

 

 

 

也就是QObjectData *d_ptr = new QObjectPrivate 

显然QObjectPrivate 继承了 QObjectData  ；

如下

 

[c-sharp]  view plain  copy

 

1. QObjectData {  
2. public:  
3.     virtual ~QObjectData() = 0;  
4.     // others  
5. };  

 

 

 

 

 

[c-sharp]  view plain  copy

 

1. class Q_CORE_EXPORT QObjectPrivate : public QObjectData  
2. {  
3.     Q_DECLARE_PUBLIC(QObject)  
4. public:  
5.     QObjectPrivate(int version = QObjectPrivateVersion);  
6.     virtual ~QObjectPrivate();  
7.     // others  
8. }  

 

 

 

 

看看QObject的一个方法

 

 

[c-sharp]  view plain  copy

 

1. QString QObject::objectName() const  
2. {  
3.     Q_D(const QObject);  
4.     return d->objectName;  
5. }  

 

 

 

展开后

 

[c-sharp]  view plain  copy

 

1. QString QObject::objectName() const  
2. {  
3.     QObjectPrivate * const d = d_func()    
4.     return d->objectName;  
5. }  

 

 

 

所以Qt 为我们把从 d_func() 获取 QObjectPrivate 指针的代码给封装起来了，之后就可以直接使用d->

 

 

 

QObject的第二个构造函数使用传入的 QObjectPrivate 对象，但它是 protected 的，也就是说，你不能在外部类中使用这个构造函数。那么这个构造函数有什么用呢？我们来看一下 QWidget 的代码：

 

[c-sharp]  view plain  copy

 

1. class QWidget : public QObject, public QPaintDevice  
2. {  
3.     Q_OBJECT  
4.     Q_DECLARE_PRIVATE(QWidget)  
5.     // others  
6. }  

 

 

 

 

QWidget 是 QObject 的子类，然后看它的构造函数：

 

[c-sharp]  view plain  copy

 

1. QWidget::QWidget(QWidgetPrivate &dd, QWidget* parent, Qt::WindowFlags f)  
2.     : QObject(dd, 0), QPaintDevice()  
3. {  
4.     Q_D(QWidget);  
5.     QT_TRY {  
6.         d->init(parent, f);  
7.     } QT_CATCH(...) {  
8.         QWidgetExceptionCleaner::cleanup(this, d_func());  
9.         QT_RETHROW;  
10.     }  
11. }  

 

 

 

 

 

显然了QWidgetPrivate 继承了QObjectPrivate

于是我们已经明白，为什么 QWidget 中找不到 d_ptr 了，因为所有的 d_ptr 都已经在父类 QObject 中定义好了！尝试展开一下 Q_DECLARE_PRIVATE 宏，你就能够发现，它实际上把父类的 QObjectPrivate 指针偷偷地转换成了 QWidgetPrivate 的指针。

 

因此有如下结论： 

1、在基类中定义一个protected权限的基类私有类d_ptr指针；

2、在每个派生类中用本类私有类初始化d_ptr（该私有类需要继承基类私有类），并定义d_func()，获取基类d_ptr，这个d_func()是由     Q_DECLARE_PRIVATE展开得来的 ，并将其转换为当前私有类指针；

3、在函数中使用Q_D，这样就可以使用d了；
4、在私有数据继承体系中，不要忘记将析构函数定义为虚函数，基类析构函数中释放d_ptr，以防内存泄露！！！

============================================================

Q-指针 
   q指针是在私有数据类中使用的，来获取主类指针。 

[cpp]  view plain  copy

 

1. class Q_CORE_EXPORT QObjectPrivate : public QObjectData  
2. {  
3.     Q_DECLARE_PUBLIC(QObject)  
4.   public:  
5.    //others...     
6.     };  

展开后：

[cpp]  view plain  copy

 

1. class Q_CORE_EXPORT QObjectPrivate : public QObjectData  
2. {  
3.     inline QObject* q_func() { return static_cast<QObject *>(q_ptr); } /   
4.     inline const QObject* q_func() const { return static_cast<const QObject *>(q_ptr); } /   
5.     friend class QObject;   
6.    //others  
7. }  

  QObjectData定义如下：

[cpp]  view plain  copy

 

1. QObjectData {  
2.      public:      
3.     QObject *q_ptr;  
4.     //others      
5. }  
6. #define Q_Q(QObject) QObject * const q = q_func()   

三、使用的例子：

     在使用调色板中

[cpp]  view plain  copy

 

1. 1. void QWidget::setPalette(const QPalette &palette)  
   2. {  
   3.     Q_D(QWidget); //得到私有成员 QWidgetPrivate指针 d  
   4.     setAttribute(Qt::WA_SetPalette, palette.resolve() != 0);     
   5.     QPalette naturalPalette = d->naturalWidgetPalette(d->inheritedPaletteResolveMask);  
   6.     QPalette resolvedPalette = palette.resolve(naturalPalette);  
   7.     d->setPalette_helper(resolvedPalette); //调用QWidgetPrivate::setPalette_helper()  
   8. }  
   9. void QWidgetPrivate::setPalette_helper(const QPalette &palette)  
   10. {  
   11.     Q_Q(QWidget);  
   12.     if (data.pal == palette && data.pal.resolve() == palette.resolve())  
   13.         return;  
   14.     data.pal = palette;  
   15.     updateSystemBackground();  
   16.     propagatePaletteChange();  
   17.     updateIsOpaque();  
   18.     q->update();  //调用QWidget::update()  
   19.     updateIsOpaque();  
   20. }