Qt学习04：QWidget顶层窗口_qwidget置于顶层

文章首发于我的个人博客：欢迎大佬们来逛逛
完整Qt学习项目地址：源码地址

Qt学习04：QWidget顶层窗口

1. QWidget

QWidget类是所有可视控件的基类，控件是用户界面的最小元素，用于接受各种事件(如：鼠标、键盘等)并且绘制出来给用户观看。

每个控件都是矩形的，他们按照Z轴顺序排列。

如果控件没有父控件，则称之为窗口，窗口会被一个框架包裹(包含标题栏，边框等)，可以通过某些函数来修改边框属性。

窗口几何

Window and Dialog Widgets

QWidget提供了几个处理小部件几何形状的函数。其中一些函数操作在纯客户区(即不包括窗框的窗口)上，其他函数包括窗框。区分的方式是透明地涵盖最常见的用法。

• 包含窗口边框：x()，y()，frameGeometry()，pos()，and move()
• 不包含窗口边框：geometry()， width()，height()， rect()，and size()

注意，这种区别只对顶级小部件有意义。对于所有子小部件，frame geometry等于小部件的客 client geometry。

大小位置

获取坐标和大小

//包含窗口边框
int x() const
int y() const
QPoint pos() const
//不包含窗口边框

int width() const
int height() const
QSize size() const

const QRect &geometry() const
QSize frameSize() const
QRect frameGeometry() const
//控件内部几何QRect(0,0,width(),height())
QRect rect() const
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

设置坐标和大小

void move(const QPoint &)
void move(int x, int y)

void resize(int w, int h)
void resize(const QSize &)

void setGeometry(const QRect &)
void setGeometry(int x, int y, int w, int h)
1
2
3
4
5
6
7
8

固定大小

void setFixedSize(const QSize &s)
void setFixedSize(int w, int h)
1
2

大小限定

去掉set就是获取函数

void setMaximumWidth(int maxw)
void setMaximumHeight(int maxh)
void setMaximumSize(const QSize &)
void setMaximumSize(int maxw, int maxh)

void setMinimumWidth(int minw)
void setMinimumHeight(int minh)
void setMinimumSize(const QSize &)
void setMinimumSize(int minw, int minh)
1
2
3
4
5
6
7
8
9

---

坐标系统转换

QPoint mapFrom(const QWidget *parent, const QPoint &pos) const
QPoint mapFromGlobal(const QPoint &pos) const
QPoint mapFromParent(const QPoint &pos) const
QPoint mapTo(const QWidget *parent, const QPoint &pos) const
QPoint mapToGlobal(const QPoint &pos) const
QPoint mapToParent(const QPoint &pos) const
1
2
3
4
5
6

• 这几个函数都是转换相对坐标系用的. 用另一个坐标系统的坐标值, 来表达当前坐标系统中某个坐标所指向的某个点,

  记住: 一定要先确两个坐标系统再确定一个点

• 相对坐标：获取自己相对于父控件的位置 QWidget::pos()

• 绝对坐标：将当前控件的相对位置转换为屏幕绝对位置 QWidget::mapToGlobal()

• 绝对坐标转为相对坐标：将屏幕绝对位置对应到控件的相对位置 QWidget::mapFromGlobal()

内容边距

设置小部件内容周围的空白，使其具有左、上、右和下的大小。边距被布局系统使用，并且可以被子类用来指定要绘制的区域(例如，不包括框架)。

void setContentsMargins(int left, int top, int right, int bottom)
void setContentsMargins(const QMargins &margins)
QMargins contentsMargins() const
//获取内容区域(除去边距)
QRect contentsRect() const
1
2
3
4
5
6

案例：创建一个窗口，包含一个标签，标签内容为"社会我顽哥，人狠话不多 "，标签大小为300x300，让内容放在标签的右下角。

鼠标指针

指针形状

QCursor cursor() const
void setCursor(const QCursor &)
void unsetCursor()
1
2
3

如果要全局设置鼠标光标样式，可以使用QGuiApplication::setOverrideCursor()， 设置鼠标指针的形状需要使用QCursor类，通过像素图或枚举指定鼠标光标形状。

QCursor

 QCursor(const QPixmap &pixmap, int hotX = -1, int hotY = -1)
 QCursor(const QBitmap &bitmap, const QBitmap &mask, int hotX = -1, int hotY = -1)
 QCursor(Qt::CursorShape shape)
1
2
3

QCursor提供了获取/设置鼠标全局坐标的静态方法。

[static] QPoint pos()
[static] QPoint pos(const QScreen *screen)
[static] void setPos(int x, int y)
[static] void setPos(QScreen *screen, int x, int y)
[static] void setPos(const QPoint &p)
[static] void setPos(QScreen *screen, const QPoint &p)
1
2
3
4
5
6

顶层窗口相关

图标

void setWindowIcon(const QIcon &icon)
QIcon windowIcon() const
1
2

标题

QString windowTitle() const
void setWindowTitle(const QString &)
1
2

窗口标题附加操作！

void setWindowModified(bool)
1

