1 _ZTS7QObject

 

一、Q_D的在文件中的提法

　　Q_D的设置意在方便地获取私有类指针，文件为qglobal.h。下面的##是宏定义的连字符。假设类名是A，那么A##Private翻译过来就是APrivate。

1 #define Q_D(Class) Class##Private * const d = d_func()

　　d_func()函数如下实现：

1 #define Q_DECLARE_PRIVATE(Class) \
2     inline Class##Private* d_func() { return reinterpret_cast<Class##Private *>(qGetPtrHelper(d_ptr)); } \
3     inline const Class##Private* d_func() const { return reinterpret_cast<const Class##Private *>(qGetPtrHelper(d_ptr)); } \
4     friend class Class##Private;

　　这里的d_func()虽然在宏里面，但是如果代入具体的类型，这里面就变成了以Class##Private的私有类指针为返回值，以func为函数名的函数。这里的qGetPtrHelper是

1 template <typename T> static inline T *qGetPtrHelper(T *ptr) { return ptr; }

　　这个模板函数里面里的T要套入某个具体的类。上面的那个Q_DECLARE_PRIVATE里面的就成了这个模板类的一个调用。这个模板类就是把这个类指针转换成了静态的。有了上面的这三段代码，如果想在某个类A里面声明一个私有类，直接来一个Q_D(A),再Q_DECLARE_PRIVATE(A)就可以了。

二、宏和模板的展开

　　展开前一个宏和后一个宏的一部分，成了

1 #define Q_D(A) APrivate *const d= d_func()

