【Qt】之 Splitter分割窗口

中英文对照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

原文链接：http://blog.csdn.net/iamdbl/article/details/1586324

测试代码：

QList<QTreeWidgetItem *> items;    for (int i = 0; i < 10; ++i)        items.append(new QTreeWidgetItem((QTreeWidget*)0, QStringList(QString("item: %1").arg(i))));    QTreeWidget* messagesTreeWidget = new QTreeWidget();    messagesTreeWidget->setColumnCount(1);    messagesTreeWidget->insertTopLevelItems(0, items);    for (int i = 0; i < 10; ++i)        items.append(new QTreeWidgetItem((QTreeWidget*)0, QStringList(QString("item: %1").arg(i))));    QTreeWidget* foldersTreeWidget = new QTreeWidget();    foldersTreeWidget->setColumnCount(1);    foldersTreeWidget->insertTopLevelItems(0, items);    QTextEdit* textEdit = new QTextEdit();    textEdit->setText(tr("happy"));    QSplitter* rightSplitter = new QSplitter(Qt::Vertical);    rightSplitter->addWidget(messagesTreeWidget);   //索引0    rightSplitter->addWidget(textEdit);             //索引1    rightSplitter->setStretchFactor(1, 1);          //索引为X的控件拉伸    QSplitter* mainSplitter = new QSplitter(Qt::Horizontal);    mainSplitter->addWidget(foldersTreeWidget);    mainSplitter->addWidget(rightSplitter);    mainSplitter->setStretchFactor(1, 1);    setCentralWidget(mainSplitter);

拉伸前：
  

拉伸后