C++ Qt開發：TabWidget實現多窗體功能

Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹TabWidget標簽組件的常用方法及靈活運用。

QTabWidget 是Qt中用於實現標簽頁（tabbed interface）的控制項，可以在一個視窗內切換不同的頁面。在開發窗體應用時通常會伴隨功能的分頁，使用TabWidget並配合自定義Dialog組件，即可實現一個複雜的多窗體分頁結構，此類佈局方式也是多數軟體通用的方案。

以下是 QTabWidget 的一些常用方法，以表格形式概述：

這些方法可以幫助你在 QTabWidget 中動態地管理標簽頁，設置標簽文本、圖標，以及進行標簽頁的切換和管理。

1.1 重覆窗體分頁

重覆窗體的使用廣泛應用於標簽頁克隆，例如一些遠程SSH工具每次打開標簽都是一個重覆的交互環境，唯一不同的只是IP地址的變化，對於這些重覆打開的標簽頁面就可以使用此分頁來解決。

首先實現如下窗體佈局，佈局中空白部分是一個TabWidget分頁組件，下方是一個PushButton按鈕，當用戶點擊按鈕時，自動將Dialog窗體追加到TabWidget組件中，如下圖；

首先讀者需要新建一個名叫FormDoc.ui的標準對話框，併在FormDoc構造函數中對該窗體進行初始化，如下代碼則是自定義 FormDoc 類的實現，該類繼承自 QWidget。在構造函數中，創建了垂直佈局管理器 QVBoxLayout，並設置了一些邊距和間距。然後，通過 setLayout 將這個佈局管理器應用到 FormDoc 類的對象上。

在構造函數中，通過 parentWidget() 獲取了父視窗指針，並通過強制類型轉換將其轉為 MainWindow* 類型。接著，通過調用 GetTableNumber() 方法獲取了選中標簽的索引，然後將其輸出到控制台。此處的GetTableNumber()是父類中的函數，主要用於返回當前TabWidget組件的下標。

#include "formdoc.h"
#include "ui_formdoc.h"
#include "mainwindow.h"

#include <QVBoxLayout>
#include <iostream>

FormDoc::FormDoc(QWidget *parent) :QWidget(parent),ui(new Ui::FormDoc)
{
    ui->setupUi(this);

    QVBoxLayout *Layout = new QVBoxLayout();
    Layout->setContentsMargins(2,2,2,2);
    Layout->setSpacing(2);
    this->setLayout(Layout);

    // 獲取父視窗指針
    MainWindow *parWind = (MainWindow*)parentWidget();

    // 獲取選中標簽索引
    QString ref = parWind->GetTableNumber();
    std::cout << ref.toStdString().data() << std::endl;
}

FormDoc::~FormDoc()
{
    delete ui;
}

接著來看下MainWindow主窗體中是如何實現創建窗體的，當用戶點擊PushButton按鈕時，首先new FormDoc新建一個空的窗體，並通過 addTab 方法將 FormDoc 實例添加到 QTabWidget 中，設置了選項卡的顯示文本為 IP 地址（"192.168.1.x"）以及對應的圖標。然後，通過 setCurrentIndex 將新建的選項卡設置為當前選中，並通過 setVisible(true) 確保 QTabWidget 是可見的。

另外，該主視窗還實現了一個槽函數 on_tabWidget_tabCloseRequested，當某個選項卡被關閉時觸發。在這個槽函數中，首先獲取被關閉的選項卡對應的 QWidget 指針，然後調用 close 方法關閉選項卡。需要註意的是，如果在關閉選項卡時需要執行一些清理工作，可以在 FormDoc 類的析構函數中進行相應的處理。

void MainWindow::on_pushButton_clicked()
{
    // 新建選項卡
    FormDoc *ptr = new FormDoc(this);

    // 關閉時自動銷毀
    ptr->setAttribute(Qt::WA_DeleteOnClose);

    int cur = ui->tabWidget->addTab(ptr,QString::asprintf(" 192.168.1.%d",ui->tabWidget->count()));

    ui->tabWidget->setTabIcon(cur,QIcon(":/image/1.ico"));

    ui->tabWidget->setCurrentIndex(cur);
    ui->tabWidget->setVisible(true);
}

