QWidget中的addWidget詳解

一、介紹

addWidget是QWidget的一個常用的函數，它的作用是將一個QWidget或其子類添加到另一個QWidget或其子類上。使用addWidget，我們可以方便地在一個QWidget中添加各種UI組件，從而創建出一個完整的GUI。

二、函數說明

addWidget的函數定義如下：

void QWidget::addWidget(QWidget *widget, int stretch = 0, Qt::Alignment alignment = 0)

參數解釋：

• widget：需要添加的QWidget。
• stretch：該QWidget在水平或垂直方向上的伸縮因子，默認值為0，表示該QWidget不會隨父QWidget的水平或垂直大小改變而改變大小。
• alignment：該QWidget在父QWidget中的對齊方式，默認值為0，表示採用默認的對齊方式。

三、使用示例

下面的例子演示了如何通過addWidget將三個QPushButton添加到一個QVBoxLayout中，並且在每個QPushButton的左上角加上了一個QLabel。

#include <QtWidgets/QApplication>
#include <QtWidgets/QVBoxLayout>
#include <QtWidgets/QPushButton>
#include <QtWidgets/QLabel>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QWidget *widget = new QWidget();
    QVBoxLayout *layout = new QVBoxLayout();

    QPushButton *button1 = new QPushButton("Button 1");
    QLabel *label1 = new QLabel("Label 1");

    QPushButton *button2 = new QPushButton("Button 2");
    QLabel *label2 = new QLabel("Label 2");

    QPushButton *button3 = new QPushButton("Button 3");
    QLabel *label3 = new QLabel("Label 3");

    layout->addWidget(button1);
    layout->addWidget(button2);
    layout->addWidget(button3);

    layout->addWidget(label1, 0, Qt::AlignTop | Qt::AlignLeft);
    layout->addWidget(label2, 0, Qt::AlignTop | Qt::AlignLeft);
    layout->addWidget(label3, 0, Qt::AlignTop | Qt::AlignLeft);

    widget->setLayout(layout);
    widget->show();

    return a.exec();
}

四、注意事項

在使用addWidget時，需要注意以下幾點：

• addWidget只適用於QWidget及其子類，如QMainWindow、QDialog、QFrame等。
• 在添加QWidget之前，需要先為QWidget設置好正確的布局。布局管理器可以是QHBoxLayout、QVBoxLayout等。
• 當一個QWidget被添加到另一個QWidget中時，前者的坐標系是相對於後者的坐標系的。
• addWidget添加的QWidget默認是可以隨著父QWidget的大小改變而改變大小的。如果不需要QWidget隨著父QWidget的大小改變而改變大小，可以將stretch設置為0。

五、總結

addWidget是QWidget的一個重要函數，它可以很方便地將一個QWidget或其子類添加到另一個QWidget或其子類上。使用addWidget可以快速創建出一個完整的GUI界面。