QTextFragment Class
La classe QTextFragment contient un fragment de texte dans une instance de ` QTextDocument ` avec un seul ` QTextCharFormat`. En savoir 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 des API de traitement de texte enrichi.
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 une partie de texte stockée avec un format de caractère unique. Un texte dans lequel le format des caractères change peut être représenté par des séquences de fragments de texte présentant des 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 divisé à chaque point où le format change, et de nouveaux fragments seront créés. Par exemple, modifier le style d’une partie du texte au milieu d’une phrase entraînera la division du fragment en trois fragments distincts : le premier et le troisième conserveront le même format qu’auparavant, tandis que le deuxième présentera le nouveau style. Le premier fragment contiendra le texte depuis le début de la phrase, le deuxième contiendra le texte à partir du milieu, et le troisième contiendra le texte depuis la fin de la phrase.
Le texte et le format des caractères d’un fragment peuvent être récupérés à l’aide des fonctions ` text()` et ` charFormat()`. La fonction ` length()` renvoie la longueur du texte contenu dans le fragment. La fonction ` position()` renvoie la position du début du fragment dans le document. Pour déterminer si le fragment contient une position particulière au sein du document, utilisez la fonction ` contains()`.
Voir également « QTextDocument » et «Structure des documents en texte enrichi».
Documentation sur les fonctions membres
QTextFragment::QTextFragment()
Crée un nouveau fragment de texte vide.
QTextFragment::QTextFragment(const QTextFragment &other)
Copie le contenu (texte et mise en forme) du fragment de texte « other » dans ce fragment de texte.
QTextCharFormat QTextFragment::charFormat() const
Renvoie le format des 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, correspondant au format de caractères du fragment de texte.
Voir également QTextDocument::allFormats().
bool QTextFragment::contains(int position) const
Renvoie « true » si le fragment de texte contient le texte situé à l'position indiquée 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 l'QTextBlock.
Si ` pos ` est inférieur à zéro, la valeur par défaut est le début de ` QTextFragment`. Si ` len ` est inférieur à zéro, la valeur par défaut est 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 s'il occupe une position valide dans un document) ; sinon, renvoie « false ».
int QTextFragment::length() const
Renvoie le nombre de caractères contenus dans le 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 également 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 mise en forme) 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.
