charles/scuc-qt-course
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
32 Commits 1 Branch 0 Tags
8d69cbebd59fb26c82186667e637b431e3e362b7
Commit Graph

11 Commits

Author SHA1 Message Date
张宗平 d94d9175b1 讲义更新：Day2 幻灯片补 Designer 表单对照章节 + Day1 PPT + property_animation gif 
- day2.html：组装思路改述为「两种信号槽写法」（lambda+context 批量绑定数字/运算键，
  成员函数指针绑定等号/清空/退格）；新增「番外：Qt Designer 表单版对照」章节，
  讲 .ui 表单 + uic + setupUi + connectSlotsByName 自动连接，及改 objectName 致
  on_<obj>_<sig>() 静默失败的坑；任务卡补「教师答案（不下发）」。
- day1.pptx：同步更新。
- property_animation/source.gif：属性动画示例演示 gif 资源。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:52:06 +08:00
张宗平 d0496675e9 student_manager 教学示例：菜单/工具栏加「删除选中」action（函数体待实现） 
「记录」菜单与工具栏新增 actRemoveSelected（删除选中），connect 到 onRemoveSelected
槽。注意：onRemoveSelected() 函数体当前为空（实现被注释），仅完成 action 注册与
连接——槽逻辑（按选中行倒序 removeRow）留作课堂练习或后续补全，先占位。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:51:49 +08:00
张宗平 d3e2e50f0e mainwindow_showcase 教学示例：补 Designer 双版本表单（mainwindow2）+ 表单维护 
- 新增 mainwindow2.{h,cpp,ui}：用 Qt Designer 生成的第二套 QMainWindow 表单
  （File/Edit/Help 菜单 + actionOpen/actionAbout_Me），供课堂对比「代码搭界面」
  与「Designer 拖界面」两条路线。
- 新增子目录 CMakeLists.txt：供单独打开该示例构建（顶层 add_subdirectory 不递归，
  与 lineedit_eye_toggle / mandelbrot_renderer 同模式）。
- mainwindow.ui / mainwindow.qrc：经 Designer 重新保存后的表单与资源清单维护
  （iconset 去掉 resource= 显式引用、属性顺序由 Designer 重排）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:51:33 +08:00
张宗平 01b264fe97 Day4 教学示例补三个：QDialog 综合 / QLineEdit 小眼睛 / 文件 IO（+顶层构建注册） 
- qdialog_showcase：wiki「6 对话框 QDialog」6.2–6.5 综合演示。含两套实现：
  · Designer 表单版（dialog.{h,cpp,ui} + resources.qrc + source.gif，QMovie 播 GIF）
  · 纯代码版（qt_dialog_showcase.cpp，单文件，QWidget 布满按钮逐个演示 QDialog 行为）
- lineedit_eye_toggle：子类化 QLineEdit，paintEvent 自绘小眼睛、mouseEvent 命中切换
  echoMode，并与内置 clear button 动态避让（读 objectName=="clearButton" 子 widget 几何）。
  含独立子目录 CMakeLists.txt 供单独打开（顶层 add_subdirectory 不递归）。
- file_io_demo：QFile/QTextStream/QDataStream/QFileInfo/QDir/QTextCodec/QJson 五主题
  综合示例，每个按钮产出一个文件落到 demo_output/ 便于课堂手动查看。

构建注册：examples/CMakeLists.txt 用 add_teaching_example 注册前两个纯代码示例，
mandelbrot 多源文件单独 add_executable；calculator_mainwindow_qss 加 themes.qrc 与
AUTORCC；all_teaching_examples 依赖列表同步补齐。

附 lineedit_eye_toggle 设计文档（docs/superpowers/specs）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:51:09 +08:00
张宗平 993aa30a1c Mandelbrot 教学示例增强：主线程渲染循环至 ≥1.5s，让界面冻结肉眼可感 
实测单帧 820×640@256 单线程仅约 70ms，远低于人眼可感阈值，直接算一帧看不出
「冻结」。故「主线程渲染」按钮改为自适应循环渲染直到累计 ≥ 1500ms（实测 ~23 帧 /
1506ms），上限 100 轮防止极慢机器卡死过久。冻结的本质是事件循环被占用，循环只是
模拟任意一个占着 GUI 线程不返回的耗时操作。

- mandelbrot_widget.cpp：onRenderOnMainThread 改 do-while 循环，标签加「· N 轮」
- README.md：补冻结时长说明与课堂演示技巧
- 设计文档同步：三段式对比章节更新实测数据与冻结本质解释
- 新增 docs/teaching/MULTITHREADING.md：多线程教学要点汇总

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:50:46 +08:00
张宗平 12950da129 QSS 教学示例重构：双主题样式抽离为外部 .qss 资源（QFile 运行时加载） 
把原先硬编码在 mainwindow.cpp 里的 kLightQss / kDarkQss 两个 C++ 字符串，
拆成独立的 themes/light.qss、themes/dark.qss，由 themes.qrc（AUTORCC）编译进
可执行文件，applyStyle() 用 QFile 读取后 qApp->setStyleSheet 应用。

教学要点（QSS 最佳实践）：
- 样式与逻辑彻底分离：设计师/非程序员可直接编辑 .qss，不必碰 C++；
- 开发期改 .qss 重跑即生效，不必改 C++ 重编译；
- 多主题物理分文件，编辑器对 .qss 有语法高亮。

