QSvgWidget Class
La classe QSvgWidget fournit un widget permettant d'afficher le contenu des fichiers SVG (Scalable Vector Graphics). En savoir plus...
| En-tête : | #include <qsvgwidget.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS SvgWidgets) target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets) |
| qmake : | QT += svgwidgets |
| Hérite de : | QWidget |
- Liste de tous les membres, y compris les membres hérités
- QSvgWidget fait partie des classes de peinture.
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 |
Slots publics
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 aux côtés de widgets standard, et s’utilise de la même manière que la classe ` QLabel ` pour l’affichage de texte et d’images bitmap.
Comme QSvgWidget est une sous-classe de QWidget, les dessins SVG sont rendus à l’aide des propriétés de l’affichage. La classe QSvgRenderer permet d’exercer un contrôle accru sur le processus de rendu, car elle peut être utilisée pour dessiner sur d’autres périphériques de dessin, 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 instancié à partir du nom d’un fichier SVG, ou sans fichier spécifique à afficher, auquel cas un fichier pourra être fourni ultérieurement. Les fonctions load() offrent deux méthodes différentes pour charger un fichier SVG : elles acceptent soit le nom d’un fichier SVG, soit un objet QByteArray contenant la représentation XML sérialisée d’un fichier SVG.
Par défaut, le widget fournit une indication de taille correspondant à celle du dessin qu’il affiche. Si aucune donnée n’a été chargée, le widget fournit l’indication de taille par défaut de QWidget. Sous-classez cette classe et réimplémentez la méthode sizeHint() si vous souhaitez personnaliser ce comportement.
Voir également ` QSvgRenderer`, Qt SVG C++ Classeset ` QPicture`.
Documentation des fonctions membres
QSvgWidget::QSvgWidget(QWidget *parent = nullptr)
Crée un nouveau widget d'affichage SVG avec l'parent on fournie.
QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)
Crée un nouveau widget d'affichage SVG avec l'parent on fournie et charge le contenu de l'file spécifiée.
[virtual noexcept] QSvgWidget::~QSvgWidget()
Supprime le widget.
[slot] void QSvgWidget::load(const QByteArray &contents)
Charge l'contents au format SVG spécifiée et met à jour le widget.
Remarque : ce slot est surchargé. Pour vous 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); }); [slot] void QSvgWidget::load(const QString &file)
Charge le contenu de l'file SVG spécifiée et met à jour le widget.
Remarque : ce slot est surchargé. Pour vous 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); }); [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 sur « options ».
Cette propriété contient un ensemble d'indicateurs d'QtSvg::Option qui permettent d'activer ou de désactiver diverses fonctionnalités liées à l'analyse et au rendu des fichiers SVG. Elle doit être définie avant l'appel de la fonction load pour que ses effets soient pris en compte.
Par défaut, aucun indicateur n’est activé.
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 pour 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.
