Qt QDockWidget详解以及例程

Qt QDockWidget详解以及例程

  • 引言
  • 一、基本用法
  • 二、深入了解
    • 2.1 窗口功能相关
    • 2.2 停靠区域限制
    • 2.3 在主窗体布局

引言

在这里插入图片描述 在这里插入图片描述
QDockWidget类提供了一个可以停靠在QMainWindow内的小窗口 (理论上可以在QMainWindow中任意排列),也可以作为QMainWindow上的顶级窗口浮动 (类似一个独立的窗口,可以通过拖动操作将QDockWidget浮动到任何位置),也可以选择限制DockWidget移动、浮动和关闭的能力,以及它们可以放置的区域。

一、基本用法

  • 在QMainWindow中将QDockWidget绘制成均匀排列 (如上图所示),源码如下:
    ui->setupUi(this);
    QWidget *w = takeCentralWidget();
    delete w;

    // 创建
    QWidget *wid_a = new QWidget(this);
    wid_a->setStyleSheet("border: 2px solid #000000;");
    QDockWidget* dock_a = new QDockWidget(this);
    dock_a->setFeatures(QDockWidget::AllDockWidgetFeatures);
    dock_a->setWindowTitle("a");
    dock_a->setWidget(wid_a);

    QWidget *wid_b = new QWidget(this);
    wid_b->setStyleSheet("border: 2px solid #000000;");
    QDockWidget* dock_b = new QDockWidget(this);
    dock_b->setFeatures(QDockWidget::AllDockWidgetFeatures);
    dock_b->setWindowTitle("b");
    dock_b->setWidget(wid_b);

    QWidget *wid_c = new QWidget(this);
    wid_c->setStyleSheet("border: 2px solid #000000;");
    QDockWidget* dock_c = new QDockWidget(this);
    dock_c->setFeatures(QDockWidget::AllDockWidgetFeatures);
    dock_c->setWindowTitle("c");
    dock_c->setWidget(wid_c);

    QWidget *wid_d = new QWidget(this);
    wid_d->setStyleSheet("border: 2px solid #000000;");
    QDockWidget* dock_d = new QDockWidget(this);
    dock_d->setFeatures(QDockWidget::AllDockWidgetFeatures);
    dock_d->setWindowTitle("d");
    dock_d->setWidget(wid_d);

    // 布局
    addDockWidget(Qt::DockWidgetArea::LeftDockWidgetArea, dock_a);
    splitDockWidget(dock_a, dock_b, Qt::Orientation::Horizontal);
    splitDockWidget(dock_a, dock_c, Qt::Orientation::Vertical);
    splitDockWidget(dock_b, dock_d, Qt::Orientation::Vertical);

其他示例可参考:

  1. QDockWidget 用法示例代码QMainwindow:https://blog.csdn.net/lanmanck/article/details/122466337
  2. Qt之QDockWidget窗口详解—含演示Demo:https://blog.csdn.net/ManagerUser/article/details/124892827
  3. Qt QDockWidget嵌套布局详解-实现Visual Studio布局:https://www.cnblogs.com/ybqjymy/p/14577183.html

二、深入了解

只列举了相关常用函数,更多细节可参考官方文档。

2.1 窗口功能相关

    1. void setFeatures(QDockWidget::DockWidgetFeatures features)

设置QDockWidget的功能,是否可移动、可关闭和可浮动 (默认可以)。可传入的参数如下表所示:

常量
描述
QDockWidget::DockWidgetClosable0x01可关闭
QDockWidget::DockWidgetMovable0x02可移动
QDockWidget::DockWidgetFloatable0x04可浮动
QDockWidget::DockWidgetVerticalTitleBar0x08左侧显示垂直标题
QDockWidget::AllDockWidgetFeatures0x07可关闭、移动和浮动 (不建议使用)
QDockWidget::NoDockWidgetFeatures0x00无法关闭、移动和浮动
    1. QDockWidget::DockWidgetFeatures features() const可获取当前QDockWidget的DockWidgetFeatures ,并且当其DockWidgetFeatures 改变时,会发送featuresChanged信号,详见setFeatures函数部分源码:
void QDockWidget::setFeatures(QDockWidget::DockWidgetFeatures features)
{
    Q_D(QDockWidget);
    features &= DockWidgetFeatureMask;
    if (d->features == features)
        return;
    const bool closableChanged = (d->features ^ features) & DockWidgetClosable;
    d->features = features;
    QDockWidgetLayout *layout
        = qobject_cast<QDockWidgetLayout*>(this->layout());
    layout->setVerticalTitleBar(features & DockWidgetVerticalTitleBar);
    d->updateButtons();
    d->toggleViewAction->setEnabled((d->features & DockWidgetClosable) == DockWidgetClosable);
    emit featuresChanged(d->features);  // 发送信号
    ... 以下省略

2.2 停靠区域限制

    1. void setAllowedAreas(Qt::DockWidgetAreas areas)

设置可以放置QDockWidget的区域,默认为Qt::AllDockWidgetAreas.可传入的参数如下表所示:

常量
描述
Qt::LeftDockWidgetArea0x1可停靠左侧
Qt::RightDockWidgetArea0x2可停靠右侧
Qt::TopDockWidgetArea0x4可停靠上侧
Qt::BottomDockWidgetArea0x8可停靠下侧
Qt::AllDockWidgetAreasDockWidgetArea_Mask (0xf)哪都能停
Qt::NoDockWidgetArea0停靠不了一点
    1. Qt::DockWidgetAreas allowedAreas() const可获取当前QDockWidget的DockWidgetAreas,并且当其DockWidgetAreas改变时,会发送allowedAreasChanged信号。

2.3 在主窗体布局

这个用的比较多

    1. void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget)
      重载函数void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget, Qt::Orientation orientation),可修改方向,垂直 or 水平。

QDockWidget添加到指定区域 - 上下左右,其中参数是TopDockWidgetArea默认水平排列 (如下图所示),如果是LeftDockWidgetArea默认垂直排列。

在这里插入图片描述

addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_a);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_b);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_c);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_d);
    1. void QMainWindow::splitDockWidget(QDockWidget *first, QDockWidget *second, Qt::Orientation orientation)

将第一个QDockWidget 覆盖的空间分成两部分,分别放入两个QDockWidget (方向指定了QDockWidget的空间排列方式:设置为水平则第二个QDockWidget放置在第一个的右边;设置为垂直则将第二个dock小部件放在第一个下面)

    1. void QMainWindow::tabifyDockWidget(QDockWidget *first, QDockWidget *second)

合并窗口:将第二个QDockWidget嵌套合并到到第一个QDockWidget的位置,位置下方有标签可以切换显示的窗口。

在这里插入图片描述

addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_a);
tabifyDockWidget(dock_a, dock_b);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_c);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_d);
    1. void QMainWindow::setCorner(Qt::Corner corner, Qt::DockWidgetArea area)

指定某个DockWidgetArea的QDockWidget设置为占据给定的角 (就四个角,不展开描述了)。示例如下:

在这里插入图片描述 在这里插入图片描述
不加setCorner,后来加的两个(Top)窗口就把a b俩(left)窗口挤下去了,如果设置左侧停靠区域的窗口占据左上角,那么a b就到左上角,c d往右排. (实际使用,特别是存在大量窗口时用的比较少),具体布局代码如下所示:

addDockWidget(Qt::DockWidgetArea::LeftDockWidgetArea, dock_a);
addDockWidget(Qt::DockWidgetArea::LeftDockWidgetArea, dock_b);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_c);
addDockWidget(Qt::DockWidgetArea::TopDockWidgetArea, dock_d);

setCorner(Qt::TopLeftCorner, Qt::LeftDockWidgetArea);  // 加不加这行...
    1. void setDockNestingEnabled(bool enabled)

如果是false,则停靠区域只能包含一行(水平或垂直)QDockWidget,限制较大。如果是True则可随意摆放,自由度更高,但是操作会略复杂,将QDockWidget移动到另一个QDockWidget上可能会嵌套合并或者垂直 or 水平排列,需要更细致的操作…

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/951504.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

