<QtDeprecationMarkers> - Qt Deprecation Macros

マクロのドキュメント

QT_DEPRECATED_WARNINGS

Qt 5.13 以降、このマクロは効果を持ちません。Qt 5.12 以前では、このマクロが定義されている場合、Qt によって非推奨と宣言された API が使用されると、コンパイラは警告を生成します。

QT_DISABLE_DEPRECATED_UP_TO 、QT_NO_DEPRECATED_WARNINGS 、およびQT_WARN_DEPRECATED_UP_TOも参照してください 。

QT_DISABLE_DEPRECATED_UP_TO

このマクロをプロジェクトファイルに定義することで、指定したバージョンのQtまたはそれ以前のバージョンで非推奨となった関数を無効にすることができます。デフォルトのバージョン番号は5.0であり、これはQt 5.0またはそれ以前のバージョンで非推奨となった関数がビルドに含まれないことを意味します。

たとえば、Qt 6.3 へのアップグレード準備において、すべての非推奨警告を解消した後、QT_DISABLE_DEPRECATED_UP_TO=0x060300 を設定することで、もはや使用していない Qt API をビルドから除外できます。これにより、プロジェクトのビルド設定において、非推奨 API への新しい呼び出しを追加しようとする開発者は、そのことを即座に認識できるようになります。 また、自身用の Qt をビルドする場合、Qt のビルド設定にこの定義を含めることで、非推奨 API の実装部分までも除外され、バイナリのサイズを縮小できます。

「 QT_DEPRECATED_WARNINGS 」および「QT_WARN_DEPRECATED_UP_TO 」も参照してください 。

QT_NO_DEPRECATED_WARNINGS

このマクロを使用すると、非推奨のAPIを使用する際に通常は生成される非推奨警告を抑制することができます。

QT_DISABLE_DEPRECATED_UP_TO およびQT_WARN_DEPRECATED_UP_TOも参照してください 。

QT_WARN_DEPRECATED_UP_TO

このマクロをプロジェクトファイルに定義することで、指定したバージョンより新しいQtバージョンで導入された非推奨警告を無効にすることができます。

たとえば、Qt 6.10 へのアップグレードを準備する際、すべての非推奨警告に対処する準備が整っていない場合は、QT_WARN_DEPRECATED_UP_TO=0x060900 を設定することで、非推奨警告を 6.9 以前のバージョンに限定することができます。

「 QT_DISABLE_DEPRECATED_UP_TO 」および「QT_NO_DEPRECATED_WARNINGS 」も参照してください 。