// 關閉Tab時執行
void MainWindow::on_tabWidget_tabCloseRequested(int index)
{
    if (index<0)
        return;
    QWidget* aForm=ui->tabWidget->widget(index);
    aForm->close();
}

程式運行後讀者可以點擊創建窗體按鈕，每次點擊都會創建一個獨立的新窗體，如下圖所示；

1.2 獨立窗體分頁

在1.1節中，筆者所介紹的方法僅用於重覆功能頁面的創建，而有時我們需要讓不同的視窗展示不同的功能，此時就需要實現多窗體，通過ToolBar與TabWidget組件的配合可以很好的實現多窗體的應用，如下圖通過ToolBar配置一個按鈕組件並初始化圖標。

接著對窗體中的菜單欄依次綁定一個名稱，其中名稱使用action開頭，如下圖所示；

接著我們分別創建三個與之對應的Dialog對話框，其中actionMain對應formmain.ui、actionOption對應到formoption.ui、actionCharts對應到formcharts.ui上面，當首頁按鈕被點擊後，在MainWindow中執行如下操作，首先判斷窗體是否打開了，如果打開了則不允許繼續打開新的，而如果沒有被打開，那麼我們就新建一個視窗，並設置到TabWidget上面，其代碼如下所示；

// 首頁菜單創建
void MainWindow::on_actionMain_triggered()
{
    int tab_count = ui->tabWidget->count();
    int option_count = 0;

    for(int x=0; x < tab_count; x++)
    {
        // 獲取出每個菜單的標題
        QString tab_name = ui->tabWidget->tabText(x);

        if(tab_name == "首頁菜單")
            option_count = option_count + 1;
    }

    if(option_count < 1)
    {
        FormMain *ptr = new FormMain(this);              // 新建選項卡
        ptr->setAttribute(Qt::WA_DeleteOnClose);         // 關閉時自動銷毀

        int cur=ui->tabWidget->addTab(ptr,QString::asprintf("首頁菜單"));
        ui->tabWidget->setTabIcon(cur,QIcon(":/image/1.ico"));

        ui->tabWidget->setCurrentIndex(cur);
        ui->tabWidget->setVisible(true);
    }
}

系統設置頁面同理，這裡我們規定系統設置頁面也只能打開一個，其代碼如下所示；

// 創建系統設置菜單
void MainWindow::on_actionOption_triggered()
{
    int tab_count = ui->tabWidget->count();
    int option_count = 0;

    for(int x=0; x < tab_count; x++)
    {
        // 獲取出每個菜單的標題
        QString tab_name = ui->tabWidget->tabText(x);

        if(tab_name == "系統設置")
            option_count = option_count + 1;
    }

    // 判斷首頁菜單是否只有一個,可判斷標簽個數來識別
    if(option_count < 1)
    {
        FormOption *ptr = new FormOption(this);
        ptr->setAttribute(Qt::WA_DeleteOnClose);

        int cur = ui->tabWidget->addTab(ptr,QString::asprintf("系統設置"));
        ui->tabWidget->setTabIcon(cur,QIcon(":/image/2.ico"));

        ui->tabWidget->setCurrentIndex(cur);
        ui->tabWidget->setVisible(true);
    }
}

最後一個是圖形繪製按鈕，該按鈕我們讓其可以彈出多個，此處就不再限制彈出數量，只要點擊按鈕就新建一個並追加到TabWidget中，代碼如下所示；

// 繪圖頁面的彈出
void MainWindow::on_actionCharts_triggered()
{
    FormCharts *ptr = new FormCharts(this);

    ptr->setAttribute(Qt::WA_DeleteOnClose);

    int cur = ui->tabWidget->addTab(ptr,QString::asprintf("圖形繪製"));
    ui->tabWidget->setTabIcon(cur,QIcon(":/image/3.ico"));

    ui->tabWidget->setCurrentIndex(cur);
    ui->tabWidget->setVisible(true);
}

運行後讀者可依次點擊不同的按鈕實現子窗體的創建，如下圖所示；

附件下載

TabWidget