08.QT控件：QWidget

一、Widget 简介

Widget 是 Qt 中的核⼼概念.。英⽂原意是 "小部件"，我们此处也把它翻译为 "控件"。控件是构成⼀个图形化界⾯的基本要素。

Qt 作为⼀个成熟的 GUI 开发框架, 内置了⼤量的常⽤控件。并且 Qt 也提供了 "⾃定义控件" 的能⼒，可以让开发者在现有控件不能满⾜需求的时候, 对现有控件做出扩展,，或者⼿搓出新的控件。

二、QWidget介绍

1. 简介

在 Qt 中, 使⽤ QWidget 类表⽰ "控件"，像按钮、视图、输⼊框、滚动条等具体的控件类，都是继承⾃ QWidget.。可以说， QWidget 中就包含了 Qt 整个控件体系中通⽤的部分。

2. 常用核心属性介绍

2.1 enabled

• 所谓 “禁用” 指的是该控件不能接收任何用户的输⼊事件，并且外观上往往是灰⾊的。

• 如果⼀个 widget 被禁用，则该 widget 的子元素也被禁用。

2.2 geometry

• x 横坐标

• y 纵坐标

• width 宽度

• height ⾼度

2.3 window frame的影响

（1）window frame简介

window frame（窗口框架）通常指的是窗口的外部边框部分，包括窗口的标题栏、边框和窗口控制按钮（最小化、最大化、关闭按钮等）

（2）window frame的影响

如果 widget 作为⼀个窗⼝ (带有标题栏，最⼩化，最⼤化，关闭按钮)，那么在计算尺⼨和坐标的时候就有两种算法，包含 window frame 和不包含 window frame：

其中 x()，y()，frameGeometry()，pos()，move() 都是按照包含 window frame 的⽅式来计算的。

其中 geometry()，width()，height()，rect()，size() 则是按照不包含 window frame 的⽅式来计算的。

当然, 如果⼀个不是作为窗⼝的 widget , 上述两类⽅式得到的结果是⼀致的。

2.4 windowTitle

注意：上述设置操作针对不同的 widget 可能会有不同的⾏为。如果是顶层 widget (独⽴窗⼝)，这个操作才会有效，如果是子widget，这个操作⽆任何效果。

2.5 windowIcon

注意：同 windowTitle，上述操作仅针对顶层 widget 有效。

2.5.1 QIcon图标类

QIcon是 Qt 中用于表示图标的类。它用于加载、显示和管理图标，可以在按钮、工具栏、菜单等各种用户界面元素中使用。

（1）建议在栈上创建：QIcon本身是一个比较小的对象，创建目的是为了设置到某个QWidget内，QIcon本身是否释放不会影响图标最终的显示。

（2）QIcon不支持对象树机制，无法为其挂载父对象。

（3）创建方式：QIcon icon("图片路径")；路径不要带中文；使用'/'或'\\'作为路径分隔。

2.5.2 qrc机制

使用QIcon("图片路径")加载图标，存在两个问题：

（1）需要确保图片所在的路径在目标用户机上存在；

（2）需要确保图片不会被丢失；

qrc机制就是从根本上解决上述两个问题：

（1）给项目引入一个额外的xml文件（后缀名使用.qrc表示）；

（2）在这个xml中将要使用的图片导入进来，并在xml中进行记录；

（3）QT在编译项目时，会根据qrc中描述的图片信息，找到图片内容并取出图片的二进制数据；

（4）将二进制数据转换为C++代码，编译到最终的.exe中；

qrc缺点：

（1）无法导入太大的资源文件；

（2）使.exe程序更大；

qrc使用示例：

（1）新建Qt Resource File

（2）将图片导入qrc文件中

1）创建“前缀”（Prefix）

所谓的“前缀”可以理解为虚拟的目录，这个目录并没有在电脑上真实存在，而是由Qt抽象出来。

2）将图片导入到资源文件中

注意：需要确保导入的图片必须在.qrc文件的同级目录，或同级目录中的子目录中。看到如图中所示的虚拟目录和图片，则说明导入成功。

（3）使用qrc文件中的图片数据

图片加载路径使用':'开头，即表示使用qrc中的图片资源。

此时我们查看编译生成的文件中，并没有该图片，但是会多出一个qrc_xxxxx.cpp文件：

打开这个文件，能够看到一个qt_resource_data数组，里面存储的就是Title1.jpg这个图片每个字节数据：

当Qt项目进行编译时，这个cpp文件就会被一起编译到exe程序中，当exe程序运行时，图片数据也就同步被加载到了内存中，避免资源丢失情况。

2.6 windowOpacity(透明度)

写一个简单的程序，每次减少或增加0.1不透明度，通过QDebug输出每次修改后的界面不透明度，会发现得到类似以下结果：

（1）增加到1时，继续增加将会维持为1不再改变；减少到0后，继续减少将会维持为0不再改变；

（2）真实的数值并没有严格的减少或增加0.1(C++中float类型遵守IEEE 754标准，存储和计算导致的精度丢失)

2.7 cursor(鼠标光标)

（1）通过ui界面修改控件cursor属性

（2）通过代码修改控件cursor属性

Qt中内置的光标：

（3）设置自定义光标

①将图片导入qrc资源文件（参考2.5.2qrc机制）

②访问到图片：

Qt中存在多种表示图片的对象，这里以QPixmap为例: QPixmap pixmap(":/image1.jpg");。

③使用图片构造QCursor对象： QCursor cursor(pixmap);。

注意：此时鼠标点击生效位置默认是图片的左上角

④设置光标热点位置： QCursor customCursor(cursorPixmap, hotX, hotY);

热点：鼠标点击时，鼠标图标的响应位置

hotX、hotY是热点相对于图标左上角原点位置，单位为像素

其他可控操作：
①缩放图片大小
QPixmap pixmap(":/image1.jpg");
pixmap = pixmap.scaled(100, 100);
注意：缩放不是修改图片本身，而是返回一个新的图片副本，所有需要重新赋值。

②免费图标获取推荐：阿里巴巴矢量图标库