qt 设置窗口风格

1.概要

// 在Windows下使用原生样式
QApplication::setStyle("windowsvista");


// 在macOS下使用融合样式
QApplication::setStyle("fusion");

2.内容

在Qt中设置窗口风格可以通过多种方式实现，主要包括使用样式表（StyleSheet）和调整窗口标志（Window Flags）。以下是详细的步骤和示例：

---

1. 使用样式表（StyleSheet）自定义外观

Qt支持类似CSS的样式表，可灵活控制窗口及控件的外观。

基本设置

// 设置窗口背景色和文字颜色
this->setStyleSheet("background-color: #2d2d2d; color: white;");


// 设置圆角边框（需启用FramelessWindowHint）
this->setStyleSheet("border-radius: 10px;");


// 设置背景图片
this->setStyleSheet("background-image: url(:/images/bg.png);");

子控件样式

// 仅修改标题栏（需自定义标题栏控件）
titleBar->setStyleSheet("background-color: #1a73e8; height: 30px;");


// 修改按钮样式
QPushButton *button = new QPushButton("Click Me");
button->setStyleSheet("QPushButton { background-color: #4CAF50; color: white; }"
"QPushButton:hover { background-color: #45a049; }");

---

2. 调整窗口标志（Window Flags）

通过 setWindowFlags() 修改窗口行为，如隐藏标题栏、置顶等。

常用标志组合

// 无边框窗口（需处理拖动事件）
setWindowFlags(Qt::FramelessWindowHint);


// 置顶窗口
setWindowFlags(windowFlags() | Qt::WindowStaysOnTopHint);


// 自定义工具窗口（小标题栏，无最大化按钮）
setWindowFlags(Qt::Tool | Qt::MSWindowsFixedSizeDialogHint);

完整示例：无边框窗口

// 隐藏标题栏和边框
setWindowFlags(Qt::FramelessWindowHint);

// 允许拖动窗口（需重写鼠标事件）
void MousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        dragPosition = event->globalPosition().toPoint() - frameGeometry().topLeft();
        event->accept();
    }
}

void MouseMoveEvent(QMouseEvent *event) {
    if (event->buttons() & Qt::LeftButton) {
        move(event->globalPosition().toPoint() - dragPosition);
        event->accept();
    }
}

---

3. 设置窗口图标和标题

// 设置窗口标题
setWindowTitle("My Custom Window");


// 设置窗口图标
setWindowIcon(QIcon(":/icons/app_icon.png"));

---

4. 高级样式控制

平台特定样式

// 在Windows下使用原生样式
QApplication::setStyle("windowsvista");


// 在macOS下使用融合样式
QApplication::setStyle("fusion");

动态切换样式

// 切换深色/浅色主题
QFile file(":/dark_theme.qss");
file.open(QFile::ReadOnly);
qApp->setStyleSheet(file.readAll());
file.close();

---

注意事项

1. 样式优先级：子控件会继承父窗口的样式，除非显式覆盖。
2. 性能优化：复杂样式表可能影响渲染性能，建议使用 QSS 调试工具预览效果。
3. 跨平台兼容性：某些样式（如圆角）在无边框窗口下需手动实现拖动和阴影。

通过组合上述方法，可实现高度定制化的Qt窗口界面。具体需求可参考Qt Style Sheets | Qt Widgets | Qt 6.9.1。

3.关联链接

Ubuntu+gnome 关于设置系统样式的链接-优快云博客

4.关联知识 

1.平台样式

Qt 平台提供了多种内置样式（Styles），用于控制应用程序的界面外观。这些样式可分为 平台相关样式（适配系统原生主题）和 跨平台样式（所有系统下保持一致外观），部分样式仅适用于特定组件类型（如 Widgets 或 Quick Controls）。以下是详细说明及表格总结：

一、Qt 内置样式分类及特点

1. 平台相关样式（适配系统原生主题）

这类样式会与当前操作系统的主题保持一致，适合需要融入系统环境的桌面应用。

