【Qt】Qt中的常用属性

---

需要云服务器等云产品来学习Linux可以移步/-->腾讯云<--/官网，轻量型云服务器低至112元/年，新用户首次下单享超低折扣。

---

目录

一、QWidget属性一览

二、属性enabled(可用状态)

三、属性geometry(修改位置和尺寸)

1、QRect类型的结构

2、geometry()获取x，y，width，heigh

3、setGeometry(QRect)实现按钮随左上角形变

[4、setGeometry(int x, int y, int width, int height)实现按钮移动](#4、setGeometry(int x, int y, int width, int height)实现按钮移动)

5、应用：必须同意的辞职报告

[6、window frame(窗口框架)对属性geometry的影响](#6、window frame(窗口框架)对属性geometry的影响)

6.1对比geometry()和frameGeometry()的大小

四、属性windowTitle(获取/设置控件的窗口标题)

五、属性windowIcon(获取/设置控件的窗口图标)

1、qrc文件管理机制

六、属性windowOpacity(获取/设置控件的不透明值)

七、属性cursor(修改鼠标光标悬停时的样式)

八、属性font(获取/设置当前widget的字体信息)

九、属性toolTip(弹窗等提示文本)

十、属性focusPolicy(设置控件获取到焦点的策略，例如输入框被选中则接收输入)

十一、属性styleSheet(通过CSS设置控件的样式)

1、通过styleSheet实现日夜切换效果

---

一、QWidget属性一览

Qt中各种控件都是继承自QWidget类。下图可以在ui文件右侧找到：

|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 属性 | 作用 |
| enabled | 设置控件是否可使⽤. true 表⽰可⽤, false 表⽰禁⽤. 禁用：该控件不能接收任何用户的输入事件，外观往往是灰色的，如果一个widget被禁用，该widget的子元素也被禁用。 |
| geometry | 位置和尺⼨. 包含 x, y, width, height 四个部分，其中坐标是以父元素为参考进⾏设置的. |
| windowTitle | 设置 widget 标题 |
| windowIcon | 设置 widget 图标 |
| windowOpacity | 设置 widget 透明度 |
| cursor | ⿏标悬停时显⽰的图标形状. 是普通箭头, 还是沙漏, 还是⼗字等形状. 在 Qt Designer 界⾯中可以清楚看到可选项 |
| font | 字体相关属性. 涉及到字体家族, 字体⼤⼩, 粗体, 斜体, 下划线等等样式. |
| toolTip | ⿏标悬停在 widget 上会在状态栏中显⽰的提⽰信息 |
| toolTipDuring | toolTip 显⽰的持续时间. |
| statusTip | Widget 状态发⽣改变时显⽰的提⽰信息(⽐如按钮被按下等). |
| whatsThis | ⿏标悬停并按下 alt+F1 时, 显⽰的帮助信息(显⽰在⼀个弹出的窗⼝中). |
| styleSheet | 允许使⽤ CSS 来设置 widget 中的样式 |
| focusPolicy | 该 widget 如何获取到焦点. • Qt::NoFocus：控件不参与焦点管理，即⽆法通过键盘或⿏标获取焦点 • Qt::TabFocus：控件可以通过Tab键获得焦点 • Qt::ClickFocus：控件可以通过⿏标点击获得焦点 • Qt::StrongFocus：控件可以通过键盘和⿏标获得焦点 • Qt::WheelFocus：控件可以通过⿏标滚轮获得焦点（在某些平台或样式中可能不可⽤） |
| contextMenuPolicy | 上下⽂菜单的显⽰策略. • Qt::DefaultContextMenu：默认的上下⽂菜单策略，⽤⼾可以通过⿏标右键或键盘 快捷键触发上下⽂菜单 • Qt::NoContextMenu：禁⽤上下⽂菜单，即使⽤⼾点击⿏标右键也不会显⽰菜单 • Qt::PreventContextMenu：防⽌控件显⽰上下⽂菜单，即使⽤⼾点击⿏标右键也不 会显⽰菜单 • Qt::ActionsContextMenu：将上下⽂菜单替换为控件的"动作"菜单，⽤⼾可以通 过⿏标右键或键盘快捷键触发这个菜单• Qt::CustomContextMenu：使⽤⾃定义的上下⽂菜单，⽤⼾可以通过⿏标右键或键 盘快捷键触发这个菜单 |
| locale | 设置语⾔和国家地区. |
| acceptDrops | 该部件是否接受拖放操作。 如果设置为true，那么该部件就可以接收来⾃其他部件的拖放操作。当⼀个部件被拖放 到该部件上时，该部件会接收到相应的拖放事件（如dropEvent）。 如果设置为false，那么该部件将不会接收任何拖放操作。 |
| minimumSize | 控件的最⼩尺⼨. 包含最⼩宽度和最⼩⾼度 |
| maximumSize | 控件的最⼤尺⼨. 包含最⼤宽度和最⼤⾼度 |
| sizePolicy | 尺⼨策略. 设置控件在布局管理器中的缩放⽅式. |
| windowModality | 指定窗⼝是否具有 "模态" ⾏为 |
| sizeIncrement | 拖动窗⼝⼤⼩时的增量单位 |
| baseSize | 窗⼝的基础⼤⼩, ⽤来搭配 sizeIncrement 调整组件尺⼨是计算组件应该调整到的合适 的值. |
| palette | 调⾊板. 可以设置 widget 的颜⾊⻛格 |
| mouseTracking | 是否要跟踪⿏标移动事件. 如果设为 true, 表⽰需要跟踪, 则⿏标划过的时候该 widget 就能持续收到⿏标移动事件. 如果设为 false, 表⽰不需要跟踪, 则⿏标划过的时候 widget 不会收到⿏标移动事件, 只 能收到⿏标按下或者释放的事件 |
| tabletTracking | 是否跟踪触摸屏的移动事件. 类似于 mouseTracking . Qt 5.9 中引⼊的新属性 |
| layoutDirection | 布局⽅向. • Qt::LeftToRight：⽂本从左到右排列，也是默认值。 • Qt::RightToLeft：⽂本从右到左排列。 • Qt::GlobalAtomics：部件的布局⽅向由全局原⼦性决定(PS 这个翻译其实有点尴 尬. 其实就是根据应⽤程序中的其他 widget 布局⽅向确定的) |
| autoFillBackground | 是否⾃动填充背景颜⾊ |
| windowFilePath | 能够把 widget 和⼀个本地⽂件路径关联起来. PS: 其实作⽤不⼤. |
| accessibleName | 设置 widget 的可访问名称. 这个名称可以被辅助技术 (像屏幕阅读器) 获取到.这个属性⽤于实现⽆障碍程序的场景中 (也就是给盲⼈写的程序). |
| accessibleDescripti | 设置 widget 的详细描述. 作⽤同 accessibleName |
| inputMethodHints | 针对输⼊框有效, ⽤来提示用户当前能输⼊的合法数据的格式. ⽐如只能输⼊数字, 只能 输⼊⽇期等. |

二、属性enabled(可用状态)

|-----------------|-------------------------------------|
| 属性enabled的API | 说明 |
| isEnable() | 获取控件的可用状态 |
| setEnable() | 设置控件是否可用，true表示可用，false表示禁用（灰色无法交互） |

控制按键控制被控制按键是否可用：

三、属性geometry(修改位置和尺寸)

|-----------------------------------------------------------------------------|-----------------------------------------------------------------|
| API | 说明（注：这里的QRect或者QPoint是小对象，通常可值传递） |
| geometry() | 获取控件的位置和尺寸。返回结果是一个QRect（一个矩形），包含了x，y，width，height。其中x，y是左上角的坐标。 |
| setGeometry(QRect) setGeometry(int x, int y, int width, int height) | 设置控件的位置和尺寸，可以直接设置一个QRect，也可以分四个属性单独设置 |

1、QRect类型的结构

注：xy是框框左上角的点

2、geometry()获取x，y，width，heigh

// 这是一个按钮的槽函数，它获取了Widget的宽
void Widget::on_pushButtonDisagree_clicked() // 不同意按钮,如果点击了个按钮该按钮就会随机乱跳
{
    int width = this->geometry().width(); // 获取Widget的宽
}
// 这是一个按钮的槽函数，它获取了Widget的QRect信息
void Widget::on_pushButtonDisagree_clicked() // 不同意按钮,如果点击了个按钮该按钮就会随机乱跳
{
    QRect rect = this->geometry(); // 它获取了Widget的QRect信息
}

3、setGeometry(QRect)实现按钮随左上角形变

这种方式改变x和y，也会对宽和高进行改变，所以target按钮呈现左上角形变的现象。

4、setGeometry(int x, int y, int width, int height)实现按钮移动

5、应用：必须同意的辞职报告

// main.cpp
#include "widget.h"

#include <QApplication>

int main(int argc, char *argv[])
{
    srand(time(nullptr));
    QApplication a(argc, argv);
    Widget w;
    w.show();
    return a.exec();
}

// widget.cpp
#include "widget.h"
#include "ui_widget.h"

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
}

Widget::~Widget()
{
    delete ui;
}

void Widget::on_pushButtonAgree_clicked()    // 同意按钮(鼠标按下+松开按钮触发)
{
    ui->label->setText("谢谢老板，江湖再见！");
}

void Widget::on_pushButtonDisagree_pressed() // 不同意按钮,如果点击了个按钮该按钮就会随机乱跳(鼠标按按钮即可触发)
{
    int width = this->geometry().width();    // 获取Widget的宽
    int height = this->geometry().height();  // 获取widget的高
    // 通过随机送生成按钮的新位置
    int x = rand() % width;
    int y = rand() % height;
    QRect rect = ui->pushButtonDisagree->geometry();
    ui->pushButtonDisagree->setGeometry(x, y, rect.width(), rect.height());
}

// widget.h
#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();

private slots:

    void on_pushButtonAgree_clicked();

    void on_pushButtonDisagree_pressed();

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H

6、window frame(窗口框架)对属性geometry的影响

1、window frame可以通过调用API来隐藏。

2、任意一个控件，它们的坐标系原点既可能是window frame左上角，也可能是widget左上角，因为在Qt中，均提供了这两种不同原点的API函数。

3、对于geometry()和setGeometry()，它们都是不考虑window frame的。

4、对于frameGeometry()和setFrameGeometry(),它们是考虑window frame的。

6.1对比geometry()和frameGeometry()的大小

widget未构造完之前是一样大的，构造之后就能看出大小区别，代码是点击按钮显示geometry()和frameGeometry()的真正大小。

// widget.h
#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
    void handle();
private:
    Ui::Widget *ui;
};
#endif // WIDGET_H

