QGraphicsEffect Class

成员函数文档

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

创建一个具有指定parent 的新QGraphicsEffect实例。

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

从源对象上移除该效果，并销毁该Graphical Effects。

QRectF QGraphicsEffect::boundingRect() const

返回此效果的有效边界矩形，即源在设备坐标系中的边界矩形，并已根据该效果自身应用的任何边距进行了调整。

另请参阅 boundingRectFor() 和updateBoundingRect()。

[virtual] QRectF QGraphicsEffect::boundingRectFor(const QRectF &rect) const

根据提供的设备坐标系下的rect ，返回此效果的有效边界矩形。在编写自定义效果时，每当更改任何可能导致此函数返回不同值的参数时，都必须调用updateBoundingRect()。

另请参阅 sourceBoundingRect()。

[pure virtual protected] void QGraphicsEffect::draw(QPainter *painter)

此纯虚拟函数负责绘制该特效，并在每次需要绘制源对象时被调用。

请在QGraphicsEffect 的子类中重写此函数，以提供效果的绘制实现，并使用painter 。

例如：

void MyGraphicsEffect::draw(QPainter *painter)
{
    //...
    QPoint offset;
    if (sourceIsPixmap()) {
        // No point in drawing in device coordinates (pixmap will be scaled anyways).
        const QPixmap pixmap = sourcePixmap(Qt::LogicalCoordinates, &offset);
        //...
        painter->drawPixmap(offset, pixmap);
    } else {
        // Draw pixmap in device coordinates to avoid pixmap scaling;
        const QPixmap pixmap = sourcePixmap(Qt::DeviceCoordinates, &offset);
        painter->setWorldTransform(QTransform());
        //...
        painter->drawPixmap(offset, pixmap);
    }
    //...
}

用户不应显式调用此函数，因为它仅用于重写目的。

[protected] void QGraphicsEffect::drawSource(QPainter *painter)

使用给定的painter 直接绘制源内容。

该函数仅应从QGraphicsEffect::draw()中调用。

例如：

void MyGraphicsOpacityEffect::draw(QPainter *painter)
{
    // Fully opaque; draw directly without going through a pixmap.
    if (qFuzzyCompare(m_opacity, 1)) {
        drawSource(painter);
        return;
    }
    //...
}

另请参阅 QGraphicsEffect::draw()。

[signal] void QGraphicsEffect::enabledChanged(bool enabled)

每当效果被启用或禁用时，都会触发此信号。enabled 参数保存了效果的新启用状态。

另请参阅 isEnabled()。

[protected] QRectF QGraphicsEffect::sourceBoundingRect(Qt::CoordinateSystem system = Qt::LogicalCoordinates) const

返回映射到给定system 的源数据的边界矩形。

如果在QGraphicsEffect::draw() 之外调用此函数并传入Qt::DeviceCoordinates ，将产生未定义的结果，因为此时没有可用的设备上下文。

另请参阅 draw()。

[virtual protected] void QGraphicsEffect::sourceChanged(QGraphicsEffect::ChangeFlags flags)

该虚拟函数由QGraphicsEffect 调用，用于通知效果器源对象已发生变化。如果该效果器使用了任何缓存，则必须清除该缓存，以反映源对象的新外观。

flags 描述了发生的变化。

[protected] bool QGraphicsEffect::sourceIsPixmap() const

如果源实际上是一个像素图（例如QGraphicsPixmapItem ），则返回true 。

此函数在优化方面非常有用。例如，如果该函数返回true ，那么为了避免像素图缩放而在设备坐标系中绘制源图像就没有意义——源像素图最终仍会被缩放。

[protected] QPixmap QGraphicsEffect::sourcePixmap(Qt::CoordinateSystem system = Qt::LogicalCoordinates, QPoint *offset = nullptr, QGraphicsEffect::PixmapPadMode mode = PadToEffectiveBoundingRect) const

返回一个已绘制源图像的位图。

system 指定了源图像应使用的坐标系。可选参数offset 返回使用当前绘制器绘制像素图时的偏移量。若需控制像素图的填充方式，请使用mode 参数。

当system 为Qt::DeviceCoordinates 时，返回的像素图将被裁剪为当前绘图器的设备矩形。

若在调用QGraphicsEffect::draw() 之前调用此函数，且Qt::DeviceCoordinates 参数值超出 () 的范围，将导致结果未定义，因为此时没有可用的设备上下文。

另请参阅 draw() 和boundingRect()。

[slot] void QGraphicsEffect::update()

安排对该效果进行重绘。每当需要重绘该效果时，请调用此函数。此函数不会触发源内容的重绘。

另请参阅 updateBoundingRect()。

[protected] void QGraphicsEffect::updateBoundingRect()

当效果的边界矩形发生变化时，此函数会通知效果框架。作为自定义效果的作者，每当您修改任何会导致虚拟函数boundingRectFor() 返回不同值的参数时，都必须调用此函数。

如有必要，该函数将调用update()。

另请参阅 boundingRectFor()、boundingRect() 和sourceBoundingRect()。