当前位置：首页 > news >正文

Qt 中 QWidget涉及的常用核心属性介绍

news 来源：原创 2025/5/13 22:22:19

欢迎来到干货小仓库

一匹真正的好马，即使在鞭子的影子下，也能飞奔

1.enabled

API	说明
isEnabled()	获取到控件的可用状态
setEnabled()	设置控件是否可使用.true：可用，false：禁用

禁用：指该控件不能接收任何用户的输入事件，并且外观上往往是灰色的。

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

示例：通过两个按钮，分别控制对方的使用状态

2.geometry

其返回值是QRect，可表示控件的位置、宽度和高度的大小

API	说明
geometry()	获取到控件的位置和尺⼨. 返回结果是⼀个 QRect, 包含了 x, y, width, height. 其中 x, y 是左上⻆的坐标.
setGeometry(QRect) setGeometry(int x, int y, int width, int height)	设置控件的位置和尺⼨. 可以直接设置⼀个 QRect, 也可以分四个属性单独设置.

示例：通过四个按钮分别控制目标按钮上下左右移动。

3.window frame

widget的窗口其父元素是整个屏幕。

示例：geometry和window frame的区别

4.windowTitle

API	说明
windowTitle()	获取到控件的窗⼝标题.
setWindowTitle(const QString& title)	设置控件的窗⼝标题.

对顶层独立窗口(widget)，才会生效。

5.windowIcon

设置窗口图标

API	说明
windowIcon()	获取到控件的窗⼝图标. 返回 QIcon 对象.
setWindowIcon(const QIcon& icon )	设置控件的窗⼝图标.

6.windowOpacity

7.QCursor

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

也可以自定义cursor的图标，通过qrc机制管理相应的图片路径

8.font

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

QFont

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

9.toolTip

API	说明
setToolTip	设置 toolTip. ⿏标悬停在该 widget 上时会有提⽰说明.
setToolTipDuring	设置 toolTip 提⽰的时间. 单位 ms. 时间到后 toolTip ⾃动消失.

10.focusPolicy

API	说明
focusPolicy()	获取该 widget 的 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 , 同时控件也通过⿏标滚轮获取到焦点 (新增

        的选项, ⼀般很少使⽤)