Spring——自动装配

假设一个场景&#xff1a; 一个人&#xff08;Person&#xff09;有一条狗&#xff08;Dog&#xff09;和一只猫(Cat)&#xff0c;狗和猫都会叫&#xff0c;狗叫是“汪汪”&#xff0c;猫叫是“喵喵”&#xff0c;同时人还有一个自己的名字。 将上述场景 抽象出三个实体类&…

MySQL安装,配置教程

一、Linux在线yum仓库安装 打开MySQL官方首页&#xff0c;链接为&#xff1a;https://www.mysql.com/ 界面如下&#xff1a; 在该页面中找到【DOWNOADS】选项卡&#xff0c;点击进入下载页面。 在下载界面中&#xff0c;可以看到不同版本的下载链接&#xff0c;这里选择【My…

上手体验微软全新整合的王炸平台Fabric

体验确实不错&#xff0c;微软强大的生态能力。 把可视化&#xff0c;数仓&#xff0c;数据胡&#xff0c;数据工厂&#xff0c;机器学习&#xff0c;数据监控等技术都整合到一个平台了。所有数据全都存储在统一的one lake数据中心&#xff0c;消除数据孤岛问题。而且不同角色可…

LabVIEW调用不定长数组 DLL数组

在使用 LabVIEW 调用 DLL 库函数时&#xff0c;如果函数中的结构体包含不定长数组&#xff0c;直接通过 调用库函数节点&#xff08;Call Library Function Node&#xff09; 调用通常会遇到问题。这是因为 LabVIEW 需要与 DLL 中的数据结构完全匹配&#xff0c;而包含不定长数…

重温设计模式--13、策略模式

策略模式介绍 文章目录 策略模式介绍C 代码示例 策略模式是一种行为设计模式&#xff0c;它允许在运行时选择算法的行为。该模式将算法的定义和使用分离开来&#xff0c;使得算法可以独立于使用它的客户端而变化&#xff0c;提高了代码的灵活性和可维护性。 其主要包含以下几个…

Bytebase 3.0.1 - 可配置在 SQL 编辑器执行 DDL/DML

&#x1f680; 新功能 新增环境策略&#xff0c;允许在 SQL 编辑器内直接执行 DDL/DML 语句。 支持为 BigQuery 数据脱敏。 在项目下新增数据访问控制及脱敏管理页面。 在数据库页面&#xff0c;支持回滚到变更历史的某个版本。 &#x1f514; 兼容性变更 禁止工单创建…

关机重启后,GitLab服务异常

整理机房,关闭了所有主机重新上架。 上架后开机,所有主机硬件启动正常。 其中一台GitLab服务器启动正常,使用gitlab-ctl status查看服务业正常。 但使用web登陆却失败,如下图: 反复测试,发现无论使用正确密码还是错误密码都是同样的提示。很大可能是数据库的问题。 使…

Python基于YOLOv8和OpenCV实现车道线和车辆检测

使用YOLOv8&#xff08;You Only Look Once&#xff09;和OpenCV实现车道线和车辆检测&#xff0c;目标是创建一个可以检测道路上的车道并识别车辆的系统&#xff0c;并估计它们与摄像头的距离。该项目结合了计算机视觉技术和深度学习物体检测。 1、系统主要功能 车道检测&am…

【算法】查找与排序

因文章篇幅有限&#xff0c;查找和排序分开写&#xff08;附代码与详细过程 注释详解&#xff09;&#xff0c;这篇文章主讲算法中的数据查找。 查找是数据结构中最基本的操作之一&#xff0c;用于从给定的数据集合中找到特定的目标数据。查找的效率直接影响程序的性能&#…

Linux环境中对Postgrel数据库的安装与配置

一、环境准备 linux操作系统的环境是centos7; Postgrel数据库的版本是12.0&#xff0c;不同版本的下载渠道如下&#xff08;PostgreSQL: File Browser&#xff09;&#xff1a; 可以看到压缩包是比较小的&#xff1b;下载之后&#xff0c;上传到你的linux环境中即可。 二、安…

