文章目录
- enabled
- geometry
- windowTitle
- windowIcon
- [qrc 机制](#qrc 机制)
- windowOpacity
- cursor
- font
- [toolTip 和 toolTipDuration](#toolTip 和 toolTipDuration)
- focusPolicy
- styleSheet
enabled
作用:设置控件是否可使用. true 表⽰可用, false 表⽰禁用.
对应的API
cpp
bool isEnabled(); // 获取到控件的可⽤状态.
void setEnabled(bool); // 设置控件是否可使⽤. true 表⽰可⽤, false 表⽰禁⽤.
// 所谓 "禁⽤" 指的是该控件不能接收任何⽤⼾的输⼊事件, 并且外观上往往是灰⾊的.
// 一个widget 被禁用,其子对象也会被禁用
geometry
作用:位置和尺寸. 其实是四个属性的统称
- x 横坐标
- y 纵坐标
- width宽度
- height 高度
对应的API
cpp
const QRect &geometry() const;
// 获取到控件的位置和尺⼨. 返回结果是⼀个 QRect, 包含了 x, y, width, height. 其中 x, y 是左上⻆的坐标.
void setGeometry(int x, int y, int w, int h);
void setGeometry(const QRect &)
// 设置控件的位置和尺⼨. 可以直接设置⼀个 QRect, 也可以分四个属性单独设置.
window frame
如果 widget 作为⼀个窗口(带有标题栏, 最⼩化, 最⼤化, 关闭按钮), 那么在计算尺寸和坐标的时候就有两种算法. 包含 window frame 和 不包含 window frame.
其中 x(), y(), frameGeometry(), pos(), move() 都是按照包含 window frame 的⽅式来计算的 。
其中 geometry(), width(), height(), rect(), size() 则是按照不包含 window frame 的⽅式来计算的 。
windowTitle
作用:设置 widget 标题
API
cpp
QString windowTitle() const; // 获取到控件的窗⼝标题.
void setWindowTitle(const QString &); // 设置控件的窗⼝标题.
windowIcon
作用:设置 widget 图标
API
cpp
QIcon windowIcon() const; // 获取到控件的窗⼝图标. 返回 QIcon 对象.
void setWindowIcon(const QIcon &icon); // 设置控件的窗⼝图标.
qrc 机制
如果我们把图片⽂件放到构建目录中, 可能在不小心删除后就丢失了. 我们还是希望能够把图片和源代码放到⼀起, 并且使我们的程序无论拷贝到任何位置中都能正确使⽤图片.qrc 机制帮我们自动完成了上述工作, 更方便的来管理项目依赖的静态资源.
qrc ⽂件是⼀种XML格式的资源配置⽂件, 它⽤XML记录硬盘上的⽂件和对应的随意指定的资源名称. 应⽤程序通过资源名称来访问这些资源.
在Qt开发中, 可以通过将资源文件添加到项⽬中来⽅便地访问和管理这些资源. 这些资源⽂件可以位于qrc⽂件所在⽬录的同级或其录下. 在构建程序的过程中, Qt 会把资源⽂件的⼆进制数据转成 cpp 代码, 编译到 exe 中. 从而使依赖的资源变得 "路径无关".
使⽤ : 作为开头, 表⽰从 qrc 中读取资源.
windowOpacity
作用 设置 widget 透明度
API
cpp
float windowOpacity() const;
//获取到控件的不透明数值. 返回 float, 取值为 0.0 -> 1.0 其中 0.0 表⽰全透明, 1.0 表⽰完全不透明.
void setWindowOpacity(float n); // 设置控件的不透明数值.
cursor
作用:⿏标悬停时显⽰的图标形状.
API
cpp
QCursor cursor() const; // 获取到当前 widget 的 cursor 属性, 返回 QCursor 对象.
void setCursor(const QCursor &); // 设置该 widget 光标的形状. 仅在⿏标停留在该 widget 上时⽣效.
QGuiApplication::setOverrideCursor(QCursor(Qt::WaitCursor));
// 设置全局光标的形状. 对整个程序中的所有 widget 都会⽣效. 覆盖上⾯的 setCursor 设置的内容.
font
作用:字体的相关属性。
API
cpp
const QFont &font() const; // 获取当前 widget 的字体信息. 返回 QFont 对象.
void setFont(const QFont &); // 设置当前 widget 的字体信息.
QFont
- family 字体家族
- pointSize 字体大小
- weight 字体粗细 以数值⽅式表⽰粗细程度取值范围为 [0, 99], 数值越⼤, 越粗.
- bold 是否加粗. 设置为 true, 相当于 weight 为 75. 设置为 false 相当于 weight 为 50.
- italic 是否倾斜
- underline 是否带有下划线
- strikeOut 是否带有删除线
toolTip 和 toolTipDuration
toolTip 作用 :⿏标悬停在 widget 上会在状态栏中显示的提示信息.
toolTipDuring 作用:toolTip 显示的持续时间.
API
cpp
QString toolTip() const; // 获取当前提示的信息
void setToolTip(const QString &); // 设置 toolTip.
void setToolTipDuration(int msec);// 设置toolTip停留时间.
focusPolicy
设置控件获取到焦点的策略. 比如某个控件能否⽤⿏标选中或者能否通过 tab 键选中.
API
cpp
Qt::FocusPolicy focusPolicy() const; // 获取该 widget 的 focusPolicy, 返回 Qt::FocusPolicy
void setFocusPolicy(Qt::FocusPolicy policy); // 设置 widget 的 focusPolicy
Qt::FocusPolicy
枚举类型
- Qt::NoFocus :控件不会接收键盘焦点
- Qt::TabFocus :控件可以通过Tab键接收焦点
- Qt::ClickFocus :控件在⿏标点击时接收焦点
- Qt::StrongFocus :控件可以通过Tab键和⿏标点击接收焦点 (默认值)
- Qt::WheelFocus : 类似于 Qt::StrongFocus , 同时控件也通过⿏标滚轮获取到焦点
styleSheet
作用:允许使⽤ CSS 来设置 widget 中的样式.
CSS 中可以设置的样式属性非常多. 基于这些属性 Qt 只能⽀持其中⼀部分, 称为 QSS (Qt Style Sheet) 。
API
cpp
QString styleSheet() const; // 获取当前的QSS样式
void setStyleSheet(const QString &styleSheet);设置当前的QSS样式