//！ Qt源代碼中的[0]

Question

Qt示例項目中C++/QML源代碼中//! [n]（n = 0,1,2 ...）標記的含義是什麼？

例如：

//! [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] 

Answer 1

儘管通常的誤解，這是的QDoc語法，不 doxygen的。此評論是爲Qt項目中的文檔目的而標記的示例代碼片段。它沒有很好的記錄，但是here你可以找到實現這個功能的相應代碼。

作爲Qt的最終用戶，除非您開始爲Qt項目本身做出貢獻，或者您正在嘗試將qdoc重用於您自己的項目，否則不需要處理它，這一點在這一點上顯然是奇怪的。