Sur cette page

QTextObject Class

La classe QTextObject est une classe de base pour différents types d'objets qui peuvent regrouper des parties d'un site QTextDocument. Plus...

En-tête : #include <QTextObject>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite : QObject
Héritée par :

QTextBlockGroup et QTextFrame

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QTextDocument *document() const
QTextFormat format() const
int formatIndex() const
int objectIndex() const

Fonctions protégées

QTextObject(QTextDocument *document)
virtual ~QTextObject()
void setFormat(const QTextFormat &format)

Description détaillée

Les objets texte de regroupement courants sont les listes (QTextList), les cadres (QTextFrame) et les tableaux (QTextTable). Un objet texte est associé à format() et document().

Il existe essentiellement deux types d'objets texte : ceux qui sont utilisés avec des blocs (formats de blocs) et ceux qui sont utilisés avec des caractères (formats de caractères). Les premiers sont dérivés de QTextBlockGroup, et les seconds de QTextFrame.

Il est rare que vous ayez besoin d'utiliser cette classe directement. Lorsque vous créez des objets texte personnalisés, vous devez également réimplémenter QTextDocument::createObject(), qui sert de méthode d'usine pour la création d'objets texte.

Voir également QTextDocument.

Documentation des fonctions membres

[explicit protected] QTextObject::QTextObject(QTextDocument *document)

Crée un nouveau QTextObject pour l'adresse document.

Attention : Cette fonction ne doit jamais être appelée directement, mais uniquement à partir de QTextDocument::createObject().

[virtual noexcept protected] QTextObject::~QTextObject()

Détruit l'objet texte.

Attention : Les objets texte sont la propriété du document, vous ne devez donc jamais les détruire vous-même.

QTextDocument *QTextObject::document() const

Renvoie le document auquel cet objet appartient.

Voir aussi format().

QTextFormat QTextObject::format() const

Renvoie le format de l'objet texte.

Voir aussi setFormat() et document().

int QTextObject::formatIndex() const

Renvoie l'index du format de l'objet dans la liste interne des formats du document.

Voir aussi QTextDocument::allFormats().

int QTextObject::objectIndex() const

Renvoie l'index de cet objet. Cette fonction peut être utilisée avec QTextFormat::setObjectIndex().

[protected] void QTextObject::setFormat(const QTextFormat &format)

Définit l'adresse format de l'objet texte.

Voir aussi format().

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