Qt 窗口标志（Window Flags）详解：控制窗口样式与行为-EW帮帮网

在 Qt 中，windowFlags 用于控制窗口的样式和行为，包括标题栏、边框、最大化/最小化按钮等。合理设置 windowFlags 可以自定义窗口的外观和交互方式。本文将详细介绍常用的窗口标志及其组合效果。

1. 基本概念

windowFlags 是一个 Qt::WindowFlags 类型的枚举组合，用于定义窗口的属性和行为。可以通过 setWindowFlags() 方法设置，或使用位运算（|）添加多个标志。

基本语法

// 设置窗口标志
setWindowFlags(Qt::WindowFlags flags);

// 添加额外标志（保留原有标志）
setWindowFlags(windowFlags() | Qt::WindowMaximizeButtonHint);

2. 常用窗口标志（Qt::WindowFlags）

以下是常用的窗口标志及其作用：

2.1 基本窗口类型

标志	说明
`Qt::Widget`	默认窗口类型，可作为独立窗口或嵌入其他窗口
`Qt::Window`	标准窗口，带标题栏和边框
`Qt::Dialog`	对话框窗口，通常无最小化/最大化按钮
`Qt::Popup`	弹出窗口（无标题栏，短暂显示）
`Qt::Tool`	工具窗口（通常无任务栏入口）

2.2 标题栏控制

标志	说明
`Qt::FramelessWindowHint`	无边框窗口（无标题栏、无系统按钮）
`Qt::WindowTitleHint`	强制显示标题栏
`Qt::WindowSystemMenuHint`	显示系统菜单（点击标题栏图标）
`Qt::WindowCloseButtonHint`	显示关闭按钮
`Qt::WindowMinimizeButtonHint`	显示最小化按钮
`Qt::WindowMaximizeButtonHint`	显示最大化按钮
`Qt::WindowMinMaxButtonsHint`	同时显示最小化和最大化按钮

2.3 窗口行为

标志	说明
`Qt::WindowStaysOnTopHint`	窗口始终置顶
`Qt::WindowStaysOnBottomHint`	窗口始终置底
`Qt::WindowTransparentForInput`	窗口透明（不接收鼠标事件）
`Qt::WindowDoesNotAcceptFocus`	窗口不接受键盘焦点

3. 常见组合示例

3.1 标准窗口（带标题栏和所有按钮）

setWindowFlags(Qt::Window | 
               Qt::WindowTitleHint |
               Qt::WindowSystemMenuHint |
               Qt::WindowCloseButtonHint |
               Qt::WindowMinMaxButtonsHint);

效果：

有标题栏
有关闭、最小化、最大化按钮
可调整大小

3.2 无边框窗口（但仍可拖动）

setWindowFlags(Qt::FramelessWindowHint);

效果：

无标题栏、无边框
需手动实现拖动功能（参考无边框窗口拖动实现）

3.3 对话框（仅有关闭按钮）

setWindowFlags(Qt::Dialog | 
               Qt::WindowTitleHint |
               Qt::WindowCloseButtonHint);

效果：

有标题栏
仅有关闭按钮（无最小化/最大化）

3.4 工具窗口（无任务栏图标）

setWindowFlags(Qt::Tool | 
               Qt::WindowTitleHint |
               Qt::WindowCloseButtonHint);

效果：

有标题栏和关闭按钮
不会出现在任务栏

3.5 置顶窗口

setWindowFlags(windowFlags() | Qt::WindowStaysOnTopHint);

效果：

窗口始终显示在其他窗口之上

4. 注意事项

setWindowFlags 会重置窗口状态
调用 setWindowFlags() 后，窗口可能会隐藏，需要重新调用 show()：
```
setWindowFlags(newFlags);
show(); // 必须重新显示
```
不同平台的差异
- 在 macOS 上，WindowMinMaxButtonsHint 可能表现不同。
- 在 Linux 上，某些窗口管理器可能会覆盖 Qt 的设置。
无边框窗口需手动实现功能
如果使用 FramelessWindowHint，需自行实现：
- 窗口拖动（mousePressEvent + mouseMoveEvent）
- 最小化/最大化/关闭按钮

动态修改窗口标志
可以使用 windowFlags() 获取当前标志，再通过位运算修改：

// 添加关闭按钮（如果不存在）
setWindowFlags(windowFlags() | Qt::WindowCloseButtonHint);

5. 总结

windowFlags 是 Qt 中控制窗口样式和行为的核心机制，合理使用可以：

自定义标题栏和按钮
实现无边框窗口
控制窗口置顶/置底
优化对话框和工具窗口的显示方式

如果窗口缺少关闭按钮，可以尝试：

setWindowFlags(windowFlags() | Qt::WindowCloseButtonHint);

Qt 窗口标志（Window Flags）详解：控制窗口样式与行为