如何阻止QPushButton因长文本自动拉伸宽度

问题场景 #

需要让QPushButton宽度保持为父HBoxLayout宽度的固定比例，同时避免文本过长时按钮、布局及上级窗口被撑大。计划用QFontMetrics实现文本省略，但也要处理省略后文本仍超宽的情况，彻底防止窗口变宽。

试过self.ui.pushButton.setFixedWidth(self.ui.pushButton.width())，虽能阻止拉伸但按钮被挤窄，还会压缩布局内其他控件；用self.ui.pushButton.setFixedWidth(self.ui.pushButton.sizeHint().width())解决了初始固定宽度问题，但窗口resize时，按钮无法先自适应比例再固定宽度，重写resizeEvent未成功，求可靠方案。

解决方案 #

核心思路是结合布局拉伸因子控制按钮宽度比例，通过窗口resize事件动态调整按钮固定宽度，再配合QFontMetrics处理文本省略，确保按钮宽度始终符合布局比例且不被文本撑大。

实现步骤 #

1. 给HBoxLayout中的按钮设置固定水平拉伸因子，明确按钮在布局中的宽度占比
2. 重写窗口resizeEvent，在窗口大小变化时根据布局宽度和比例计算按钮目标宽度并设置为固定宽度
3. 用QFontMetrics自动截断过长文本，避免按钮试图撑大自身

修改后的代码 #

guiTest.py（顶层代码）

from widthTest_ui import Ui_Dialog
from PyQt5.QtWidgets import QDialog, QApplication
from PyQt5.QtGui import QFontMetrics
import sys

class widthTestDialog(QDialog, Ui_Dialog):
    def __init__(self, parent):
        QDialog.__init__(self)
        self.parent = parent
        self.ui = Ui_Dialog()
        self.ui.setupUi(self)
        self.txt = ''
        # 配置按钮与其他控件的拉伸比例（按钮占1份，其他控件总占2份）
        self.button_stretch = 1
        self.others_stretch = 2
        # 初始化按钮宽度
        self.adjust_button_width()

    def onClick(self, e):
        self.txt += 'a'
        # 更新文本时自动截断
        self.update_button_text(self.txt)

    def update_button_text(self, raw_text):
        metrics = QFontMetrics(self.ui.pushButton.font())
        # 留10px边距，计算可显示的省略文本
        elided_text = metrics.elidedText(raw_text, 0, self.ui.pushButton.width() - 10)
        self.ui.pushButton.setText(elided_text)

    def adjust_button_width(self):
        # 获取HBoxLayout的可用宽度
        layout_total_width = self.ui.horizontalLayout.contentsRect().width()
        # 计算按钮应占的宽度比例
        total_stretch = self.button_stretch + self.others_stretch
        target_width = int(layout_total_width * (self.button_stretch / total_stretch))
        # 设置按钮固定宽度
        self.ui.pushButton.setFixedWidth(target_width)

    def resizeEvent(self, event):
        super().resizeEvent(event)
        # 窗口 resize 时重新调整按钮宽度
        self.adjust_button_width()
        # 同步更新文本截断
        self.update_button_text(self.txt)

def main():
    app = QApplication(sys.argv)
    w = widthTestDialog(app)
    w.show()
    sys.exit(app.exec_())

if __name__ == "__main__":
    main()

widthTest_ui.py（调整布局设置）

修改按钮的SizePolicy并添加拉伸因子（如果布局内有其他控件，需给对应控件设置拉伸因子）：

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_Dialog(object):
    def setupUi(self, Dialog):
        Dialog.setObjectName("Dialog")
        Dialog.resize(176, 87)
        self.verticalLayout = QtWidgets.QVBoxLayout(Dialog)
        self.verticalLayout.setObjectName("verticalLayout")
        self.horizontalLayout = QtWidgets.QHBoxLayout()
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.pushButton = QtWidgets.QPushButton(Dialog)
        # 修改SizePolicy为Fixed水平，避免按钮主动拉伸
        sizePolicy = QtWidgets.QSizePolicy(QtWidgets.QSizePolicy.Fixed, QtWidgets.QSizePolicy.Fixed)
        sizePolicy.setHorizontalStretch(0)
        sizePolicy.setVerticalStretch(0)
        sizePolicy.setHeightForWidth(self.pushButton.sizePolicy().hasHeightForWidth())
        self.pushButton.setSizePolicy(sizePolicy)
        font = QtGui.QFont()
        font.setFamily("Segoe UI")
        font.setPointSize(12)
        self.pushButton.setFont(font)
        self.pushButton.setObjectName("pushButton")
        # 给按钮添加拉伸因子
        self.horizontalLayout.addWidget(self.pushButton, stretch=1)
        # 若布局内有其他控件（如标签），添加对应拉伸因子
        # self.horizontalLayout.addWidget(self.label, stretch=2)
        self.verticalLayout.addLayout(self.horizontalLayout)

        self.retranslateUi(Dialog)
        self.pushButton.clicked.connect(Dialog.onClick) # type: ignore
        QtCore.QMetaObject.connectSlotsByName(Dialog)

    def retranslateUi(self, Dialog):
        _translate = QtCore.QCoreApplication.translate
        Dialog.setWindowTitle(_translate("Dialog", "Dialog"))
        self.pushButton.setText(_translate("Dialog", "PushButton"))

方案说明 #

• 拉伸因子可根据需求调整，比如按钮拉伸因子设为1、其他控件总拉伸因子设为2，按钮就会始终占HBoxLayout宽度的1/3
• update_button_text方法通过QFontMetrics自动生成省略文本，确保文本不会超出按钮宽度
• resizeEvent中同步调整按钮宽度和文本，保证窗口大小变化时按钮始终符合比例
• 完全基于Qt布局机制和事件系统实现，无hack操作

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