QSvgRenderer Class

Documentación de funciones miembro

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

Crea un nuevo renderizador con la dirección parent.

QSvgRenderer::QSvgRenderer(QXmlStreamReader *contents, QObject *parent = nullptr)

Construye un nuevo renderizador con la dirección parent y carga los datos SVG utilizando el lector de flujo especificado por contents.

QSvgRenderer::QSvgRenderer(const QByteArray &contents, QObject *parent = nullptr)

Crea un nuevo renderizador con la dirección parent y carga los datos SVG desde la matriz de bytes especificada en contents.

QSvgRenderer::QSvgRenderer(const QString &filename, QObject *parent = nullptr)

Construye un nuevo renderizador con la dirección parent y carga el contenido del archivo SVG con la dirección filename especificada.

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

Destruye el renderizador.

bool QSvgRenderer::animated() const

Devuelve true si el documento actual contiene elementos animados; en caso contrario devuelve false.

Véase también framesPerSecond().

QRectF QSvgRenderer::boundsOnElement(const QString &id) const

Devuelve el rectángulo delimitador del elemento con la dirección id. La matriz de transformación de los elementos padre no afecta a los límites del elemento.

Véase también transformForElement().

QSize QSvgRenderer::defaultSize() const

Devuelve el tamaño por defecto del contenido del documento.

bool QSvgRenderer::elementExists(const QString &id) const

Devuelve true si el elemento con el id dado existe en el archivo SVG actualmente analizado y es un elemento renderizable.

Nota: este método devuelve true sólo para elementos que pueden ser renderizados. Lo que implica que los elementos que se consideran parte de las propiedades de estilo de relleno/trazo, por ejemplo, radialGradients aunque estén marcados con atributos "id" no serán encontrados por este método.

bool QSvgRenderer::isValid() const

Devuelve true si hay un documento actual válido; en caso contrario devuelve false.

[slot] bool QSvgRenderer::load(QXmlStreamReader *contents)

Carga el SVG especificado en contents, devolviendo true si el contenido se ha analizado correctamente; en caso contrario devuelve false.

Se utilizará el lector desde donde esté posicionado actualmente. Si contents es null, el comportamiento es indefinido.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QXmlStreamReader *contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QByteArray &contents)

Carga el formato SVG especificado contents, devolviendo true si el contenido se ha analizado correctamente; en caso contrario devuelve false.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QByteArray &contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QString &filename)

Carga el archivo SVG especificado por filename, devolviendo true si el contenido se ha analizado correctamente; en caso contrario devuelve false.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QString &filename) { receiver->load(filename); });

[slot] void QSvgRenderer::render(QPainter *painter)

Renderiza el documento actual, o el fotograma actual de un documento animado, utilizando la dirección painter.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter) { receiver->render(painter); });

[slot] void QSvgRenderer::render(QPainter *painter, const QRectF &bounds)

Renderiza el documento actual, o el fotograma actual de un documento animado, utilizando el painter dado en el bounds especificado dentro del pintor. Si bounds no está vacío, la salida se escalará para llenarlo, ignorando cualquier relación de aspecto implícita en el SVG.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QRectF &bounds) { receiver->render(painter, bounds); });

[slot] void QSvgRenderer::render(QPainter *painter, const QString &elementId, const QRectF &bounds = QRectF())

Renderiza el elemento dado con elementId utilizando el painter dado en el bounds especificado. Si no se especifica el rectángulo delimitador, el elemento SVG se asigna a todo el dispositivo de pintura.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QString &elementId, const QRectF &bounds) { receiver->render(painter, elementId, bounds); });

[signal] void QSvgRenderer::repaintNeeded()

Esta señal se emite cada vez que es necesario actualizar la representación del documento, normalmente con fines de animación.

[static, since 6.8] void QSvgRenderer::setDefaultOptions(QtSvg::Options flags)

Establece las opciones con las que se crearán los renderizadores en flags. Por defecto, no se establece ninguna opción.

En tiempo de ejecución, esto puede ser anulado por la variable de entorno QT_SVG_DEFAULT_OPTIONS.

Esta función se introdujo en Qt 6.8.

QTransform QSvgRenderer::transformForElement(const QString &id) const

Devuelve la matriz de transformación del elemento con la dirección id. La matriz es un producto de la transformación de los padres del elemento. No se incluye la transformación del propio elemento.

Para encontrar el rectángulo que delimita el elemento en coordenadas lógicas, puede aplicar la matriz al rectángulo devuelto por boundsOnElement().

Véase también boundsOnElement().

QRect QSvgRenderer::viewBox() const

Devuelve viewBoxF().toRect().

Véase también setViewBox() y viewBoxF().