QTextImageFormat Class

La clase QTextImageFormat proporciona información sobre el formato de las imágenes en QTextDocument. Más...

Cabecera:	`#include <QTextImageFormat>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake:	`QT += gui`
Hereda:	QTextCharFormat

Lista de todos los miembros, incluyendo los heredados
QTextImageFormat es parte de APIs de Procesamiento de Texto Enriquecido y Clases Implícitamente Compartidas.

Nota: Todas las funciones de esta clase son reentrantes.

Funciones Públicas

	QTextImageFormat()
qreal	height() const
bool	isValid() const
QTextLength	maximumWidth() const
QString	name() const
int	quality() const
void	setHeight(qreal height)
void	setMaximumWidth(QTextLength maximumWidth)
void	setName(const QString &name)
void	setQuality(int quality = 100)
void	setWidth(qreal width)
qreal	width() const

Descripción Detallada

Las imágenes en línea se representan mediante un valor Unicode U+FFFC (OBJECT REPLACEMENT CHARACTER) que tiene asociado un QTextImageFormat. El formato de imagen especifica un nombre con setName() que se utiliza para localizar la imagen. El tamaño del rectángulo que ocupará la imagen se especifica en píxeles mediante setWidth() y setHeight(). La calidad deseada de la imagen puede establecerse con setQuality().

Las imágenes pueden suministrarse en cualquier formato para el que Qt disponga de un lector de imágenes, por lo que los dibujos SVG pueden incluirse junto a PNG, TIFF y otros formatos de mapa de bits.

Véase también QImage y QImageReader.

Documentación de las funciones miembro

QTextImageFormat::QTextImageFormat()

Crea un nuevo objeto de formato de imagen.

qreal QTextImageFormat::height() const

Devuelve la altura del rectángulo ocupado por la imagen.

Véase también width() y setHeight().

bool QTextImageFormat::isValid() const

Devuelve true si este formato de imagen es válido; en caso contrario devuelve false.

QTextLength QTextImageFormat::maximumWidth() const

Devuelve la anchura máxima del rectángulo ocupado por la imagen.

Véase también width() y setMaximumWidth().

QString QTextImageFormat::name() const

Devuelve el nombre de la imagen. El nombre se refiere a una entrada en el archivo de recursos de la aplicación.

Véase también setName().

int QTextImageFormat::quality() const

Devuelve el valor establecido por setQuality().

Véase también setQuality().

void QTextImageFormat::setHeight(qreal height)

Establece el height del rectángulo ocupado por la imagen.

Véase también height() y setWidth().

void QTextImageFormat::setMaximumWidth(QTextLength maximumWidth)

Establece el maximumWidth del rectángulo ocupado por la imagen. Puede ser un número absoluto o un porcentaje del tamaño disponible del documento.

Véase también maximumWidth(), width() y setHeight().

void QTextImageFormat::setName(const QString &name)

Establece el name de la imagen. name se utiliza para localizar la imagen en los recursos de la aplicación.

Véase también name().

void QTextImageFormat::setQuality(int quality = 100)

Establece la calidad que deben utilizar los exportadores al exportar la imagen. QTextDocumentWriter exportará imágenes jpg con el valor quality establecido aquí al exportar a archivos ODF si quality está establecido en un valor entre 0 y 100. O exportará imágenes png si quality tiene un valor igual o superior a 100 (valor predeterminado).

Véase también quality().

void QTextImageFormat::setWidth(qreal width)

Establece el width del rectángulo ocupado por la imagen.

Véase también width(), setHeight() y maximumWidth().

qreal QTextImageFormat::width() const

Devuelve la anchura del rectángulo ocupado por la imagen.

Véase también height() y setWidth().

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