Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QSvgWidget Class

La classe QSvgWidget fournit un widget utilisé pour afficher le contenu des fichiers SVG (Scalable Vector Graphics). Plus d'informations...

En-tête : #include <QSvgWidget>
CMake : find_package(Qt6 REQUIRED COMPONENTS SvgWidgets)
target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets)
qmake : QT += svgwidgets
Héritages : QWidget

Fonctions publiques

QSvgWidget(QWidget *parent = nullptr)
QSvgWidget(const QString &file, QWidget *parent = nullptr)
virtual ~QSvgWidget()
(since 6.7) QtSvg::Options options() const
QSvgRenderer *renderer() const
(since 6.7) void setOptions(QtSvg::Options options)

Fonctions publiques réimplémentées

virtual QSize sizeHint() const override

Emplacements publics

void load(const QByteArray &contents)
void load(const QString &file)

Fonctions protégées réimplémentées

virtual void paintEvent(QPaintEvent *event) override

Description détaillée

Cette classe permet aux développeurs d'afficher des dessins SVG à côté des widgets standard, et est utilisée de la même manière que QLabel pour afficher du texte et des images bitmap.

Comme QSvgWidget est une sous-classe de QWidget, les dessins SVG sont rendus en utilisant les propriétés de l'affichage. La classe QSvgRenderer permet d'exercer un plus grand contrôle sur le processus de rendu, car elle peut être utilisée pour peindre sur d'autres dispositifs de peinture, tels que QImage et QGLWidget. Le moteur de rendu utilisé par le widget peut être obtenu à l'aide de la fonction renderer().

Chaque QSvgWidget peut être construit avec le nom d'un fichier SVG ou sans fichier spécifique à rendre et un fichier peut être fourni plus tard. Les fonctions load() permettent de charger un fichier SVG de deux manières différentes : elles acceptent soit le nom de fichier d'un fichier SVG, soit une adresse QByteArray contenant la représentation XML sérialisée d'un fichier SVG.

Par défaut, le widget fournit un indice de taille pour refléter la taille du dessin qu'il affiche. Si aucune donnée n'a été chargée, le widget fournit l'indice de taille par défaut QWidget. Sous-classez cette classe et réimplémentez sizeHint() si vous avez besoin de personnaliser ce comportement.

Voir également QSvgRenderer, Qt SVG C++ Classes, et QPicture.

Documentation des fonctions membres

QSvgWidget::QSvgWidget(QWidget *parent = nullptr)

Construit un nouveau widget d'affichage SVG avec l'adresse parent.

QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)

Construit un nouveau widget d'affichage SVG avec l'adresse parent donnée et charge le contenu de l'adresse file spécifiée.

[virtual noexcept] QSvgWidget::~QSvgWidget()

Détruit le widget.

[slot] void QSvgWidget::load(const QByteArray &contents)

Charge le format SVG spécifié contents et met à jour le widget.

Note : Ce slot est surchargé. Pour se connecter à ce slot :

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgWidget, qOverload(&QSvgWidget::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgWidget, [receiver = svgWidget](const QByteArray &contents) { receiver->load(contents); });
Pour plus d'exemples et d'approches, voir se connecter aux slots surchargés.

[slot] void QSvgWidget::load(const QString &file)

Charge le contenu du SVG spécifié file et met à jour le widget.

Note : Ce slot est surchargé. Pour se connecter à ce slot :

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgWidget, qOverload(&QSvgWidget::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgWidget, [receiver = svgWidget](const QString &file) { receiver->load(file); });
Pour plus d'exemples et d'approches, voir se connecter aux slots surchargés.

[since 6.7] QtSvg::Options QSvgWidget::options() const

Renvoie les options du moteur de rendu du widget.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi setOptions.

[override virtual protected] void QSvgWidget::paintEvent(QPaintEvent *event)

Réimplémente : QWidget::paintEvent(QPaintEvent *event).

QSvgRenderer *QSvgWidget::renderer() const

Renvoie le moteur de rendu utilisé pour afficher le contenu du widget.

[since 6.7] void QSvgWidget::setOptions(QtSvg::Options options)

Définit les options de rendu du widget à options.

Cette propriété contient un ensemble de drapeaux QtSvg::Option qui peuvent être utilisés pour activer ou désactiver diverses fonctionnalités de l'analyse et du rendu des fichiers SVG. Elle doit être définie avant d'appeler la fonction de chargement pour avoir un effet.

Par défaut, aucun drapeau n'est défini.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi options.

[override virtual] QSize QSvgWidget::sizeHint() const

Réimplémente une fonction d'accès à la propriété : QWidget::sizeHint.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.