// widget.cpp
#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <QPushButton>
Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    //如果直接在构造函数打印两个大小，是一样的，此时Widget还未加入windows frame
    QRect rect = this->geometry();
    QRect frameRect = this->frameGeometry();
    qDebug() << rect;
    qDebug() << frameRect;

    QPushButton* button = new QPushButton(this);
    button->setText("按钮");
    button->move(100, 100);
    connect(button, &QPushButton::clicked, this, &Widget::handle);
}

Widget::~Widget()
{
    delete ui;
}

void Widget::handle()
{
    QRect rect = this->geometry();
    QRect frameRect = this->frameGeometry();
    qDebug() << rect;
    qDebug() << frameRect;
}

四、属性windowTitle(获取/设置控件的窗口标题)

|-------------------------------------|------------|
| API | 说明 |
| windowTitle() | 获取到控件的窗口标题 |
| setWindowTitle(QString& title) | 设置控件的窗口标题 |

windowsTitle仅对顶层窗口有效

五、属性windowIcon(获取/设置控件的窗口图标)

|---------------------------------------|--------------------------------------------|
| API | 说明 |
| windowIcon() | 获取到控件的窗口图标，返回QIcon对象(QIcon表示一个图标) 很少用这个API |
| setWindowIcon(const QIcon& icon) | 设置控件的窗口图标 |

