使用分数DPR时QPushButton边框截断问题的一致性解决方法咨询

问题背景 #

将软件从Qt 5.15升级至Qt 6.5后，高DPI缩放的新处理逻辑导致自定义QPushButton出现视觉异常：部分按钮因所属QLayout的布局计算，边框左侧或顶部被截断。自定义按钮基于QPushButton重写paintEvent实现，已通过ceil(dpr)缩放线宽+使用cosmetic QPen避免分数线宽问题，但手动调整布局边距无法适配所有缩放/分辨率场景，且不想修改HighDpiScaleFactorRoundingPolicy。

核心问题分析 #

布局裁剪边框的本质是：自定义按钮的绘制区域超出了布局分配的空间。Cosmetic笔的线宽为居中绘制，当线宽大于0时，边框的一半会落在Widget的rect()范围之外，而Qt 6的高DPI布局像素对齐逻辑会将这部分超出区域裁剪。

解决方案 #

1. 调整绘制路径，避免超出Widget边界 #

修改paintEvent中的矩形绘制逻辑，将绘制区域向内偏移笔宽的一半，确保整个边框都在Widget的可见范围内：

void CustomButton::paintEvent(QPaintEvent *event)
{
    QPainter p(this);
    p.setRenderHints(QPainter::Antialiasing);

    // 使用Widget自身的DPR（更准确，适配跨屏幕场景）
    qreal dpr = this->devicePixelRatio();
    qreal scaledLineWidth = 1.0 * ceil(dpr);
    qreal halfLineWidth = scaledLineWidth / 2.0;

    // 向内偏移笔宽的一半，避免边框超出Widget边界
    QRectF drawRect = rect().adjusted(halfLineWidth, halfLineWidth, -halfLineWidth, -halfLineWidth);

    QPainterPath bgRectPath;
    bgRectPath.addRoundedRect(drawRect, 0.5*drawRect.height(), 0.5*drawRect.height());

    p.setClipPath(bgRectPath);

    QPen framePen = QPen(Qt::black, scaledLineWidth);
    framePen.setCosmetic(true);
    p.setPen(framePen);
    p.drawPath(bgRectPath);

    event->accept();
}

2. 重写sizeHint，为边框预留布局空间 #

让布局自动为按钮分配包含边框宽度的空间，无需手动调整边距：
在custombutton.h中添加声明：

protected:
    QSize sizeHint() const override;

在custombutton.cpp中实现：

QSize CustomButton::sizeHint() const
{
    QSize baseSize = QPushButton::sizeHint();
    qreal dpr = this->devicePixelRatio();
    qreal scaledLineWidth = 1.0 * ceil(dpr);
    // 给宽高各加上完整线宽（左右/上下各占一半）
    int extra = qCeil(scaledLineWidth);
    return baseSize + QSize(extra, extra);
}

3. 优化布局间距（可选） #

如果使用固定间距，需适配高DPI：

// 将固定间距改为适配DPR的逻辑值
layout->addSpacing(qRound(5 * this->devicePixelRatio()));

复现代码 #

main.cpp #

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}

mainwindow.h #

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QLayout>
#include "custombutton.h"

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
};
#endif // MAINWINDOW_H

mainwindow.cpp #

#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent)
{
    QWidget *widget = new QWidget;
    CustomButton *button = new CustomButton;

    QHBoxLayout *layout = new QHBoxLayout;
    layout->addSpacing(5);
    layout->addWidget(button);
    layout->addSpacing(5);
    layout->setContentsMargins(0, 0, 0, 0);

    widget->setLayout(layout);
    setCentralWidget(widget);
}

MainWindow::~MainWindow() {}

custombutton.h #

#ifndef CUSTOMBUTTON_H
#define CUSTOMBUTTON_H

#include <QPaintEvent>
#include <QPushButton>
#include <QPainter>
#include <QPainterPath>

class CustomButton : public QPushButton
{
    Q_OBJECT
public:
    CustomButton();

protected:
    void paintEvent(QPaintEvent *event) override;
    QSize sizeHint() const override;
};

#endif // CUSTOMBUTTON_H

custombutton.cpp #

#include "custombutton.h"
#include <QSize>

CustomButton::CustomButton() {}

void CustomButton::paintEvent(QPaintEvent *event)
{
    QPainter p(this);
    p.setRenderHints(QPainter::Antialiasing);

    qreal dpr = this->devicePixelRatio();
    qreal scaledLineWidth = 1.0 * ceil(dpr);
    qreal halfLineWidth = scaledLineWidth / 2.0;

    QRectF drawRect = rect().adjusted(halfLineWidth, halfLineWidth, -halfLineWidth, -halfLineWidth);

    QPainterPath bgRectPath;
    bgRectPath.addRoundedRect(drawRect, 0.5*drawRect.height(), 0.5*drawRect.height());

    p.setClipPath(bgRectPath);

    QPen framePen = QPen(Qt::black, scaledLineWidth);
    framePen.setCosmetic(true);
    p.setPen(framePen);
    p.drawPath(bgRectPath);

    event->accept();
}

QSize CustomButton::sizeHint() const
{
    QSize baseSize = QPushButton::sizeHint();
    qreal dpr = this->devicePixelRatio();
    qreal scaledLineWidth = 1.0 * ceil(dpr);
    int extra = qCeil(scaledLineWidth);
    return baseSize + QSize(extra, extra);
}

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