《ASCE1885的Qt学习记录》の停靠窗口

#ifndef DOCKWINDOWS_H
#define DOCKWINDOWS_H
#include <QtGui/QMainWindow>
class DockWindows : public QMainWindow
{

Q_OBJECT
public:
    DockWindows(QWidget *patent=0);
};
#endif // DOCKWINDOWS_H
 
====================实现源文件dockWindows.cpp===================
#include "dockwindows.h"
#include <QtGui/QTextEdit>
#include <QtGui/QDockWidget>
DockWindows::DockWindows(QWidget *parent)
    :QMainWindow(parent)
{
    setWindowTitle(tr("DockWindows"));
    QTextEdit *te = new QTextEdit(this);
    te->setText(QString::fromLocal8Bit("主窗口"));
    te->setAlignment(Qt::AlignCenter);
    setCentralWidget(te);
    //停靠窗口1
    QDockWidget *dock = new QDockWidget(QString::fromLocal8Bit("停靠窗口1"), this);
    dock->setFeatures(QDockWidget::DockWidgetMovable);
    dock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);
    QTextEdit *te1 = new QTextEdit();
    te1->setText(QString::fromLocal8Bit("窗口1"));
    dock->setWidget(te1);
    addDockWidget(Qt::RightDockWidgetArea, dock);
    //停靠窗口2
    dock = new QDockWidget(QString::fromLocal8Bit("停靠窗口2"), this);
    dock->setFeatures(QDockWidget::DockWidgetFloatable | QDockWidget::DockWidgetClosable);
    QTextEdit *te2 = new QTextEdit();
    te2->setText(QString::fromLocal8Bit("窗口2"));
    dock->setWidget(te2);
    addDockWidget(Qt::RightDockWidgetArea, dock);
    //停靠窗口3
    dock = new QDockWidget(QString::fromLocal8Bit("停靠窗口3"),this);
    dock->setFeatures(QDockWidget::AllDockWidgetFeatures);
    QTextEdit *te3 = new QTextEdit();
    te3->setText(QString::fromLocal8Bit("窗口3"));
    dock->setWidget(te3);
    addDockWidget(Qt::BottomDockWidgetArea, dock);
}
 
由上面代码可以看出，设置停靠窗口的一般步骤是：
1）  创建一个QDockWidget对象的停靠窗体；
2） 设置此停靠窗体的属性，通常调用setFeatures()及setAllowedAreas()两种方法；
3） 新建一个要插入停靠窗体的控件，常用的一般为QListWidget和QTextEdit；
4） 把控件插入停靠窗体中，调用QDockWidget的setWidget()方法；
5） 使用addDockWidget()方法在QMainWindow中加入此停靠窗体。
 
其中，setAllowedAreas()方法设置停靠窗体可停靠的区域，原型如下：
void setAllowedAreas (Qt::DockWidgetAreas areas)
其中参数Qt::DockWidgetAreas指定了停靠窗体可停靠的区域，包括以下几种：
Qt::LeftDockWidgetArea          //左侧停靠
Qt::RightDockWidgetArea  //右侧停靠
Qt::TopDockWidgetArea          //顶端停靠
Qt::BottomDockWidgetArea //底部停靠                    
Qt::AllDockWidgetAreas           //任意(以上四个)部位停靠
Qt::NoDockWidgetArea       //只可停靠在插入处
 
setFeatures()方法设置停靠窗体的特性，原型如下：
void  setFeatures(DockWidgetFeatures features)
参数QDockWidget::DockWidgetFeatures指定停靠窗体的特性，包括以下几种：
QDockWidget::DockWidgetClosable    //停靠窗可关闭
QDockWidget::DockWidgetMovable     //停靠窗可移动
QDockWidget::DockWidgetFloatable   //停靠窗可浮动
QDockWidget::AllDockWidgetFeatures //拥有停靠窗的所有特性
QDockWidget::NoDockWidgetFeatures  //停靠窗不可移动、不可关闭、不可浮动
 
========================工程pro文件========================
#-------------------------------------------------
#
# Project created by QtCreator 2010-08-17T22:46:43
#
#-------------------------------------------------
QT       += core
TARGET = DockWindows
CONFIG   += windows
CONFIG   -= app_bundle
TEMPLATE = app
SOURCES += main.cpp /
    dockwindows.cpp
HEADERS += /
    dockwindows.h
 
=======================main函数===========================
#include <QtGui/QApplication>
#include "dockwindows.h"
int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    DockWindows window;
    window.show();
    return app.exec();
}