//! [0] trong mã nguồn Qt

Question

Ý nghĩa của đánh dấu //! [n] (n = 0, 1, 2 ...) trong nguồn C++/QML trong các dự án mẫu Qt là gì?

Ví dụ:

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

Mặc dù quan niệm sai lầm phổ biến, đây là qdoc cú pháp, không doxygen. Nhận xét này là dành cho các mục đích tài liệu trong Dự án Qt để đánh dấu các đoạn mã mẫu được hiển thị như vậy. Nó không thực sự là tài liệu, nhưng here bạn có thể tìm thấy mã tương ứng thực hiện tính năng này.

Là người dùng cuối của Qt, bạn không cần xử lý quá nhiều trừ khi bạn bắt đầu đóng góp cho Dự án Qt hoặc bạn đang cố gắng sử dụng lại qdoc cho dự án của riêng mình, điều này sẽ được thừa nhận là lẻ vào thời điểm này .