Q_OBJECTマクロは何をしますか？すべてのQtオブジェクトにこのマクロが必要なのはなぜですか？

Qtを使い始めたばかりですが、すべてのサンプルクラス定義Q_OBJECTの最初の行にマクロがあることに気付きました。このプリプロセッサマクロの目的は何ですか？

Qtドキュメントから：

メタオブジェクトコンパイラーmocは、QtのC ++拡張機能を処理するプログラムです。

mocツールはC ++ヘッダーファイルを読み取ります。Q_OBJECTマクロを含む1つ以上のクラス宣言が見つかると、それらのクラスのメタオブジェクトコードを含むC ++ソースファイルが生成されます。特に、シグナルとスロットのメカニズム、実行時の型情報、動的プロパティシステムにはメタオブジェクトコードが必要です。

これは単に、このクラスにgui要素があり、 'moc'を実行する必要があることをプリコンパイラに通知するだけです。これは、シグナル/スロットメカニズムを使用するクラスに追加するだけです。
しかし、他のクラスでは静かに無視されます-ビルド時間を増やすだけです。

MOC（メタオブジェクトコンパイラ）は、Q_OBJECTマクロを含むヘッダーファイルをC ++の同等のソースコードに変換します。それは基本的にシグナルスロットメカニズムを制御し、C ++コンパイラに理解可能にします

1 メタオブジェクトシステムの Qtドキュメントから

mocツールはC ++ソースファイルを読み取ります。Q_OBJECTマクロを含む1つ以上のクラス宣言が見つかると、それらのクラスのそれぞれのメタオブジェクトコードを含む別のC ++ソースファイルが作成されます。この生成されたソースファイルは、クラスのソースファイルに#includeされるか、通常はコンパイルされてクラスの実装にリンクされます。

2 QtドキュメントのTHE Q_OBJECTから

Q_OBJECTマクロは、独自のシグナルとスロットを宣言する、またはQtのメタオブジェクトシステムによって提供される他のサービスを使用するクラス定義のプライベートセクションに表示する必要があります。

3 mocの Qtドキュメントから

mocツールはC ++ヘッダーファイルを読み取ります。Q_OBJECTマクロを含む1つ以上のクラス宣言が見つかると、それらのクラスのメタオブジェクトコードを含むC ++ソースファイルが生成されます。特に、シグナルとスロットのメカニズム、実行時の型情報、動的プロパティシステムにはメタオブジェクトコードが必要です。

4 信号とスロットの Qtドキュメントから

Q_OBJECTマクロは、mocによって実装されるいくつかのメンバー関数を宣言するためにプリプロセッサーによって展開されます。「LcdNumberのvtableへの未定義の参照」の行に沿ってコンパイラエラーが発生した場合は、おそらくmocを実行するか、リンクコマンドにmoc出力を含めるのを忘れています。

gccでは、-E展開されたマクロを確認できます。これはQ_OBJECT、Linuxのgccに拡張されます。これはプラットフォームに依存している可能性があり、QTのバージョンによって異なる場合があることに注意してください。これはmocコンパイラーの単なるタグではないことがわかります。

# 11 "mainwindow.hh"
#pragma GCC diagnostic push
# 11 "mainwindow.hh"

# 11 "mainwindow.hh"
#pragma GCC diagnostic ignored "-Wsuggest-override"
# 11 "mainwindow.hh"
    static const QMetaObject staticMetaObject; virtual const QMetaObject *metaObject() const; virtual void *qt_metacast(const char *); virtual int qt_metacall(QMetaObject::Call, int, void **); static inline QString tr(const char *s, cons
t char *c = nullptr, int n = -1) { return staticMetaObject.tr(s, c, n); } __attribute__ ((__deprecated__)) static inline QString trUtf8(const char *s, const char *c = nullptr, int n = -1) { return staticMetaObject.tr(s, c, n); } private:
# 11 "mainwindow.hh"
#pragma GCC diagnostic ignored "-Wattributes"
# 11 "mainwindow.hh"
    __attribute__((visibility("hidden"))) static void qt_static_metacall(QObject *, QMetaObject::Call, int, void **);
# 11 "mainwindow.hh"
#pragma GCC diagnostic pop
# 11 "mainwindow.hh"
    struct QPrivateSignal {};

Q_OBJECTマクロは、独自のシグナルとスロットを宣言する、またはQtのメタオブジェクトシステムによって提供される他のサービスを使用するクラス定義のプライベートセクションに表示する必要があります。