【Qt 学习笔记】QWidget的windowOpacity属性 | cursor属性 | font属性

---

• 博客主页：Duck Bro 博客主页
• 系列专栏：Qt 专栏
• 关注博主，后期持续更新系列文章
• 如果有错误感谢请大家批评指出，及时修改
• 感谢大家点赞👍收藏⭐评论✍

---

QWidget的windowOpacity属性 | cursor属性 | font属性

文章编号：Qt 学习笔记 / 18

---

一、windowOpacity属性

1. 简介

windowOpacity属性是Qt中QWindow类的一个属性。它用于设置窗口的不透明度（透明度）。

窗口的不透明度值范围是0.0到1.0之间，其中0.0表示完全透明，1.0表示完全不透明。默认情况下，窗口的不透明度为1.0，即完全不透明。

您可以使用setWindowOpacity()方法来设置窗口的不透明度。例如，以下代码将窗口的不透明度设置为0.5：

window->setWindowOpacity(0.5);

此外，您还可以使用windowOpacity()方法获取当前窗口的不透明度值。例如，以下代码将当前窗口的不透明度值打印出来：

qDebug() << window->windowOpacity();

请注意，windowOpacity属性仅适用于QWindow类的对象，而不适用于QWidget类的窗口对象。如果您正在使用QWidget类的窗口对象，请改用QWidget类的setWindowOpacity()和windowOpacity()方法。

2. API

API	说明
windowOpacity()	获取到控件的不透明数值. 返回 float, 取值为 0.0 -> 1.0 其中 0.0 表⽰全透明, 1.0 表⽰完全不透明.
setWindowOpacity(float n)	设置控件的不透明数值.

3. 代码示例

示例1：调整窗口透明度

• 在界⾯上拖放两个按钮, 分别⽤来增加不透明度和减少不透明度.
  
• 编写 wdiget.cpp, 编写两个按钮的 slot 函数
  UP 会减少不透明度, 也就是窗⼝越来越透明
  DOWN 会增加不透明度, 窗⼝会逐渐恢复

• 执⾏程序，可以看到。点击UP增加不透明度，点击DOWN减少透明度
  

文件代码：

#include "widget.h"
#include "ui_widget.h"
#include<QDebug>
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);
}Widget::~Widget()
{delete ui;
}void Widget::on_pushButton_up_clicked()
{//获取窗口不透明值float opacity = this->windowOpacity();//进行判定不透明值是否超过1.0if(opacity >= 1.0){return;}//打印不透明值qDebug()<<opacity;//增加不透明度opacity+=0.1;//设置到窗口上this->setWindowOpacity(opacity);
}void Widget::on_pushButton_down_clicked()
{//获取窗口不透明值float opacity = this->windowOpacity();//进行判定不透明值是否小于1.0if(opacity <= 0.0){return;}//打印不透明值qDebug()<<opacity;//减少不透明度opacity-=0.1;//设置到窗口上this->setWindowOpacity(opacity);
}

---

二、cursor属性

1. 简介

在Qt中，QWidget类和QApplication类都提供了一个cursor属性，用于设置和获取窗口或应用程序的鼠标指针样式。该属性可用于控制鼠标在窗口上的显示效果。

常见的鼠标指针样式包括箭头、手指、等待、文本输入等。通过设置cursor属性，可以更改鼠标指针的样式。

QCursor类定义了一组预定义的光标样式，包括箭头、手指、等待、文本输入等。可以使用这些预定义样式，也可以创建自定义的光标样式。

设置窗口的cursor属性可以使用setCursor()方法，例如：

QWidget *widget = new QWidget;
widget->setCursor(Qt::PointingHandCursor);

上述代码演示了Qt中的cursor属性的基本用法。通过设置和获取cursor属性，可以实现在窗口和应用程序中自定义鼠标指针的样式。

2. API

API	说明
cursor()	获取到当前 widget 的 cursor 属性, 返回 QCursor 对象.当⿏标悬停在该 widget 上时, 就会显⽰出对应的形状.
setCursor(const QCursor& cursor)	设置该 widget 光标的形状. 仅在⿏标停留在该 widget 上时⽣效.
QGuiApplication::setOverrideCursor(const QCursor&cursor)	设置全局光标的形状. 对整个程序中的所有 widget 都会⽣效. 覆盖上⾯的 setCursor 设置的内容.

3. 系统内置的光标形状

Ctrl + 左键 点击 Qt::WaitCursor 跳转到源码即可看到.

enum CursorShape {ArrowCursor,UpArrowCursor,CrossCursor,WaitCursor,IBeamCursor,SizeVerCursor,SizeHorCursor,SizeBDiagCursor,SizeFDiagCursor,SizeAllCursor,BlankCursor,SplitVCursor,SplitHCursor,PointingHandCursor,ForbiddenCursor,WhatsThisCursor,BusyCursor,OpenHandCursor,ClosedHandCursor,DragCopyCursor,DragMoveCursor,DragLinkCursor,LastCursor = DragLinkCursor,BitmapCursor = 24,CustomCursor = 25}

