En esta página

QTextImageFormat Class

La clase QTextImageFormat proporciona información de formato para las imágenes de un ` QTextDocument`. Más...

Encabezado: #include <QTextImageFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QTextCharFormat

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 el valor Unicode U+FFFC (CARÁCTER DE SUSTITUCIÓN DE OBJETO), al que se le asocia un objeto de tipo QTextImageFormat. El formato de imagen especifica un nombre mediante la función 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 de imagen deseada se puede establecer con setQuality().

Las imágenes pueden proporcionarse en cualquier formato para el que Qt disponga de un lector de imágenes, por lo que se pueden incluir dibujos SVG junto con PNG, TIFF y otros formatos de mapa de bits.

Véase también QImage y QImageReader.

Documentación de funciones miembro

QTextImageFormat::QTextImageFormat()

Crea un nuevo objeto de formato de imagen.

qreal QTextImageFormat::height() const

Devuelve la altura del rectángulo que ocupa 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 que ocupa la imagen.

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

QString QTextImageFormat::name() const

Devuelve el nombre de la imagen. El nombre hace referencia a una entrada del archivo de recursos de la aplicación.

Véase también setName().

int QTextImageFormat::quality() const

Devuelve el valor establecido mediante la función setQuality().

Véase también setQuality().

void QTextImageFormat::setHeight(qreal height)

Establece el height del rectángulo que ocupa la imagen.

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

void QTextImageFormat::setMaximumWidth(QTextLength maximumWidth)

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

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

void QTextImageFormat::setName(const QString &name)

Establece la ruta de acceso « name » de la imagen. La ruta « 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 de « quality » establecido aquí al exportar a archivos ODF si « quality » se establece en un valor comprendido entre 0 y 100. O bien, exportará imágenes PNG si « quality » se establece en 100 (valor predeterminado) o superior.

Véase también quality().

void QTextImageFormat::setWidth(qreal width)

Establece el width del rectángulo que ocupa la imagen.

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

qreal QTextImageFormat::width() const

Devuelve el ancho del rectángulo que ocupa 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.