blob: 2dd572533e3667a0d01533b30ae924ff9a59528c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\headerfile <QtDeprecationMarkers>
\inmodule QtCore
\title Qt Deprecation Macros
\brief The <QtDeprecationMarkers> header file contains deprecation helper macros.
The header file declares several macros for disabling deprecated Qt APIs
and enabling/disabling compiler warnings when they are used.
*/
/*!
\macro QT_DISABLE_DEPRECATED_BEFORE
\relates <QtDeprecationMarkers>
\deprecated [6.5] Use QT_DISABLE_DEPRECATED_UP_TO instead
\sa QT_DISABLE_DEPRECATED_UP_TO
*/
/*!
\macro QT_DISABLE_DEPRECATED_UP_TO
\relates <QtDeprecationMarkers>
This macro can be defined in the project file to disable functions
deprecated in a specified version of Qt or any earlier version. The default
version number is 5.0, meaning that functions deprecated in or before
Qt 5.0 will not be included.
For instance, when preparing to upgrade to Qt 6.3, after eliminating all
deprecation warnings, you can set \c{QT_DISABLE_DEPRECATED_UP_TO=0x060300}
to exclude from your builds the Qt APIs you no longer use. In your own
project's build configuration, this will ensure that anyone adding new calls
to the deprecated APIs will know about it right away. If you also build Qt
for yourself, including this define in your build configuration for Qt will
make your binaries smaller by leaving out even the implementation of the
deprecated APIs.
\sa QT_DEPRECATED_WARNINGS, QT_DISABLE_DEPRECATED_UP_TO
*/
/*!
\macro QT_DEPRECATED_WARNINGS
\relates <QtDeprecationMarkers>
Since Qt 5.13, this macro has no effect. In Qt 5.12 and before, if this macro
is defined, the compiler will generate warnings if any API declared as
deprecated by Qt is used.
\sa QT_DISABLE_DEPRECATED_UP_TO, QT_NO_DEPRECATED_WARNINGS
*/
/*!
\macro QT_NO_DEPRECATED_WARNINGS
\relates <QtDeprecationMarkers>
\since 5.13
This macro can be used to suppress deprecation warnings that would otherwise
be generated when using deprecated APIs.
\sa QT_DISABLE_DEPRECATED_UP_TO
*/
|