QTextImageFormat Class
La classe QTextImageFormat fournit des informations de formatage pour les images dans un site QTextDocument. Plus....
| En-tête : | #include <QTextImageFormat> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Héritages : | QTextCharFormat |
- Liste de tous les membres, y compris les membres hérités
- QTextImageFormat fait partie de Rich Text Processing APIs et de Implicitly Shared Classes.
Note : 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 en ligne sont représentées par une valeur Unicode U+FFFC (OBJECT REPLACEMENT CHARACTER) à laquelle est associé un QTextImageFormat. Le format d'image spécifie un nom avec setName() qui est utilisé pour 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 à l'aide de setQuality().
Les images peuvent être fournies dans n'importe quel format pour lequel Qt Image Formats dispose d'un lecteur d'images, de sorte que les dessins SVG peuvent être inclus aux côtés des formats PNG, TIFF et autres bitmaps.
Voir aussi 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 aussi 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 aussi width() et setMaximumWidth().
QString QTextImageFormat::name() const
Renvoie le nom de l'image. Le nom fait référence à une entrée du fichier de ressources de l'application.
Voir aussi setName().
int QTextImageFormat::quality() const
Renvoie la valeur définie par setQuality().
Voir aussi setQuality().
void QTextImageFormat::setHeight(qreal height)
Définit l'adresse height du rectangle occupé par l'image.
Voir aussi height() et setWidth().
void QTextImageFormat::setMaximumWidth(QTextLength maximumWidth)
Définit le maximumWidth 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 maximumWidth(), width() et setHeight().
void QTextImageFormat::setName(const QString &name)
Définit le name de l'image. Le name est utilisé pour localiser l'image dans les ressources de l'application.
Voir aussi name().
void QTextImageFormat::setQuality(int quality = 100)
Définit la qualité qui doit être utilisée par les exportateurs lors de l'exportation de l'image. QTextDocumentWriter exportera des images jpg avec la qualité quality définie ici lors de l'exportation vers des fichiers ODF si quality a une valeur comprise entre 0 et 100. Il exportera également des images png si quality a une valeur égale ou supérieure à 100 (valeur par défaut).
Voir aussi quality().
void QTextImageFormat::setWidth(qreal width)
Définit l'adresse width du rectangle occupé par l'image.
Voir aussi 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.
