QSvgRenderer Class

Dokumentation zu den Mitgliedsfunktionen

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

Erstellt einen neuen Renderer mit dem angegebenen „ parent “.

QSvgRenderer::QSvgRenderer(QXmlStreamReader *contents, QObject *parent = nullptr)

Erstellt einen neuen Renderer mit dem angegebenen ` parent ` und lädt die SVG-Daten mithilfe des durch ` contents` angegebenen Stream-Readers.

QSvgRenderer::QSvgRenderer(const QByteArray &contents, QObject *parent = nullptr)

Erstellt einen neuen Renderer mit dem angegebenen ` parent ` und lädt die SVG-Daten aus dem durch ` contents` angegebenen Byte-Array.

QSvgRenderer::QSvgRenderer(const QString &filename, QObject *parent = nullptr)

Erstellt einen neuen Renderer mit dem angegebenen „ parent “ und lädt den Inhalt der SVG-Datei mit dem angegebenen „ filename “.

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

Löscht den Renderer.

bool QSvgRenderer::animated() const

Gibt „true“ zurück, wenn das aktuelle Dokument animierte Elemente enthält; andernfalls gibt es „false“ zurück.

Siehe auch framesPerSecond().

QRectF QSvgRenderer::boundsOnElement(const QString &id) const

Gibt das Begrenzungsrechteck des Elements mit der angegebenen „ id “ zurück. Die Transformationsmatrix der übergeordneten Elemente hat keinen Einfluss auf die Begrenzungen des Elements.

Siehe auch ` transformForElement()`.

QSize QSvgRenderer::defaultSize() const

Gibt die Standardgröße des Dokumentinhalts zurück.

bool QSvgRenderer::elementExists(const QString &id) const

Gibt „true“ zurück, wenn das Element mit dem angegebenen „ id “ in der aktuell geparsten SVG-Datei vorhanden ist und ein darstellbares Element ist.

Hinweis: Diese Methode gibt nur für Elemente „true“ zurück, die gerendert werden können. Das bedeutet, dass Elemente, die als Teil der Füll- und Konturstil-Eigenschaften gelten, z. B. „radialGradients“, selbst wenn sie mit „id“-Attributen gekennzeichnet sind, von dieser Methode nicht gefunden werden.

bool QSvgRenderer::isValid() const

Gibt „true“ zurück, wenn ein gültiges aktuelles Dokument vorhanden ist; andernfalls wird „false“ zurückgegeben.

[slot] bool QSvgRenderer::load(QXmlStreamReader *contents)

Lädt die angegebene SVG-Datei unter contents und gibt „true“ zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls wird „false“ zurückgegeben.

Der Reader wird ab der aktuellen Position verwendet. Wenn contents gleich null ist, ist das Verhalten undefiniert.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QXmlStreamReader *contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QByteArray &contents)

Lädt das angegebene SVG-Format contents und gibt „true“ zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls wird „false“ zurückgegeben.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QByteArray &contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QString &filename)

Lädt die durch ` filename` angegebene SVG-Datei und gibt `true` zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls wird `false` zurückgegeben.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QString &filename) { receiver->load(filename); });

[slot] void QSvgRenderer::render(QPainter *painter)

Rendert das aktuelle Dokument oder den aktuellen Frame eines animierten Dokuments unter Verwendung der angegebenen ` painter`.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter) { receiver->render(painter); });

[slot] void QSvgRenderer::render(QPainter *painter, const QRectF &bounds)

Rendert das aktuelle Dokument oder den aktuellen Frame eines animierten Dokuments unter Verwendung des angegebenen „ painter “ auf dem angegebenen „ bounds “ innerhalb des Painters. Ist „ bounds “ nicht leer, wird die Ausgabe so skaliert, dass sie diesen Bereich ausfüllt, wobei das durch das SVG vorgegebene Seitenverhältnis ignoriert wird.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QRectF &bounds) { receiver->render(painter, bounds); });

[slot] void QSvgRenderer::render(QPainter *painter, const QString &elementId, const QRectF &bounds = QRectF())

Rendert das angegebene Element mit „ elementId “ unter Verwendung des angegebenen „ painter “ auf dem angegebenen „ bounds “. Wenn kein Begrenzungsrechteck angegeben ist, wird das SVG-Element auf das gesamte Zeichen-Device abgebildet.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QString &elementId, const QRectF &bounds) { receiver->render(painter, elementId, bounds); });

[signal] void QSvgRenderer::repaintNeeded()

Dieses Signal wird immer dann ausgelöst, wenn die Darstellung des Dokuments aktualisiert werden muss, in der Regel für Animationszwecke.

[static, since 6.8] void QSvgRenderer::setDefaultOptions(QtSvg::Options flags)

Setzt die Optionsflags, mit denen Renderer erstellt werden, auf „ flags “. Standardmäßig sind keine Flags gesetzt.

Zur Laufzeit kann dies durch die Umgebungsvariable `QT_SVG_DEFAULT_OPTIONS` überschrieben werden.

Diese Funktion wurde in Qt 6.8 eingeführt.

QTransform QSvgRenderer::transformForElement(const QString &id) const

Gibt die Transformationsmatrix für das Element mit dem angegebenen id zurück. Die Matrix ist das Produkt der Transformationen der übergeordneten Elemente. Die Transformation des Elements selbst ist nicht enthalten.

Um das Begrenzungsrechteck des Elements in logischen Koordinaten zu ermitteln, können Sie die Matrix auf das von ` boundsOnElement()` zurückgegebene Rechteck anwenden.

Siehe auch ` boundsOnElement()`.

QRect QSvgRenderer::viewBox() const

Gibt ` viewBoxF().toRect()` zurück.

Siehe auch „ setViewBox()“ und „ viewBoxF()“.