要点
使用宏定义让 Doxygen 跳过代码段。
一、问题描述
Doxygen 认为 property 和 function 是相似项目,在文档中 \property 命令的解释为
Indicates that a comment block contains documentation for a property (either global or as a member of a class). This command is equivalent to \fn, \typedef, and \var.
在 Qt 中,property 是以字符串来索引的,因此可以使用与 property 相同名字的 function 作为其 READ 方法,这也是比较常见的命名方式。但是在 Doxygen 中(版本1.8.2),二者会导致命名“冲突”。样例如下:
main.h 文件
#include "qpushbutton.h"
class CMyButton : public QPushButton
{
Q_OBJECT
Q_PROPERTY(int type READ type WRITE setType)
public:
int