4. 代码示例

示例1：在Qt Designer中设置按钮的光标

• 在界⾯中创建⼀个按钮，直接在右侧属性编辑区修改 cursor 属性为 “等待”
  
• 运行程序, 鼠标悬停到按钮上, 即可看到光标的变化 （window11的等待效果）
  

示例2：通过代码设置按钮的光标

• 设置一个按钮并进行设置大小及位置，其中 Qt::WaitCursor 就是⾃带的沙漏形状的光标.
  
• 运⾏程序, 观察效果.
  

文件代码：

#include "widget.h"
#include "ui_widget.h"
#include<QPushButton>
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);//创建一个按钮QPushButton* button=new QPushButton(this);//修改按钮尺寸大小button->resize(300,150);//修改按钮在界面中的位置button->move(200,100);//设置按钮的文本button->setText("按钮");//设置按钮的cursor属性button->setCursor(QCursor(Qt::WaitCursor));}Widget::~Widget()
{delete ui;
}

示例3：自定义鼠标光标

• Qt ⾃带的光标形状有限，可以自己找图片，做成鼠标光标。以下图为例图片来自阿里巴巴矢量图标库
  
• 创建 qrc 资源⽂件, 添加前缀 / , 并加⼊ dianzan.png 详细步骤参考：qrc文件机制
  
  
• 编写 widget.cpp
  热点：鼠标点击时生效的位置，类似于箭头的尖尖
  
• 运⾏程序, 观察效果
  

文件代码：

#include "widget.h"
#include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);// 创建⼀个位图对象, 加载⾃定义光标图⽚QPixmap pixmap(":/dianzan.png");// 缩放图⽚为 64 * 64 的尺⼨pixmap =pixmap.scaled(64,64);// 创建 QCursor 对象, 并指定 "热点" 为 (2, 2) 坐标位置.// 所谓 "热点" 就是⿏标点击时生效的位置，类似于箭头的尖尖QCursor cursor(pixmap,2,2);// 设置光标this->setCursor(cursor);
}Widget::~Widget()
{delete ui;
}

---

三、font属性

1. 简介

在Qt中，font属性用于设置控件的字体样式。每个Qt控件都有一个font属性，用于设置控件的字体。

在Qt中，可以使用以下方法来设置控件的字体：

1. 使用控件自己的setFont方法来设置字体，例如：这将将按钮的字体设置为Arial字体，大小为12。

QPushButton* button = new QPushButton("Button");
button->setFont(QFont("Arial", 12));

2. 使用样式表（QSS）来设置字体，例如：这将将所有QPushButton控件的字体设置为Arial字体，大小为12。

QPushButton {font-family: Arial;font-size: 12px;
}

3. 使用控件的QPalette对象来设置字体，例如：这将将按钮的字体设置为Arial字体，大小为12。

QPushButton* button = new QPushButton("Button");
QPalette palette = button->palette();
palette.setFont(QFont("Arial", 12));
button->setPalette(palette);

总之，Qt中的font属性可以通过控件自带的方法、样式表或QPalette对象来设置，可以自由选择最适合的方法来设置控件的字体样式。

2. API

API	说明
font()	获取当前 widget 的字体信息. 返回 QFont 对象.
setFont(const QFont& font)	设置当前 widget 的字体信息

3. QFont各属性说明

属性	说明
family	字体家族. ⽐如 “楷体”, “宋体”, “微软雅⿊” 等.
pointSize	字体⼤⼩
weight	字体粗细. 以数值⽅式表⽰粗细程度取值范围为 [0, 99], 数值越⼤, 越粗.
bold	是否加粗. 设置为 true, 相当于 weight 为 75. 设置为 false 相当于
weight	为 50.
italic	是否倾斜
underline	是否带有下划线
strikeOut	是否带有删除线

4. 代码示例

示例1：在Qt Designer中设置字体属性

• 创建一个label标签，在右侧的属性编辑区, 设置该 label 的 font 相关属性
  
• 通过修改右边font的属性，来改变label里的文本
  
• 执行程序，运行结果
  

示例2：在代码中设置字体属性

• 在界⾯中创建 label，并修改font属性，设置到label
  
• 执行代码，运行结果
  

文件代码：

#include "widget.h"
#include "ui_widget.h"
#include<QLabel>
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);QLabel* label=new QLabel(this);//设置label的文本内容label->setText("这是一段文本");//改变label的位置label->move(200,300);//创建字体对象QFont font;//设置字体家族font.setFamily("楷体");//设置字体大小font.setPixelSize(20);//设置字体加粗font.setBold(true);//设置字体倾斜font.setItalic(true);//设置字体下划线font.setUnderline(true);//设置字体删除线font.setStrikeOut(true);//设置字体对象到label上label->setFont(font);
}Widget::~Widget()
{delete ui;
}

---