QTextImageFormat Class
Die Klasse „QTextImageFormat“ stellt Formatierungsinformationen für Bilder in einem „ QTextDocument “ bereit. Mehr...
| Header: | #include <QTextImageFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QTextCharFormat |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextImageFormat ist Teil der Rich-Text-Verarbeitungs-APIs und der implizit gemeinsam genutzten Klassen.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Funktionen
| 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 |
Ausführliche Beschreibung
Inline-Bilder werden durch den Unicode-Wert U+FFFC (OBJECT REPLACEMENT CHARACTER) dargestellt, dem ein QTextImageFormat zugeordnet ist. Das Bildformat gibt einen Namen mit setName() an, der zum Auffinden des Bildes verwendet wird. Die Größe des Rechtecks, das das Bild einnehmen wird, wird in Pixeln mithilfe von ` setWidth()` und ` setHeight()` angegeben. Die gewünschte Bildqualität kann mit ` setQuality()` festgelegt werden.
Bilder können in jedem Format bereitgestellt werden, für das Qt über einen Bildleser verfügt, sodass SVG-Zeichnungen neben PNG, TIFF und anderen Bitmap-Formaten eingebunden werden können.
Siehe auch QImage und QImageReader.
Dokumentation zu den Member-Funktionen
QTextImageFormat::QTextImageFormat()
Erstellt ein neues Bildformatobjekt.
qreal QTextImageFormat::height() const
Gibt die Höhe des Rechtecks zurück, das das Bild einnimmt.
Siehe auch width() und setHeight().
bool QTextImageFormat::isValid() const
Gibt „ true “ zurück, wenn dieses Bildformat gültig ist; andernfalls wird „ false “ zurückgegeben.
QTextLength QTextImageFormat::maximumWidth() const
Gibt die maximale Breite des vom Bild eingenommenen Rechtecks zurück.
Siehe auch „ width()“ und „ setMaximumWidth()“.
QString QTextImageFormat::name() const
Gibt den Namen des Bildes zurück. Der Name bezieht sich auf einen Eintrag in der Ressourcen-Datei der Anwendung.
Siehe auch ` setName()`.
int QTextImageFormat::quality() const
Gibt den durch setQuality() festgelegten Wert zurück.
Siehe auch ` setQuality()`.
void QTextImageFormat::setHeight(qreal height)
Legt die Koordinaten „ height “ des Rechtecks fest, das das Bild einnimmt.
Siehe auch ` height()` und ` setWidth()`.
void QTextImageFormat::setMaximumWidth(QTextLength maximumWidth)
Legt die Koordinaten „ maximumWidth “ des Rechtecks fest, das das Bild einnimmt. Dies kann eine absolute Zahl oder ein Prozentsatz der verfügbaren Dokumentgröße sein.
Siehe auch „ maximumWidth()“, „ width()“ und „ setHeight()“.
void QTextImageFormat::setName(const QString &name)
Legt den „ name “ des Bildes fest. Der „ name “ dient dazu, das Bild in den Ressourcen der Anwendung zu finden.
Siehe auch name().
void QTextImageFormat::setQuality(int quality = 100)
Legt die Qualität fest, die von den Exportern beim Exportieren des Bildes verwendet werden soll. QTextDocumentWriter exportiert JPG-Bilder mit der hier festgelegten Einstellung „ quality “, wenn in ODF-Dateien exportiert wird und „ quality “ auf einen Wert zwischen 0 und 100 gesetzt ist. Oder es exportiert PNG-Bilder, wenn „ quality “ auf 100 (Standard) oder höher gesetzt ist.
Siehe auch „ quality“ ().
void QTextImageFormat::setWidth(qreal width)
Legt die Koordinaten des Bildausschnitts ( width ) des vom Bild eingenommenen Rechtecks fest.
Siehe auch „ width()“, „ setHeight()“ und „ maximumWidth()“.
qreal QTextImageFormat::width() const
Gibt die Breite des Rechtecks zurück, das das Bild einnimmt.
© 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.
