简介这是一份面向高校C与Qt开发初学者的课程设计级绘图软件项目适用于软件工程、K12信息技术拓展及C期末实践教学场景。项目实现了完整的图形编辑功能支持文本、线段、矩形、椭圆、箭头等基础图元的添加、删除、移动、旋转与缩放具备视图拖拽缩放、图元连接、图纸导出为图片/PDF、配置文件导入导出等实用能力。资源包共44个文件含9个核心cpp源码、8个h头文件构成模块化架构如circuitbaseobject、circuittextobject等1个ui界面文件、1个pro工程配置及qss样式文件辅以20张运行截图和1份docx使用说明整体仅247KB轻量易读。目前已有313人学习下载代码结构清晰、注释规范完整呈现Qt信号槽机制、图形项管理QGraphicsItem与场景视图QGraphicsScene/QGraphicsView的典型应用是理解Qt绘图框架与面向对象设计思想的优质入门范例。1. 这不是“画图板”而是一套可扩展的 Qt 图元管理框架C 课设里真正能跑通、能调试、能交差的绘图系统很多同学拿到“Qt 绘图软件”课设题时第一反应是打开 Qt Creator 新建 Widget 项目拖几个按钮QPainter一画了事——结果鼠标拖拽卡顿、图元缩放后线条模糊、删除一个矩形连带箭头断连、导出 PDF 字体乱码。这套drawing-qt项目恰恰反其道而行它不依赖QGraphicsView的默认渲染管线而是用QGraphicsItem自定义图元类circuitbaseobject.h及其子类构建完整对象模型所有图元Text/Line/Rect/Ellipse/Arrow均继承自统一基类CircuitBaseObject支持独立坐标系、局部变换矩阵、连接锚点绑定与事件拦截。它解决的不是“怎么画一条线”而是“如何让 5 类图元在缩放、旋转、移动时保持拓扑关系一致、属性可序列化、视图交互无撕裂”。适合软件工程方向学生理解 MVC 分离、面向对象设计原则也适合作为 K12 教学工具链中图形化编程模块的底层支撑——你改一行circuittextobject.cpp的paint()实现就能看到所有文本图元实时响应导出配置时xml/目录下生成的是标准 DOM 结构而非二进制 blob打印功能直接调用QPrinterQPainter::setRenderHint(QPainter::Antialiasing)规避了常见 Qt 打印失真问题。2. 图元生命周期与事件驱动机制从CircuitBaseObject到CircuitTextObject的继承链解析2.1 基类CircuitBaseObject的核心契约设计circuitbaseobject.h定义了所有图元必须实现的最小接口集它不是抽象基类未声明纯虚函数而是通过virtual函数提供可覆盖行为。关键成员包括class CircuitBaseObject : public QGraphicsItem { public: explicit CircuitBaseObject(QGraphicsItem *parent nullptr); virtual ~CircuitBaseObject() override; // 必须重写返回图元类型标识用于序列化/反序列化 virtual ObjectType type() const { return ObjectType::Unknown; } // 必须重写绘制逻辑由 QGraphicsView 调用 virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override 0; // 必须重写返回包围盒影响碰撞检测与重绘区域 virtual QRectF boundingRect() const override 0; // 可选重写鼠标按下事件支持拖拽起点记录 virtual void mousePressEvent(QGraphicsSceneMouseEvent *event) override; // 可选重写鼠标移动事件支持实时拖拽更新 virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override; // 可选重写鼠标释放事件触发位置提交与连接线重算 virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event) override; protected: // 内部状态是否处于选中态影响绘制高亮边框 bool m_selected{false}; // 内部状态是否启用连接锚点Arrow/Line 需要 bool m_hasAnchorPoints{false}; // 内部状态当前缩放比例用于动态调整画笔宽度 qreal m_scaleFactor{1.0}; };提示m_scaleFactor不是 Qt 内置属性而是项目自定义字段。它在CircuitBaseView::scale()中被同步更新并通过CircuitBaseObject::setScaleFactor(qreal)通知所有图元。这意味着图元缩放不是简单调用setScale()而是主动感知视图缩放并调整自身QPen宽度——这正是摘要中“图元的放缩致使画笔也应该随之变化”的实现基础。2.2 文本图元CircuitTextObject的典型实现细节circuittextobject.h和circuittextobject.cpp展示了如何将抽象契约落地。其paint()函数不直接调用QPainter::drawText()而是先计算文本布局void CircuitTextObject::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) { // 1. 启用抗锯齿避免文字边缘发虚 painter-setRenderHint(QPainter::Antialiasing, true); // 2. 根据当前缩放因子动态设置字体大小核心优化点 QFont font m_font; font.setPointSizeF(m_font.pointSizeF() * m_scaleFactor); // 关键字体随缩放等比放大 // 3. 计算文本实际渲染区域考虑 DPI 缩放 QRectF textRect boundingRect(); textRect.adjust(2, 2, -2, -2); // 留出内边距 // 4. 设置画笔颜色支持选中态高亮 QPen pen m_pen; if (m_selected) { pen.setColor(Qt::red); pen.setWidthF(2.0 / m_scaleFactor); // 画笔宽度反比于缩放保证视觉粗细一致 } painter-setPen(pen); // 5. 渲染文本居中对齐 painter-setFont(font); painter-drawText(textRect, Qt::AlignCenter, m_text); }2.2.1boundingRect()的精确计算逻辑文本图元的包围盒不能简单返回QFontMetrics::boundingRect()因为该函数返回的是逻辑像素尺寸未考虑m_scaleFactor。CircuitTextObject::boundingRect()实现如下QRectF CircuitTextObject::boundingRect() const { QFontMetricsF fm(m_font); // 获取未缩放时的原始尺寸 QRectF baseRect fm.boundingRect(m_text); // 按当前缩放因子等比放大 return QRectF( baseRect.x() * m_scaleFactor, baseRect.y() * m_scaleFactor, baseRect.width() * m_scaleFactor, baseRect.height() * m_scaleFactor ); }注意QFontMetricsF使用浮点精度避免整数截断导致的尺寸偏差。baseRect的x()/y()是负值因字体基线偏移直接乘以m_scaleFactor保证了锚点位置缩放一致性。2.3 连接线图元CircuitLineObject的锚点绑定机制circuitlineobject.h定义了startAnchor()和endAnchor()两个QPointF成员它们不直接存储绝对坐标而是指向被连接图元的锚点 ID如top、bottom。CircuitLineObject::updatePosition()在图元移动时被调用void CircuitLineObject::updatePosition() { if (!m_startItem || !m_endItem) return; // 1. 查询起始图元的 top 锚点世界坐标 QPointF startWorldPos m_startItem-mapToScene( m_startItem-anchorPoint(top) // 返回局部坐标 ); // 2. 查询结束图元的 bottom 锚点世界坐标 QPointF endWorldPos m_endItem-mapToScene( m_endItem-anchorPoint(bottom) ); // 3. 更新线段端点触发重绘 prepareGeometryChange(); m_line.setP1(startWorldPos); m_line.setP2(endWorldPos); }anchorPoint()在CircuitBaseObject中默认返回(0,0)但CircuitRectObject重写了它QPointF CircuitRectObject::anchorPoint(const QString anchorName) const { QRectF rect boundingRect(); if (anchorName top) return QPointF(rect.center().x(), rect.top()); if (anchorName bottom) return QPointF(rect.center().x(), rect.bottom()); if (anchorName left) return QPointF(rect.left(), rect.center().y()); if (anchorName right) return QPointF(rect.right(), rect.center().y()); return QPointF(0, 0); }这种设计使连接线完全解耦于具体图元形状——只要图元提供锚点线就能自动吸附。这也是摘要中“图元移动时连线也跟随移动”的技术保障。3. 视图控制与交互逻辑CircuitBaseView如何协调缩放、拖拽与图元选择3.1CircuitBaseView的三大核心重载函数circuitbaseview.h继承自QGraphicsView其wheelEvent()、mousePressEvent()、mouseMoveEvent()构成交互主干。与默认QGraphicsView不同它禁用了内置缩放setTransformationAnchor(NoAnchor)转而手动控制void CircuitBaseView::wheelEvent(QWheelEvent *event) { // 1. 获取滚轮角度单位为 1/8 度 int delta event-angleDelta().y(); // 2. 计算缩放因子增量每滚轮格 1.1 倍 qreal scaleFactor 1.1; if (delta 0) scaleFactor 1.0 / scaleFactor; // 3. 以鼠标位置为中心缩放关键避免视图平移错位 QPointF centerBefore mapToScene(event-pos()); scale(scaleFactor, scaleFactor); QPointF centerAfter mapToScene(event-pos()); QPointF offset centerBefore - centerAfter; translate(offset.x(), offset.y()); // 4. 同步所有图元的 m_scaleFactor foreach (QGraphicsItem *item, scene()-items()) { if (auto *obj dynamic_castCircuitBaseObject*(item)) { obj-setScaleFactor(transform().m11()); // transform().m11() 即 x 方向缩放系数 } } }3.1.1transform().m11()的物理意义QTransform矩阵结构为[ m11 m12 dx ] [ m21 m22 dy ] [ 0 0 1 ]其中m11是 x 轴缩放系数m22是 y 轴缩放系数。项目假设等比缩放m11 m22故仅读取m11。该值直接传给图元setScaleFactor()驱动paint()中字体/画笔的动态调整。3.2 多图元选择与批量操作的实现策略mainwindow.cpp中on_actionSelect_triggered()并非简单调用scene()-selectedItems()而是通过CircuitBaseObject::setSelected(bool)显式控制void MainWindow::on_actionSelect_triggered() { QListQGraphicsItem* items scene-selectedItems(); foreach (QGraphicsItem *item, items) { if (auto *obj dynamic_castCircuitBaseObject*(item)) { obj-setSelected(true); // 触发图元内部重绘高亮边框 } } }CircuitBaseObject::setSelected()内部会设置m_selected true调用update()请求重绘若为连接线递归调用startItem-setSelected(true)和endItem-setSelected(true)确保连接关系可视化删除操作 (on_actionDelete_triggered()) 同样显式遍历void MainWindow::on_actionDelete_triggered() { QListQGraphicsItem* items scene-selectedItems(); foreach (QGraphicsItem *item, items) { if (auto *obj dynamic_castCircuitBaseObject*(item)) { // 1. 断开所有连接到此图元的线 obj-disconnectAllLines(); // 2. 从场景移除 scene-removeItem(item); // 3. 删除对象注意QGraphicsItem 析构需手动 delete delete item; } } }disconnectAllLines()在CircuitBaseObject中遍历m_connectedLinesQListCircuitLineObject*调用line-setStartItem(nullptr)和line-setEndItem(nullptr)再从line的m_startItem/m_endItem反向列表中移除自身——形成双向解绑闭环。3.3 打印与导出功能的技术路径对比功能实现方式关键参数说明图片导出QPixmap::grabWidget()QPixmap::save()grabWidget()捕获当前视图区域save(out.png, PNG, 100)100% 质量PDF 导出QPrinterQPainterscene()-render()QPrinter::setOutputFormat(QPrinter::PdfFormat)render()指定目标区域配置导出QDomDocumentQFile序列化每个图元的type()、pos()、rotation()等QDomElement层级结构严格对应CircuitBaseObject子类字段支持 XML Schema 验证scenes/circuitbasescene.cpp中exportToXml()函数生成的 XML 示例drawing version1.0 text id1 x100.5 y200.0 textHello font-size12 rotation0/ rect id2 x300 y150 width100 height60 fill#ffcc00 stroke#000000/ line id3 x1100 y1200 x2300 y2150 stroke#0000ff width2/ /drawing提示QDomDocument的save()方法默认 UTF-8 编码中文文本无需额外处理。但QFile打开时需指定QIODevice::Text模式否则 Windows 下可能产生 BOM 头导致解析失败。4. 配置导入与暗黑模式切换基于QSS与resources.qrc的主题热加载4.1resources.qrc的资源组织逻辑resources.qrc文件将qss/目录下的样式表打包为 Qt 资源系统的一部分RCC qresource prefix/styles fileqss/light.qss/file fileqss/dark.qss/file fileimages/logo.ico/file /qresource /RCC编译后可通过:/styles/light.qss路径访问。mainwindow.cpp中applyStyleSheet()函数实现热切换void MainWindow::applyStyleSheet(const QString styleName) { QFile file(QString(:/styles/%1.qss).arg(styleName)); if (file.open(QFile::ReadOnly | QFile::Text)) { QTextStream stream(file); QString style stream.readAll(); qApp-setStyleSheet(style); // 全局应用 file.close(); } }light.qss与dark.qss的差异集中在QGraphicsView、QMenuBar、QStatusBar的background-color和color属性。例如dark.qss中QGraphicsView { background-color: #2d2d2d; border: 1px solid #444; } QMenuBar::item:selected { background-color: #4a4a4a; }4.2 配置导入时的图元重建流程importFromXml()函数解析 DOM 后根据text、rect等标签名创建对应图元实例void CircuitBaseScene::importFromXml(const QString filePath) { QDomDocument doc; QFile file(filePath); if (!file.open(QIODevice::ReadOnly)) return; if (!doc.setContent(file)) { file.close(); return; } file.close(); QDomElement root doc.documentElement(); QDomNodeList items root.elementsByTagName(text); for (int i 0; i items.length(); i) { QDomElement elem items.at(i).toElement(); CircuitTextObject *text new CircuitTextObject(); text-setPos(elem.attribute(x).toDouble(), elem.attribute(y).toDouble()); text-setText(elem.attribute(text)); text-setFont(QFont(Arial, elem.attribute(font-size).toInt())); text-setRotation(elem.attribute(rotation).toDouble()); addItem(text); } // ... 同理处理 rect/line/ellipse/arrow }注意addItem()将图元加入QGraphicsScene但不会自动调用CircuitBaseObject::setScaleFactor()。因此导入后需显式遍历所有图元调用obj-setScaleFactor(view-transform().m11())同步缩放状态否则新图元在缩放视图中尺寸异常。4.3 暗黑模式下图元绘制的兼容性处理CircuitBaseObject::paint()中QPen颜色需适配主题。CircuitTextObject重写了penColor()QColor CircuitTextObject::penColor() const { // 检测当前应用样式表是否含 dark 关键字 QString styleSheet qApp-styleSheet(); if (styleSheet.contains(dark.qss) || styleSheet.contains(#2d2d2d)) { return Qt::white; // 暗黑模式用白色文字 } return Qt::black; // 默认用黑色 }CircuitRectObject::paint()同理fillColor()根据主题返回#ffcc00亮色或#8a6d3b暗色确保图元在两种模式下均有足够对比度。5. 课设交付与调试技巧快速验证图元行为、定位缩放失真、修复连接断连5.1 三步法验证图元缩放一致性当发现缩放后文字模糊或线条过细时按顺序检查确认CircuitBaseView::wheelEvent()是否正确调用setScaleFactor()在wheelEvent()末尾添加日志qDebug() Scale factor: transform().m11();滚动鼠标观察输出是否随缩放递增如 1.0 → 1.1 → 1.21 → 1.331。确认图元paint()中字体/画笔是否使用m_scaleFactor在CircuitTextObject::paint()开头添加qDebug() Text scale: m_scaleFactor font size: m_font.pointSizeF() * m_scaleFactor;拖拽图元时若m_scaleFactor为 1.0则说明setScaleFactor()未被调用。确认boundingRect()返回值是否匹配缩放后尺寸在CircuitTextObject::boundingRect()返回前添加qDebug() Bounding rect: baseRect scaled: QRectF(...);对比baseRect与scaled的宽高比应严格等于m_scaleFactor。5.2 连接线断连的定位与修复表现象根本原因修复指令移动图元后连线消失CircuitBaseObject::mouseMoveEvent()未调用updatePosition()在mouseMoveEvent()末尾添加if (m_connectedLines.size()) updateConnectedLines();连线端点漂移至图元中心anchorPoint()返回(0,0)而非实际锚点坐标检查CircuitRectObject::anchorPoint()是否正确计算rect.center().x()等表达式删除图元后连线仍显示悬空disconnectAllLines()未清空m_connectedLines在CircuitBaseObject::~CircuitBaseObject()中添加qDeleteAll(m_connectedLines);updateConnectedLines()实现void CircuitBaseObject::updateConnectedLines() { foreach (CircuitLineObject *line, m_connectedLines) { line-updatePosition(); // 强制重算端点 } }5.3 K12 教学场景下的轻量化改造建议针对中小学信息课需求可快速启用以下功能禁用复杂操作注释mainwindow.ui中actionRotate、actionScale对应的triggered连接保留actionSelect/actionDelete/actionPrint。简化图元面板修改mainwindow.cpp的initToolButtons()只保留Text、Rect、Line三个按钮。强制亮色模式删除qss/dark.qss在main()中移除applyStyleSheet(dark)调用避免学生误操作切换主题。最终交付包只需包含bin/可执行文件、images/图标、qss/light.qss三个目录体积压缩至 2MB 以内满足校园机房快速部署要求。本文还有配套的精品资源点击获取
