如何裁剪QWidget？实现蒙版切片效果使部分区域不可见

以下是Qt中实现QWidget部分区域不可见的常用方法，覆盖不同场景需求：

1. 用QRegion直接设置部件可见区域 #

这是最轻量化的方案，直接通过setMask()定义部件的可见范围，被裁剪的区域既不可见也不会响应交互事件。

示例代码（C++）：

// 假设targetWidget是你需要裁剪的QWidget实例
QRect widgetBounds = targetWidget->rect();

// 示例1：只保留左半部分可见
QRegion visibleArea(widgetBounds.left(), widgetBounds.top(), widgetBounds.width()/2, widgetBounds.height());

// 示例2：挖去中间一块矩形区域
// QRegion visibleArea(widgetBounds);
// QRect hiddenRect(widgetBounds.center().x()-100, widgetBounds.center().y()-100, 200, 200);
// visibleArea -= QRegion(hiddenRect);

// 应用蒙版
targetWidget->setMask(visibleArea);

优势：无需额外绘制逻辑，性能开销极低，适合静态或简单动态的蒙版需求。

2. 重写paintEvent绘制视觉蒙版 #

如果需要半透明蒙版、渐变蒙版，或者希望被隐藏的区域仍能响应交互（只是视觉上不可见），可以重写paintEvent()，在原有内容之上绘制覆盖层。

示例代码（自定义Widget）：

void MaskedWidget::paintEvent(QPaintEvent* event)
{
    // 先绘制原有部件内容
    QWidget::paintEvent(event);

    QPainter painter(this);
    painter.setRenderHint(QPainter::Antialiasing);

    // 定义需要隐藏的区域（示例：右下角圆形）
    QRect hiddenArea(width()-150, height()-150, 150, 150);
    QRegion hiddenRegion(hiddenArea, QRegion::Ellipse);

    // 用父窗口背景色覆盖（如果需要半透明，可设置painter.setOpacity(0.8)）
    painter.setBrush(palette().background());
    painter.setPen(Qt::NoPen);
    painter.drawRegion(hiddenRegion);
}

优势：灵活控制蒙版的视觉效果，不影响部件的事件响应逻辑。

3. 嵌套QGraphicsView实现复杂蒙版 #

如果你的UI涉及大量动态元素或需要更复杂的蒙版变换（比如旋转、缩放蒙版），可以把QWidget包装成QGraphicsProxyWidget，利用Qt Graphics Framework的蒙版功能。

示例代码：

// 创建场景和视图
QGraphicsScene* scene = new QGraphicsScene(this);
QGraphicsView* view = new QGraphicsView(scene, this);
view->setGeometry(0, 0, 400, 400);
view->setFrameShape(QFrame::NoFrame);

// 包装目标Widget
QWidget* myWidget = new QWidget;
myWidget->setStyleSheet("background: lightblue;");
QGraphicsProxyWidget* proxy = scene->addWidget(myWidget);
proxy->setGeometry(0, 0, 400, 400);

// 设置蒙版：只显示上半部分
QRegion mask(QRect(0, 0, 400, 200));
proxy->setMask(mask);

优势：支持复杂的图形变换和动态蒙版调整，适合富交互场景。

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