【Qt6 QML Book 基础】01：可交互旋转风车动画（附完整可运行代码）

引言

在学习 Qt 6 QML 开发时，书中示例往往仅提供碎片化代码，缺乏完整工程结构，导致开发者难以直接在 Qt Creator 中编译运行。本文基于 可直接运行的完整 QML 代码，详细解析如何实现一个具备 键盘 / 鼠标交互、窗口自适应布局 的旋转风车动画，帮助初学者快速掌握 Qt6 QML 基础开发流程。

一、最终效果与核心功能

效果演示

核心功能

1. 多方式旋转控制：

   • 键盘左键 / 右键：每次按键使风车逆时针 / 顺时针旋转 45°，伴随模糊层透明度变化
   • 鼠标点击风车区域：按下时立即旋转 45°（无动画）

2. 智能布局适配：

   • 窗口初始化时自动匹配背景图尺寸（background.png 实际像素决定窗口大小）
   • 背景图固定在窗口底层，风车组件始终相对于旗杆居中对齐

3. 平滑动画效果：

   • 旋转 / 透明度变化使用 Behavior 实现过渡动画
   • 模糊层与风车叶片同步旋转，通过 opacity 变化增强交互反馈

二、核心代码解析（QML 实现）

1. 项目结构与文件组织