README 同步更新差异表、最佳实践条目与目录结构。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:50:31 +08:00
张宗平 6773f9b29e Day4 教学示例：Mandelbrot 分形渲染器（QPainter 绘图 + 多线程 + 事件处理综合演示） 
三段式对比直击 Day4 slides「主线程耗时=冻结」痛点：主线程渲染冻结 / 后台单线程不卡但慢 / 后台多线程不卡且快。
- QThreadPool + QRunnable 分水平条带并行，排队信号槽回传，epoch 版本号防过期覆盖
- wheelEvent 缩放（鼠标为锚）+ mouseEvent 拖拽平移 + paintEvent 画 QImage
- 子目录自带独立 CMakeLists.txt，可单独构建/共享（双模式约定同 lineedit_eye_toggle）
- 配套 README（概念/走读/双构建/5 踩坑点/练习）+ 设计规格
- 已验证：独立工程 offscreen 运行 exit=0；主工程构建 exit=0（w64devkit g++16 + mingw73 Qt5.14.2）

注：主工程 examples/CMakeLists.txt 的接入（mandelbrot + lineedit_eye_toggle + qdialog + themes 原子接入）与顶层 CMakeLists 本地调试改动未一并提交，待整体确认后单独提交。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 09:01:29 +08:00
张宗平 05a685c952 Day3 教学示例：增强版计算器接入 + QMainWindow/QSS 两版参考实现 
- calculator_designer_ext（Day2 增强版：表达式求值 + 括号，递归下降解析器）接入 cmake
- calculator_mainwindow（Day3 上午）：增强版计算器装进 QMainWindow，
  菜单/状态栏/历史停靠窗，纯代码 + 显式 connect，与 mainwindow_showcase 形成坑卡对照
- calculator_mainwindow_qss（Day3 下午）：上午版 + QSS 双主题美化（按键分色/伪状态/深浅切换）
- 验证 mainwindow_showcase（QMainWindow 六大组件综合演示，.ui + .qrc）
- OUTLINE_4DAY.md / ASSIGNMENTS.md Day3 衔接增强版起点 + 参考实现指引
- 补提交 Day2 calculator/ 与 calculator_designer/ 参考实现（CMakeLists 已引用）
- 全量构建 28/28，4 目标离屏自测退出码 0

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-07 22:59:05 +08:00
张宗平 6d1895d696 教学示例补 5 个：3 个坑点复现 + QTableWidget + Day5 学员管理器参考实现 
- pitfall_stack_widget / pitfall_lambda_capture / pitfall_double_connect：
  默认跑正确写法（离屏验证退出码 0），--crash / --dangle 开关课堂现场触发
  真实崩溃/悬空访问
- table_widget：QTableWidget 单元格事件最小示例（新安排 Day4「表格事件」）
- student_manager：Day5 综合案例参考实现，离屏自测覆盖 JSON round-trip
  与 QThread 后台导入闭环
- 均接入 examples/CMakeLists.txt 的 add_teaching_example，手工维护区不影响生成器
 2026-07-05 12:49:20 +08:00
张宗平 1f66098277 Qt 示例窗口默认不再自动退出，仅离屏验证时自动退出 
p03/ 生成产物与 docs/teaching/examples/ 手工示例里的 QTimer::singleShot
自动退出逻辑，从"始终 200ms 后退出"改为"仅当 QT_QPA_PLATFORM=offscreen
时才退出"。正常运行（有显示环境）窗口保持打开，需手动关闭；离屏自动化
验证（tools/run_qt.sh + QT_QPA_PLATFORM=offscreen）行为不变。

p03/ 改动来自重新生成 tools/gen_part3.py（AUTO_QUIT 常量加 qgetenv 判断），
未手改生成产物。QCoreApplication 控制台风格示例（qfile_basic 等）本就
执行完即退出，不受影响。
 2026-07-02 16:14:49 +08:00
张宗平 83620c0cf5 教案对齐官方方案书：重写为 5 天 C++/Qt 教学设计，补齐 6 个 Qt 技术缺口示例 
- docs/teaching/OUTLINE.md、slides/day1-5.html、index.html：替换此前自定义的
  4 天方案，严格对齐 docs/TRAINING_PLAN_2026.md「C++方向」Day1-5 课堂内容
  （Day6-10 为纯项目实作，不在教案范围）
- docs/teaching/examples/：官方方案书要求但仓库 p03/(wiki 抓取内容) 未覆盖的
  QSS/Model-View/JSON/QThread/QPropertyAnimation/QStateMachine 六个技术点，
  各补一个最小可运行示例 + README 教学文档，均已离屏验证跑通；手工维护，
  不属于 gen_part3.py 生成产物
- 根 CMakeLists.txt：接入 docs/teaching/examples 构建（BUILD_QT_PART 分支内），
  不改动生成器管理的 p01/p03 CMakeLists
- 任务卡改为目标/验收标准/基础知识参考三段式模板，custom.css 配套新增样式
- docs/teaching/PRETEST.md：10 题 10 分钟 C++ 摸底测验，验证教案假定的受众
  基础是否成立，并与 OUTLINE.md §0 的分层预案挂钩
 2026-07-02 11:31:44 +08:00