(十七)QDockWidget详解

转自:http://blog.csdn.net/chenlong12580/article/details/9051847

作者:chenlong12580

 QDockWidget类详解

【详细描述】

QDockWidget类提供了一个特殊的窗口部件，它可以是被锁在QMainWindow窗口内部或者是作为顶级窗口悬浮在桌面上。
QDockWidget类提供了dock widget的概念，dock widget也就是我们熟悉的工具面板或者是工具窗口。Dock window是放置在
QMindow窗口周围的dock widget区域中的。

如下图所示：

Dock windows可以在几个区域中移动，或者是悬浮。该类提供的API允许程序员限制dock widgets的移动，悬浮和关闭，以及它
可以被放置的区域。

【外观】

一个QDockWidget包含一个小的工具栏和内容区域。小的工具栏用于显示窗口标题，一个浮动按钮和一个关闭按钮。取决于QDockWidget的状态，浮动按钮和关闭按钮可能或者禁止或者完全不显示。

工具栏和按钮的显示取决于你所使用的样式。

QDockWidget可以作为它子窗口部件的封装，通过setWidget()设置子窗口部件。自定义的尺寸提示，最小和最大化尺寸已经尺寸策略都必须由子窗口部件来实现。QDockWidget会遵守它们，调整它自己的限制包括框架和工具栏。我们不应该为QDockWidget设置尺寸限制，因为它们根据QDockWidget是否锁住而改变，一个锁住的QDockWidget窗口部件不包括框架和小的工具栏。

【类详解】

1、QDockWidget对象包含一些特性，例如：移动、悬浮、关闭等等，这些都是枚举类型：

2、QDockWidget可以放置的位置，也是枚举类型：

3、成员函数：void QDockWidget::setTitleBarWidget(QWidget * widget)

设置任意的widget作为dock widget的工具栏。如果widget设置为0，那么之前在dock widget上设置的任意自定义工具栏都会被清除，但是不是删除，并且会使用默认的工具栏。
如果我们为工具栏设置了widget，那么当它悬浮的时候，QDockWidget不会使用本地窗口装饰它。
下面是对实现自定义的工具栏的一些建议：
*那些不是明确由工具栏处理的鼠标事件应该通过调用QMouseEvent::ignore()函数忽略掉。这些事件就会传递给QDockWidget，由
QDockWidget按照常规的方式处理。拖动鼠标的时候就移动，双击的时候就锁住/解锁等等。
*当为QDockWidget设置了DockWidgetVerticalTitleBar时，那么工具栏窗口部件就会相应的放置在新的位置上。在resizeEvent()中
，工具栏必须检查放置的方向：
QDockWidget *dockWidget = qobject_cast<QDockWidget*>(parentWidget());
if (dockWidget->features() & QDockWidget::DockWidgetVerticalTitleBar) {
    // I need to be vertical
} else {
    // I need to be horizontal
}
*工具栏widget必须包含有合法的QWidget::sizeHint()和QWidget::minimumSizeHint()。这些方法必须考虑工具栏放置的方向。
*从一个锁定的widget中移除工具栏是不可能的。然而，我们可以通过将默认构造的QWidget作为工具栏widget来达到这种效果。

4、成员函数：void QDockWidget::setWidget(QWidget * widget)

当widget添加的时候，如果dock widget是可见的，那么你就需要显示的调用show()函数。

在调用这个函数之前，你必须先添加widget的布局，否则，添加的widget就是不可见的。

【示例1】

{效果}

{实现}

【示例2】

{效果}

{实现}

这里的dockwidget较之前的要丰富得多，是因为自定义了类ColorSwatch，该类继承自QDockWidget：

[cpp]  view plain  copy

1. <span style="font-family:Verdana;font-size:14px;">class ColorSwatch : public QDockWidget  
2. {  
3.     Q_OBJECT  
4.   
5.     QAction *closableAction;  
6.     QAction *movableAction;  
7.     QAction *floatableAction;  
8.     QAction *floatingAction;  
9.     QAction *verticalTitleBarAction;  
10.   
11.     QActionGroup *allowedAreasActions;  
12.     QAction *allowLeftAction;  
13.     QAction *allowRightAction;  
14.     QAction *allowTopAction;  
15.     QAction *allowBottomAction;  
16.   
17.     QActionGroup *areaActions;  
18.     QAction *leftAction;  
19.     QAction *rightAction;  
20.     QAction *topAction;  
21.     QAction *bottomAction;  
22.   
23.     QAction *changeSizeHintsAction;  
24.   
25.     QMenu *tabMenu;  
26.     QMenu *splitHMenu;  
27.     QMenu *splitVMenu;  
28.   
29.     QAction *windowModifiedAction;  
30.   
31. public:  
32.     explicit ColorSwatch(const QString &colorName, QWidget *parent = 0, Qt::WindowFlags flags = 0);  
33.   
34.     QMenu *menu;  
35.     void setCustomSizeHint(const QSize &size);  
36.   
37. protected:  
38.     virtual void contextMenuEvent(QContextMenuEvent *event);  
39.     virtual void resizeEvent(QResizeEvent *e);  
40.   
41. private:  
42.     void allow(Qt::DockWidgetArea area, bool allow);  
43.     void place(Qt::DockWidgetArea area, bool place);  
44.   
45. private slots:  
46.     void changeClosable(bool on);  
47.     void changeMovable(bool on);  
48.     void changeFloatable(bool on);  
49.     void changeFloating(bool on);  
50.     void changeVerticalTitleBar(bool on);  
51.     void updateContextMenu();  
52.   
53.     void allowLeft(bool a);  
54.     void allowRight(bool a);  
55.     void allowTop(bool a);  
56.     void allowBottom(bool a);  
57.   
58.     void placeLeft(bool p);  
59.     void placeRight(bool p);  
60.     void placeTop(bool p);  
61.     void placeBottom(bool p);  
62.   
63.     void splitInto(QAction *action);  
64.     void tabInto(QAction *action);  
65. };</span>  

我们来看看它的构造函数：

    explicit ColorSwatch(const QString &colorName, QWidget *parent = 0, Qt::WindowFlags flags = 0);

这里我们比较关注的是第一个参数，dockwidget的颜色，这一点从前面的运行效果也可以看出来，然后比较关注的就是第三个参数，主要设置QDockWidget的一些标志，我们可以看看它的实例化：

再来看看在自定义的类中定义了不少QAction，这些是上下文菜单中使用的，如下图，具体的使用方式就是根据QDockWidget的features()函数判断某些特性是否选中：

最后，我们还是用了之前介绍QDockWidget类时重点提到的两个函数：

(1)setWidget()

(2)setTitleBarWidget()

QMainWindow默认是把dock嵌套关闭的，即拖动QDockWidget时不能将被拖动的QDockWidget放到两个QDockWidget中间，通过QMainWindow成员函数,将参数设置为true解决此问题:

void QMainWindow::setDockNestingEnabled ( bool enabled )