學習QT之QSplitter、QDockWidget、QStackedWidget

一、QSplitter（分割視窗）

#include "mainwindow.h"
#include <QApplication>
#include <QFont>
#include <QSplitter>
#include <QTextEdit>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QFont font("ZYSong18030",12);
    a.setFont(font);
    //主分割視窗
    QSplitter *splitterMain = new QSplitter(Qt::Horizontal,0);//（a）
    QTextEdit *textleft = new QTextEdit(QObject::tr("Left Widget"),splitterMain);//(b)

    textleft->setAlignment(Qt::AlignCenter);//(c)
    //右分割視窗
    QSplitter *splitterRight = new QSplitter(Qt::Vertical,splitterMain);//(d)
    splitterRight->setOpaqueResize(false);//(e)
    QTextEdit *textUp = new QTextEdit(QObject::tr("Top Widget"),splitterRight);
    textUp->setAlignment(Qt::AlignCenter);
    QTextEdit *textButtom = new QTextEdit(QObject::tr("Bottom Widget"),splitterRight);
    textButtom->setAlignment(Qt::AlignCenter);
    splitterMain->setStretchFactor(1,1);//(f)
    splitterMain->setWindowTitle(QObject::tr("Splitter"));
    splitterMain->show();
    //MainWindow w;
    //w.show();

    return a.exec();
}

其中，

（a）QSplitter *splitterMain = new QSplitter(Qt::Horizontal,0)：建立一個QSplitter類對象，作為主分割視窗，設定此分割視窗為水準分割視窗。

（b）QTextEdit *textLeft = new QTextEdit(QObject::tr(“Left Widget”),splitterMain)：建立一個QTextEdit類對象，并将其插入主分割視窗中。

（c）textLeft->setAlignment(Qt::AlignCenter)：設定TextEdit中文字的對齊方式，常用的對齊方式有以下幾種。

Qt::AlignLeft：左對齊。
Qt::AlignRight：右對齊。
Qt::AlignCenter：文字居中（Qt::AlignHCenter為水準居中，Qt::AlignVCenter為垂直居中）。
Qt::AlignUp：文字與頂部對齊。
Qt::AlignBottom：文字與底部對齊。

（d）QSplitter *splitterRight = new QSplitter(Qt::Vertical,splitterMain)：建立一個QSplitter類對象，作為右分割視窗，設定此分割視窗為垂直分割視窗，并以主分割視窗為父視窗。

（e）splitterRight->setOpaqueResize(false)：調用setOpaqueResize(bool)方法用于設定分割視窗的分割條在拖拽時是否實時更新顯示，若設為true則實時更新顯示，若設為false則在拖拽時隻顯示一條灰色的粗線條，在拖拽到位并釋放滑鼠後再顯示分割條。預設設定為true。

（f）splitterMain->setStretchFactor(1,1)：調用setStrethFactor()方法用于設定可伸縮控件，它的第一個參數用于指定設定的控件序号，控件序号按插入的先後次序從0起依次編号；第二個參數為大于0的值，表示此控件為可伸縮控件。此執行個體中設定右部的分割視窗為可伸縮控件，當整個對話框的寬度發生改變是，左部的檔案編輯框寬度保持不變，右部的分割視窗寬度随整個對話框大小的改變進行調整。

運作程式，結果如下：

學習QT之QSplitter、QDockWidget、QStackedWidget

二、QDockWidget（停靠視窗）

停靠視窗QDockWidget類設定停靠視窗的一般流程如下：

建立一個QDockWidget對象的停靠窗體；
設定此停靠窗體的屬性，通常調用setFeatures()即setAllowedAreas()兩種方法；
建立一個要插入停靠窗體的控件，常用的有QListWidget和QTextEdit。
将控件插入停靠視窗，調用QDockWidget的setWidget()方法。
使用addDockWidget()方法在MainWindow中加入此停靠窗體。

#include "mainwindow.h"
#include <QTextEdit>
#include <QDockWidget>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    setWindowTitle(tr("DockWindows"));
    QTextEdit *te = new QTextEdit(this);
    te->setText(tr("Main Window"));
    te->setAlignment(Qt::AlignCenter);
    setCentralWidget(te);
    //停靠視窗1
    QDockWidget *dock = new QDockWidget(tr("DockWindow1"),this);
    //可移動
    dock->setFeatures(QDockWidget::DockWidgetMovable);//(a)
    dock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);//(b)

    QTextEdit *te1 = new QTextEdit();
    te1->setText(tr("window1,the dock widget can be moved between docks by the user " ""));
    dock->setWidget(te1);
    addDockWidget(Qt::RightDockWidgetArea,dock);
    //停靠視窗2
    dock = new QDockWidget(tr("DockWindow2"),this);
    dock->setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetFloatable);
    QTextEdit *te2 = new QTextEdit();
    te2->setText(tr("Window2,the dock widget can be detached from the main window,""and floated as an independent window,and can bu closed"));
    dock->setWidget(te2);
    addDockWidget(Qt::RightDockWidgetArea,dock);
    //停靠視窗3
    dock = new QDockWidget(tr("DockWindow3"),this);
    dock->setFeatures(QDockWidget::AllDockWidgetFeatures);
    QTextEdit *te3 = new QTextEdit();
    te3->setText(tr("Window3,the dock widget can be closed,moved,and floated"));
    dock->setWidget(te3);
    addDockWidget(Qt::RightDockWidgetArea,dock);
}

