[toc]

QDockWidget充当它的子控件的容器，其尺寸设置由其子控件决定，QDockWidget本身不做尺寸大小方面的设置。

QMainWindow提供了一系列函数来管理和操控QDockWidget：

• addDockWidget()： 添加一个给定的停靠窗口到指定区域；
• splitDockWidget()： 把两个dock进行左右或上下并排布置，做成一个类似QSplitter的功能；
• tabifyDockWidget()： 移动第二个停靠窗口到第一个停靠窗口，可以在主窗口中生成一个标签样式的停靠窗口；
• tabifiedDockWidgets()： 返回和指定停靠窗口形成标签样式的停靠窗口列表；
• removeDockWidget()： 从主窗口布局中移除停靠窗口，并隐藏它，注意，停靠窗口并不会被删除；
• restoreDockWidget()： 恢复停靠窗口的状态；
• dockWidgetArea()： 返回指定停靠窗口的停靠区域，返回值为Qt. DockWidgetArea的相关取值；
• resizeDocks()： 改变指定停靠窗口列表的尺寸；
• setDockNestingEnabled ()： 设置停靠窗口是否可以嵌套；
• isDockNestingEnabled()： 返回停靠窗口是否有可嵌套的特性；
• setDockOptions()： 设置停靠窗口的停靠属性,取值见QMainWindow. DockOption；
• dockOptions()： 获得停靠窗口的停靠属性。

Qt. DockWidgetArea取值列表:

• LeftDockWidgetArea： 窗口可在左侧停靠；
• RightDockWidgetArea： 窗口可在右侧停靠；
• TopDockWidgetArea： 窗口可在顶端停靠；
• BottomDockWidgetArea： 窗口可在底端停靠；
• AllDockWidgetArea： 窗口可在任意方向停靠；：
• NoDockWidgetArea： 只可停靠在插入处。

QMainWindow. DockOption取值列表：

• AnimatedDocks： 动画方式停靠；
• AllowNestedDocks： 允许嵌套；
• AllowTabbedDocks： 允许标签页方式停靠；
• ForceTabbedDocks： 强制标签页方式停靠；
• VerticalTabs： 垂直标签页方式；
• GroupedDragging： 允许成组拖动标签页停靠窗口。

QMainWindow中关于停靠窗口操作的相关信号：

• tabifiedDockWidgetActivated： 选中标签停靠区中的停靠窗口并激活时发射该信号。

QDockWidget常用方法有：

• setFeatures()： 设置停靠窗口的属性，取值见QDockWidget. DockWidgetFeature；
• features()： 获得停靠窗口的特性设置；
• setFloating()： 设置停靠窗口是否可浮动；
• isFloating()： 获得停靠窗口的可浮动属性；
• setAllowedAreas()： 设置允许停靠的区域，取值为Qt. DockWidgetArea相关取值；
• allowedAreas()： 获得停靠窗口允许停靠的区域；
• setTitleBarWidget()： 设置停靠窗口标题栏部件；
• titleBarWidget()： 获得停靠窗口标题栏部件。

QDockWidget. DockWidgetFeature取值列表:

• DockWidgetClosable： 允许关闭，在一些系统上会显示一个关闭按钮；
• DockWidgetMovable： 允许在Dock之间移动；
• DockWidgetFloatable： 允许作为一个独立窗口浮动；
• DockWidgetVerticalTitleBar： 在Dock左侧显示一个垂直标题栏；
• NoDockWidgetFeatures： 无具体特性设置，无法关闭、移动或者浮动。

QDockWidget常用信号：

• featuresChanged： 停靠窗口的特性发生了改变时发射该信号；
• topLevelChanged： 停靠窗口的浮动属性发生了改变时发射该信号；
• allowedAreasChanged： 停靠窗口的允许停靠区域发生了改变时发射该信号；
• visibilityChanged： 停靠窗口的可视属性(显示/隐藏)发生改变时发射该信号；
• dockLocationChanged： 停靠窗口的位置发生了改变时发射该信号。

QDockWidget类继承关系：