QTextImageFormat Class
La classe `QTextImageFormat` fournit des informations de mise en forme pour les images contenues dans un fichier ` QTextDocument`. En savoir plus...
| En-tête : | #include <QTextImageFormat> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QTextCharFormat |
- Liste de tous les membres, y compris les membres hérités
- QTextImageFormat fait partie des API de traitement de texte enrichi et des classes implicitement partagées.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| 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 |
Description détaillée
Les images intégrées sont représentées par la valeur Unicode U+FFFC (CARACTÈRE DE REMPLACEMENT D’OBJET) à laquelle est associée une instance de QTextImageFormat. Le format d’image spécifie un nom à l’aide de la fonction setName() qui sert à localiser l’image. La taille du rectangle que l’image occupera est spécifiée en pixels à l’aide de setWidth() et setHeight(). La qualité d’image souhaitée peut être définie avec setQuality().
Les images peuvent être fournies dans n'importe quel format pour lequel Qt dispose d'un lecteur d'images ; il est donc possible d'inclure des dessins SVG aux côtés de fichiers PNG, TIFF et d'autres formats bitmap.
Voir également QImage et QImageReader.
Documentation des fonctions membres
QTextImageFormat::QTextImageFormat()
Crée un nouvel objet de format d'image.
qreal QTextImageFormat::height() const
Renvoie la hauteur du rectangle occupé par l'image.
Voir également width() et setHeight().
bool QTextImageFormat::isValid() const
Renvoie « true » si ce format d'image est valide ; sinon, renvoie « false ».
QTextLength QTextImageFormat::maximumWidth() const
Renvoie la largeur maximale du rectangle occupé par l'image.
Voir également width() et setMaximumWidth().
QString QTextImageFormat::name() const
Renvoie le nom de l'image. Ce nom correspond à une entrée du fichier de ressources de l'application.
Voir également setName().
int QTextImageFormat::quality() const
Renvoie la valeur définie par la fonction setQuality().
Voir également setQuality().
void QTextImageFormat::setHeight(qreal height)
Définit les coordonnées ( height ) du rectangle occupé par l'image.
Voir également ` height()` et ` setWidth()`.
void QTextImageFormat::setMaximumWidth(QTextLength maximumWidth)
Définit l'maximumWidth s du rectangle occupé par l'image. Il peut s'agir d'un nombre absolu ou d'un pourcentage de la taille disponible du document.
Voir également les fonctions ` maximumWidth()`, ` width()` et ` setHeight()`.
void QTextImageFormat::setName(const QString &name)
Définit l'name de l'image. L'name permet de localiser l'image dans les ressources de l'application.
Voir aussi name().
void QTextImageFormat::setQuality(int quality = 100)
Définit la qualité que les exportateurs doivent utiliser lors de l'exportation de l'image. QTextDocumentWriter exportera des images JPG avec la qualité définie ici ( quality ) lors de l'exportation vers des fichiers ODF si quality est défini sur une valeur comprise entre 0 et 100. Il exportera quant à lui des images PNG si quality est défini sur 100 (valeur par défaut) ou plus.
Voir également quality().
void QTextImageFormat::setWidth(qreal width)
Définit l'width du rectangle occupé par l'image.
Voir également width(), setHeight() et maximumWidth().
qreal QTextImageFormat::width() const
Renvoie la largeur du rectangle occupé par l'image.
© 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.
