中英文對照Splitter handles（分隔條）

 一個QSplitter控制元件中可以包含其他控制元件，這些控制元件被一個分隔條隔開，託拽這個分隔條，裡面的控制元件的大小可以改變。QSplitter控制元件經常做為佈局管理器使用，給使用者提供更多的介面控制。

QSplitter控制元件中的子控制元件總是按順序自動並肩排列（或者上下排列）。相鄰的控制元件之間有一個分隔條。下面是建立圖6.7的窗體的程式碼： int main(int argc, char *argv[]) {     QApplication app(argc, argv);     QTextEdit *editor1 = new QTextEdit;     QTextEdit *editor2 = new QTextEdit;     QTextEdit *editor3 = new QTextEdit;     QSplitter splitter(Qt::Horizontal);     splitter.addWidget(editor1);     splitter.addWidget(editor2);     splitter.addWidget(editor3);     ...     splitter.show();     return app.exec(); } Figure 6.7. The Splitter application

   這個例子中的窗體有一個QSplitter控制元件，其中有三個水平排列的QTextEdit控制元件，和佈局管理器不同，QSplitter不但可以排列子控制元件，還有一個可視的外觀，QSplitter控制元件從QWidget繼承，擁有QWidget所有的功能。

Figure 6.8. The Splitter application's widgets 第一次是呼叫rightSplitter的setStretchFactor，把索引值為1的控制元件（textEdit）的拉伸係數設定為1，第二次是呼叫mainSplitter的setStretchFactor()，設定控制元件rightSplitter的拉伸係數為1。這樣，textEdit控制元件就能夠得到儘可能多餘的空間。 當應用程式啟動時，QSplitter根據子控制元件的初始尺寸或者sizeHint合理分配每一個子控制元件的大小。程式中，我們可以呼叫QSplitter::setSizes()改變分隔條的位置。QSplitter還可以儲存當前的狀態，在程式下一次執行時恢復以前的狀態。下面是writeSettings()函式，儲存當前分隔條的狀態： void MailClient::writeSettings() {     QSettings settings("Software Inc.", "Mail Client");     settings.beginGroup("mainWindow");     settings.setValue("size", size());     settings.setValue("mainSplitter", mainSplitter->saveState());     settings.setValue("rightSplitter", rightSplitter->saveState());     settings.endGroup(); } 下面是相應的readSettings()函式： void MailClient::readSettings() {     QSettings settings("Software Inc.", "Mail Client");     settings.beginGroup("mainWindow");     resize(settings.value("size", QSize(480, 360)).toSize());     mainSplitter->restoreState(             settings.value("mainSplitter").toByteArray());     rightSplitter->restoreState(             settings.value("rightSplitter").toByteArray());     settings.endGroup(); } Qt Designer也支援QSplitter。把子控制元件放到合適的位置，把他們選中，選擇選單Form|Lay out Horizontally in Splitter或者Form|Lay out Verticallly in Splitter，所選擇的子控制元件就被加入到QSplitter控制元件中。 對QSplitter進行水平或者垂直巢狀可以實現更加複雜的佈局。例如，圖6-9所示的MailClient程式中，就是一個垂直方向的QSplitter控制元件中嵌套了一個水平方向的QSplitter控制元件。 Figure 6.9. The Mail Client application on Mac OS X

下面的程式碼是MailClient程式的主視窗類建構函式程式碼： MailClient::MailClient() {     ...     rightSplitter = new QSplitter(Qt::Vertical);     rightSplitter->addWidget(messagesTreeWidget);  //索引0     rightSplitter->addWidget(textEdit);//索引1     rightSplitter->setStretchFactor(1, 1);//指定索引為1的textEdit拉伸     mainSplitter = new QSplitter(Qt::Horizontal);     mainSplitter->addWidget(foldersTreeWidget);     mainSplitter->addWidget(rightSplitter);     mainSplitter->setStretchFactor(1, 1);     setCentralWidget(mainSplitter);     setWindowTitle(tr("Mail Client"));     readSettings(); } 建立完我們所需要顯示三個控制元件（messageTreeWidget，textEdit，foldersTreeWidget）後，我們建立一個垂直的QSplitter，rightSplitter控制元件，把messageTreeWidget和textEdit控制元件加到rightSplitter中。然後建立一個水平的QSplitter，mainSplitter控制元件，把rightSplitter和foldersTreeWidget加入到mainSplitter中。把mainSplitter做為QMainWindow的中央控制元件。 當用戶改變視窗的大小時， QSplitter通常給所有的子控制元件一樣的空間。在MailClient程式中，我們希望左邊的檔案樹控制元件（foldersTreeWidget）和訊息樹控制元件（messageTreeWidget）保持它們的大小，把其他的空間都分配給QTextEdit。這由兩個setStretchFactor()呼叫實現。第一個引數是0開始的子控制元件的索引值，第二個引數為我們設定的拉伸係數，預設值為0。 Figure 6.10. The Mail Client's splitter indexing

測試程式碼：

1. QList<QTreeWidgetItem *> items;  
2.     for (int i = 0; i < 10; ++i)  
3.         items.append(new QTreeWidgetItem((QTreeWidget*)0, QStringList(QString("item: %1").arg(i))));  
4.     QTreeWidget* messagesTreeWidget = new QTreeWidget();  
5.     messagesTreeWidget->setColumnCount(1);  
6.     messagesTreeWidget->insertTopLevelItems(0, items);  
7.     for (int i = 0; i < 10; ++i)  
8.         items.append(new QTreeWidgetItem((QTreeWidget*)0, QStringList(QString("item: %1").arg(i))));  
9.     QTreeWidget* foldersTreeWidget = new QTreeWidget();  
10.     foldersTreeWidget->setColumnCount(1);  
11.     foldersTreeWidget->insertTopLevelItems(0, items);  
12.     QTextEdit* textEdit = new QTextEdit();  
13.     textEdit->setText(tr("happy"));  
14.     QSplitter* rightSplitter = new QSplitter(Qt::Vertical);  
15.     rightSplitter->addWidget(messagesTreeWidget);   //索引0
16.     rightSplitter->addWidget(textEdit);             //索引1
17.     rightSplitter->setStretchFactor(1, 1);          //索引為X的控制元件拉伸
18.     QSplitter* mainSplitter = new QSplitter(Qt::Horizontal);  
19.     mainSplitter->addWidget(foldersTreeWidget);  
20.     mainSplitter->addWidget(rightSplitter);  
21.     mainSplitter->setStretchFactor(1, 1);  
22.     setCentralWidget(mainSplitter);  

拉伸前：
   拉伸後

FROM:  http://blog.csdn.net/teng_ontheway/article/details/18262827