QGraphicsEffect Class

Member Function Dokumentation

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

Konstruiert eine neue QGraphicsEffect-Instanz mit dem angegebenen parent.

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

Entfernt den Effekt aus der Quelle und vernichtet den Grafikeffekt.

QRectF QGraphicsEffect::boundingRect() const

Gibt das effektive Begrenzungsrechteck für diesen Effekt zurück, d. h. das Begrenzungsrechteck der Quelle in Gerätekoordinaten, angepasst um alle vom Effekt selbst angewendeten Ränder.

Siehe auch boundingRectFor() und updateBoundingRect().

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

Gibt das effektive Begrenzungsrechteck für diesen Effekt zurück, unter Berücksichtigung der angegebenen rect in den Gerätekoordinaten. Wenn Sie Ihren eigenen benutzerdefinierten Effekt schreiben, müssen Sie updateBoundingRect() immer dann aufrufen, wenn Parameter geändert werden, die dazu führen könnten, dass diese Funktion einen anderen Wert zurückgibt.

Siehe auch sourceBoundingRect().

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

Diese rein virtuelle Funktion zeichnet den Effekt und wird immer dann aufgerufen, wenn die Quelle gezeichnet werden muss.

Reimplementieren Sie diese Funktion in einer QGraphicsEffect Unterklasse, um die Zeichnungsimplementierung des Effekts bereitzustellen, indem Sie painter verwenden.

Ein Beispiel:

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);
    }
    ...
}

Diese Funktion sollte nicht explizit vom Benutzer aufgerufen werden, da sie nur für Reimplementierungszwecke gedacht ist.

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

Zeichnet die Quelle direkt unter Verwendung der angegebenen painter.

Diese Funktion sollte nur von QGraphicsEffect::draw() aus aufgerufen werden.

Ein Beispiel:

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

Siehe auch QGraphicsEffect::draw().

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

Dieses Signal wird ausgegeben, wenn der Effekt aktiviert oder deaktiviert wird. Der Parameter enabled enthält den neuen Aktivierungsstatus des Effekts.

Siehe auch isEnabled().

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

Gibt das Begrenzungsrechteck der Quelle zurück, die dem angegebenen system zugeordnet ist.

Der Aufruf dieser Funktion mit Qt::DeviceCoordinates außerhalb von QGraphicsEffect::draw() führt zu undefinierten Ergebnissen, da kein Gerätekontext verfügbar ist.

Siehe auch draw().

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

Diese virtuelle Funktion wird von QGraphicsEffect aufgerufen, um dem Effekt mitzuteilen, dass sich die Quelle geändert hat. Wenn der Effekt einen Cache anwendet, muss dieser Cache geleert werden, um das neue Aussehen der Quelle wiederzugeben.

Die flags beschreibt, was sich geändert hat.

[protected] bool QGraphicsEffect::sourceIsPixmap() const

Gibt true zurück, wenn die Quelle tatsächlich eine Pixmap ist, z. B. QGraphicsPixmapItem.

Diese Funktion ist für Optimierungszwecke nützlich. Es macht zum Beispiel keinen Sinn, die Quelle in Gerätekoordinaten zu zeichnen, um die Skalierung der Pixmap zu vermeiden, wenn diese Funktion true zurückgibt - die Quell-Pixmap wird ohnehin skaliert.

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

Gibt eine Pixmap zurück, in die die Quelle eingezeichnet ist.

Der Parameter system gibt an, welches Koordinatensystem für die Quelle verwendet werden soll. Der optionale Parameter offset gibt den Offset zurück, an dem die Pixmap unter Verwendung des aktuellen Painters gezeichnet werden soll. Mit dem Parameter mode wird festgelegt, wie die Pixmap aufgefüllt wird.

Die zurückgegebene Pixmap wird auf das Geräterechteck des aktuellen Painters beschnitten, wenn system gleich Qt::DeviceCoordinates ist.

Der Aufruf dieser Funktion mit Qt::DeviceCoordinates außerhalb von QGraphicsEffect::draw() führt zu undefinierten Ergebnissen, da kein Gerätekontext verfügbar ist.

Siehe auch draw() und boundingRect().

[slot] void QGraphicsEffect::update()

Plant ein erneutes Zeichnen des Effekts. Rufen Sie diese Funktion immer dann auf, wenn der Effekt neu gezeichnet werden muss. Diese Funktion löst kein erneutes Zeichnen der Quelle aus.

Siehe auch updateBoundingRect().

[protected] void QGraphicsEffect::updateBoundingRect()

Diese Funktion benachrichtigt das Effekt-Framework, wenn sich das Begrenzungsrechteck des Effekts geändert hat. Als Autor eines benutzerdefinierten Effekts müssen Sie diese Funktion immer dann aufrufen, wenn Sie einen Parameter ändern, der dazu führt, dass die virtuelle Funktion boundingRectFor() einen anderen Wert zurückgibt.

Diese Funktion ruft update() auf, wenn dies notwendig ist.

Siehe auch boundingRectFor(), boundingRect(), und sourceBoundingRect().