多读书多实践,勤思考善领悟

qt 宏

本文于1069天之前发表,文中内容可能已经过时。

宏的知识

1
2
3
4
5
6
7
8
9
10
11
12
13
#define <宏名> (<参数表>) <宏体>
#undef <宏名>

#ifdef <宏名>
...
#else
...
#endif

//define中的三个特殊符号:#,##,#@
#define STRCAT(x,y) x##y //连接x和y成一个字符串
#define TOCHAR(x) #@x //给x加上单引号
#define TOSTR(x) #x //给x加上双引号

宏是C/C++系列语言的一大特色,它将一个标识符定义为一个字符串,在预处理阶段源程序中的该标识符均以指定的字符串来代替,使用宏可以使代码更加简洁和增强可读性。

Qt中的宏

操作系统宏、处理器相关宏、编译器宏

1
2
3
4
5
6
7
#define Q_OS_X // 例如 Q_OS_WIN

#deinfe Q_PROCESSOR_X // 例如 Q_PROCESSOR_X86_32
#define Q_BYTE_ORDER Q_LITTLE_ENDIAN // 字节序:小端模式
#define Q_PROCESSOR_WORDSIZE 4

#define Q_CC_X // 例如 Q_CC_MINGW

动态库宏

1
2
3
4
#ifdef Q_OS_WIN
#define Q_DECL_EXPORT __declspec(dllexport)
#define Q_DECL_IMPORT __declspec(dllimport)
#endif

命名空间宏

1
2
3
#define QT_USE_NAMESPACE using namespace ::QT_NAMESPACE;
#define QT_BEGIN_NAMESPACE namespace QT_NAMESPACE {
#define QT_END_NAMESPACE }

Qt注释宏(注释类、函数、访问限制符)

1
2
3
#define QT_ANNOTATE_CLASS(type, ...)
#define QT_ANNOTATE_FUNCTION(x)
#define QT_ANNOTATE_ACCESS_SPECIFIER(x)

Qt信号与槽机制相关宏

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
#define slots Q_SLOTS
#define signals Q_SIGNALS
#define emit

#define Q_SLOTS QT_ANNOTATE_ACCESS_SPECIFIER(qt_slot)
#define Q_SIGNALS public QT_ANNOTATE_ACCESS_SPECIFIER(qt_signal)
#define Q_EMIT

#define METHOD(a) qFlagLocation("0"#a QLOCATION)
#define SLOT(a) qFlagLocation("1"#a QLOCATION)
#define SIGNAL(a) qFlagLocation("2"#a QLOCATION)

const char *qFlagLocation(const char *method)
{
QThreadData *currentThreadData = QThreadData::current(false);
if (currentThreadData != 0)
currentThreadData->flaggedSignatures.store(method);
return method;
}

可以分析出signals限定了是public的,而发射信号emit就是调用信号函数
而我们在连接信号与槽时使用的SIGNAL和SLOT,就是一个代表方法的字符串