基于vue的商城小程序的毕业设计与实现(源码及报告)

环境搭建 ☞☞☞ ​​​Vue入手篇(一)&#xff0c;防踩雷(全网最详细教程)_vue force-CSDN博客 目录 一、功能介绍 二、登录注册功能 三、首页 四、项目截图 五、源码获取 一、功能介绍 用户信息展示&#xff1a;页面顶部设有用户头像和昵称展示区&#xff0c;方便用户识别…

单元测试概述入门

引入 什么是测试&#xff1f;测试的阶段划分&#xff1f; 测试方法有哪些&#xff1f; 1.什么是单元测试&#xff1f; 单元测试&#xff1a;就是针对最小的功能单元&#xff08;方法&#xff09;&#xff0c;编写测试代码对其正确性进行测试。 2.为什么要引入单元测试&#x…

Springboot3巧妙运用拦截器阻断xss攻击

Springboot3巧妙运用拦截器阻断xss攻击 什么是xss跨站脚本攻击类型简单示例解决方法拦截器代码使用demo 什么是xss 人们经常将跨站脚本攻击&#xff08;Cross Site Scripting&#xff09;缩写为CSS&#xff0c;但这会与层叠样式表&#xff08;Cascading Style Sheets&#xff…

DAY39|动态规划Part07|LeetCode:198.打家劫舍、213.打家劫舍II、337.打家劫舍III

目录 LeetCode:198.打家劫舍 基本思路 C代码 LeetCode:213.打家劫舍II 基本思路 C代码 LeetCode:337.打家劫舍III 基本思路 C代码 LeetCode:198.打家劫舍 力扣题目链接 文字讲解&#xff1a;LeetCode:198.打家劫舍 视频讲解&#xff1a;动态规划&#xff0c;偷不偷这个…

数据结构——栈的实现

今天&#xff0c;我们来写一下关于栈的博文。 1.首先我们先了解一下什么是栈&#xff1f; 一&#xff1a;概念&#xff1a; 栈&#xff1a;一种特殊的线性表&#xff0c;其只允许在固定的一端进行插入和删除元素操作。 进行数据插入和删除操作的一端称为栈顶&#xff0c;另…

uniapp 的uni.getRecorderManager() 录音功能小记

官网上明确说的是全局唯一并且只是获取对象&#xff0c;所以会导致一个问题就是&#xff0c;当你多个页面要用到这个对象的时候&#xff0c;会发现 onStop 方法会被覆盖&#xff0c;导致调用结果不是自己想要的 解决办法也简单粗暴&#xff0c;在需要用到的界面重新覆盖onStop…

Unity:删除注册表内的项目记录

然后WinR按键输入regedit 打开注册表 在注册表 HKEY CURRENT USER—>SOFTWARE—>Unity—>UnityEditor—>DefaultCompany —>language_Test 中&#xff0c;删除我们的之前存储的语言环境数据。在 “ 三、文本调用和替换 ” 测试时已经将语言环境存储到注册表中了…

标准应用 | 2025年网络安全服务成本度量实施参考

01 网络安全服务成本度量依据相关新变化 为了解决我国网络安全服务产业发展中面临的服务供需两方对于服务成本组成认知偏差较大、网络安全服务成本度量缺乏依据的问题&#xff0c;中国网络安全产业联盟&#xff08;CCIA&#xff09;组织北京赛西科技发展有限责任公司、北京安…

微信小程序map组件所有markers展示在视野范围内

注意&#xff1a;使用include-points属性不生效&#xff0c;要通过createMapContext实现 <template><view class"map-box"><map id"map" class"map" :markers"markers" :enable-traffic"true" :enable-poi&…

PLC实现HTTP协议JSON格式数据上报对接的参数配置说明

IGT-SER系列PLC通讯智能网关支持HTTP协议GET和POST、PUT请求模式。支持JSON格式的文件&#xff0c;也可以实现WebService的调用。 通常智能网关是HTTP协议的客户端&#xff0c;也可以同时作为HTTP的服务端。相关案例 作为客户端时支持触发、周期、混合等多种工…