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

本文讲讲停靠窗口的使用吧，实例效果如下：

 

本实例实现的停靠窗口功能如下：停靠窗口1只可在主窗口的左边和右边停靠；停靠窗口2只可在浮动和在右部停靠两种状态间切换，并且不可移动；停靠窗口3可实现停靠窗口的各个状态。

 

=====================实现头文件dockWindows.h===================

#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();

}