目录
关于QWidget
作为界面组件时，你需要有印象的
1. 控制属性
2. 组件状态与交互属性
3. 外观和样式属性
4. 布局与子组件管理属性
5. 图标和光标属性
6. 大小策略属性
作为单独的窗体的属性
写Qt快两年了，也写过一些规模偏大的软件，但是依旧觉得对QWidget的类比较陌生，这里整理一下笔者看到的一些笔记。供以参考翻阅！
关于QWidget
关于QWidget，他是大部分Ui控件的爹。几乎所有的常用控件都是直接或者是间接的继承了QWidget。也就是说，它实际上定义了控件的最基础属性。我们很多时候聊Ui布局感官可能就需要从这里开始顺藤摸瓜。
作为界面组件时，你需要有印象的
属性很多，我委托GPT帮助我整理了一下，下面是我审核后认为无误的部分：
1. 控制属性
这里则是说Widget大小属性的部分，其实跟下面的外观分不开来，更多的是说Widget自身的属性。比如说窗体自身的大小策略
| 属性名称 | 类型 | 功能说明 | 使用示例 | 注意事项 |
|---|---|---|---|---|
windowTitle | QString | 设置或获取窗口的标题。 | setWindowTitle("My Application"); | 窗口标题通常在窗口的标题栏中显示。 |
geometry | QRect | 设置或获取窗口的位置和大小。 | setGeometry(100, 100, 800, 600); | 参数依次为窗口的x坐标、y坐标、宽度和高度。 |
size | QSize | 设置或获取窗口的大小。 | resize(800, 600); | 仅修改窗口的大小，不改变位置。 |
minimumSize | QSize | 设置窗口的最小大小。 | setMinimumSize(400, 300); | 当用户调整窗口时，不能小于该大小。 |
maximumSize | QSize | 设置窗口的最大大小。 | setMaximumSize(1200, 800); | 当用户调整窗口时，不能大于该大小。 |
isVisible | bool | 获取窗口是否可见。 | bool visible = isVisible(); | 该属性通常在运行时动态变化。 |
2. 组件状态与交互属性
| 属性名称 | 类型 | 功能说明 | 使用示例 | 注意事项 |
|---|---|---|---|---|
enabled | bool | 设置或获取组件是否启用。 | setEnabled(false); | 禁用后组件无法接收用户输入。（只能看不能用） |
focusPolicy | Qt::FocusPolicy | 设置焦点策略，决定该组件如何获得焦点。 | setFocusPolicy(Qt::StrongFocus); | 可选值包括：Qt::NoFocus, Qt::TabFocus等。 |
toolTip | QString | 设置或获取组件的工具提示。 | setToolTip("This is a button."); | 鼠标悬停时显示，通常用于提供附加信息。 |
statusTip | QString | 设置或获取组件的状态提示。 | setStatusTip("Click to perform action."); | 通常在状态栏显示，提供操作的简短描述。 |
whatsThis | QString | 设置“这是什么”提示。 | setWhatsThis("This button starts the application."); | 提供更详细的说明，可以通过帮助系统访问。 |
mouseTracking | bool | 设置或获取组件是否跟踪鼠标移动。 | setMouseTracking(true); | 启用后，可以在mouseMoveEvent中处理鼠标移动。 |
acceptDrops | bool | 设置组件是否接受拖放操作。 | setAcceptDrops(true); | 需要重载dragEnterEvent和dropEvent。 |
tabletTracking | bool | 设置或获取组件是否跟踪平板输入。 | setTabletTracking(true); | 启用后，可以在tabletEvent中处理平板输入。 |
3. 外观和样式属性
| 属性名称 | 类型 | 功能说明 | 使用示例 | 注意事项 |
|---|---|---|---|---|
styleSheet | QString | 设置组件的样式表，定义组件的外观。 | setStyleSheet("background-color: yellow;"); | 使用CSS样式表语法，可用于复杂的样式设置。 |
autoFillBackground | bool | 设置是否自动填充背景。 | setAutoFillBackground(true); | 使背景颜色填充组件的整个区域。 |
palette | QPalette | 获取或设置组件的调色板，控制颜色和样式。 | QPalette palette; palette.setColor(QPalette::Window, Qt::blue); setPalette(palette); | 颜色可针对不同状态（如禁用、悬停等）设置。 |
font | QFont | 设置或获取组件的字体。 | setFont(QFont("Arial", 12)); | 字体设置会影响文本的显示效果。 |
4. 布局与子组件管理属性
| 属性名称 | 类型 | 功能说明 | 使用示例 | 注意事项 |
|---|---|---|---|---|
layout | QLayout* | 设置或获取组件的布局管理器。 | QVBoxLayout *layout = new QVBoxLayout(this); setLayout(layout); | 只能有一个布局管理器，设置后会删除之前的布局。 |
parent | QWidget* | 设置或获取组件的父对象。 | QWidget *child = new QWidget(this); | 父对象负责管理子对象的生命周期。 |
children | QList<QWidget*> | 获取组件的子对象列表。 | QList<QWidget*> children = this->findChildren<QWidget*>(); | 可以使用模板过滤特定类型的子对象。 |
5. 图标和光标属性
这是用在widget显示icon的
| 属性名称 | 类型 | 功能说明 | 使用示例 | 注意事项 |
|---|---|---|---|---|
iconSize | QSize | 设置图标的显示大小（在某些组件中有效）。 | setIconSize(QSize(32, 32)); | 适用于如QToolButton等需要图标的组件。 |
cursor | QCursor | 设置或获取鼠标光标。 | setCursor(Qt::PointingHandCursor); | 可以使用Qt预定义的光标类型，或自定义光标。 |
6. 大小策略属性
控制了控件的大小对于外部布局时的行为。比如说Agressive的占据尽可能大的空间或者选择保守的策略。
| 属性名称 | 类型 | 功能说明 | 使用示例 | 注意事项 |
|---|---|---|---|---|
sizePolicy | QSizePolicy | 设置组件的大小策略，决定如何调整大小。 | setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed); | 影响组件在布局中的表现和调整。 |
很多都很好理解，但是这个sizePolicy可能会在后面的布局的时候会用到，这里说一下：
| sizeType属性说明 | 值 | 说明 |
|---|---|---|
| Fixed | 0 | 固定值策略: Qwidget.sizeHint()对应的缺省大小就是部件的固定不变大小,因此部件不能放大也不能缩小。 |
| Minimum | GrowFlag | 指定最小值策略: Qwidget. sizeHint()对应的缺省大小是最小值，不能调整部件大小到比缺省大小更小的尺寸，并且该值应该足够满足部件的展现。部件允许扩展，但是Qt并不建议扩展(例如:水平方向上的按钮)。 |
| Maximum | ShrinkFlag | 指定最大值策略: Qwidget. sizeHint()对应的缺省大小是最大值,假如其它部件需要空间并且不会破坏该部件,那么该部件允许被缩小(例如:-个分割线)。 |
| Perferred | GrowFlag|ShrinkFlag | 首选项策略: Qwidget sizeHint()对应的缺省大小是最佳效果，部件允许放大或缩小，但不建议扩展比sizeHint()大,该策略是缺省策略。 |
| Expanding | GrowFlag|ShrinkFlag|ExpandFlag | 扩展策略: Qwidget. sizeHint()对应的缺省大小是合理的大小,但部件允许缩小并且可用。部件可以利用额外的空间,因此它将会得到尽可能多的空间(例如:水平方向上的滑块)。 |
| MinimumExpanding | GrowFlag|ExpandFlag | 最小可扩展策略: Qwidget. sizeHint()对应的缺省大小是最小值，并且大小足够。部件允许使用额外空间，因此它将会得到尽可能多的空间(例如:水平方向上的滑块)。 |
| Ignored | ShrinkFlag|GrowFlag|IgnoreFlag | Qwidget.sizeHint()对应的缺省大小将会被忽略,部件将会获取尽可能多的空间。 |
感谢qt 如何设计好布局和漂亮的界面。_qt 界面-CSDN博客的大佬，这里引用一下：
-
Fixed：控件不能放大或者缩小，控件的大小就是它的sizeHint。
-
Minimum：控件的sizeHint为控件的最小尺寸。控件不能小于这个sizeHint，但是可以放大。
-
Maximum：控件的sizeHint为控件的最大尺寸，控件不能放大，但是可以缩小到它的最小的允许尺寸。
-
Preferred：控件的sizeHint是它的sizeHint，但是可以放大或者缩小。
-
Expanding：控件可以自行增大或者缩小。（原文这里的Expanding打错了，打成了Expandint）
-
MinimumExpanding：控件的sizeHint是它的sizeHint，但是可以使用额外的空间，也就是它会尽可能得到更多的空间。
-
Ignored：控件的sizeHint不起作用，它会尽可能得到更多的空间。
这里就把常见的必备属性说完了，下面聊一聊当QWidget是一个单独的窗体的时候的行为。
作为单独的窗体的属性
| 属性名称 | 类型 | 功能说明 |
|---|---|---|
windowTitle | QString | 设置或获取窗口的标题。 |
windowIcon | QIcon | 设置或获取窗口的图标。 |
windowOpacity | qreal | 设置窗口的不透明度，值范围为0.0（完全透明）到1.0（完全不透明）。 |
windowFilePath | QString | 获取或设置窗口相关的文件路径（在某些应用程序中使用）。当然Windows Meaningful Only |
windowModified | bool | 设置或获取窗口是否被修改过，通常用于指示文件是否已更改。 |
windowModality | Qt::WindowModality | 设置窗口的模态性，决定是否阻塞其他窗口的输入。 |
windowState | Qt::WindowState | 设置或获取窗口的状态（如最小化、最大化）。 |
windowFlags | Qt::WindowFlags | 设置窗口的标志，决定窗口的行为和外观。 |