En esta página

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

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

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

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); });
Para ver más ejemplos y métodos, consulta «Conexión a ranuras sobrecargadas».

[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); });
Para ver más ejemplos y métodos, consulta la sección sobre cómo conectarse a ranuras sobrecargadas.

[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.