1.一些常用控件的作用和使用场景
1.1布局管理器（Layout）
这四个是 Qt Designer 里最核心的布局管理器（Layout），作用是让你的界面控件自动适应窗口大小、整齐排列、不会乱飘
①Vertical Layout（垂直布局）
核心作用
把控件从上到下、垂直排成一列，就像手机列表一样。
控件会自动平分垂直方向的空间，窗口拉大 / 缩小，控件会跟着等比例缩放，不会挤在一起。
适用场景
音乐播放器的「播放列表」（歌曲名从上到下排）
左侧功能栏（首页、我的、收藏等按钮垂直排列）
播放器的控制区（进度条、音量条垂直堆叠）
②Horizontal Layout（水平布局）
核心作用
把控件从左到右、水平排成一行，就像工具栏一样。
控件自动平分水平方向的空间，窗口缩放时自动适配。
适用场景
音乐播放器的「底部控制栏」（上一曲、播放 / 暂停、下一曲、音量按钮水平排列）
顶部导航栏（返回、搜索、菜单按钮水平排列）
歌词显示区的时间标签（当前时间 / 总时长左右排列）
③Grid Layout（网格布局）
核心作用
把控件像 Excel 表格一样，按行和列排列，可以自由跨行、跨列，是最灵活的布局。
可以精准控制每个控件的位置，比如一个控件占 2 行 1 列，另一个占 1 行 2 列。
适用场景
音乐播放器的「专辑封面 + 歌曲信息」（封面占左列 2 行，歌名 / 歌手占右列 2 行）
歌单的网格展示（封面 + 标题按 3 列 / 4 列网格排列）
复杂的设置界面（多组选项按行列整齐排列）
④Form Layout（表单布局）
核心作用
专门做「标签 + 输入框」的表单界面，自动把标签右对齐、输入框左对齐，是最规范的表单布局。左边是标签（Label），右边是输入控件（LineEdit、SpinBox 等），自动对齐，不用手动调间距。
适用场景
音乐播放器的「登录 / 注册界面」（用户名标签 + 输入框、密码标签 + 输入框）
「新建歌单」界面（歌单名标签 + 输入框、描述标签 + 输入框）
软件设置界面（音量标签 + 滑块、主题标签 + 下拉框）
1.2按钮类控件
① Push Button（普通按钮）
核心作用
最常用的点击触发动作按钮，就是我们最熟悉的按钮样式。
特点
可显示文字 / 图标，点击后触发事件，支持悬停、按下、禁用等状态。
音乐播放器场景
底部控制栏的「播放 / 暂停」「上一曲」「下一曲」按钮
「搜索」「收藏」「删除歌单」等功能按钮
登录界面的「登录」「注册」按钮
例句：点击「播放」Push Button，触发音乐播放逻辑。
②Tool Button（工具按钮）
A.核心作用
专门给工具栏 / 菜单栏用的按钮，主打「图标优先」，适合做快捷操作。
B.特点
默认只显示图标（也可加文字），样式更紧凑，支持下拉菜单、弹出面板。
C.音乐播放器场景
顶部工具栏的菜单,设置,搜索.图标按钮
播放列表里的「更多操作」（右键菜单的快捷入口）
歌词界面的「放大 / 缩小」「翻译切换」按钮
例句：用 Tool Button 做播放器右上角的「设置」图标，点击弹出设置面板。
③ Radio Button（单选按钮）
A.核心作用
多选一，一组里只能选一个，用于互斥选项。
B.特点
圆形单选框，同一组内只能选中一个，选中后自动取消其他选项。
C.音乐播放器场景：
播放模式选择：「顺序播放」「随机播放」「单曲循环」（三选一）
音质选择：「标准音质」「高清音质」「无损音质」（三选一）
主题选择：「浅色模式」「深色模式」「跟随系统」（三选一）
例句：在设置页用 Radio Button 做播放模式切换，只能选一种播放逻辑。
④ Check Box（复选框）
A.核心作用
多选多，可同时选中多个，用于非互斥选项。
B.特点
方形复选框，支持**「选中 / 未选中 / 半选中」三种状态**，可批量选择。
C.音乐播放器场景
批量选择播放列表里的歌曲（多选删除 / 多选添加到歌单）
权限设置
「允许后台播放」「允许通知栏控制」「自动下载歌词」（可同时开多个）
筛选歌单
「仅显示本地歌曲」「仅显示收藏歌曲」（可同时勾选）
例句：用 Check Box 做歌单筛选，同时勾选「本地」和「收藏」，显示符合两个条件的歌曲。
⑤ Command Link Button（命令链接按钮）
A.核心作用
带引导性的「链接式按钮」，适合做向导 / 步骤引导。
B.特点
类似网页链接，可显示主标题 + 副标题说明，视觉上更像 "入口"，而非普通按钮。
C.音乐播放器场景
新手引导页：「创建我的第一个歌单」「导入本地音乐」「同步云端歌单」
功能入口：「开通会员」「查看听歌排行」「反馈问题」
例句：在首页用 Command Link Button 做「导入本地音乐」入口，副标题写 "一键添加电脑里的歌曲"。
⑥ Dialog Button Box（对话框按钮组）
A.核心作用
一键生成标准对话框按钮，不用手动拖多个按钮，自动适配系统风格。
B.特点
内置「确定 / 取消 / 应用 / 帮助」等标准按钮，自动排列、自动关联信号槽，符合系统交互规范。
C.音乐播放器场景
弹出对话框：「新建歌单」（确定 / 取消）、「删除歌曲」（确定 / 取消）、「修改信息」（确定 / 取消）
设置对话框：「应用 / 取消 / 确定」按钮组
例句：做「删除歌单」弹窗时，直接拖 Dialog Button Box，自动生成「确定」和「取消」按钮，不用手动排版。
1.3弹簧类控件
① Horizontal Spacer（水平弹簧）
作用：
在水平方向（左右）把控件撑开，自动把空隙占满。像个可伸缩的橡皮筋，左边推满，右边推满。
播放器场景
你有三个按钮（上一曲、播放/暂停、下一曲）水平排列。如果你不加弹簧，按钮会挤在中间，很难看。你在第一个按钮左边加一个 Horizontal Spacer：窗口变大时 → 弹簧变长 → 上一曲 按钮死死贴在最左边。你在按钮中间加一个：三个按钮自动平分剩余空间，均匀分散。
② Vertical Spacer（垂直弹簧）
作用
在垂直方向（上下）把控件撑开，自动把空隙占满。像个可伸缩的柱子，上边推满，下边推满。
播放器场景
你想把专辑封面放在窗口的正中间。你给封面的上面套一个 Vertical Spacer，下面也套一个：无论窗口拉大还是拉小，封面都会始终停在正中间！想让控件贴底：在控件下面加 Vertical Spacer。
想让控件贴顶：在控件上面加 Vertical Spacer。
1.4列表 / 树形 / 表格控件
这一组是 Qt 里基于模型 - 视图架构（MVC）的列表 / 树形 / 表格控件，专门用来展示大量结构化数据，是做音乐播放器「播放列表、歌单管理」的核心控件；
① List View（列表视图）
核心作用
展示一维、垂直排列的列表数据，是最基础的列表控件，只显示单列内容，支持单选 / 多选。就是
手机里的歌曲列表样式，一行一个条目，从上到下滚动。
音乐播放器场景
播放列表 / 本地歌曲列表（一行显示一首歌曲名 + 歌手）
我的歌单列表（一行一个歌单名称）
搜索结果列表（一行一个匹配的歌曲）
用 List View 展示本地音乐列表，点击条目直接播放对应歌曲。
②Tree View（树形视图）
核心作用
展示层级化、树形结构的数据，支持展开 / 折叠父节点，适合有上下级关系的数据。就是电脑里的「文件夹树」，可以展开文件夹看里面的文件，层级清晰。
音乐播放器场景
本地音乐文件树（按「歌手→专辑→歌曲」层级展示，展开歌手看专辑，展开专辑看歌曲）
我的歌单分类树（「我的收藏→喜欢的歌→2025 年歌单」多层级）
播放历史树（按「日期→歌曲」层级展示）
用 Tree View 做本地音乐文件浏览器，按歌手 - 专辑 - 歌曲三级树形结构管理音乐。
③ able View（表格视图）
核心作用
展示二维、表格形式的数据，支持多列、表头、排序、筛选，适合结构化的多字段数据。其实就是就是 Excel 表格，一行一条数据，一列一个属性，比如「歌曲名、歌手、时长、大小」。
音乐播放器场景
完整的歌曲信息列表（多列显示：歌曲名、歌手、专辑、时长、文件大小）
歌单管理表格（多列显示：歌单名、歌曲数、创建时间、最后播放时间）
播放统计表格（多列显示：歌曲名、播放次数、最后播放时间）
用 Table View 做歌曲详情列表，表头设为「歌曲名、歌手、时长、文件路径」，清晰展示所有歌曲信息。
④Column View（列视图）
核心作用
展示层级化的多列数据，每一列对应一个层级，点击上一列的条目，下一列显示子数据，是 macOS Finder 风格的视图。就是「分栏浏览」，左栏选歌手，中栏显示该歌手的专辑，右栏显示该专辑的歌曲，逐级深入。
音乐播放器场景
音乐分栏浏览器（左栏：歌手 → 中栏：专辑 → 右栏：歌曲）
歌单分栏浏览（左栏：歌单分类 → 中栏：歌单 → 右栏：歌单内歌曲）
用 Column View 做音乐分栏浏览，用户点击左栏歌手，中栏自动加载该歌手的专辑，点击专辑右栏加载歌曲，操作流畅。
⑤Undo View（撤销视图）
核心作用
专门用来展示撤销 / 重做操作的历史记录，是 Qt 内置的辅助控件，和业务数据展示无关。就是「操作历史面板」，显示用户做过的所有可撤销操作，比如删除歌曲、修改歌单等。软件的「操作历史」面板（显示用户删除歌曲、重命名歌单、批量移动等操作，支持一键撤销）
用 Undo View 做播放器的「操作历史」侧边栏，用户误删歌单后，直接点击历史记录一键恢复
1.5 Item Widget 条目小控件
这一组是 Qt 里基于 Item（条目）的便捷版列表 / 树形 / 表格控件，和刚才的 Item Views (Model-Based) 是功能对应、用法更简单的版本，专门用来快速开发小体量数据展示
| 类别 | 核心架构 | 用法特点 | 适用场景 |
|---|---|---|---|
| Item Widgets (Item-Based) | 内置数据 + 视图一体（非 MVC） | 开箱即用，不用单独写 Model，直接 addItem 加数据 | **小体量数据、**快速开发、简单界面（比如你的音乐播放器） |
| Item Views (Model-Based) | 模型 - 视图分离（MVC） | 必须搭配 Model，数据和界面分离 | 大数据量、复杂界面、需要数据复用 / 多视图展示 |
① List Widget（列表部件）
核心作用
List View 的便捷版，展示一维、垂直排列的列表数据，内置数据存储，不用单独绑定 Model，直接添加条目。就是手机里的「歌曲列表」，一行一个条目，从上到下滚动，拖到界面就能用，不用写 Model 代码。
音乐播放器场景
播放列表 / 本地歌曲列表（一行显示歌曲名 + 歌手）
我的歌单列表（一行一个歌单名称）
搜索结果列表（一行一个匹配的歌曲）
②Tree Widget（树形部件）
核心作用
Tree View 的便捷版 ，展示层级化、树形结构的数据，支持展开 / 折叠父节点，内置数据存储，不用单独绑定 Model。就是电脑里的「文件夹树」，可以展开文件夹看里面的文件，拖到界面就能用，直接加父子节点。
音乐播放器场景
- 本地音乐文件树（按「歌手→专辑→歌曲」层级展示）
- 我的歌单分类树（「我的收藏→喜欢的歌→2025 年歌单」多层级）
- 播放历史树（按「日期→歌曲」层级展示）
用 Tree Widget 做本地音乐文件浏览器，直接创建父节点（歌手）、子节点（专辑 / 歌曲），不用写 Model。
③ Table Widget（表格部件）
核心作用
Table View 的便捷版，展示二维、表格形式的数据，支持多列、表头、排序，内置数据存储，不用单独绑定 Model。就是 Excel 表格，一行一条数据，一列一个属性，拖到界面就能用，直接设置单元格内容。
音乐播放器场景
完整的歌曲信息列表（多列显示：歌曲名、歌手、专辑、时长、文件大小）
歌单管理表格（多列显示：歌单名、歌曲数、创建时间、最后播放时间）
播放统计表格（多列显示：歌曲名、播放次数、最后播放时间）
用 Table Widget 做歌曲详情列表，直接设置表头、填充单元格内容，不用写 Model。
1.6 容器控件 Container
这一组是 Qt 里的容器控件，核心作用是承载、组织其他控件，帮你把界面分区域、分层级、做交互切换，是搭建音乐播放器复杂界面的骨架；
① Group Box（分组框）
核心作用：给一组相关控件做视觉分组 + 逻辑分组，自带标题栏，让界面结构更清晰。
特点：可设置标题、可勾选（勾选后组内控件启用 / 禁用），组内控件会跟着分组框一起移动、显示 / 隐藏。
音乐播放器场景： 把「播放模式、音质选择、主题设置」等选项放在一个 Group Box 里，标题设为「播放设置」 把「登录、注册、忘记密码」放在一个 Group Box 里，标题设为「账号管理」 例句：用 Group Box 给播放器的「音效设置」分组，包含均衡器、混响、环绕声等控件，界面更整洁。
② Scroll Area（滚动区域）
核心作用：给内容超出窗口大小的控件加滚动条，让用户可以滚动查看全部内容。
特点 ：自动根据内容大小显示垂直 / 水平滚动条，可设置滚动条样式、滚动范围。 音乐播放器场景： 超长的播放列表、歌词列表，窗口缩小时自动出现滚动条 复杂的设置界面，内容太多一屏放不下，用 Scroll Area 包裹
例句：用 Scroll Area 包裹歌词显示区，歌词太长时自动出现垂直滚动条，用户可滚动查看完整歌词。
③ Tool Box（工具箱）
核心作用：做折叠式的分类面板，每个分类对应一个页面，点击标题展开 / 折叠，适合分类展示大量工具 / 选项。
特点：类似手机里的「折叠菜单」，每个页面可放一组控件，节省界面空间。 音乐播放器场景： 左侧分类面板：「我的音乐、我的歌单、本地音乐、收藏」，每个分类对应一个 Tool Box 页面 音效设置面板：「均衡器、混响、环绕声、降噪」，每个分类折叠展示
例句：用 Tool Box 做播放器的「音效工具箱」，每个分类折叠，用户点击展开对应设置，节省界面空间。
④ Tab Widget（标签页控件）
核心作用：做多标签页界面，每个标签对应一个页面，点击标签切换页面，是最常用的界面切换控件。
特点：标签可放在顶部 / 底部 / 左侧 / 右侧，支持添加、删除、重命名标签，每个页面可放独立控件。
音乐播放器场景： 主界面标签页：「推荐、歌单、歌手、排行榜」，点击标签切换不同页面
设置界面标签页：「播放设置、音效设置、外观设置、账号设置」 例句：用 Tab Widget 做音乐播放器的主界面，「推荐」「我的」「发现」三个标签页，用户点击切换不同功能区。
⑤ Stacked Widget（堆叠窗口）
核心作用 ：做多页面堆叠切换，多个页面叠在一起，通过代码控制显示哪个页面，适合无标签的页面切换。
特点：不显示标签，完全通过代码控制页面切换，可做自定义切换动画。 音乐播放器场景： 登录 / 注册页面切换：点击「注册」按钮，Stacked Widget 切换到注册页面 播放器模式切换：「迷你模式、完整模式、歌词模式」，通过按钮切换不同页面
用 Stacked Widget 做播放器的「登录 / 注册」页面，点击「去注册」按钮，切换到注册页面，无标签更简洁。
⑥ Frame（框架）
核心作用 ：给控件做视觉边框 / 分隔，纯装饰性容器，不影响控件逻辑，只美化界面。
特点 ：可设置边框样式、颜色、阴影，用来分隔界面区域，让界面更有层次感。
音乐播放器场景： 给专辑封面加一个 Frame 边框，突出显示 给播放控制栏加一个 Frame 边框，和主界面分隔开
用 Frame 给播放器的「专辑封面」加一个圆角边框，界面更美观。
⑦Widget（基础容器）
核心作用 ：Qt 所有控件的基类容器，是最基础的空白画布，用来承载其他控件，做布局的载体。
特点：无默认样式，可自定义背景、边框，是所有界面的基础容器。
音乐播放器场景： 主界面的空白画布，用来放所有控件、布局 自定义控件的基类，比如自定义播放按钮、自定义进度条
用 Widget 做播放器主界面的载体，给所有控件套上布局，实现界面自适应。
⑧ MDI Area（多文档界面区域）
核心作用 ：做多窗口嵌套界面，在一个主窗口里打开多个子窗口，类似 Word 的多文档界面。
特点：支持子窗口最大化、最小化、平铺、层叠，适合多文档管理。
音乐播放器场景： 同时打开多个歌单编辑窗口、多个歌词编辑窗口 多文件音乐管理界面，同时打开多个文件夹的音乐列表 ；
用 MDI Area 做音乐管理器，同时打开多个歌单窗口，用户可自由切换、排列。
⑨ Dock Widget（停靠窗口）
核心作用 ：做可停靠、可拖动的浮动窗口，类似 IDE 的侧边栏，可拖到窗口四周、浮动、隐藏。
特点：可设置停靠区域、是否可浮动、是否可关闭，适合做辅助面板。
音乐播放器场景： 播放器的「歌词面板、播放列表面板、搜索面板」，可拖到窗口右侧、浮动、隐藏 音效设置面板，用户可拖动到任意位置，随时打开 / 关闭；
列如：用 Dock Widget 做播放器的「歌词浮动窗口」，用户可拖动到桌面任意位置，边听歌边看歌词。
⑩ QAxWidget（ActiveX 容器）
核心作用：在 Qt 程序里嵌入 ActiveX 控件（比如 Windows 媒体播放器、Office 控件等），用来集成第三方组件。
特点 ：仅支持 Windows 平台，用来集成系统自带的 ActiveX 组件。
音乐播放器场景： 嵌入 Windows Media Player 控件，直接用系统播放器播放音乐嵌入 Flash 控件（已淘汰，现在基本不用）
例如：用 QAxWidget 嵌入系统媒体播放器，快速实现音乐播放功能，不用自己写播放逻辑
1.7 输入控件组 Input Widget
Input Widgets（输入控件组），是用户交互、数据选择的核心控件
① Combo Bpx（组合框/下拉框）
核心作用
提供下拉选择列表，让用户从预设选项中单选，既节省界面空间，又能规范用户输入（避免手动输入错误）。其实就是网页 / 软件里常见的「下拉菜单」，点击箭头展开选项，选中后自动收起，只显示当前选择项。
核心特点
支持静态添加选项（Qt Designer 直接填）和动态添加 / 删除（代码控制）
可设置为可编辑模式（用户可手动输入自定义内容）
支持图标 + 文字的选项样式，适配个性化界面
选中项变化时触发信号，可绑定槽函数实现联动逻辑
音乐播放器场景
音质选择：「标准音质」「高清音质」「无损音质」三选一
播放速度选择：「0.5 倍」「1.0 倍」「1.5 倍」「2.0 倍」
主题选择：「浅色模式」「深色模式」「跟随系统」
歌单分类选择：「全部」「我的收藏」「本地音乐」「最近播放]
②字体下拉框 Font Combo Box
Font Combo Box 是 Qt 里 专门用于选择字体的下拉框 ，它是 QComboBox 的特殊版本 ，自带字体预览功能，是做歌词显示、文本编辑、设置界面的高频控件。就是 Qt 版的字体选择器，比普通的 Combo Box 更智能 ------它显示什么字体，选出来就是什么字体
核心作用
- 一键选择字体：下拉列表展示系统所有可用字体（如微软雅黑、宋体、Arial），选中后自动应用。
- 实时字体预览 ：下拉列表里的每个选项，直接用对应字体显示（比如 "微软雅黑" 选项就用微软雅黑字体展示），用户一眼能看到效果。
- 规范字体选择：限制用户只能选择系统安装的字体，避免输入无效字体名称。
| 场景 | 作用 | 实现效果 |
|---|---|---|
| 歌词显示设置 | 切换歌词的字体 | 选中 "华文琥珀"，歌词立刻变成琥珀体，更有艺术感 |
| 歌曲信息展示 | 调整歌手 / 歌名的字体风格 | 主界面歌名用 "幼圆"，歌手名用 "楷体"，提升界面层次感 |
| 文本编辑 / 备注 | 编辑歌单描述、反馈文本 | 让用户自由选择喜欢的字体输入内容 |
| 播放控制栏美化 | 自定义按钮 / 标签字体 | 让 "播放 / 暂停" 按钮文字更醒目，匹配播放器整体 UI |
③ Line Edit 单行输入框
Line Edit 是 Qt 最基础、最常用的单行文本输入控件，专门用于接收用户的短文本输入，是做音乐播放器搜索、登录、命名等功能的核心控件。就是我们平时用软件时最常见的输入框，比如搜索框、登录的用户名 / 密码框，只能打一行字，不能换行；
核心作用
接收单行文本输入：用户只能输入一行内容，适合短文本场景
支持多种输入模式：普通文本、密码（隐藏输入）、只读、禁用等
内置输入校验：可限制输入格式（如数字、邮箱、手机号），避免非法输入
信号联动：输入内容变化、回车按下等操作可触发槽函数，实现实时交互；
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 搜索框 | 输入歌曲名 / 歌手名 / 歌单名，点击搜索按钮匹配列表 | 输入「周杰伦」，自动筛选出所有周杰伦的歌曲 |
| 登录 / 注册 | 用户名输入框、密码输入框（设置 EchoMode 为密码模式） |
密码输入时显示圆点，保护隐私 |
| 歌单命名 | 新建歌单时，输入歌单名称 | 给歌单起名字，比如「我的最爱」「跑步专用」 |
| 批量操作 | 输入歌曲 ID / 文件名，批量添加到播放列表 | 快速导入多首歌曲 |
| 搜索联想 | 输入时实时触发搜索，下拉显示匹配结果 | 输入「晴天」，自动联想「晴天 - 周杰伦」等结果 |
④ Text Edit 富文本的文本编辑控件
Text Edit 是 Qt 中支持多行、富文本的文本编辑控件，是 Line Edit 的增强版，专门用于长文本的展示与编辑，也是你做音乐播放器歌词、备注等功能的核心控件。就是一个「迷你记事本」，可以输入、编辑、展示大段文字，还能给文字加样式、插图片，和只能输一行的 Line Edit 完全不同。
核心作用
多行文本输入与展示：支持换行、滚动，可容纳大量长文本
富文本支持：可直接显示 HTML 格式内容（如字体、颜色、图片、超链接）
滚动条自动适配：内容超出可视区域时，自动显示垂直 / 水平滚动条
丰富的编辑功能：内置复制、粘贴、撤销、重做、全选等操作，无需额外编码
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 歌词展示 / 编辑 | 显示完整歌词，支持滚动查看，可手动编辑歌词 | 播放歌曲时，歌词逐行滚动，支持用户修改歌词内容 |
| 歌单 / 歌曲备注 | 给歌单、歌曲添加长描述、个人感悟 | 给「跑步歌单」添加备注：「适合晨跑、节奏 180BPM」 |
| 用户反馈 / 意见 | 让用户输入长文本反馈问题、建议 | 收集用户对播放器的使用意见 |
| 歌曲介绍 / 专辑文案 | 展示歌手、专辑的详细介绍文案 | 显示周杰伦《叶惠美》专辑的创作背景、歌曲介绍 |
| 日志 / 调试信息 | 显示播放器的运行日志、播放记录 | 后台记录播放历史、错误信息，方便调试 |
⑤ Plain Text Edit
Plain Text Edit 是 Qt 中轻量、高性能的纯文本多行编辑控件，是 Text Edit 的极简版，专门用于纯文本的展示与编辑，和 Text Edit 形成互补。就是一个无格式记事本，只能输入纯文本，不能给文字加样式、插图片，比 Text Edit 更轻、更快，适合只需要纯文本的场景。
核心作用
纯文本多行输入与展示：仅支持无格式的纯文本，不解析 HTML，性能更优
滚动条自动适配：内容超出可视区域时，自动显示垂直滚动条
高效编辑：内置复制、粘贴、撤销、重做等基础操作，适合大段纯文本
光标精准控制：支持逐行定位、选中，适合日志、代码等场景
| 场景 | 用法说明 | 核心优势 |
|---|---|---|
| 日志 / 调试信息展示 | 实时输出播放器运行日志、播放记录、错误信息 | 性能高，大段日志滚动流畅，无格式开销 |
| 纯文本歌词展示 | 显示无格式的歌词文本，适合快速加载 | 加载速度快，适合大量歌词文本 |
| 代码 / 配置编辑 | 编辑播放器的配置文件、自定义脚本 | 纯文本无干扰，适合代码编辑 |
| 批量文本处理 | 批量导入歌曲列表、歌单数据 | 纯文本格式，方便批量读取、处理 |
| 用户反馈纯文本输入 | 让用户输入纯文本反馈，无格式干扰 | 输入简洁，方便后台处理 |
⑥整数微调框
Spin Box 是 Qt 中专门用于整数输入 / 调整的控件，自带上下箭头微调按钮，能严格限制输入范围，是做数值精准调节的核心控件，和你做音乐播放器的音量、进度等功能高度适配。就是一个「带上下箭头的数字输入框」，只能输入整数，点箭头就能加减数字，还能限制输入范围，防止输错。
核心作用
整数数值输入与微调：用户可直接输入整数，或点击上下箭头增减数值
范围严格限制：可自定义最小值、最大值、步长，避免非法输入
前缀 / 后缀支持：可给数值加单位（如 %、dB），提升可读性
信号联动：数值变化时触发信号，可实时同步其他控件（如滑块）
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 音量数值调节 | 范围 0-100，步长 1，后缀加 % |
显示「80%」，点击箭头增减音量，和音量滑块双向同步 |
| 播放进度跳转 | 范围 0 - 歌曲总时长（秒），步长 1 | 输入秒数直接跳转到对应播放位置 |
| 均衡器频段调节 | 范围 -12dB 到 +12dB，步长 1 | 精准调节每个频段的增益，实现音效自定义 |
| 播放速度调节 | 范围 50-200，步长 10，后缀加 % |
0.5 倍速到 2 倍速，精准控制播放速度 |
| 歌单排序优先级 | 范围 1-10，步长 1 | 给歌单设置排序优先级，自定义展示顺序 |
⑦ Double Spin Box ->浮点数（小数）输入 / 调整的控件
Double Spin Box 是 Qt 中专门用于浮点数（小数）输入 / 调整的控件，是 Spin Box 的「小数增强版」，自带上下箭头微调，支持自定义精度、范围，是做精细数值调节的核心控件，完美适配音乐播放器的音效、速度等精细调节场景。就是一个「带上下箭头的小数输入框」，能输入 / 调节带小数点的数字，比如 1.25、0.75，还能限制小数位数，防止输错。
核心作用
浮点数（小数）输入与微调: 支持手动输入小数，或点击上下箭头增减数值
高精度范围控制： 可自定义最小值、最大值、步长、小数位数，严格限制输入
前缀 / 后缀支持： 可添加单位（如 x、dB），提升数值可读性
双向联动： 数值变化时触发信号，可实时同步滑块、其他控件
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 播放速度精细调节 | 范围 0.5x - 2.0x，步长 0.1，后缀 x |
支持 0.5 倍、1.25 倍、1.75 倍等精细速度调节 |
| 均衡器频段精细调节 | 范围 -15.0dB 到 +15.0dB，步长 0.5，后缀 dB |
精准调节每个频段的增益，实现专业音效自定义 |
| 音量精细调节 | 范围 0.0 - 100.0，步长 0.5，后缀 % |
比整数音量更精细，适合专业用户微调 |
| 音高 / 音调调节 | 范围 -12.0 到 +12.0（半音），步长 1.0 | 调整歌曲音调，适配不同音高需求 |
| 时间轴精细跳转 | 范围 0.0 - 歌曲总时长（秒），步长 0.1 | 精准跳转到 0.1 秒级别的播放位置 |
⑧ Time Edit 时间选择和输入控件
Time Edit 是 Qt 中专门用于时间选择与输入的控件，自带时间选择器，能严格规范时间格式，是做时间相关设置、定时任务的核心控件，也能完美适配音乐播放器的定时、计时等场景。就是一个「带时间选择器的输入框」，只能输入合法时间，点箭头就能弹出日历式时间选择器，不用手动输，还能防止输错时间格式。
核心作用
时间输入与选择：支持手动输入时间，或点击下拉箭头弹出时间选择器选择
格式严格校验：自动校验时间合法性（如 25:00 会自动修正），避免非法输入
时间格式自定义：支持 12/24 小时制、自定义显示格式（如 hh:mm:ss / hh:mm AP）
信号联动：时间变化时触发信号，可实现定时、倒计时等逻辑
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 定时关闭 | 设置播放器自动关闭时间（如 23:30） | 到点自动关闭播放器，适合睡前听歌 |
| 定时播放 | 设置定时启动播放（如 7:00 自动播放起床歌） | 到点自动启动播放器，播放指定歌单 |
| 歌曲定时剪辑 | 设置歌曲剪辑的起始 / 结束时间（如 00:30-01:20） | 精准截取歌曲片段，制作铃声 |
| 播放计时 / 倒计时 | 显示当前播放时长、剩余时长，设置倒计时停止 | 实时显示播放时间，倒计时结束自动暂停 |
| 定时切换歌单 | 设置定时切换歌单（如 20:00 切换到夜听歌单） | 到点自动切换歌单，适配不同时段听歌需求 |
⑨Date Edit 日期选择和输入控件
Date Edit 是 Qt 中专门用于日期选择与输入的控件，自带日历选择器，能严格规范日期格式，是做日期筛选、定时任务、数据统计的核心控件，也能完美适配音乐播放器的各类日期相关功能。就是一个「带日历的日期输入框」，点一下就能弹出日历选日期，不用手动输，还能防止输错日期格式，是日期输入的标准化控件。
核心作用
日期输入与选择：支持手动输入日期，或点击下拉箭头弹出日历选择器可视化选择
合法性自动校验：自动修正非法日期（如 2025/02/30 会自动调整），避免错误输入
格式高度自定义：支持 yyyy-MM-dd、MM/dd/yyyy 等多种显示格式，适配不同地区习惯
范围限制：可自定义最小 / 最大日期，限制用户选择区间（如仅能选择近 30 天）
信号联动：日期变化时触发信号，可实现日期筛选、定时任务等逻辑
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 播放历史日期筛选 | 选择日期，筛选当天 / 指定日期的播放记录 | 输入「2025-04-01」，自动展示当天听过的所有歌曲 |
| 定时任务（按天） | 设置指定日期执行任务（如 2025-04-10 自动备份歌单） | 到指定日期自动执行备份、清理等操作 |
| 歌单创建 / 修改日期筛选 | 筛选指定日期创建的歌单（如近 7 天创建的歌单） | 快速找到近期新建的歌单，方便管理 |
| 会员到期 / 订阅日期设置 | 显示会员到期日，设置订阅续费提醒 | 到期前自动提醒用户续费 |
| 歌曲发布日期筛选 | 按发布年份 / 日期筛选歌曲（如 2020-2025 年发行的歌曲） | 快速找到指定年代的歌曲，生成年代歌单 |
⑩Date /Time Edit
DateTime Edit 是 Qt 中同时支持日期 + 时间选择与输入的控件，是 Date Edit 和 Time Edit 的「组合增强版」，自带日历 + 时间选择器，能完整规范日期时间格式，是做精准定时、时间戳筛选的核心控件，完美适配音乐播放器的各类时间相关功能。就是一个**「带日历 + 时钟的完整时间输入框」，能一次性选好「哪天几点」，不用分开选日期和时间，还能防止输错格式，是精准时间输入的标准化控件。**
核心作用
完整日期时间输入与选择：支持手动输入 年月日 时分秒，或点击下拉弹出日历 + 时间选择器可视
化选择合法性自动校验：自动修正非法日期时间（如 2025/02/30 25:00 会自动调整），避免错误输入
格式高度自定义：支持 yyyy-MM-dd hh:mm:ss 等多种格式，适配 12/24 小时制、不同地区习惯
范围限制：可自定义最小 / 最大日期时间，限制选择区间（如仅能选择近 30 天内的时间）
信号联动：时间变化时触发信号，可实现精准定时、时间筛选等逻辑
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 精准定时任务 | 设置「2025-04-05 07:00:00」自动播放起床歌 | 到指定日期时间，自动启动播放器播放指定歌单 |
| 播放历史精准筛选 | 选择「2025-04-01 18:00:00」到「2025-04-02 00:00:00」的播放记录 | 精准筛选出晚上听歌的记录，生成晚间歌单 |
| 定时关闭（跨天） | 设置「2025-04-05 01:00:00」自动关闭播放器 | 睡前设置，跨天到点自动关闭，适合熬夜听歌 |
| 歌曲发布时间筛选 | 按「2020-01-01 00:00:00」到「2025-12-31 23:59:59」筛选歌曲 | 精准筛选指定时间段发行的歌曲，生成年代歌单 |
| 定时备份 / 同步 | 设置「每周日 22:00:00」自动备份歌单 | 到指定时间自动执行备份，保障数据安全 |
①Dial 数值调节控件
Dial 是 Qt 中模拟物理旋钮的数值调节控件，通过旋转圆盘来调整数值，视觉效果直观且具有沉浸感，是音乐播放器做音量调节、音效精细控制的绝佳选择。就是一个虚拟的物理旋钮，比如你家里的音响旋钮，转一圈就能调音量，比冷冰冰的滑块更有操作感，适合做专业播放器的音效调节面板。
核心作用
可视化数值调节：通过鼠标拖动或点击圆盘边缘，像调节收音机、音响旋钮一样调整数值
范围精准控制：可自定义最小值、最大值、单步步长，限定数值区间
方向与反转支持：可设置顺时针增加 / 逆时针增加，适配不同操作习惯
信号联动：数值变化时实时触发信号，可同步更新其他控件（如进度条、数值框）
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 主音量调节 | 范围 0-100，初始值 50 | 旋转圆盘调节音量，视觉反馈强，操作直观 |
| 均衡器增益调节 | 范围 -20dB 到 +20dB，步长 0.5dB | 针对低音、中音、高音各频段进行精细调节，打造专属音效 |
| 播放进度跳转 | 范围 0 - 歌曲总时长，单位秒 | 旋转圆盘直接跳转播放位置，适合快速拖拽进度 |
| 播放速度微调 | 范围 0.5x-2.0x，步长 0.05x | 比整数调节更细腻，适合不同场景的听歌节奏 |
| 音效混合比例 | 如左右声道平衡（左 - 100 到右 + 100） | 精准控制左右声道音量比例，实现沉浸式听感 |
②Horizontal Scroll Bar-> 水平方向滚动浏览超长内容的控件
Horizontal Scroll Bar 是 Qt 中用于水平方向滚动浏览超长内容的控件，是解决界面空间不足、内容超出可视区域的核心工具，也是音乐播放器各类列表、长内容展示的必备组件。就是一个横向的 "滑动条"，比如你手机里横向滑动的歌单列表，用它就能左右拖动，看到界面外的内容，解决 "内容太长、界面装不下" 的问题。
核心作用
水平滚动浏览：拖动滑块、点击箭头，左右滚动查看超出界面宽度的内容
范围与步长控制：自定义最小值、最大值、单步 / 页步长，适配不同内容长度
信号联动：滑块位置变化时触发信号，可实现内容同步滚动、进度联动
样式高度自定义：通过 QSS 完全自定义滚动条外观，适配播放器 UI 风格
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 超长歌单横向滚动 | 歌单封面 / 名称超出界面宽度，用滚动条左右滑动查看 | 横向排列多个歌单卡片，滑动浏览全部歌单 |
| 歌词长行滚动 | 歌词行太长超出界面，滚动查看完整歌词 | 单行歌词横向滚动，完整显示长句 |
| 播放列表横向导航 | 多个播放列表横向排列，滚动切换查看 | 左右滑动切换不同歌单，提升界面利用率 |
| 均衡器多频段横向滚动 | 10 段 / 15 段均衡器超出界面宽度，滚动调节所有频段 | 横向排列所有频段旋钮，滑动查看并调节 |
| 时间轴精细滚动 | 歌曲时间轴太长，滚动放大 / 缩小时间轴，精准定位 | 拖动滚动条缩放时间轴，快速跳转播放位置 |
③ Vertical Scroll Bar ->竖直方向滚动浏览超长内容
Vertical Scroll Bar 是 Qt 中用于垂直方向滚动浏览超长内容的控件，是桌面端界面最常用的滚动组件，完美解决纵向内容超出可视区域的问题，也是音乐播放器各类列表、长文本展示的核心工具。就是我们最熟悉的电脑窗口右侧的上下滑动条，比如浏览器、文件管理器里的滚动条，用它就能上下拖动，看到界面外的长内容，是桌面端最经典的交互组件。
核心作用
垂直滚动浏览：拖动滑块、点击上下箭头，上下滚动查看超出界面高度的内容
范围与步长精准控制：自定义最小值、最大值、单步 / 页步长，适配不同内容长度
信号联动：滑块位置变化时触发信号，实现内容同步滚动、进度联动
样式完全自定义：通过 QSS 100% 自定义滚动条外观，深度适配播放器 UI 风格
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 播放列表纵向滚动 | 歌曲列表超出界面高度，上下滑动浏览全部歌曲 | 纵向排列所有歌曲，快速滚动定位目标歌曲 |
| 歌词长列表滚动 | 多段歌词、逐句歌词超出界面，滚动查看完整歌词 | 上下滑动浏览整首歌的歌词，支持定位到当前播放句 |
| 本地音乐库列表 | 海量本地歌曲、专辑列表超出界面，滚动浏览 | 上下滑动查看全部歌曲，支持按歌手 / 专辑分类 |
| 日志 / 调试信息滚动 | 播放器运行日志、调试信息超长，滚动查看历史记录 | 实时追加日志，自动滚动到最新内容 |
| 设置项列表滚动 | 播放器设置项过多，超出界面高度，滚动查看全部设置 | 上下滑动浏览所有设置选项，分类管理 |
④ Horizontal Slider
Horizontal Slider 是 Qt 中最经典的线性数值调节控件，通过左右拖动滑块来调整数值，直观易用，是音乐播放器做音量、进度、音效调节的核心组件，也是桌面端最常用的交互控件之一。**就是我们最熟悉的 "进度条 / 调节条"，比如音乐播放器的音量条、播放进度条，拖动滑块就能调音量、**跳进度，是最直观的数值调节方式，几乎所有播放器都用它做核心交互
核心作用
线性数值调节：左右拖动滑块、点击轨道，快速调整整数数值
范围精准控制：自定义最小值、最大值、单步步长，严格限制输入区间
方向与刻度支持：可设置从左到右 / 从右到左递增，支持显示刻度
信号实时联动：滑块位置变化时实时触发信号，同步更新其他控件（如数值框、进度显示）
样式高度自定义：通过 QSS 完全自定义轨道、滑块外观，深度适配播放器 UI
| 场景 | 用法说明 | 实现效果 |
|---|---|---|
| 播放进度调节 | 范围 0 - 歌曲总时长（秒），初始值 0 | 拖动滑块跳转到任意播放位置，实时同步当前播放时间 |
| 音量调节 | 范围 0-100，初始值 50 | 拖动滑块调节音量，和 Spin Box/Dial 双向联动，显示具体音量百分比 |
| 均衡器频段调节 | 范围 -12dB 到 +12dB，步长 1 | 针对低音、中音、高音各频段，用水平滑块快速调节增益 |
| 播放速度调节 | 范围 50-200（对应 0.5x-2.0x），步长 10 | 拖动滑块快速切换播放速度，适配不同听歌场景 |
| 左右声道平衡 | 范围 -100（左声道）到 +100（右声道），初始值 0 | 拖动滑块调节左右声道音量比例，实现沉浸式听感 |
与 Vertical Slider / Dial / Scroll Bar 的核心区别（避坑指南）
| 特性 | Horizontal Slider | Vertical Slider | Dial | Scroll Bar |
|---|---|---|---|---|
| 形态 | 水平线性 | 垂直线性 | 圆形圆盘 | 滚动条（带箭头） |
| 核心用途 | 进度、音量、横向调节 | 纵向调节、侧边栏控制 | 模拟旋钮、沉浸感调节 | 内容滚动浏览 |
| 交互体验 | 直观、快速定位，符合进度条习惯 | 适合纵向布局、侧边调节 | 模拟物理旋钮，专业感强 | 仅用于滚动，不用于数值调节 |
| 适用场景 | 播放进度、音量、均衡器（横向） | 纵向音量、侧边栏控制 | 专业音效、复古播放器 | 列表、长内容滚动 |
④Key Sequence Edit -> 自定义快捷键控件
Key Sequence Edit 是 Qt 中专门用于捕获、编辑键盘快捷键序列的输入控件，是软件设置「自定义快捷键」功能的核心组件，能让用户直观地绑定、修改全局 / 局部快捷键。就是一个快捷键设置输入框，比如你在软件里设置「Ctrl+S 保存」「Ctrl+O 打开」时，点击这个输入框，按下你想要的快捷键，它就会自动识别并记录，是所有带自定义快捷键功能的软件的标配组件
核心作用
快捷键序列捕获：自动识别用户按下的键盘组合（如 Ctrl+S、Alt+F4、Ctrl+Shift+N），无需手动输入
合法性校验：自动过滤非法按键（如单独的 Shift/Ctrl 修饰键），避免无效快捷键
序列编辑与重置：支持清除、修改已绑定的快捷键，一键恢复默认设置
信号联动：快捷键变化时触发信号，可实时更新应用的快捷键映射
样式自定义：通过 QSS 自定义输入框外观，适配软件 UI 风格
1.8 Display widget
这些组件都属于 Display Widgets（显示控件组），和 Input Widgets（输入控件，比如 Slider、SpinBox）的核心区别：
✅ 核心用途：仅用于展示信息、可视化反馈、界面美化，默认不接收用户输入（ 如需交互需手动绑定事件）
✅ 共性特点：都支持 QSS 样式美化，可统一适配播放器 UI 主题
❌ 和输入控件的本质不同：输入控件是「用户操作→改变数值」，显示控件是「程序更新→展示给用户」，数据流方向完全相反
①Label 标签
核心用法：最基础的显示控件，用于展示文本、图片、富文本、超链接
音乐播放器场景 ：歌曲名 / 歌手 / 专辑展示、封面图、歌词单行显示、音量百分比、按钮图标
和其他显示控件的区别：通用型基础控件，轻量、易用，适合简单展示；复杂文本 / 图形用其他专用控件
② Text Browser
Text Browser 是 Qt 中专门用于展示只读富文本、长文本、HTML 内容的显示控件，属于 Display Widgets 分类，是音乐播放器展示长文本、歌词、简介的核心组件。
核心定位与特性
本质：只读的富文本浏览器，继承自 QTextEdit，但默认禁用编辑，仅用于展示
核心特点：
✅ 支持 HTML 富文本渲染（字体、颜色、样式、超链接）
✅ 自带垂直滚动条，长文本无需额外添加滚动控件
✅ 支持锚点跳转、超链接点击、图片嵌入
✅ 纯展示类控件，默认不接收用户输入，仅可查看
✅ 支持 QSS 样式美化，适配播放器 UI 主题
| 场景 | 用法说明 | 优势 |
|---|---|---|
| 歌词全文展示 | 逐行显示歌词，支持高亮当前播放句、滚动定位 | 自带滚动条，支持富文本样式，完美适配歌词展示 |
| 歌手 / 歌曲简介 | 展示歌手介绍、歌曲背景、专辑信息 | 支持 HTML 排版，图文混排，比 Label 更适合长文本 |
| 日志 / 调试信息 | 实时追加播放器运行日志、错误信息 | 自动滚动到底部，支持滚动查看历史日志 |
| 帮助文档 / 使用说明 | 展示播放器功能说明、快捷键指南 | 支持超链接跳转，可加载本地 HTML 文档 |
| 歌单介绍 / 评论 | 展示歌单简介、用户评论 | 支持富文本样式，长文本滚动查看 |
③ Graphics View
Graphics View 采用经典的 Model-View-Controller（MVC）架构，由三部分组成：
QGraphicsView（视图）：就是图中的这个控件，负责渲染、显示图形场景，提供滚动、缩放、平移等交互
QGraphicsScene（场景）：存储所有图形项（Item）的容器，管理图形的逻辑、碰撞检测、事件分发
QGraphicsItem（图形项）：场景中的具体元素，如矩形、圆形、线条、自定义图形等
✅ 核心特点：
支持高性能 2D 图形绘制，可承载数万图形项
自带缩放、平移、旋转等交互，无需手动实现
支持碰撞检测、事件响应、动画效果
纯展示类控件，可自定义交互逻辑
支持 QSS 样式美化，适配播放器 UI 主题
| 场景 | 用法说明 | 优势 |
|---|---|---|
| 实时音频频谱 | 绘制柱形 / 波形频谱，随音乐实时更新 | 高性能渲染，支持数万柱形，动画流畅 |
| 音频波形图 | 绘制音频波形，可视化音频文件 | 支持缩放、平移，精准定位音频片段 |
| 均衡器动态效果 | 绘制均衡器滑块、频段增益动态变化 | 自定义图形样式，交互反馈直观 |
| 自定义 UI 元素 | 绘制圆形音量旋钮、播放按钮、进度条 | 完全自定义样式，突破原生控件限制 |
| 音乐可视化动画 | 绘制粒子、波形、频谱动画，提升视觉效果 | 支持动画框架，实现炫酷视觉效果 |
④Canlender Widget
Calendar Widget 是 Qt 中开箱即用的完整日历组件，属于 Display Widgets 分类，专门用于日期展示、选择与标记，是带日期相关功能的应用的核心控件。
核心定位与特性
本质：完整的日历视图控件，内置月份切换、日期选择、导航等全部功能
核心特点 ：
✅ 支持日期选择、范围选择、单个 / 多个日期标记
✅ 自带月份 / 年份切换、导航按钮，无需手动实现
✅ 支持自定义日期样式（颜色、字体、背景），标记特殊日期
✅ 纯展示 + 轻交互控件，默认支持点击选择日期
✅ 支持 QSS 样式美化，适配播放器 UI 主题
| 场景 | 用法说明 | 优势 |
|---|---|---|
| 播放历史日期筛选 | 标记用户听过歌的日期，点击日期查看当日播放记录 | 直观展示听歌习惯，快速筛选历史 |
| 定时任务 / 定时播放 | 选择日期设置定时播放、定时关闭 | 可视化日期选择，比输入框更易用 |
| 歌单创建日期展示 | 标记歌单创建日期，按日期筛选歌单 | 清晰展示歌单时间线 |
| 打卡 / 听歌日历 | 每日听歌打卡，标记连续听歌天数 | 可视化打卡记录，提升用户粘性 |
| 日程 / 提醒 | 设置听歌提醒、新歌上线提醒 | 日历视图直观管理提醒 |
⑤LCD Number
LCD Number 是 Qt 中专门用于模拟液晶显示屏、展示数字 / 时间的纯显示控件，属于 Display Widgets 分类，是音乐播放器展示时间、数值的经典组件。
核心定位与特性
本质：模拟电子设备的液晶数字显示，仅用于展示数字、时间、百分比等数值类信息
核心特点：
✅ 支持多种数字样式（七段数码管、十六段、平面等），还原真实液晶效果
✅ 可显示整数、小数、时间（如 03:45）、十六进制 / 二进制等格式
✅ 支持自定义数字颜色、大小、段样式，适配播放器 UI 主题
✅ 纯展示类控件，默认不接收用户输入，仅用于信息展示
✅ 轻量高效，适合高频刷新场景（如实时时间、音量）
| 场景 | 用法说明 | 优势 |
|---|---|---|
| 播放时间展示 | 显示当前播放时间 / 总时长（如 03:45 / 04:20） |
经典液晶效果，比 Label 更专业，符合播放器设计习惯 |
| 音量数值展示 | 显示当前音量百分比（0-100） | 直观展示音量，搭配音量滑块使用 |
| 音频参数展示 | 显示比特率、采样率、音量增益等数值 | 专业参数展示，适合音乐发烧友 |
| 倒计时 / 定时 | 显示定时关闭倒计时（如 10:00） |
清晰直观，适合倒计时场景 |
| 频谱 / 均衡器数值 | 显示各频段增益数值 | 实时展示均衡器参数，可视化调节效果 |
⑥ Progress Bar
Progress Bar 是 Qt 中专门用于可视化展示任务进度的纯显示控件，属于 Display Widgets 分类，是音乐播放器、下载工具等应用的核心交互反馈组件。
核心定位与特性
本质：线性进度可视化控件，通过填充进度条直观展示任务完成百分比
核心特点：
✅ 支持水平 / 垂直两种方向，适配不同 UI 布局
✅ 可自定义进度范围、步长、样式，适配播放器主题
✅ 支持忙碌状态（无限进度条），用于未知时长的加载任务
✅ 纯展示类控件，默认不接收用户输入，仅用于进度反馈
✅ 轻量高效，支持高频刷新，适配实时进度场景
| 场景 | 用法说明 | 优势 |
|---|---|---|
| 播放进度展示 | 可视化歌曲播放进度，直观展示当前播放位置 | 线性进度直观，用户一眼看懂播放状态 |
| 下载 / 缓冲进度 | 展示歌曲 / 专辑下载进度、音频缓冲进度 | 实时反馈加载状态，提升用户体验 |
| 音量 / 均衡器进度 | 垂直进度条展示音量大小、各频段增益 | 可视化调节效果，比纯数字更直观 |
| 加载进度 | 应用启动、资源加载时的进度反馈 | 忙碌状态适配未知时长的加载任务 |
| 导出 / 转换进度 | 音频格式转换、歌单导出时的进度展示 | 实时反馈任务状态，避免用户焦虑 |
⑦Horizontal Line
Horizontal Line 是 Qt 中纯界面美化、区域分隔的装饰性显示控件，属于 Display Widgets 分类，是 UI 布局中最基础的辅助组件。
核心定位与特性
本质：一条固定的水平直线，仅用于界面视觉分隔，无任何业务功能
核心特点：
✅ 纯装饰性控件，不接收用户输入，不承载业务逻辑
✅ 可自定义颜色、粗细、样式，适配不同 UI 主题
✅ 轻量无性能损耗，拖拽即用，无需编写代码
✅ 完美适配布局，自动随窗口拉伸调整长度
基础使用（拖拽即用）
在 Qt Designer 中直接拖拽到界面即可，无需额外代码，仅需通过 QSS 自定义样式：
| 场景 | 用法说明 | 作用 |
|---|---|---|
| 界面区域分隔 | 分隔播放控制区、歌单列表区、歌词展示区 | 清晰划分功能模块，提升界面层次感 |
| 设置页分组分隔 | 分隔快捷键设置、音效设置、外观设置等分组 | 让设置项分类更清晰，避免视觉混乱 |
| 列表项分隔 | 分隔歌单列表、播放历史列表的条目 | 替代边框，让列表更清爽，提升可读性 |
| 标题栏分隔 | 分隔标题栏与内容区 | 强化标题视觉，让界面结构更分明 |
| 自定义 UI 装饰 | 作为进度条、音量条的装饰边框 | 美化控件，提升界面精致度 |
⑧openGL Widget
| 场景 | 用法说明 | 优势 |
|---|---|---|
| 高性能 3D 音频可视化 | 3D 频谱、波形、粒子特效，随音乐实时渲染 | GPU 硬件加速，动画流畅，支持复杂 3D 效果 |
| 2D 音频频谱 / 波形 | 高性能 2D 频谱柱形、波形图，高频刷新无卡顿 | 性能远超 Graphics View，适合实时音频数据 |
| 3D 播放器界面 | 3D 旋转专辑封面、3D 音量旋钮、3D 播放按钮 | 打造炫酷 3D 交互界面，提升视觉体验 |
| 视频渲染 | 播放 MV、音频可视化视频，硬件解码渲染 | 利用 GPU 解码，播放流畅，支持高清视频 |
| 自定义图形动画 | 粒子动画、光影特效、转场动画 | 着色器编程实现复杂视觉效果，性能拉满 |