1 inline APrivate* d_func() { return reinterpret_cast<APrivate *>(qGetPtrHelper((d_ptr));}

　　上面这个函数qGetPtrHelper调用的输入值是QObject类里面的一个成员变量，d_ptr指针，定义如下：

1     QScopedPointer<QObjectData> d_ptr;

 　　根据模板函数调用返回的仍然是一个QScopedPointer<QObjectData>类型的变量，也就是一个指向QObjectData类型的智能限域指针。最后调用reinterpret_cast重新解释前面得到的指针，把它变成指向APrivate类型的。

　　这里的QObjectData的定义也在QObject里面

 1 class Q_CORE_EXPORT QObjectData {
 2 public:
 3     virtual ~QObjectData() = 0;
 4     QObject *q_ptr;
 5     QObject *parent;
 6     QObjectList children;
 7 
 8     uint isWidget : 1;
 9     uint blockSig : 1;
10     uint wasDeleted : 1;
11     uint isDeletingChildren : 1;
12     uint sendChildEvents : 1;
13     uint receiveChildEvents : 1;
14     uint isWindow : 1; //for QWindow
15     uint unused : 25;
16     int postedEvents;
17     QDynamicMetaObjectData *metaObject;
18     QMetaObject *dynamicMetaObject() const;
19 };

　　至于QScopedPointer，有点复杂，核心思想是一个不需要自己销毁的指针。

三、继承和调用

　　自己写一个类MyQFileSystemModel继承QFileSystemModel，在MyQFileSystemModel中使用Q_D宏，会出现错误：

 1 C:\Qt\Qt5.9.2\5.9.2\mingw53_32\include\QtWidgets/qfilesystemmodel.h: In constructor 'MyQFileSystemModel::MyQFileSystemModel()':
 2 C:\Qt\Qt5.9.2\5.9.2\mingw53_32\include/QtCore/qglobal.h:1002:28: error: 'QFileSystemModelPrivate* QFileSystemModel::d_func()' is private
 3      inline Class##Private* d_func() { return reinterpret_cast<Class##Private *>(qGetPtrHelper(d_ptr)); } \
 4                             ^
 5 C:\Qt\Qt5.9.2\5.9.2\mingw53_32\include\QtWidgets/qfilesystemmodel.h:152:5: note: in expansion of macro 'Q_DECLARE_PRIVATE'
 6      Q_DECLARE_PRIVATE(QFileSystemModel)
 7      ^
 8 C:\Qt\Qt5.9.2\5.9.2\mingw53_32\include/QtCore/qglobal.h:1016:54: error: within this context
 9  #define Q_D(Class) Class##Private * const d = d_func()
10                                                       ^
11 ..\student\myqfilesystemmodel.cpp:5:5: note: in expansion of macro 'Q_D'
12      Q_D(const QFileSystemModel);
13      ^
14 C:\Qt\Qt5.9.2\5.9.2\mingw53_32\include/QtCore/qglobal.h:1016:43: warning: unused variable 'd' [-Wunused-variable]
15  #define Q_D(Class) Class##Private * const d = d_func()
16                                            ^
17 ..\student\myqfilesystemmodel.cpp:5:5: note: in expansion of macro 'Q_D'

 　　意思是，d_func()是QFileSystemModel这个类里面的私有函数，对于c++的私有函数，子类是不能够继承的。

四、q指针

　　写一个MyQFileSystemModel的私有类MyQFileSystemModelPrivate，就可以使用Q_Q宏，从私有类引用对应的公有类了。

 1 #ifndef MYQFILESYSTEMMODEL_P_H
 2 #define MYQFILESYSTEMMODEL_P_H
 3 #include <myqfilesystemmodel.h>
 4 class MyQFileSystemModelPrivate;
 5 class MyQFileSystemModel;
 6 QT_BEGIN_NAMESPACE
 7 class MyQFileSystemModelPrivate: public QFileSystemModelPrivate
 8 {
 9 public:
10     //MyQFileSystemModelPrivate(MyQFileSystemModel * parent):q_ptr(parent){}
11 public:
12     Q_DECLARE_PUBLIC(MyQFileSystemModel)
13     MyQFileSystemModel *q_ptr;
14 };
15 QT_END_NAMESPACE
16 #endif // MYQFILESYSTEMMODEL_P_H

　　这里面需要尤其注意的是，MyQFileSystemModel *q_ptr;这一行是不能少的。c++的static_cast是对被转换的类型有限制的。如果B类继承了A类，那么从B类转换成A类是完全没有问题的。但是，如果想把A类转换成B类，就要求B类里面，问题就出现了，A类可能没有B类那么丰满，转换出来的类可能是残废的，所以一般情况下，这种转换是不能成功的。除非：B类里面包含了一个指向A类的指针。如果把q_ptr指针声明去掉了，会报这个错误：

1 C:\Qt\Qt5.9.2\5.9.2\mingw53_32\include\QtCore\qglobal.h:1012: error: invalid static_cast from type 'QObject*' to type 'MyQFileSystemModel*'
2      inline Class* q_func() { return static_cast<Class *>(q_ptr); } \
3                                                                ^

五、私有类函数调用

　　Qt中的公有类和私有类关系密切，私有类的函数是不能够直接使用的。要是想用，一定要通过其他类调用。在Qt编译的时候，QFileSystemModel.h是一堆声明，会导出很多函数到QtWidget.dll里面去。值得注意的是，这里导出的只是这个文件里所声明的类、函数和变量，而不会导出只在私有类头文件QFileSystemModel_p.h里面声明过的函数和变量。

　　当然，编译的时候，也会引用QFileSystemModelPrivate.h和QFileSystemModel.cpp里的声明以及定义。一般情况下，我们只是Qt的使用者，在windows系统下，只要下载安装就好，不需要自己再编译了。但是当我们想使用私有类做一些更深入的定制的时候，希望能够调直接调用私有类的成员。这时候，如果只是include了.h文件，就会报undefined reference错误。也就是说，编译能过，链接过不了，找不到私有类成员。

 　　解决的方法就是将对应的cpp文件也包含进工程目录里面，但这时候会有新的问题出现。有些类的实现已经编译到库函数里面了，这时候又在cpp文件重新实现，会报警告：redeclared without dllimport attribute。只需要把cpp文件中的实现函数删除掉就可以了。

　　虽然通过上面的方法，可以实现私有类的使用，但是值得注意的是，已经编译好的二进制文件dll里面的同名私有函数还在起着作用。还是用QFileSystemModel为例，它已经被Qt编译好放到了QWidget.dll里面了。在此dll文件里也会有QFileSystemModelPrivate的函数（只是不会有直接指向外部的声明，外部不能直接链接引用而已），否则私有类就完全没用了。当新的工程要使用到QFileSystemModel，而QFileSystemModelPrivate被间接地引用，使用的版本就是之前编译好的成品。当新的工程要直接调用私有类函数的时候，才是用的新的版本。

　　用Dependency打开Qt5Widgets.dll看到私有类的函数名形式如下：

1 _ZN16QFileSystemModelC1ER23QFileSystemModelPrivateP7QObject

　　这可能只是一个构造函数，在Qt5Widgets.dll里只有两个上面这种QFileSystemModelPrivate的函数，可见大多数私有类的函数没有导出。而直接用本节方法编译出来的QFileSystemModelPrivate.dll里面的私有成员函数形式如下：　　

1 _ZNK23QFileSystemModelPrivate4nodeERK11QModelIndex

　　代表形参是QModelIndex的私有类函数node，像这样的函数还有很多，它们与私有类的.h文件能够对应起来。