Qt类相关宏

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
#define Q_CLASSINFO(name, value)
#define Q_PLUGIN_METADATA(x) QT_ANNOTATE_CLASS(qt_plugin_metadata, x)
#define Q_INTERFACES(x) QT_ANNOTATE_CLASS(qt_interfaces, x)
#ifdef Q_COMPILER_VARIADIC_MACROS
# define Q_PROPERTY(...) QT_ANNOTATE_CLASS(qt_property, __VA_ARGS__)
#else
# define Q_PROPERTY(text) QT_ANNOTATE_CLASS(qt_property, text)
#endif
#define Q_PRIVATE_PROPERTY(d, text) QT_ANNOTATE_CLASS2(qt_private_property, d, text)
#ifndef Q_REVISION
# define Q_REVISION(v)
#endif
#define Q_OVERRIDE(text) QT_ANNOTATE_CLASS(qt_override, text)
#define QDOC_PROPERTY(text) QT_ANNOTATE_CLASS(qt_qdoc_property, text)
#define Q_ENUMS(x) QT_ANNOTATE_CLASS(qt_enums, x)
#define Q_FLAGS(x) QT_ANNOTATE_CLASS(qt_enums, x)
#define Q_ENUM_IMPL(ENUM) \
friend Q_DECL_CONSTEXPR const QMetaObject *qt_getEnumMetaObject(ENUM) Q_DECL_NOEXCEPT { return &staticMetaObject; } \
friend Q_DECL_CONSTEXPR const char *qt_getEnumName(ENUM) Q_DECL_NOEXCEPT { return #ENUM; }
#define Q_ENUM(x) Q_ENUMS(x) Q_ENUM_IMPL(x)
#define Q_FLAG(x) Q_FLAGS(x) Q_ENUM_IMPL(x)
#define Q_SCRIPTABLE QT_ANNOTATE_FUNCTION(qt_scriptable)
#define Q_INVOKABLE QT_ANNOTATE_FUNCTION(qt_invokable)
#define Q_SIGNAL QT_ANNOTATE_FUNCTION(qt_signal)
#define Q_SLOT QT_ANNOTATE_FUNCTION(qt_slot)

其中Q_PROPERTY定义了Qt的属性系统,Q_ENUMS、Q_FLAGS定义了Qt的枚举类型操作

Qt翻译宏

1
2
3
4
5
#define QT_TR_FUNCTIONS \
static inline QString tr(const char *s, const char *c = Q_NULLPTR, int n = -1) \
{ return staticMetaObject.tr(s, c, n); } \
QT_DEPRECATED static inline QString trUtf8(const char *s, const char *c = Q_NULLPTR, int n = -1) \
{ return staticMetaObject.tr(s, c, n); }

Q_OBJECT宏

1
2
3
4
5
6
7
8
9
#define Q_OBJECT \
public: \
static const QMetaObject staticMetaObject; \
virtual const QMetaObject *metaObject() const; \
virtual void *qt_metacast(const char *); \
virtual int qt_metacall(QMetaObject::Call, int, void **); \
QT_TR_FUNCTIONS \
private: \
static void qt_static_metacall(QObject *, QMetaObject::Call, int, void **);

Q_OBJECT宏是Qt元对象模型Meta-Object Model的基础

全局宏定义

中文件中定义了很多宏,以下一些是比较常用的:

  • QT_VERSION:这个宏展开为数值形式 0xMMNNPP (MM = major, NN = minor, PP = patch) 表示 Qt 编译器版本,例如 Qt 编译器版本为 Qt 5.9.1,则 QT_VERSION 为 0x050901。这个宏常用于条件编译设置,根据 Qt 版本不同,编译不同的代码段。

    1
    2
    3
    4
    5
    6
    #if QT_VERSION >= 0x040100
    QIcon icon = style()->standardIcon(QStyle::SP_TrashIcon);
    #else
    QPixmap pixmap = style()->standardPixmap(QStyle::SP_TrashIcon);
    Qlcon icon(pixmap);
    #endif
  • QT_VERSION_CHECK:这个宏展开为 Qt 版本号的一个整数表示,例如:

    1
    2
    3
    4
    5
    #if (QT_VERSION >= QT_VERSION_CHECK(5, 0, 0))
    #include <QtWidgets>
    #else
    #include <QtGui>
    #endif
  • QT_VERSION_STR:这个宏展开为 Qt 版本号的字符串,如“5.9.0”。

  • Q_BYTE_ORDER、Q_BIG_ENDIAN 和 Q_LITTLE_ENDIAN:Q_BYTE_ORDER 表示系统内存中数据的字节序,Q_BIG_ENDIAN 表示大端字节序,Q_LITTLE_ ENDIAN 表示小端字节序。在需要判断系统字节序时会用到,例如:

    1
    2
    3
    #if Q_BYTE_ORDER == Q_LITTLE_ENDIAN
    ...
    #endif
  • Q_DECL_IMPORT 和 Q_DECL_EXPORT:在使用或设计共享库时,用于导入或导出库的内容,后续章节有其使用实例。

  • Q_DECL_OVERRIDE:在类定义中,用于重载一个虚函数,例如在某个类中重载虚函数 paintEvem(),可以定义如下:

    void paintEvent(QPaintEvent*) Q_DECL_OVERRIDE;

    使用 Q_DECL_OVERRIDE 宏后,如果重载的虚函数没有进行任何重载操作,编译器将会报错。

  • Q_DECL_FINAL:这个宏将一个虚函数定义为最终级别,不能再被重载,或定义一个类不能再被继承,示例如下:

    1
    2
    3
    Class QRect Q_DECL_FINAL { // QRect 不能再被继承
    // ...
    };
  • Q_UNUSED(name):这个宏用于在函数中定义不在函数体里使用的参数,示例如下:

    1
    2
    3
    4
    5
    void MainWindow::on_imageSaved(int id, const QString &fileName)
    {
    Q_UNUSED(id);
    LabInfo->setText ("图片保存为:"+ fileName);
    }

    在这个函数里,id 参数没有使用。如果不用 QJJNUSED(id) 定义,编译器会出现参数未使用的警告。

  • foreach(variable, container):foreach 用于容器类的遍历,例如:

    1
    2
    foreach (const QString &codecName, recorder->supportedAudioCodecs())
    ui->comboCodec->addItem(codecName);
  • forever:forever用于构造一个无限循环,例如:

    1
    2
    3
    forever {
    ...
    }
  • qDebug(const char * message,…):在debugger窗体显示信息,如果编译器设置了 Qt_NO_DEBUG_OUTPUT,则不作任何输出,例如:

    qDebug(“Items in list: %d”, myList.size());

类似的宏还有 qWarning、qCritical、qFatal、qInfo 等,也是用于在 debugger 窗体显示信息。