样式名称	适用系统	特点	备注
Windows	Windows	适配 Windows 系统默认主题，外观与当前系统版本（如 Win7、Win10、Win11）一致。旧版 Qt（如 5.6）曾提供 WindowsXP/WindowsVista 样式，新版已合并为通用 Windows 样式。	仅在 Windows 下生效，依赖系统主题。
macOS (Aquawhite)	macOS	适配 macOS 系统原生主题，使用苹果的界面元素（如按钮、菜单栏、滚动条），符合 macOS 设计规范。	仅在 macOS 下生效，依赖系统主题。
GTK+	Linux/Unix	在 Linux/Unix 系统下使用 GTK+ 工具包的样式，外观与系统桌面环境（如 GNOME、Xfce）主题一致。	需系统安装 GTK+ 库，仅在 Linux/Unix 下生效。
CDE/Motif	Unix/Linux	适配传统的 CDE（Common Desktop Environment）或 Motif 窗口管理器样式，界面较为传统（平面、无阴影）。	适用于遗留 Unix 系统或需要传统风格的应用，较少使用。

2. 跨平台样式（所有系统下一致）

这类样式不依赖系统主题，适合需要统一外观的跨平台应用（桌面/移动）。

样式名称	适用组件	特点	备注
Fusion	Widgets	现代扁平化设计，带有平滑渐变和阴影效果，跨平台一致。支持高对比度主题，适合需要现代感的应用。	默认跨平台样式（Qt 5.7+ 推荐），适合桌面应用。
Plastic	Widgets	具有塑料质感的 3D 立体效果，类似旧版 Windows（如 XP）的立体风格，颜色较鲜艳。	适合传统桌面应用，跨平台可用。
Universal	Widgets（旧版）	早期跨平台样式，设计较简单，已逐渐被 Fusion 取代。	Qt 5.6 及更早版本的默认跨平台样式，新版建议使用 Fusion。

3. Quick Controls 专用样式（适用于 QML/移动端）

Qt Quick Controls 2 提供了独立的主题系统，支持现代设计规范（如 Material Design）。

样式名称	适用组件	特点	备注
Material	Quick Controls 2	遵循 Google Material Design 规范，扁平化设计，支持颜色、阴影、动画效果，适合移动和现代桌面应用。	需使用 QML（.qml 文件），支持自定义主题颜色（Primary/Accent）。
iOS	Quick Controls 2	适配 iOS 系统原生风格，按钮、导航栏、滑动操作等符合 iOS 设计规范。	仅在 iOS 下生效，需使用 QML。
Basic	Quick Controls 2	最简化的样式，无平台特定元素，适合需要自定义外观的应用。	默认样式，跨平台可用，无额外依赖。

二、表格总结（Widgets 样式）

以下为 Qt Widgets 的内置样式对比（Quick Controls 样式见上文）：

样式名称	类型	适用系统	外观风格	跨平台支持	备注
Windows	平台相关	Windows	系统原生主题（Win7/10/11）	否	依赖系统版本，旧版有 XP/Vista 样式，新版合并为通用。
macOS (Aquawhite)	平台相关	macOS	苹果原生主题（按钮/菜单）	否	仅 macOS 生效，适配系统更新。
GTK+	平台相关	Linux/Unix	系统 GTK+ 主题	否	需 GTK+ 库，Linux 桌面环境一致。
CDE/Motif	平台相关	Unix/Linux	传统 CDE/Motif 平面风格	否	遗留系统适用，较少使用。
Fusion	跨平台	所有系统	现代扁平+渐变/阴影	是	默认跨平台样式（Qt 5.7+），推荐使用。
Plastic	跨平台	所有系统	塑料质感 3D 立体	是	传统立体风格，跨平台一致。
Universal	跨平台	所有系统	早期简单跨平台样式	是	Qt 5.6 及更早默认，新版建议换 Fusion。

三、关键说明

• 样式切换方法：通过 QApplication::setStyle() 或 QQuickStyle::setStyle() 设置（Widgets 用前者，Quick 用后者）。
  示例（Widgets）：

  QApplication::setStyle("Fusion"); // 切换为 Fusion 样式

  示例（Quick）：

  QQuickStyle::setStyle("Material"); // 切换为 Material 样式（需 QML）

• 自定义样式：可通过继承 QStyle（Widgets）或 QQuickStyle（Quick）实现完全自定义外观。
• 平台限制：平台相关样式（如 macOS、GTK+）仅在对应系统下生效，跨平台样式（Fusion、Plastic）在所有系统可用。

通过合理选择样式，可让 Qt 应用既适配系统环境，又保持跨平台一致性。