QSvgRenderer Class

Fonction membre Documentation

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

Construit un nouveau moteur de rendu avec l'adresse parent.

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

Construit un nouveau moteur de rendu avec l'adresse parent et charge les données SVG à l'aide du lecteur de flux spécifié par contents.

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

Construit un nouveau moteur de rendu avec l'adresse parent et charge les données SVG à partir du tableau d'octets spécifié par contents.

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

Construit un nouveau moteur de rendu avec l'adresse parent donnée et charge le contenu du fichier SVG avec l'adresse filename spécifiée.

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

Détruit le moteur de rendu.

bool QSvgRenderer::animated() const

Retourne true si le document actuel contient des éléments animés, sinon retourne false.

Voir également framesPerSecond().

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

Renvoie le rectangle de délimitation de l'élément avec l'adresse id. La matrice de transformation des éléments parents n'affecte pas les limites de l'élément.

Voir aussi transformForElement().

QSize QSvgRenderer::defaultSize() const

Renvoie la taille par défaut du contenu du document.

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

Renvoie un résultat positif si l'élément portant l'adresse id existe dans le fichier SVG actuellement analysé et s'il s'agit d'un élément pouvant être rendu.

Remarque : cette méthode ne renvoie un résultat positif que pour les éléments qui peuvent être rendus. Cela signifie que les éléments considérés comme faisant partie des propriétés de style fill/stroke, par exemple radialGradients, même s'ils sont marqués par des attributs "id", ne seront pas trouvés par cette méthode.

bool QSvgRenderer::isValid() const

Retourne true s'il existe un document courant valide, sinon retourne false.

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

Charge le SVG spécifié dans contents, en renvoyant true si le contenu a été analysé avec succès ; sinon, il renvoie false.

Le lecteur sera utilisé à partir de l'endroit où il est actuellement positionné. Si contents est null, le comportement est indéfini.

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

Charge le format SVG spécifié contents, en renvoyant true si le contenu a été analysé avec succès ; sinon, il renvoie false.

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

Charge le fichier SVG spécifié par filename, en renvoyant true si le contenu a été analysé avec succès, sinon en renvoyant false.

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

Rend le document actuel, ou l'image actuelle d'un document animé, en utilisant l'adresse 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)

Effectue le rendu du document actuel, ou de l'image actuelle d'un document animé, en utilisant l'adresse painter sur l'adresse bounds spécifiée à l'intérieur du peintre. Si bounds n'est pas vide, la sortie sera mise à l'échelle pour le remplir, en ignorant tout rapport d'aspect impliqué par le SVG.

// 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())

Rend l'élément donné avec elementId en utilisant painter sur bounds. Si le rectangle de délimitation n'est pas spécifié, l'élément SVG est représenté sur l'ensemble du dispositif de peinture.

// 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()

Ce signal est émis lorsque le rendu du document doit être mis à jour, généralement à des fins d'animation.

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

Définit les drapeaux d'option avec lesquels les moteurs de rendu seront créés à flags. Par défaut, aucun drapeau n'est défini.

Au moment de l'exécution, cela peut être remplacé par la variable d'environnement QT_SVG_DEFAULT_OPTIONS.

Cette fonction a été introduite dans Qt 6.8.

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

Renvoie la matrice de transformation de l'élément avec l'adresse id. La matrice est un produit de la transformation des parents de l'élément. La transformation de l'élément lui-même n'est pas incluse.

Pour trouver le rectangle de délimitation de l'élément en coordonnées logiques, vous pouvez appliquer la matrice au rectangle renvoyé par boundsOnElement().

Voir aussi boundsOnElement().

QRect QSvgRenderer::viewBox() const

Renvoie viewBoxF().toRect().

Voir aussi setViewBox() et viewBoxF().