QTextFragment Class
La classe QTextFragment contient un morceau de texte dans une page QTextDocument avec une seule QTextCharFormat. Plus...
| En-tête : | #include <QTextFragment> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- QTextFragment fait partie de Rich Text Processing APIs.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| QTextFragment() | |
| QTextFragment(const QTextFragment &other) | |
| QTextCharFormat | charFormat() const |
| int | charFormatIndex() const |
| bool | contains(int position) const |
| QList<QGlyphRun> | glyphRuns(int pos = -1, int len = -1) const |
| bool | isValid() const |
| int | length() const |
| int | position() const |
| QString | text() const |
| bool | operator!=(const QTextFragment &other) const |
| bool | operator<(const QTextFragment &other) const |
| QTextFragment & | operator=(const QTextFragment &other) |
| bool | operator==(const QTextFragment &other) const |
Description détaillée
Un fragment de texte décrit un morceau de texte stocké dans un format de caractère unique. Un texte dont le format de caractère change peut être représenté par des séquences de fragments de texte de formats différents.
Si l'utilisateur modifie le texte d'un fragment et introduit un format de caractères différent, le texte du fragment sera scindé à chaque point où le format change, et de nouveaux fragments seront créés. Par exemple, si l'on modifie le style d'un texte au milieu d'une phrase, le fragment sera scindé en trois fragments distincts : le premier et le troisième avec le même format qu'auparavant, et le deuxième avec le nouveau style. Le premier fragment contiendra le texte du début de la phrase, le deuxième le texte du milieu et le troisième le texte de la fin de la phrase.
Le texte et le format de caractères d'un fragment peuvent être obtenus à l'aide des fonctions text() et charFormat(). La fonction length() donne la longueur du texte dans le fragment. position La fonction () donne la position du début du fragment dans le document. Pour déterminer si le fragment contient une position particulière dans le document, utilisez la fonction contains().
Voir également QTextDocument et Rich Text Document Structure.
Documentation des fonctions membres
QTextFragment::QTextFragment()
Crée un nouveau fragment de texte vide.
QTextFragment::QTextFragment(const QTextFragment &other)
Copie le contenu (texte et format) du fragment de texte other dans ce fragment de texte.
QTextCharFormat QTextFragment::charFormat() const
Renvoie le format de caractères du fragment de texte.
Voir aussi text().
int QTextFragment::charFormatIndex() const
Renvoie un index dans la liste interne des formats de caractères du document pour le format de caractères du fragment de texte.
Voir aussi QTextDocument::allFormats().
bool QTextFragment::contains(int position) const
Renvoie true si le fragment de texte contient le texte à l'endroit donné position dans le document ; sinon, renvoie false.
QList<QGlyphRun> QTextFragment::glyphRuns(int pos = -1, int len = -1) const
Renvoie les glyphes correspondant aux caractères len de ce fragment de texte à partir de la position pos. Les positions des glyphes sont relatives à la position de la mise en page de QTextBlock.
Si pos est inférieur à zéro, il correspondra par défaut au début du fragment QTextFragment. Si len est inférieur à zéro, il correspondra par défaut à la longueur du fragment.
Voir également QGlyphRun, QTextBlock::layout(), QTextLayout::position() et QPainter::drawGlyphRun().
bool QTextFragment::isValid() const
Renvoie true s'il s'agit d'un fragment de texte valide (c'est-à-dire dont la position est valide dans un document) ; sinon, renvoie false.
int QTextFragment::length() const
Renvoie le nombre de caractères du fragment de texte.
Voir aussi text().
int QTextFragment::position() const
Renvoie la position de ce fragment de texte dans le document.
QString QTextFragment::text() const
Renvoie le fragment de texte sous forme de texte brut.
Voir aussi length() et charFormat().
bool QTextFragment::operator!=(const QTextFragment &other) const
Renvoie true si ce fragment de texte est différent (à une position différente) du fragment de texte other; sinon renvoie false.
bool QTextFragment::operator<(const QTextFragment &other) const
Renvoie true si ce fragment de texte apparaît plus tôt dans le document que le fragment de texte other; sinon, renvoie false.
QTextFragment &QTextFragment::operator=(const QTextFragment &other)
Attribue le contenu (texte et format) du fragment de texte other à ce fragment de texte.
bool QTextFragment::operator==(const QTextFragment &other) const
Renvoie true si ce fragment de texte est identique (à la même position) au fragment de texte other; sinon renvoie false.
© 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.
