QSvgRenderer Class

Documentation sur les fonctions membres

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

Crée un nouveau moteur de rendu avec l'parent spécifiée.

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

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

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

Crée un nouveau moteur de rendu avec l'parent, puis charge les données SVG à partir du tableau d'octets spécifié par contents.

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

Crée un nouveau moteur de rendu avec l'parent fourni et charge le contenu du fichier SVG dont l'filename est spécifiée.

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

Détruit le moteur de rendu.

bool QSvgRenderer::animated() const

Renvoie « true » si le document actuel contient des éléments animés ; sinon, renvoie « false ».

Voir aussi framesPerSecond().

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

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

Voir également transformForElement().

QSize QSvgRenderer::defaultSize() const

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

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

Renvoie « true » si l'élément portant l'id on indiquée existe dans le fichier SVG en cours d'analyse et s'il s'agit d'un élément pouvant être affiché.

Remarque : cette méthode ne renvoie « true » que pour les éléments pouvant être affichés. Cela implique que les éléments considérés comme faisant partie des propriétés de style de remplissage/contour, par exemple les radialGradients, ne seront pas détectés par cette méthode, même s'ils sont marqués par des attributs « id ».

bool QSvgRenderer::isValid() const

Renvoie « true » s'il existe un document courant valide ; sinon, renvoie « false ».

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

Charge le fichier SVG spécifié à l'adresse contents et renvoie « true » si le contenu a été analysé avec succès ; sinon, renvoie « false ».

Le lecteur sera utilisé à partir de sa position actuelle. 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 l'contents au format SVG spécifié et renvoie « true » si le contenu a été analysé avec succès ; sinon, 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 et renvoie « true » si le contenu a été analysé avec succès ; sinon, 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 QString &filename) { receiver->load(filename); });

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

Affiche le document actuel, ou l'image actuelle d'un document animé, à l'aide de l'painter indiquée.

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

Affiche le document actuel, ou l'image actuelle d'un document animé, en utilisant l'painter fournie sur l'bounds spécifiée au sein du « painter ». Si bounds n'est pas vide, la sortie sera redimensionnée pour le remplir, en ignorant tout rapport d'aspect implicite du 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())

Affiche l'élément donné avec l'elementId en utilisant l'painter fournie sur l'bounds spécifiée. Si le rectangle de délimitation n'est pas spécifié, l'élément SVG est mappé sur l'ensemble du périphérique de dessin.

// 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 chaque fois que l'affichage du document doit être mis à jour, généralement dans le cadre d'une animation.

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

Définit les indicateurs d'options avec lesquels les moteurs de rendu seront créés sur « flags ». Par défaut, aucun indicateur n'est défini.

Au moment de l'exécution, cette valeur peut être remplacée 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 dont l'id est spécifiée. Cette matrice est le produit des transformations des éléments parents de l'élément. La transformation de l'élément lui-même n'est pas incluse.

Pour déterminer le rectangle englobant de l’élément en coordonnées logiques, vous pouvez appliquer la matrice au rectangle renvoyé par la fonction boundsOnElement().

Voir également boundsOnElement().

QRect QSvgRenderer::viewBox() const

Renvoie viewBoxF().toRect().

Voir également setViewBox() et viewBoxF().