QGraphicsEffect 类

成员函数文档

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

构造一个新的QGraphicsEffect实例，具有指定的parent。

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

从源中删除效果并销毁图形效果。

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。

例如

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中调用此函数。

例如

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

另请参阅QGraphicsEffect::draw。

[信号] void QGraphicsEffect::enabledChanged(bool enabled)

当效果被启用或禁用时，会发出此信号。参数enabled包含效果的新启用状态。

另请参阅：isEnabled()。

[受保护] QRectF QGraphicsEffect::sourceBoundingRect(Qt::CoordinateSystem system = Qt::LogicalCoordinates) const

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

当在QGraphicsEffect::draw()之外调用此函数使用Qt::DeviceCoordinates，将给出未定义的结果，因为没有设备上下文可用。

另请参阅：draw()。

[虚受保护] void QGraphicsEffect::sourceChanged(QGraphicsEffect::ChangeFlags flags)

此虚函数由 QGraphicsEffect 调用来通知效果，源已更改。如果效果应用了任何缓存，则必须清除这些缓存，以便反映源的新外观。

flags 描述了哪些内容已更改。

[受保护] bool QGraphicsEffect::sourceIsPixmap() const

如果源实际上是一个位图，例如一个QGraphicsPixmapItem，则返回 true。

此函数在优化方面很有用。例如，如果此函数返回 true，则无需在设备坐标中绘制源以避免位图缩放 - 位图无论如何都需要缩放。

[受保护] 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()。

[槽] void QGraphicsEffect::update()

安排重新绘制效果。每当效果需要重新绘制时，请调用此函数。此函数不会触发源的重新绘制。

另请参阅：updateBoundingRect()。

[受保护] void QGraphicsEffect::updateBoundingRect()

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

如果需要，此函数将调用update()。

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