1、windowIcon仅对顶层窗口有效。

2、QIcon对象建议创建在栈上，其一是小对象，其二是创建后被setWindowIcon()函数设置后，临时对象销毁了也还在，其三是QIcon不支持对象树，堆区创建得手动释放资源。

路径建议要用相对路径，要考虑到客户不会把这个jpg文件放到d盘。

也可以使用qrc机制：给Qt项目引入一个额外的xml文件(后缀名使用.qrc表示)，在这个xml中把要使用的图片资源导入进来，Qt在编译时，会根据.qrc文件中的图片信息找到图片内容，并提取出图片的二进制数据，会把这些二进制数据自动转成C++代码和工程一起编译到exe里。缺点:无法导入大文件资源。

1、qrc文件管理机制

1、在项目中创建一个.qrc文件(不要中文和特殊符号)

2、把图片导入到qrc文件中

2.1先创建一个前缀Prefix (前缀：理解为虚拟目录，不在自己电脑上真实存在，是Qt自己抽象出来的)

2.2把目标图片加载进来

六、属性windowOpacity(获取/设置控件的不透明值)

|--------------------------------|--------------------------------------|
| API | 说明 |
| windowOpacity() | 获取控件的不透明值，返回float，取值0.0-1.0表示透明到不透明。 |
| setWindowOpaacity(float n) | 设置控件的不透明值（超过1.0或少于0.0的数字设置不进去） |

