Qt6实战：用setGeometry和事件重写实现一个可拖拽、可缩放的自定义控件

Qt6实战打造可拖拽、可缩放的Photoshop风格图层控件在图形界面开发中能够自由拖拽和调整大小的控件是提升用户体验的关键要素。想象一下Photoshop中的图层操作——那种流畅的拖拽感和精准的尺寸调整正是我们今天要用Qt6实现的效果。本文将带你从零开始创建一个继承自QWidget的自定义控件通过重写鼠标事件和巧妙运用setGeometry实现类似专业设计软件中的交互体验。1. 项目准备与环境搭建首先确保你已经安装了Qt6开发环境。推荐使用Qt Creator作为IDE它能提供完善的代码补全和调试支持。新建一个Qt Widgets Application项目命名为DraggableWidget。在开始编码前我们需要明确几个核心概念setGeometry函数这是QWidget的核心方法之一用于同时设置控件的位置和大小。其参数可以是一个QRect对象也可以是四个整数(x, y, width, height)。鼠标事件处理Qt通过mousePressEvent、mouseMoveEvent和mouseReleaseEvent等方法提供了完整的鼠标交互支持。自定义绘图通过重写paintEvent我们可以完全控制控件的外观呈现。提示在Qt6中事件处理系统相比Qt5有一些优化但基本用法保持兼容这对我们项目的可移植性是个好消息。2. 创建基础可拖拽控件让我们先实现最基本的拖拽功能。创建一个新的C类继承自QWidget// DraggableWidget.h #pragma once #include QWidget class DraggableWidget : public QWidget { Q_OBJECT public: explicit DraggableWidget(QWidget *parent nullptr); protected: void mousePressEvent(QMouseEvent *event) override; void mouseMoveEvent(QMouseEvent *event) override; void paintEvent(QPaintEvent *event) override; private: QPoint dragStartPosition; };对应的实现文件// DraggableWidget.cpp #include DraggableWidget.h #include QMouseEvent #include QPainter DraggableWidget::DraggableWidget(QWidget *parent) : QWidget(parent) { setFixedSize(200, 150); // 初始大小 setStyleSheet(background-color: #3498db; border: 2px solid #2980b9;); } void DraggableWidget::mousePressEvent(QMouseEvent *event) { if (event-button() Qt::LeftButton) { dragStartPosition event-pos(); // 记录拖拽起始点 } QWidget::mousePressEvent(event); } void DraggableWidget::mouseMoveEvent(QMouseEvent *event) { if (event-buttons() Qt::LeftButton) { QPoint delta event-pos() - dragStartPosition; move(pos() delta); // 更新控件位置 } QWidget::mouseMoveEvent(event); } void DraggableWidget::paintEvent(QPaintEvent *event) { QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.fillRect(rect(), QColor(#3498db)); // 绘制控件标识 painter.setPen(Qt::white); painter.drawText(rect(), Qt::AlignCenter, 可拖拽控件); QWidget::paintEvent(event); }这个基础版本已经实现了拖拽功能但还比较简陋。接下来我们要增强它的交互体验。3. 实现八向缩放功能真正的设计软件通常提供八个方向的缩放控制点。我们需要在控件边缘添加这些交互区域// 在DraggableWidget.h中添加 enum ResizeHandle { None, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight }; // 添加私有成员变量 ResizeHandle currentHandle; int handleSize;然后更新实现文件// 在构造函数中初始化 DraggableWidget::DraggableWidget(QWidget *parent) : QWidget(parent), currentHandle(None), handleSize(8) { setMinimumSize(50, 50); // 最小尺寸限制 } // 判断鼠标位置在哪个控制点上 ResizeHandle DraggableWidget::getHandleAt(const QPoint pos) { QRect rect this-rect(); // 定义八个控制点的区域 QRect topLeft(rect.topLeft(), QSize(handleSize, handleSize)); QRect topRight(rect.topRight() - QPoint(handleSize, 0), QSize(handleSize, handleSize)); QRect bottomLeft(rect.bottomLeft() - QPoint(0, handleSize), QSize(handleSize, handleSize)); QRect bottomRight(rect.bottomRight() - QPoint(handleSize, handleSize), QSize(handleSize, handleSize)); QRect top(rect.topLeft() QPoint(handleSize, 0), QSize(rect.width() - 2*handleSize, handleSize)); QRect bottom(rect.bottomLeft() - QPoint(0, handleSize) QPoint(handleSize, 0), QSize(rect.width() - 2*handleSize, handleSize)); QRect left(rect.topLeft() QPoint(0, handleSize), QSize(handleSize, rect.height() - 2*handleSize)); QRect right(rect.topRight() - QPoint(handleSize, 0) QPoint(0, handleSize), QSize(handleSize, rect.height() - 2*handleSize)); if (topLeft.contains(pos)) return TopLeft; if (topRight.contains(pos)) return TopRight; if (bottomLeft.contains(pos)) return BottomLeft; if (bottomRight.contains(pos)) return BottomRight; if (top.contains(pos)) return Top; if (bottom.contains(pos)) return Bottom; if (left.contains(pos)) return Left; if (right.contains(pos)) return Right; return None; } // 更新mousePressEvent void DraggableWidget::mousePressEvent(QMouseEvent *event) { if (event-button() Qt::LeftButton) { currentHandle getHandleAt(event-pos()); if (currentHandle None) { dragStartPosition event-pos(); } else { dragStartPosition event-pos(); originalGeometry geometry(); // 保存原始几何信息 } } QWidget::mousePressEvent(event); }现在我们需要实现mouseMoveEvent来处理各种缩放情况void DraggableWidget::mouseMoveEvent(QMouseEvent *event) { if (event-buttons() Qt::LeftButton) { if (currentHandle None) { // 拖拽移动逻辑 QPoint delta event-pos() - dragStartPosition; move(pos() delta); } else { // 缩放逻辑 QPoint delta event-pos() - dragStartPosition; QRect newGeometry originalGeometry; switch (currentHandle) { case TopLeft: newGeometry.setTopLeft(newGeometry.topLeft() delta); break; case Top: newGeometry.setTop(newGeometry.top() delta.y()); break; case TopRight: newGeometry.setTopRight(newGeometry.topRight() delta); break; case Left: newGeometry.setLeft(newGeometry.left() delta.x()); break; case Right: newGeometry.setRight(newGeometry.right() delta.x()); break; case BottomLeft: newGeometry.setBottomLeft(newGeometry.bottomLeft() delta); break; case Bottom: newGeometry.setBottom(newGeometry.bottom() delta.y()); break; case BottomRight: newGeometry.setBottomRight(newGeometry.bottomRight() delta); break; default: break; } // 应用新的几何属性 if (newGeometry.width() minimumWidth() newGeometry.height() minimumHeight()) { setGeometry(newGeometry); } } } QWidget::mouseMoveEvent(event); }4. 增强视觉效果与用户体验为了让控件更像专业设计软件中的元素我们需要添加一些视觉效果void DraggableWidget::paintEvent(QPaintEvent *event) { QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); // 绘制背景 QLinearGradient gradient(rect().topLeft(), rect().bottomRight()); gradient.setColorAt(0, QColor(52, 152, 219)); gradient.setColorAt(1, QColor(41, 128, 185)); painter.fillRect(rect(), gradient); // 绘制边框 painter.setPen(QPen(Qt::white, 2)); painter.drawRect(rect().adjusted(1, 1, -1, -1)); // 绘制控制点仅在选中时显示 if (underMouse() || currentHandle ! None) { painter.setBrush(Qt::white); QRect rect this-rect(); // 绘制八个控制点 painter.drawRect(QRect(rect.topLeft(), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.topRight() - QPoint(handleSize, 0), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.bottomLeft() - QPoint(0, handleSize), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.bottomRight() - QPoint(handleSize, handleSize), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.topLeft() QPoint(rect.width()/2 - handleSize/2, 0), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.bottomLeft() QPoint(rect.width()/2 - handleSize/2, -handleSize), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.topLeft() QPoint(0, rect.height()/2 - handleSize/2), QSize(handleSize, handleSize))); painter.drawRect(QRect(rect.topRight() QPoint(-handleSize, rect.height()/2 - handleSize/2), QSize(handleSize, handleSize))); } // 绘制文本 painter.setPen(Qt::white); QFont font painter.font(); font.setPointSize(12); painter.setFont(font); painter.drawText(rect(), Qt::AlignCenter, 可拖拽控件); QWidget::paintEvent(event); }此外我们还需要更新鼠标光标形状以提供更好的视觉反馈void DraggableWidget::enterEvent(QEnterEvent *event) { setCursor(Qt::OpenHandCursor); update(); // 触发重绘以显示控制点 QWidget::enterEvent(event); } void DraggableWidget::leaveEvent(QEvent *event) { unsetCursor(); update(); // 触发重绘以隐藏控制点 QWidget::leaveEvent(event); } void DraggableWidget::mousePressEvent(QMouseEvent *event) { if (event-button() Qt::LeftButton) { currentHandle getHandleAt(event-pos()); if (currentHandle None) { setCursor(Qt::ClosedHandCursor); dragStartPosition event-pos(); } else { // 根据控制点设置不同的光标形状 switch (currentHandle) { case TopLeft: case BottomRight: setCursor(Qt::SizeFDiagCursor); break; case TopRight: case BottomLeft: setCursor(Qt::SizeBDiagCursor); break; case Top: case Bottom: setCursor(Qt::SizeVerCursor); break; case Left: case Right: setCursor(Qt::SizeHorCursor); break; default: break; } dragStartPosition event-pos(); originalGeometry geometry(); } } QWidget::mousePressEvent(event); } void DraggableWidget::mouseReleaseEvent(QMouseEvent *event) { setCursor(Qt::OpenHandCursor); currentHandle None; QWidget::mouseReleaseEvent(event); }5. 高级功能扩展现在我们的控件已经具备了基本功能让我们添加一些高级特性5.1 添加对齐辅助线专业设计软件通常会在控件对齐时显示辅助线。我们可以通过重写paintEvent来实现// 在DraggableWidget.h中添加 bool isSnapping; QListQLine snapLines; // 在paintEvent中添加 if (!snapLines.isEmpty()) { painter.setPen(QPen(Qt::red, 1, Qt::DashLine)); for (const QLine line : snapLines) { painter.drawLine(line); } snapLines.clear(); }然后添加对齐检测逻辑void DraggableWidget::checkSnapping(QRect newGeometry) { snapLines.clear(); isSnapping false; // 获取父控件中的所有同类控件 QListDraggableWidget* siblings; foreach (QObject *obj, parent()-children()) { if (DraggableWidget *dw qobject_castDraggableWidget*(obj)) { if (dw ! this) siblings.append(dw); } } // 检查与每个兄弟控件的对齐情况 for (DraggableWidget *sibling : siblings) { QRect sibGeo sibling-geometry(); // 检查垂直对齐 if (abs(newGeometry.left() - sibGeo.left()) 5) { newGeometry.moveLeft(sibGeo.left()); snapLines.append(QLine(newGeometry.left(), 0, newGeometry.left(), parentWidget()-height())); isSnapping true; } // 其他对齐情况检查... } }5.2 添加旋转功能要实现旋转功能我们需要使用QTransform// 在DraggableWidget.h中添加 double rotationAngle; QPoint rotationCenter; // 更新paintEvent QTransform transform; transform.translate(rotationCenter.x(), rotationCenter.y()); transform.rotate(rotationAngle); transform.translate(-rotationCenter.x(), -rotationCenter.y()); painter.setTransform(transform);5.3 添加撤销/重做功能要实现操作历史记录我们可以使用QUndoStack// 命令类定义 class MoveCommand : public QUndoCommand { public: MoveCommand(DraggableWidget *widget, const QPoint oldPos, QUndoCommand *parent nullptr) : QUndoCommand(parent), widget(widget), oldPos(oldPos), newPos(widget-pos()) { setText(移动控件); } void undo() override { widget-move(oldPos); } void redo() override { widget-move(newPos); } private: DraggableWidget *widget; QPoint oldPos; QPoint newPos; }; // 在mouseReleaseEvent中添加 if (originalPos ! pos()) { undoStack-push(new MoveCommand(this, originalPos)); }6. 性能优化与边界处理随着功能增加我们需要确保控件的性能不受影响6.1 减少不必要的重绘// 设置控件属性 setAttribute(Qt::WA_StaticContents); // 静态内容优化 setAttribute(Qt::WA_OpaquePaintEvent); // 不透明优化 // 在move/resize时只更新必要区域 void DraggableWidget::moveEvent(QMoveEvent *event) { QWidget::moveEvent(event); update(rect()); // 只更新控件区域 } void DraggableWidget::resizeEvent(QResizeEvent *event) { QWidget::resizeEvent(event); update(rect()); // 只更新控件区域 }6.2 处理边界情况// 确保控件不会移出父窗口 void DraggableWidget::move(int x, int y) { QWidget *p parentWidget(); if (p) { x qMax(0, qMin(x, p-width() - width())); y qMax(0, qMin(y, p-height() - height())); } QWidget::move(x, y); } // 限制最小尺寸 void DraggableWidget::setMinimumSize(const QSize size) { QSize actualSize(size.width() handleSize*2, size.height() handleSize*2); QWidget::setMinimumSize(actualSize); }7. 实际应用示例让我们创建一个简单的图片编辑器来演示这个控件的实际应用// MainWindow.h class MainWindow : public QMainWindow { Q_OBJECT public: MainWindow(QWidget *parent nullptr); private slots: void addTextWidget(); void addImageWidget(); private: QUndoStack *undoStack; }; // MainWindow.cpp MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), undoStack(new QUndoStack(this)) { // 创建工具栏 QToolBar *toolBar addToolBar(工具); toolBar-addAction(添加文本, this, MainWindow::addTextWidget); toolBar-addAction(添加图片, this, MainWindow::addImageWidget); // 创建中央画布 QWidget *canvas new QWidget; canvas-setStyleSheet(background-color: #ecf0f1;); setCentralWidget(canvas); // 添加撤销/重做按钮 QAction *undoAction undoStack-createUndoAction(this, 撤销); undoAction-setShortcut(QKeySequence::Undo); QAction *redoAction undoStack-createRedoAction(this, 重做); redoAction-setShortcut(QKeySequence::Redo); toolBar-addAction(undoAction); toolBar-addAction(redoAction); } void MainWindow::addTextWidget() { DraggableWidget *widget new DraggableWidget(centralWidget()); widget-show(); } void MainWindow::addImageWidget() { DraggableWidget *widget new DraggableWidget(centralWidget()); // 这里可以加载图片... widget-show(); }这个示例展示了如何将我们的可拖拽控件集成到一个实际应用中并添加了撤销/重做功能。