QTextObject Class
La classe `QTextObject` est une classe de base pour différents types d'objets permettant de regrouper des éléments d'une QTextDocument. En savoir 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 de : | QObject |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QTextObject fait partie des API de traitement de texte enrichi.
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 généralement regroupés sont les listes (QTextList), les cadres (QTextFrame) et les tableaux (QTextTable). À chaque objet texte sont associées les fonctions format() et document().
Il existe essentiellement deux types d’objets texte : ceux qui sont utilisés avec des blocs (formats de bloc) et ceux qui sont utilisés avec des caractères (formats de caractère). Les premiers sont dérivés de ` QTextBlockGroup`, et les seconds de ` QTextFrame`.
Vous aurez rarement besoin d’utiliser cette classe directement. Lors de la création d’objets texte personnalisés, vous devrez également réimplémenter la méthode 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 nouvel objet `QTextObject` pour l'document` spécifié.
Avertissement : cette fonction ne doit jamais être appelée directement, mais uniquement à partir de ` QTextDocument::createObject()` .
[virtual noexcept protected] QTextObject::~QTextObject()
Supprime l'objet texte.
Avertissement : les objetstexte appartiennent au document ; vous ne devez donc jamais les détruire vous-même.
QTextDocument *QTextObject::document() const
Renvoie le document auquel appartient cet objet.
Voir aussi format().
QTextFormat QTextObject::format() const
Renvoie le format de l'objet texte.
Voir également 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 conjointement avec la fonction ` QTextFormat::setObjectIndex()`.
[protected] void QTextObject::setFormat(const QTextFormat &format)
Définit la propriété « 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.