PyQt6自定义异形按钮部分点击失效问题求助

问题 #

基于PyQt6开发GUI，需放置大量几何形状各异、布局无规律的按钮（无法使用QHBoxLayout或QVBoxLayout），核心需求是点击按钮时切换显示对应图片。目前遇到两个问题：

• self.button_R_1无法正常响应点击事件
• 按钮的可用性受定义顺序影响
  最终需要添加约30个此类无规律布局的按钮，求问题原因及修复方案。

问题原因 #

1. setGeometry参数错误：QWidget.setGeometry()的参数格式为(x, y, width, height)，但你传入的是geometry_points[2].x(), geometry_points[2].y()，这将按钮的宽高设置为了绝对坐标值，导致按钮实际的点击区域（控件矩形）和你绘制的多边形区域完全不匹配，甚至可能被其他控件遮挡。
2. 重写geometry()方法冲突：QWidget本身自带geometry()方法，用于返回控件的矩形几何区域，你重写该方法返回多边形，会导致Qt内部对控件几何位置的判断逻辑混乱，进而影响鼠标事件的传递。
3. 控件堆叠层级问题：Qt中控件的创建顺序决定了堆叠层级（后创建的控件默认在顶层），如果先创建的按钮点击区域被后创建的控件覆盖，就无法响应点击，这就是按钮可用性受定义顺序影响的原因。

修复方案 #

1. 修正setGeometry参数计算 #

计算按钮的实际宽高：取多边形所有点的最大/最小坐标，用max_x - min_x作为宽度，max_y - min_y作为高度，确保控件矩形能完整覆盖你绘制的多边形区域。

2. 避免重写父类geometry()方法 #

将自定义的多边形几何方法重命名为polygon()，避免和QWidget的原生方法冲突。

3. 优化鼠标事件判断 #

在mousePressEvent中使用重命名后的polygon()方法判断点击位置是否在多边形内。

4. 封装按钮创建逻辑 #

将按钮创建的重复代码封装成函数，方便后续批量添加30个按钮，同时避免代码冗余。

修改后的完整代码 #

import sys
from PyQt6.QtWidgets import QApplication, QWidget, QLabel, QHBoxLayout, QPushButton, QGridLayout
from PyQt6.QtGui import QPixmap, QPainter, QPolygon, QColor
from PyQt6.QtCore import Qt, QPoint, pyqtSignal

# 自定义按钮类
class CustomButton(QPushButton):
    buttonClicked = pyqtSignal()

    def __init__(self, text, geometry_points, parent=None):
        super().__init__(text, parent)
        self.geometry_points = geometry_points
        # 计算按钮的矩形区域
        xs = [p.x() for p in geometry_points]
        ys = [p.y() for p in geometry_points]
        self.setGeometry(min(xs), min(ys), max(xs)-min(xs), max(ys)-min(ys))
    
    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.RenderHint.Antialiasing)
        
        # 绘制按钮背景多边形
        painter.setBrush(QColor(255, 255, 255))
        painter.setPen(Qt.GlobalColor.black)
        painter.drawPolygon(self.polygon())
        
        # 绘制文本
        painter.setPen(Qt.GlobalColor.black)
        text_rect = self.polygon().boundingRect()
        painter.drawText(text_rect, Qt.AlignmentFlag.AlignCenter, self.text())

    def polygon(self):
        # 重命名方法，避免和geometry()冲突
        polygon = QPolygon()
        for point in self.geometry_points:
            polygon.append(QPoint(int(point.x()), int(point.y())))
        return polygon
    
    def mousePressEvent(self, event):
        # 使用自定义polygon()判断点击位置
        if self.polygon().containsPoint(event.pos(), Qt.FillRule.WindingFill):
            self.buttonClicked.emit()
        # 调用父类方法，保留默认行为
        super().mousePressEvent(event)