此属性保存窗口中显示的文档是否有未保存的更改。

修改后的窗口是指内容已更改但尚未保存到磁盘的窗口。这个标志将根据平台的不同而有不同的效果。在macOS上关闭按钮会有一个修改过的外观；在其他平台上，窗口标题将带有“*”(星号)。

窗口标题必须包含“[]”占位符，它指示“”应该出现的位置。通常，它应该出现在文件名后面(例如，“document1.txt[*] -文本编辑器”)。如果窗口没有被修改，占位符就会被删除。

注意，如果一个小部件被设置为已修改，那么它的所有祖先也将被设置为已修改。但是，如果在一个小部件上调用setWindowModified(false)，这将不会传播到它的父组件，因为父组件的其他子组件可能已经被修改了。

如果你想要在窗口标题后面显示，应用程序名称，可以使用以下函数。(这个不算标题的一部分)

[static]void QGuiApplication::setApplicationDisplayName(const QString &name)
1

不透明度

void setWindowOpacity(qreal level)
qreal windowOpacity() const
1
2

窗口状态

Qt::WindowStates windowState() const
void setWindowState(Qt::WindowStates windowState)
bool isActiveWindow()       //是否为活跃窗口
1
2
3

如果窗口不可见(即isVisible()返回false)，当show()被调用时窗口状态才生效。对于可见的窗口，会立即生效。例如，要在全屏模式和普通模式之间切换，使用以下代码:

 w->setWindowState(w->windowState() ^ Qt::WindowFullScreen);
1

为了恢复和激活最小化的窗口(同时保持其最大化和/或全屏状态)，请使用以下命令:

 w->setWindowState((w->windowState() & ~Qt::WindowMinimized) | Qt::WindowActive);
1

最大化最小化

void showFullScreen()
void showMaximized()
void showMinimized()
void showNormal()

bool isMaximized() const
bool isMinimized() const
bool isFullScreen() const
1
2
3
4
5
6
7
8

窗口标志

常用标志详见 附录1

void overrideWindowFlags(Qt::WindowFlags flags)

void setWindowFlag(Qt::WindowType flag, bool on = true)
void setWindowFlags(Qt::WindowFlags type)
Qt::WindowFlags windowFlags() const
1
2
3
4
5

交互状态

是否禁用

void setDisabled(bool disable)
void setEnabled(bool)
bool isEnabled() const
bool isEnabledTo(const QWidget *ancestor) const
1
2
3
4

是否显示/隐藏

virtual void setVisible(bool visible)
1

setVisible的马甲

void show()
void hide()
void setHidden(bool hidden)
1
2
3

判断是否可见

bool isVisible() const
bool isHidden() const
bool isVisibleTo(const QWidget *ancestor) const    //如果能随着widget控件的显示和隐藏, 而同步变化, 则返回true
1
2
3

帮助系统

Help System

toolTip

当鼠标悬停在空间上时，会在鼠标旁边显示"工具提示"

void setToolTip(const QString &)
QString toolTip() const

void setToolTipDuration(int msec)
int toolTipDuration() const
1
2
3
4
5

whatsThis

切换到whatsThis模式，鼠标点击控件会显示"这是啥提示"

void setWhatsThis(const QString &)
QString whatsThis() const
1
2

• 先创建三个按钮

  QPushButton*btn1 = new QPushButton("open",this);
  QPushButton*btn2 = new QPushButton("new",this);
  QPushButton*btn3 = new QPushButton("look",this);
  btn2->move(100,0);
  btn3->move(200,0);
  
  btn1->setToolTip("打开文件");
  btn1->setWhatsThis("open a new file");
  
  btn2->setToolTip("新建文件");
  btn2->setWhatsThis("create a new file");
  
  btn3->setToolTip("查看");
  btn3->setWhatsThis("查看其他按钮的详细信息");
  
  connect(btn3,&QPushButton::clicked,this,[=]()
  {
      QWhatsThis::enterWhatsThisMode();
  });
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19

• 运行程序后按Shift + F1会出现当前获得焦点的widget的whatsThis信息

• 调用QWhatsThis的静态函数enterWhatsThisMode进入whatsThis模式，此时当鼠标移动到设置了whatsThis的widget上光标会出现一个问号，再点击则会出现whatsThis的窗口。

父子关系

返回控件坐标系中位置(x, y)处的可见子控件，没有则返回nullptr。

QWidget *childAt(int x, int y) const
QWidget *childAt(const QPoint &p) const
1
2

返回包裹所有子控件的矩形(隐藏的控件除外)

QRect childrenRect() const
QRegion childrenRegion() const
1
2

返回父控件

QWidget *parentWidget() const
1

层级控制

void lower()    //将控件降低到父控件堆栈的底部
void raise()    //将控件提升到父控件堆栈顶部
void stackUnder(QWidget *w) //将控件放在w控件下面。控件本身和w必须是兄弟姐妹。
1
2
3

焦点控制

单个控件

void setFocus(Qt::FocusReason reason)
void clearFocus()
Qt::FocusPolicy focusPolicy() const
1
2
3

多个子控件

