基于PyQt6创建并对齐非矩形可点击组件

一、组件实现：优先选QAbstractButton而非QPushButton #

• QPushButton自带大量默认样式、边框逻辑，重写时要额外清理这些冗余行为，反而麻烦。QAbstractButton是抽象基类，只提供按钮核心交互（点击、悬停状态管理），能完全自定义绘制逻辑，更适配非矩形组件场景。
• 核心实现步骤：
  1. 重写paintEvent：根据按钮状态（正常/悬停/按下），用QPainter绘制自定义非矩形图形（比如多边形、路径）。
  2. 重写hitButton(const QPoint &pos)：这是判断点击是否有效关键，默认只识别矩形区域，你需要在这里根据自定义形状返回true/false，确保只有点击到目标区域才触发按钮事件。
  3. 重写sizeHint()：返回组件实际尺寸，为后续布局计算提供依据。

二、无空隙对齐：别用绝对定位，试试这两种方案 #

方案1：自定义布局管理器 #

• 继承QLayout，重写addItem、sizeHint、setGeometry等方法，根据每个组件的自定义形状和尺寸，精确计算位置，保证紧密贴合无空隙。这种方式下每个组件是独立按钮对象，各自管理状态，适合组件数量多或需动态调整的场景。
• 核心逻辑：在setGeometry中遍历所有子组件，按预设的拼接规则（比如组成某个整体形状）计算每个组件的坐标，再调用item->setGeometry()设置位置。

方案2：单组件+区域划分（更轻量） #

• 如果整体形状固定、不需要动态增减组件，可以用一个QWidget作为父容器，在paintEvent里绘制所有非矩形区域；然后在mousePressEvent、mouseMoveEvent中判断鼠标位置落在哪个区域，手动触发对应区域的点击/悬停逻辑，同时触发重绘更新状态。
• 优势：无需创建多个按钮对象，布局完全由你掌控，绝对不会出现空隙，适合形状固定、交互逻辑不复杂的场景。比如可以用QMap<QPainterPath, int>存储每个区域的路径和对应ID，鼠标事件里遍历路径判断是否包含当前点。

三、悬停效果实现 #

• 用QAbstractButton的话，可通过isHovered()判断状态，在paintEvent中绘制不同样式；同时要给组件开启鼠标追踪：setMouseTracking(true)，确保鼠标未点击时也能触发悬停状态变化。
• 用单组件方案的话，需要在mouseMoveEvent里记录当前悬停的区域ID，调用update()触发重绘，在paintEvent中给悬停区域绘制高亮样式。

简单示例代码（QAbstractButton子类） #

class CustomShapeButton : public QAbstractButton
{
    Q_OBJECT
public:
    explicit CustomShapeButton(QWidget *parent = nullptr) : QAbstractButton(parent) {
        setMouseTracking(true);
    }

    QSize sizeHint() const override {
        return QSize(100, 100); // 替换为你的组件实际尺寸
    }

protected:
    void paintEvent(QPaintEvent *event) override {
        Q_UNUSED(event);
        QPainter painter(this);
        painter.setRenderHint(QPainter::Antialiasing);

        // 自定义三角形路径
        QPainterPath path;
        path.moveTo(50, 0);
        path.lineTo(100, 100);
        path.lineTo(0, 100);
        path.closeSubpath();

        // 根据状态设置样式
        if (isDown()) {
            painter.setBrush(QColor(200, 0, 0));
        } else if (isHovered()) {
            painter.setBrush(QColor(255, 100, 100));
        } else {
            painter.setBrush(QColor(255, 0, 0));
        }
        painter.setPen(Qt::black);
        painter.drawPath(path);
    }

    bool hitButton(const QPoint &pos) const override {
        // 判断点击点是否在三角形区域内
        QPainterPath path;
        path.moveTo(50, 0);
        path.lineTo(100, 100);
        path.lineTo(0, 100);
        path.closeSubpath();
        return path.contains(pos);
    }
};

内容的提问来源于stack exchange，提问作者StaZ