問題描述

是什么意思//！[n] (n = 0, 1, 2 ...) Qt 示例項目中 C++/QML 源代碼中的標記?

What is the meaning of the //! [n] (n = 0, 1, 2 ...) markup in the C++/QML sources in the Qt sample projects?

例如:

//! [0]
GLWidget::GLWidget(Helper *helper, QWidget *parent)
    : QGLWidget(QGLFormat(QGL::SampleBuffers), parent), helper(helper)
{
    elapsed = 0;
    setFixedSize(840, 400);
    setAutoFillBackground(false);
}
//! [0]

//! [1]
void GLWidget::animate()
{
    elapsed = (elapsed + qobject_cast<QTimer*>(sender())->interval()) % 1000;
    repaint();
}
//! [1]

//! [2]
void GLWidget::paintEvent(QPaintEvent *event)
{
    QPainter painter;
    painter.begin(this);
    painter.setRenderHint(QPainter::Antialiasing);
    helper->paint(&painter, event, elapsed);
    painter.end();
}
//! [2]

推薦答案

盡管存在常見的誤解，但這是 qdoc 語法，不是 doxygen.此注釋用于 Qt 項目中的文檔目的，以標記要呈現的示例片段.請參閱文檔和對應代碼，實現了這個功能.

Despite the common misconception, this is qdoc syntax, not doxygen. This comment is for documentation purposes in the Qt Project to mark example snippets to be rendered so. See the documentation and the corresponding code that implements this feature.

作為 Qt 的最終用戶，您不需要過多處理它，除非您開始為 Qt 項目本身做出貢獻，或者您正在嘗試將 qdoc 重用于您自己的項目，這在這一點上無疑是奇怪的.

As an end user of Qt, you do not need to deal with it too much unless you start contributing to the Qt Project itself or you are trying to reuse qdoc for your own project, which would be admittedly odd at this point.

這篇關于//![0] 在 Qt 源代碼中的文章就介紹到這了，希望我們推薦的答案對大家有所幫助，也希望大家多多支持html5模板網！