# 主窗口类
class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle("Hintergrundbild anpassen")
        self.setStyleSheet("background-color: #7F9EA9;")
        
        # 加载背景图
        image_path = "C:/Users/paull/Google Drive /HIWI/Arbeit/V_Modell_6.png"  
        pixmap = QPixmap(image_path)
        
        # 适配屏幕大小
        screen = QApplication.primaryScreen()
        screen_size = screen.availableGeometry().size()
        self.resize(screen_size)
        
        # 缩放图片
        scale_factor = 0.85
        ratio_pixmap = 0.5626953125
        self.original_scaled_width = int(screen_size.width() * scale_factor)
        self.original_scaled_height = int(self.original_scaled_width * ratio_pixmap)
        self.scaled_pixmap = pixmap.scaledToWidth(self.original_scaled_width, Qt.TransformationMode.SmoothTransformation)

        # 创建图片标签
        self.label = QLabel(self)
        self.label.setPixmap(self.scaled_pixmap)
        self.label.setGeometry(0, 0, self.original_scaled_width, self.original_scaled_height)

        # 创建按钮容器
        button_container = QWidget()
        button_layout = QGridLayout()
        button_layout.addWidget(self.label)
        button_container.setLayout(button_layout)

        # 缩放因子
        self.faktor = self.original_scaled_width / 5120

        # 封装按钮创建函数
        def create_button(name, abweichung_x_faktor, abweichung_y_faktor, points):
            abweichung_x = self.original_scaled_width * abweichung_x_faktor
            abweichung_y = self.original_scaled_height * abweichung_y_faktor
            geometry_points = [
                QPoint(int(round(p.x()*self.faktor - abweichung_x)), 
                       int(round(p.y()*self.faktor - abweichung_y))) 
                for p in points
            ]
            btn = CustomButton("", geometry_points, button_container)
            btn.buttonClicked.connect(self.handler)
            return btn

        # 创建各个按钮
        self.button_R_1 = create_button(
            "R_1",
            237/1440, 85/926,
            [QPoint(1711,553), QPoint(1875,553), QPoint(2135,1588), QPoint(1972,1588)]
        )
        
        self.button_F_1 = create_button(
            "F_1",
            220/1440, 117/926,
            [QPoint(1594,755), QPoint(1760,755), QPoint(1971,1588), QPoint(1803,1588)]
        )

        self.button_F_0 = create_button(
            "F_0",
            165/1440, 84/926,
            [QPoint(1200,554), QPoint(1710,554), QPoint(1760,755), QPoint(1250,755)]
        )
        
        self.button_R_0 = create_button(
            "R_0",
            175/1632, 38/918,
            [QPoint(1127,263), QPoint(1803,263), QPoint(1875,553), QPoint(1199,553)]
        )

        self.button_Projektinitialisierung = create_button(
            "Projektinitialisierung",
            106/1632, 9/918,
            [QPoint(695,84), QPoint(1757,84), QPoint(1799,252), QPoint(736,252)]
        )

        # 返回按钮
        self.button_zurueck = QPushButton("Zurück", button_container)
        self.button_zurueck.clicked.connect(self.backButtonClicked)
        self.button_zurueck.hide()

        # 主布局
        main_layout = QHBoxLayout()
        main_layout.addWidget(button_container)
        main_layout.setAlignment(Qt.AlignmentFlag.AlignCenter)
        self.setLayout(main_layout)

    def handler(self):
        sender = self.sender()
        image_path = ""
        if sender in (self.button_R_0, self.button_R_1):
            image_path = "C:/Users/paull/Google Drive /HIWI/Arbeit/R.png"
            print("R clicked")
        elif sender == self.button_Projektinitialisierung:
            image_path = "C:/Users/paull/Google Drive /HIWI/Arbeit/Projektinitialisierung.png"
            print("pro clicked")
        elif sender in (self.button_F_0, self.button_F_1):
            image_path = "C:/Users/paull/Google Drive /HIWI/Arbeit/F.png"
            print("F clicked")
        
        if image_path:
            pixmap = QPixmap(image_path)
            self.label.setPixmap(pixmap)
            # 隐藏所有功能按钮
            for btn in [self.button_Projektinitialisierung, self.button_R_0, self.button_R_1, self.button_F_0, self.button_F_1]:
                btn.hide()
            self.button_zurueck.show()

    def backButtonClicked(self):
        self.button_zurueck.hide()
        self.label.setPixmap(self.scaled_pixmap)
        # 显示所有功能按钮
        for btn in [self.button_Projektinitialisierung, self.button_R_0, self.button_R_1, self.button_F_0, self.button_F_1]:
            btn.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    mainWindow = MainWindow()
    mainWindow.show()
    sys.exit(app.exec())

额外优化建议 #

• 如果后续添加30个按钮，可以把按钮的配置数据（偏移因子、多边形点）放到一个列表中，循环创建按钮，进一步简化代码。
• 如果按钮之间存在重叠且需要精确响应，可以给按钮设置setAttribute(Qt.WidgetAttribute.WA_TransparentForMouseEvents, False)，确保鼠标事件能正确传递到目标按钮。

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