QSvgRenderer Class

Dokumentation der Mitgliedsfunktionen

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

Konstruiert einen neuen Renderer mit dem angegebenen parent.

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

Konstruiert einen neuen Renderer mit dem angegebenen parent und lädt die SVG-Daten mit dem durch contents angegebenen Stream-Reader.

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

Konstruiert 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)

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

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

Zerstört den Renderer.

bool QSvgRenderer::animated() const

Gibt true zurück, wenn das aktuelle Dokument animierte Elemente enthält; andernfalls wird false zurückgegeben.

Siehe auch framesPerSecond().

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

Liefert das Begrenzungsrechteck des Elements mit der angegebenen id. Die Transformationsmatrix der übergeordneten Elemente wirkt sich nicht auf die Begrenzungen des Elements aus.

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 der angegebenen id in der aktuell geparsten SVG-Datei existiert und ein renderbares Element ist.

Hinweis: Diese Methode liefert true nur für Elemente, die gerendert werden können. Das bedeutet, dass Elemente, die als Teil der Fill/Stroke-Stil-Eigenschaften betrachtet werden, z. B. radialGradients, auch wenn sie mit "id"-Attributen gekennzeichnet sind, von dieser Methode nicht gefunden werden.

bool QSvgRenderer::isValid() const

Gibt true zurück, wenn es ein gültiges aktuelles Dokument gibt; andernfalls wird false zurückgegeben.

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

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

Der Reader wird an der Stelle verwendet, an der er sich gerade befindet. Wenn contents null ist, ist das Verhalten undefiniert.

[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.

[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.

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

Rendert das aktuelle Dokument oder das aktuelle Bild eines animierten Dokuments unter Verwendung der angegebenen painter.

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

Rendert das aktuelle Dokument oder den aktuellen Frame eines animierten Dokuments unter Verwendung der angegebenen painter auf der angegebenen bounds im Painter. Wenn bounds nicht leer ist, wird die Ausgabe so skaliert, dass sie den Bereich ausfüllt, wobei ein vom SVG impliziertes Seitenverhältnis ignoriert wird.

[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 das Begrenzungsrechteck nicht angegeben wird, wird das SVG-Element auf das gesamte Malgerät abgebildet.

[signal] void QSvgRenderer::repaintNeeded()

Dieses Signal wird immer dann ausgegeben, wenn das Rendering 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 die 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 der angegebenen id zurück. Die Matrix ist ein Produkt aus den Transformationen der Eltern des Elements. Die Transformation des Elements selbst ist nicht enthalten.

Um das begrenzende Rechteck des Elements in logischen Koordinaten zu finden, 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().