//! [0] in Qt-Quelltext

Question

Was bedeutet die //! [n] (n = 0, 1, 2 ...) Markup in den C++/QML-Quellen in den Qt-Beispielprojekten?

Zum Beispiel:

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

Trotz des weit verbreiteten Missverständnis, das ist qdoc Syntax, nicht doxygen. Dieser Kommentar dient zu Dokumentationszwecken im Qt-Projekt zum Markieren von Beispiel-Snippets, die so gerendert werden sollen. Es ist nicht wirklich gut dokumentiert, aber here Sie können den entsprechenden Code finden, der diese Funktion implementiert.

Als Endbenutzer von Qt müssen Sie sich nicht zu sehr damit befassen, es sei denn, Sie fangen an, selbst an dem Qt-Projekt mitzuarbeiten, oder Sie versuchen, qdoc für Ihr eigenes Projekt wiederzuverwenden .