QWidget *focusWidget() const
bool focusNextChild()
bool focusPreviousChild()
virtual bool focusNextPrevChild(bool next)
[static] void setTabOrder(QWidget *first, QWidget *second)
1
2
3
4
5

设置exe图标

设置完窗口图标之后，我们可能需要设置可执行程序exe文件的图标，这个稍微麻烦一点点，但是也是三步搞定，走起！

• 1，创建一个图标格式(ico)的文件，可以将一个普通的图片转成.ico格式的图标文件，图片格式在线转换

• 2，将转换好的ico文件放到源文件所在目录，即和CMakeLists.txt文件同级目录，并创建名为icon.rc的文件，写入如下内容。

  IDI_ICON1 ICON DISCARDABLE "zay.ico"
  1

• 3，最后在CMakeLists.txt中添加如下命令

  aux_source_directory(. MY_SCOURCES)
  add_executable(QtTest ${MY_SCOURCES} "icon.rc")
  1
  2

最后重新运行程序，找到exe，完成！

设置窗口属性

• setAttribute用来设置小部件的属性，testAttribute查看是否设置了某种属性。

常用属性

Qt部署应用程序发布包

windeployqt.exe是Qt自带的工具，用于创建应用程序发布包。 简单来说，这个工具可以自动地将某程序依赖的库、资源拷贝到其所在目录，防止程序在其他电脑上运行报找不到库的错误。

原理

windeployqt.exe工作原理很简单，它会到当前的环境变量PATH配置的搜索路径中，查找应用程序所需要的库和资源，拷贝到应用程序目录中。

使用

• 先从开始菜单中打开**「对应版本的Qt」**的命令行终端界面，如下图：

• 然后再命令行中输入windeployqt AppName ，AppName表示应用程序完整路径；

  我们知道，Qt项目路径不能包含中文，所以为了保险起见，应用程序路径中不要包含中文。另外，如果应用程序路径中包含空格，需要用双引号将整个路径字符串包裹起来。

注意坑

大体上的流程只有这两步。 整个发布过程看似比较简单，但是其中还是存在一些坑的。

坑点一：未使用Qt的命令行终端执行发布命令，导致库版本拷贝错误

坑点二：未使用与Qt版本对应的windeployqt.exe

坑点三：发布时，默认文件不会覆盖

如果已经存在同名的文件，则不会自动覆盖，可以通过添加强制覆盖参数–force强制覆盖已存在的文件。

windeployqt --force D:\test\maye.exe
1

**注意点：**命令行在启动是，会有一行提示,记得调用vcvarsall.bat来完成环境设置!

意思是说，我们还没有运行vcvarsall.bat，所以VS的环境变量没有配置好，因此不会拷贝VS相关的依赖库。

vcvarsall.bat是VS自带的配置环境变量的批处理文件。它的位置取决你的安装位置，我的在D:\MySoftWare\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build下，接下来就尝试运行vcvarsall.bat来配置一下VS的环境。

maye> D:\MySoftWare\\"Microsoft Visual Studio\"\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat

maye>windeployqt F:\MyCode\QtTest.exe
1
2
3

这样发布出来的目录就带上了VS的依赖库，拷贝到没有安装VS的电脑上亦可以运行。

2. 资源文件 .qrc

需要我们给窗口设置图标

// 弊端: 发布的exe 必须要加载 d:\\pic\\1.ico 如果对应的目录中么有图片, 图标就无法被加载
//          发布exe 需要额外发布图片, 将其部署到某个目录中
setWindowIcon(QIcon("d:\\pic\\1.ico"));
1
2
3

使用资源文件解决上述的弊端:

优势:

1. 将图片资源放到资源文件
2. 当程序编译的时候, 资源文件中的图片会被转换为二进制, 打包到exe中
3. 直接发布exe就可以, 不需要额外提供图片资源了

在VS中使用资源文件，需要安装Vs的Qt插件，具体操作如下。

2.1.打开VS

选择菜单栏->扩展->管理扩展

2.VS安装Qt插件

选择菜单栏的 扩展->管理扩展，输入Qt搜索，然后下载Qt Visual Studio Tools（下载灰常的银杏，慢的死~还不一定能下载）

如果实在不能忍受这龟速，咱们来别的办法

先到Qt官网下载对于版本的插件，我这里是VS2022：

Qt官网插件下载

如果跳到如下页面，选择清华大学镜像源下载即可。

3.安装VSIX(即上面下载的那个插件)

如果是通过Vs下载的，会自动安装。

如果是手动下载的，需要双击自己安装。

打开安装包之后，点击Install等待安装完成即可。

安装之前，请先关掉Vs没有关掉会出现如下界面，点击end tasks即可

关闭Vs之后，一秒安装完成

安装完成，关掉程序

附录一

• 此枚举类型用于为小部件指定各种窗口系统属性。 它们相当不寻常，但在少数情况下是必要的。 其中一些标志取决于底层窗口管理器是否支持它们。

• 窗口提示可以有多个(不一定会生效，看平台是否支持)

附录二

• 窗口状态 Qt::WindowState