QSvgWidget Class
La clase QSvgWidget proporciona un widget que se utiliza para mostrar el contenido de archivos SVG (Scalable Vector Graphics). Más información...
| Encabezado: | #include <qsvgwidget.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SvgWidgets) target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets) |
| qmake: | QT += svgwidgets |
| Heredado de: | QWidget |
- Lista de todos los miembros, incluidos los heredados
- QSvgWidget forma parte de las clases de pintura.
Funciones públicas
| 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) |
Funciones públicas reimplementadas
| virtual QSize | sizeHint() const override |
Ranuras públicas
Funciones protegidas reimplementadas
| virtual void | paintEvent(QPaintEvent *event) override |
Descripción detallada
Esta clase permite a los desarrolladores mostrar dibujos SVG junto con los widgets estándar, y se utiliza de forma muy similar a como se utiliza ` QLabel ` para mostrar texto e imágenes de mapa de bits.
Dado que `QSvgWidget` es una subclase de ` QWidget`, los dibujos SVG se representan utilizando las propiedades de la pantalla. Se puede ejercer un mayor control sobre el proceso de representación con la clase ` QSvgRenderer `, ya que esta se puede utilizar para dibujar en otros dispositivos de dibujo, como ` QImage ` y `QGLWidget`. El renderizador utilizado por el widget se puede obtener con la función ` renderer()`.
Cada QSvgWidget puede crearse con el nombre de un archivo SVG, o bien sin un archivo específico que renderizar, en cuyo caso se puede proporcionar uno más adelante. Las funciones ` load()` ofrecen dos formas diferentes de cargar un archivo SVG: aceptan bien el nombre de un archivo SVG, bien un objeto ` QByteArray ` que contenga la representación XML serializada de un archivo SVG.
Por defecto, el widget proporciona una indicación de tamaño que refleja el tamaño del dibujo que muestra. Si no se han cargado datos, el widget proporciona la indicación de tamaño predeterminada de ` QWidget `. Subclasifica esta clase y reimplementa ` sizeHint()` si necesitas personalizar este comportamiento.
Véase también ` QSvgRenderer`, Qt SVG C++ Classesy QPicture.
Documentación de las funciones miembro
QSvgWidget::QSvgWidget(QWidget *parent = nullptr)
Crea un nuevo widget de visualización SVG con el archivo « parent » especificado.
QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)
Crea un nuevo widget de visualización SVG con el ` parent ` proporcionado y carga el contenido de la ` file` especificada.
[virtual noexcept] QSvgWidget::~QSvgWidget()
Elimina el widget.
[slot] void QSvgWidget::load(const QByteArray &contents)
Carga el archivo en formato SVG especificado contents y actualiza el widget.
Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:
// 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)
Carga el contenido del archivo SVG especificado file y actualiza el widget.
Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:
// 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
Devuelve las opciones del renderizador del widget.
Esta función se introdujo en Qt 6.7.
Véase también setOptions.
[override virtual protected] void QSvgWidget::paintEvent(QPaintEvent *event)
Reimplementa: ` QWidget::paintEvent` (`QPaintEvent *event)`.
QSvgRenderer *QSvgWidget::renderer() const
Devuelve el renderizador utilizado para mostrar el contenido del widget.
[since 6.7] void QSvgWidget::setOptions(QtSvg::Options options)
Establece las opciones del renderizador del widget en « options ».
Esta propiedad contiene un conjunto de indicadores de « QtSvg::Option » que pueden utilizarse para activar o desactivar diversas funciones relacionadas con el análisis y la representación de archivos SVG. Debe configurarse antes de llamar a la función «load» para que surta efecto.
Por defecto, no hay ningún indicador activado.
Esta función se introdujo en Qt 6.7.
Véase también options.
[override virtual] QSize QSvgWidget::sizeHint() const
Reimplementa una función de acceso para la propiedad: 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.