七、属性cursor(修改鼠标光标悬停时的样式)

|----------------------------------------------------------------|-----------------------------------------------------------|
| API | 说明 |
| cursor() | 获取到当前控件的cursor属性，返回QCursor对象（栈对象）。当鼠标悬停在该控件上时，就会显示出对应的形状。 |
| setCursor(const QCursor& cursor) | 设置该控件光标的形状，仅在鼠标停留在该控件时生效。 |
| QGuiApplication::setOverrideCursor(const QCursor& cursor) | 设置全局光标的形状，对整个程序中所有的控件生效，覆盖上面的setCursor设置的内容。 |

源代码中关于cursor属性的名称定义：

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
    };

内置样式的使用：

自定义图片资源充当鼠标样式：阿里巴巴矢量图标库

八、属性font(获取/设置当前widget的字体信息)

font:

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

QFont:

|----------------------------|-----------------------------------------------------|
| 属性 | 说明 |
| family/setFamily | 字体家族，比如"楷体""宋体"等 |
| pointSize/setPointSize | 字体大小（单位像素） |
| weight/setWeight | 字体粗细[0, 99]。数值越大越粗 |
| bold/setBold | 是否加粗，设置为true，相当于weight = 75；设置为false，相当于weight = 50 |
| italic/setItalic | 是否倾斜 |
| underline/setUnderline | 是否带有下划线 |
| strikeOut/setStrikeOut | 是否带有删除线 |
| ............................ ||

九、属性toolTip(弹窗等提示文本)

|----------------------------------|----------------------------------------------------|
| API | 说明 |
| setToolTip(const QString &) | 设置toolTip，鼠标悬停在该控件上时会出现弹窗说明(鼠标在控件一秒后，弹窗出现并悬停10秒左右) |
| setToolTipDuration(int msec) | 设置toolTip提示的时间，单位ms。时间一到toolTip自动消失。 |
| toolTip只是给用户看的，代码中一般不需要获取到toolTip ||

十、属性focusPolicy(设置控件获取到焦点的策略，例如输入框被选中则接收输入)

一个控件获取到焦点有两种方式：

1、鼠标点击

2、键盘Tab键/shift +Tab(切换到下一个输入框/切换到上一个输入框)

|--------------------------------------------|---------------------------------------|
| API | 说明 |
| focusPolicy() | 获取该控件的focusPolicy，返回Qt::FocusPolicy |
| setFocusPolicy(Qt::FocusPolicy policy) | 设置widget的focusPolicy |
| Qt::FocusPolicy是枚举类型，取值如下： ||
| Qt::NoFocus | 控件不会接收键盘焦点 |
| Qt::TabFocus | 控件可以通过Tab键接收焦点 |
| Qt::ClickFocus | 控件在鼠标点击时接收焦点 |
| Qt::StrongFocus | 控件可以通过Tab键和鼠标点击接收焦点(默认值) |
| Qt::WheelFocus | 除了Qt::StrongFocus的功能,控件也可以通过鼠标滚轮获取到焦点 |

十一、属性styleSheet(通过CSS设置控件的样式)

|-----------------------------------------------|-----------------------|
| API | 说明 |
| setStyleSheet(const QString& styleSheet) | 设置控件样式 |
| rgb(255, 0, 255)或者#FF00FF | 红色255(最红)， 绿色0， 蓝色255 |

修改控件样式：

可以在Qt文档中搜索Qt Style Sheet查看写法。

1、通过styleSheet实现日夜切换效果

可以使用QQ截图进行取色可知widget的初始颜色为(240, 240, 240)：