QSvgWidget Class
La clase QSvgWidget proporciona un widget que se utiliza para mostrar el contenido de los archivos Scalable Vector Graphics (SVG). Más...
| Cabecera: | #include <QSvgWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SvgWidgets)target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets) |
| qmake: | QT += svgwidgets |
| Hereda: | QWidget |
- Lista de todos los miembros, incluyendo los heredados
- QSvgWidget es parte de 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 widgets estándar, y se utiliza de forma muy parecida 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 renderizado con la clase QSvgRenderer, ya que ésta se puede utilizar para pintar sobre otros dispositivos de pintura, como QImage y QGLWidget. El renderizador utilizado por el widget puede obtenerse con la función renderer().
Cada QSvgWidget puede ser construido con el nombre de un archivo SVG, o pueden ser construidos sin un archivo específico para renderizar y uno puede ser suministrado más tarde. Las funciones load() proporcionan dos formas diferentes de cargar un archivo SVG: aceptan el nombre de archivo de un archivo SVG o un QByteArray que contiene la representación XML serializada de un archivo SVG.
Por defecto, el widget proporciona una sugerencia de tamaño para reflejar el tamaño del dibujo que muestra. Si no se han cargado datos, el widget proporciona la sugerencia de tamaño predeterminada QWidget. Subclase esta clase y reimplemente sizeHint() si necesita 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 la dirección parent.
QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)
Crea un nuevo widget de visualización SVG con la dirección parent y carga el contenido de la dirección file especificada.
[virtual noexcept] QSvgWidget::~QSvgWidget()
Destruye el widget.
[slot] void QSvgWidget::load(const QByteArray &contents)
Carga el 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 SVG file especificado 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 de renderizado del widget en options.
Esta propiedad contiene un conjunto de banderas QtSvg::Option que se pueden utilizar para activar o desactivar varias características del análisis sintáctico y el renderizado de archivos SVG. Para que tenga efecto, debe establecerse antes de llamar a la función de carga.
Por defecto, no se establece ninguna bandera.
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.