其中，

**（a）setFeatures()**方法設定停靠窗體的特性，原型如下：

void setFeatures(DockWidgetFeatures features)

參數QDockWidget::DockWidgetFeatures指定停靠窗體的特性，包括以下幾種參數：

QDockWidget::DockWidgetClosable：停靠窗體可關閉。
QDockWidget::DockWidgetMovable：停靠窗體可移動。
QDockWidget::DockWidgetFloatable：停靠窗體可浮動。
QDockWidget::AllDockWidgetFeatures：此參數表示擁有停靠窗體的所有特性。
QDockWidget::NoDockWidgetFeatures：不可移動、不可關閉、不可浮動。

此參數可以采用或（|）的方式對停靠窗體進行特性的設定。

（b）setAllowedAreas() 方法設定停靠窗體可停靠的區域，原型如下：

void setAllowedAreas(Qt::QDockWidgetAreas areas)

參數Qt::DockWidgetAreas指定停靠窗體可停靠的區域，包括以下幾種參數：

Qt::LeftDockWidgetArea：可在主視窗的左側停靠。
Qt::RightDockWidgetArea：可在主視窗的右側停靠。
Qt::TopDockWidgetArea：可在主視窗的頂部停靠。
Qt::BottomDockWidgetArea：可在主視窗的底部停靠。
Qt::AllDockWidgetArea：可在主視窗的任意（以上四個）部位停靠。
Qt::NoDockWidgetArea：隻可停靠在插入處。

運作程式，結果如下：

三、QStackedWidget（堆棧視窗）

//頭檔案
#ifndef STACKDLG_H
#define STACKDLG_H

#include <QDialog>
#include <QListWidget>
#include <QStackedWidget>
#include <QLabel>

class StackDlg : public QDialog
{
    Q_OBJECT

public:
    StackDlg(QWidget *parent = 0);
    ~StackDlg();
private:
    QListWidget *list;
    QStackedWidget *stack;
    QLabel *label1;
    QLabel *label2;
    QLabel *label3;
};

#endif // STACKDLG_H


//源檔案
#include "stackdlg.h"
#include <QHBoxLayout>

StackDlg::StackDlg(QWidget *parent)
    : QDialog(parent)
{
    setWindowTitle("StackedWidget");
    list = new QListWidget(this);  //建立一個QListWidget空間對象
    //在建立的QListWidget控件中插入三個條目，作為選擇項
    list->insertItem(0,tr("Window1"));
    list->insertItem(1,tr("Window2"));
    list->insertItem(2,tr("Window3"));
    //建立三個QLabel标簽對象，作為堆棧視窗需要顯示的三層窗體
    label1 = new QLabel(tr("WindowTest1"));
    label2 = new QLabel(tr("WindowTest2"));
    label3 = new QLabel(tr("WindowTest3"));
    stack = new QStackedWidget(this);  //建立一個QStackedWidget堆棧窗體對象
    stack->addWidget(label1);
    stack->addWidget(label2);
    stack->addWidget(label3);

    QHBoxLayout *mainLayout = new QHBoxLayout(this);
    mainLayout->setMargin(5);
    mainLayout->setSpacing(5);
    mainLayout->addWidget(list);
    mainLayout->addWidget(stack,0,Qt::AlignHCenter);
    mainLayout->setStretchFactor(list,1);//(a)
    mainLayout->setStretchFactor(stack,3);
    connect(list,SIGNAL(currentRowChanged(int)),stack,SLOT(setCurrentIndex(int)));//(b)

}

StackDlg::~StackDlg()
{

}

其中，

（a）mainLayout->setStretchFactor(list,1)：設定可伸縮控件，第1個參數用于指定設定的控件（序号從0開始編号），第2個參數的值大于0則表示此控件為可伸縮控件。

（b）connect(list,SIGNAL(currentRowChanged(int)),stack,SLOT(setCurrentIndex(int)))：将QListWidget的currentRowChanged()信号與堆棧窗體的setCurrentIndex()的槽函數連接配接起來，實作按選擇顯示窗體。此處的堆棧窗體index按插入的順序從0起依次排序，與QListWidget的條目排序相一緻。

學習QT之QSplitter、QDockWidget、QStackedWidget