课程代码仓库初始化：Part1 (144) + Part3 (29) 全量生成与验证

把川大 wiki「02.Qt方向」课程代码整理为 CMake 管理的可编译运行项目。 Part1 C/C++ 强化 (p01/, 144 目标, host gcc/g++ 构建, 全绿): - 修复全部编译失败：补 <cstring>/<fstream>/<iomanip>/<vector> 等缺失头 (common_fix + infer_stl_includes 自动检测注入)、修正 pause() 壳注入 (改检测已转换后的 pause 调用)、namespace 提升出函数体、const 成员函数正确性、dedupe 不再破坏函数重载集、K&R 隐式 int / 动态异常规范等 C++17 移除特性的可编译等价改写。 - 目录采用深缩写 p01/ch04/s03/ (原 part1_cpp/ch04_class_object/03_ctor_dtor)。 Part3 Qt 桌面 (p03/, 29 目标, 隔离 Qt 5.14.2 构建, 全绿): - gen_part3.py: Qt 外壳模板 (main+QApplication+show, QTimer 自动退出便于 offscreen 验证)、AUTOMOC + .moc include、rewrite_* 处理散文混入/重载/ 资源依赖、生成占位 png/gif + .qrc + rundata 样例数据。 - 修正 QLable 笔误、全角分号、.→->、Windows 路径、QApplication 阻塞事件循环改为 QCoreApplication 等。任务1 概念/版本验证: - tools/std_probe.py: 跨 -std= 编译探针 (--pedantic-errors 让已废除特性硬失败)。 - tools/demo_versions/: K&R 隐式 int、三目左值、void* 转换、enum 赋整、 const 经指针、动态异常规范共 6 个跨版本演示。 - docs/VERSION_NOTES.md: 每条「原文说法→C17/C++17 是否成立→何版本成立→已验证」。文档: 顶层 README、docs/SOURCE_PAGES.md (页面→目录映射)、 docs/ERRATA.md (Part1 修正)、docs/ERRATA_part3.md (Part3 修正)。另修复 tools/run.sh / run_qt.sh 的 ${1:?...} 引号语法 bug。隔离 Qt 验证: ldd 0 系统 Qt 引用; 173/173 目标全绿; p03 offscreen 运行通过。
2026-06-30 14:16:55 +08:00
commit 13b3ebbe14
287 changed files with 16532 additions and 0 deletions
@@ -0,0 +1,17 @@
+# Auto-generated by tools/gen_part3.py — do not edit by hand.
+# 章节：p03/ch09
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+add_executable(mouse_event mouse_event.cpp)
+set_target_properties(mouse_event PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(mouse_event PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(mouse_event PRIVATE -Wall -Wextra)
+add_executable(event_override_customwidget event_override_customwidget.cpp)
+set_target_properties(event_override_customwidget PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(event_override_customwidget PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(event_override_customwidget PRIVATE -Wall -Wextra)
+add_executable(event_filter_mainwindow event_filter_mainwindow.cpp)
+set_target_properties(event_filter_mainwindow PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(event_filter_mainwindow PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(event_filter_mainwindow PRIVATE -Wall -Wextra)
+add_custom_target(all_p03_ch09 DEPENDS mouse_event event_override_customwidget event_filter_mainwindow)
@@ -0,0 +1,136 @@
+# p03/ch09 — Qt 示例
+
+## 可运行示例
+
+| 目标 | 源文件 | 说明 |
+|---|---|---|
+| `mouse_event` | `mouse_event.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh mouse_event` |
+| `event_override_customwidget` | `event_override_customwidget.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh event_override_customwidget` |
+| `event_filter_mainwindow` | `event_filter_mainwindow.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh event_filter_mainwindow` |
+
+## 参考片段（签名/伪代码，未单独建目标）
+
+### [block 1] .1 事件
+
+```cpp
+label->setMouseTracking(true);
+```
+
+### [block 3] .2 event（）
+
+```cpp
+bool CustomTextEdit::event(QEvent *e)
+{
+if (e->type() == QEvent::KeyPress)
+{
+QKeyEvent *keyEvent = static_cast<QKeyEvent *>(e);
+if (keyEvent->key() == Qt::Key_Tab)
+{
+qDebug() << "You press tab.";
+return true;
+}
+}
+return false;
+}
+```
+
+### [block 4] .2 event（）
+
+```cpp
+switch (event->type()) {
+case QEvent::MouseMove:
+mouseMoveEvent((QMouseEvent*)event);
+break;
+// ...
+}
+```
+
+### [block 5] .2 event（）
+
+```cpp
+//!!! Qt5
+bool QObject::event(QEvent *e)
+{
+switch (e->type()) {
+case QEvent::Timer:
+timerEvent((QTimerEvent*)e);
+break;
+case QEvent::ChildAdded:
+case QEvent::ChildPolished:
+case QEvent::ChildRemoved:
+childEvent((QChildEvent*)e);
+break;
+// ...
+default:
+if (e->type() >= QEvent::User) {
+customEvent(e);
+break;
+}
+return false;
+}
+return true;
+}
+```
+
+### [block 7] .3 事件过滤器
+
+```cpp
+bool CustomWidget::event(QEvent *e)
+{
+if (e->type() == QEvent::KeyPress) {
+QKeyEvent *keyEvent = static_cast<QKeyEvent *>(e);
+if (keyEvent->key() == Qt::Key_Tab) {
+qDebug() << "You press tab.";
+return true;
+}
+}
+return QWidget::event(e);
+}
+现在，我们可以给出一个使用事件过滤器的版本：
+bool FilterObject::eventFilter(QObject *object, QEvent *event)
+{
+if (object == target && event->type() == QEvent::KeyPress)
+{
+QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event);
+if (keyEvent->key() == Qt::Key_Tab) {
+qDebug() << "You press tab.";
+return true;
+} else {
+return false;
+}
+}
+return false;
+}
+```
+
+### [block 8] .4 总结
+
+```cpp
+LRESULT CALLBACK WndProc(HWND hWnd,
+UINT message,
+WPARAM wParam,
+LPARAM lParam)
+```
+
+### [block 9] .4 总结
+
+```cpp
+switch(message)
+{
+case WM_PAINT:
+// ...
+break;
+case WM_DESTROY:
+// ...
+break;
+...
+}
+```
+
+### [block 10] .4 总结
+
+```cpp
+virtual bool QCoreApplication::notify ( QObject * receiver,
+QEvent * event );
+```
+
@@ -0,0 +1,47 @@
+// ============================================================================
+//  event_filter_mainwindow  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954546:6]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QMainWindow>
+#include <QLabel>
+#include <QEvent>
+#include <QDebug>
+#include <QTimer>
+
+// 事件过滤器：拦截 label 上的事件
+class MainWindow : public QMainWindow {
+    Q_OBJECT
+public:
+    MainWindow() {
+        label = new QLabel(QStringLiteral("事件过滤器示例"), this);
+        label->setGeometry(10, 30, 200, 30);
+        label->installEventFilter(this);  // 给 label 安装事件过滤器
+    }
+protected:
+    bool eventFilter(QObject* watched, QEvent* event) override {
+        if (watched == label && event->type() == QEvent::MouseButtonPress) {
+            qDebug() << "label 上的鼠标按下事件被过滤器拦截";
+            return true;  // 拦截，不再派发
+        }
+        return QMainWindow::eventFilter(watched, event);
+    }
+private:
+    QLabel* label;
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    MainWindow w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "event_filter_mainwindow.moc"
@@ -0,0 +1,43 @@
+// ============================================================================
+//  event_override_customwidget  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954546:2]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QWidget>
+#include <QEvent>
+#include <QKeyEvent>
+#include <QDebug>
+#include <QTimer>
+
+class CustomWidget : public QWidget {
+    Q_OBJECT
+public:
+    explicit CustomWidget(QWidget* p = nullptr) : QWidget(p) {}
+protected:
+    bool event(QEvent* e) override {
+        if (e->type() == QEvent::KeyPress) {
+            QKeyEvent* ke = static_cast<QKeyEvent*>(e);
+            if (ke->key() == Qt::Key_Tab) {
+                qDebug() << "Tab pressed in CustomWidget";
+                return true;  // 事件已处理，不再向上传递
+            }
+        }
+        return QWidget::event(e);  // 其余交给基类
+    }
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    CustomWidget w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "event_override_customwidget.moc"
@@ -0,0 +1,49 @@
+// ============================================================================
+//  mouse_event  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954546:0]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QWidget>
+#include <QLabel>
+#include <QMouseEvent>
+#include <QString>
+#include <QTimer>
+
+// 自定义 QLabel：重写鼠标事件，显示坐标
+class EventLabel : public QLabel {
+    Q_OBJECT
+public:
+    explicit EventLabel(QWidget* p = nullptr) : QLabel(p) {
+        setMouseTracking(true);  // 启用鼠标移动追踪（默认只在按键时追踪）
+        setText(QStringLiteral("移动鼠标到这里"));
+    }
+protected:
+    void mouseMoveEvent(QMouseEvent* event) override {
+        setText(QString("<center><h1>Move: (%1, %2)</h1></center>")
+                .arg(event->x()).arg(event->y()));
+    }
+    void mousePressEvent(QMouseEvent* event) override {
+        setText(QString("<center><h1>Press: (%1, %2)</h1></center>")
+                .arg(event->x()).arg(event->y()));
+    }
+    void mouseReleaseEvent(QMouseEvent* event) override {
+        setText(QString("<center><h1>Release: (%1, %2)</h1></center>")
+                .arg(event->x()).arg(event->y()));
+    }
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    EventLabel w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "mouse_event.moc"