Qt 的 Pimpl 习惯用法

Question

我正在尝试使用 Qt 5.6.0 构建一个共享库，我想使用 Pimpl。

我有一个 class 要导出，这个 class 继承自 QGraphicsScene，它本身继承自 QObject：

// CustomScene.h
#include "customscene_global.h" // recommended header from Qt
#include <QGraphicsScene> // do not compile if not present 

// forward declarations
class CustomSceneImpl;
template <typename T> class QList;
class QString;
template <class Key, class T> class QMap;
// some other classes ...

class CustomScene : public QGraphicsScene
{
  Q_OBJECT

  public :
  // some public functions

  signals:
  // some custom signals

  public slots:
  // some custom public slots

  private:
    CustomSceneImpl *m_pimpl; // pointer to private members

};

如果我 #include <QGraphicsScene> 在此 header 中，一切都很好，但我更愿意转发声明 QGraphicsScene。但是，如果我这样做，我会收到以下编译错误：

error: invalid use of incomplete type 'struct QGraphicsScene'

我想我在使用 QObject 宏和一般的 moc 时做错了，无法识别。

我知道有专门的 Qt 宏来使用 Pimpl (Q_D, ..)，但我真的不明白如何使用它们以及它是否能解决这个问题。

感谢您的帮助。

Answer 1

Everything's is fine if i #include QGraphicsScene in this header but i would prefer to forward declare QGraphicsScene.

你不能这样做，因为你继承自 QGraphicsScene:

class CustomScene : public QGraphicsScene

顺便说一句。这个错误与你实现 PIMPL 习语的方式无关（实际上它看起来不错），从不完整类型继承是不可能的，因为编译器需要知道你的基础的大小/布局 class.

Answer 2

由于前向声明 class 没有关于内容的信息，您不能将其用于继承。

Answer 3

您可以将 PIMPL 习语用于组合，而不是用于继承。如果需要继承自QGraphicsScene，则不能转发声明。您必须包含其完整定义。

Qt 的 Pimpl 习惯用法

Pimpl idiom with Qt

c++

qt

pimpl-idiom