自定义QPushButton提示框首次显示不全问题排查求助

核心原因分析 #

首次hover时提示框显示不全，本质是tooltip首次显示前未完成正确的尺寸计算：QLabel的文本内容未触发布局更新，导致self.width()和self.height()获取的是初始默认尺寸（远小于实际文本所需），从而移动位置和显示范围错误。移出再hover时，组件已完成布局，尺寸计算恢复正常。

具体修复方案 #

1. 强制Tooltip完成尺寸计算 #

修改CustomTooltip类，确保文本加载后立即触发布局调整，获取正确的控件尺寸：

class CustomTooltip(QWidget):
    def __init__(self, text, parent):
        super().__init__(parent)
        self.label = QLabel(self)
        self.text = text
        self.label.setText(self.text)
        # 让QLabel根据文本内容调整自身尺寸
        self.label.adjustSize()
        # 让Tooltip窗口根据QLabel的尺寸调整自身大小
        self.adjustSize()
        
        self.setWindowFlags(Qt.ToolTip | Qt.FramelessWindowHint)
        self.setStyleSheet("background: #aaaaaa; border: 2px solid black; border-radius: 12px; color: black; padding: 5px;")
        self.setAttribute(Qt.WA_TranslucentBackground)

    def showAtMouse(self):
        cursor_pos = QCursor.pos()
        # 每次显示前再次确认尺寸（避免文本动态变化或样式更新导致的偏差）
        self.label.adjustSize()
        self.adjustSize()
        self.move(cursor_pos.x() - self.width() - 5, cursor_pos.y() - self.height() - 5)
        self.show()

2. 优化InfoButton的事件触发逻辑 #

避免mouseMoveEvent频繁触发tooltip更新，改为在enterEvent中初始化显示，mouseMoveEvent中仅更新位置，减少首次显示的布局冲突：

class InfoButton(QPushButton):
    def __init__(self, string, size: int, parent):
        super().__init__(parent)  # 修复：原代码未传入parent，可能导致父组件关联异常
        self.string = string
        self.size = size
        self.parent_object = parent

        self.setStyleSheet("background-color: transparent;"
                           "border: 0px solid;"
                           f"border-radius: {self.size}px;"
                           "color: #ffffff;")

        self.setIcon(QIcon('images/icons/black/info48x48.svg'))  # 路径用正斜杠，避免转义问题
        self.setIconSize(QSize(self.size, self.size))

        self.custom_tooltip = CustomTooltip(self.string, self.parent_object)
        self.setToolTipDuration(0)
        self.setMouseTracking(True)

    def enterEvent(self, a0):
        # 鼠标进入时首次显示tooltip，确保尺寸已计算完成
        self.custom_tooltip.showAtMouse()

    def mouseMoveEvent(self, e):
        # 鼠标移动时仅更新位置，无需重复计算尺寸
        cursor_pos = QCursor.pos()
        self.custom_tooltip.move(cursor_pos.x() - self.custom_tooltip.width() - 5, cursor_pos.y() - self.custom_tooltip.height() - 5)

    def leaveEvent(self, a0):
        self.custom_tooltip.hide()

3. 排查父组件布局影响 #

如果某场景仍存在问题，检查该场景下InfoButton的父组件：

• 确保父组件已完成show()或layout()初始化，避免tooltip首次显示时父组件未渲染完成
• 若父组件是滚动区域、堆叠窗口等动态容器，可在父组件showEvent中延迟初始化InfoButton，确保容器布局稳定后再创建按钮

关键细节说明 #

• 原代码中super().__init__()未传入parent，可能导致按钮与父组件的布局关联异常，修正为super().__init__(parent)
• 路径中的反斜杠\改为正斜杠/，避免Windows下的转义错误
• adjustSize()会让控件根据子组件（QLabel）的尺寸自动调整自身大小，确保tooltip的宽高完全包裹文本内容

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