如何在PyQt5中实现仅弧形区域可点击的扇形按钮？

要让扇形按钮的点击区域严格匹配绘制的弧形，核心是用**矢量路径（QPainterPath）**替代基于像素的QRegion来设置按钮的点击掩码，同时避免默认的矩形按钮背景干扰。以下是具体实现方案：

关键修改点 #

• 用QPainterPath创建精确的闭合扇形路径，将其作为按钮的点击掩码，确保点击区域完全匹配视觉效果
• 在按钮尺寸变化时重新计算路径，保证掩码始终与按钮大小同步
• 禁用QPushButton的默认矩形背景，避免视觉和点击判断的干扰
• 修正角度计算逻辑，确保扇形与六边形顶点位置精准对齐

修改后的完整代码 #

import sys
import numpy as np
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QWidget, QScrollArea, QVBoxLayout
from PyQt5.QtCore import Qt, QRectF, QPointF
from PyQt5.QtGui import QPainter, QPen, QColor, QPainterPath, QPolygonF

class Hex(QWidget): # 六边形单元格
    def __init__(self, buttons, state, radius, cell_id, label_pos, channel_id, channel_pos, color, parent=None):
        super().__init__(parent)
        self.cell_id = cell_id
        self.label_pos = label_pos
        self.radius = radius
        self.state = state
        self.color = color
        self.channel_id = channel_id
        self.channel_pos = channel_pos
        # 创建扇形按钮并存储
        self.button2 = WedgeButton(self.state, channel_id, self.channel_pos, self.radius/1.5, self)
        buttons[cell_id] = self.button2
        
    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing)
        # 绘制六边形
        vertices = [QPointF(self.radius * np.cos(x*np.pi/3 + np.pi/2) + self.radius, 
                           self.radius * np.sin(x*np.pi/3 + np.pi/2) + self.radius) for x in range(6)]
        polygon = QPolygonF(vertices)
        pen = QPen(QColor(self.color))
        painter.setPen(pen)
        painter.setBrush(QColor(self.color))
        painter.drawPolygon(polygon)
        
        # 计算按钮位置并设置
        angle = 3*np.pi/2 + self.channel_pos*np.pi/3 # 从六边形中心到对应顶点的角度
        btn_pos_x = int(self.radius - self.button2.radius + self.radius*np.cos(angle))
        btn_pos_y = int(self.radius - self.button2.radius + self.radius*np.sin(angle))
        self.button2.setGeometry(btn_pos_x, btn_pos_y, int(self.button2.radius*2), int(self.button2.radius*2))

class WedgeButton(QPushButton):
    def __init__(self, state, channel_id, channel_pos, radius, parent=None):
        super().__init__(parent)
        self.channel_id = channel_id
        self.channel_pos = channel_pos
        self.state = int(state)
        self.radius = radius
        # 禁用默认背景绘制，避免矩形干扰
        self.setStyleSheet("QPushButton { border: none; background: transparent; }")
        self.clicked.connect(self.changeState)
        # 初始化时设置掩码
        self.updateMask()

    def changeState(self):
        self.state = (self.state + 1) % 4
        self.update()

    def updateMask(self):
        # 创建扇形路径作为点击掩码
        path = QPainterPath()
        rect = QRectF(0, 0, 2*self.radius, 2*self.radius)
        # Qt的角度单位为1/16度，需做转换
        start_angle = ((210 - self.channel_pos*60) * 16) % (360*16)
        span_angle = 120 * 16
        path.arcMoveTo(rect, start_angle/16)
        path.arcTo(rect, start_angle, span_angle)
        path.lineTo(self.radius, self.radius) # 连接到圆心闭合路径
        path.closeSubpath()
        # 设置路径掩码
        self.setMask(path.toFillPolygon().toPolygon())

    def resizeEvent(self, event):
        # 尺寸变化时更新掩码
        self.updateMask()
        super().resizeEvent(event)

    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing)
        pen = QPen(Qt.black)
        painter.setPen(pen)
        # 根据状态设置填充颜色
        match self.state:
            case 0:
                painter.setBrush(QColor('#3498db'))
            case 1:
                painter.setBrush(Qt.yellow)
            case 2:
                painter.setBrush(QColor('#ffbc36'))
            case 3:
                painter.setBrush(Qt.red)
        
        rect = QRectF(0, 0, 2*self.radius, 2*self.radius)
        start_angle = ((210 - self.channel_pos*60) * 16) % (360*16)
        span_angle = 120 * 16
        painter.drawPie(rect, start_angle, span_angle)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setGeometry(0, 0, 1000, 900)

        self.scroll = QScrollArea()
        self.scroll.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)
        self.scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        self.scroll.setWidgetResizable(True)
        self.setCentralWidget(self.scroll)

        self.widget = QWidget()
        self.scroll.setWidget(self.widget)
        self.vbox = QVBoxLayout()
        self.widget.setLayout(self.vbox)
        self.buttons = {}
        
        pad = Hex(self.buttons, 0, 30, 0, [0,18], 0, 0, '#d1dbe8', parent=self.widget)
        pad.setGeometry(500, 500, pad.radius*2, pad.radius*2)
        
if __name__ == "__main__":
    app = QApplication(sys.argv)
    mainWindow = MainWindow()
    mainWindow.show()
    sys.exit(app.exec_())

效果说明 #

• 点击区域严格匹配扇形范围，矩形区域外的部分不会响应点击
• 无像素化问题，掩码基于矢量路径生成，保持抗锯齿效果
• 按钮状态切换时视觉显示正常，与六边形单元格的位置对齐精准

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