QTextTableCell Class
La classe `QTextTableCell` représente les propriétés d'une cellule d'un ` QTextTable`. En savoir plus...
| En-tête : | #include <QTextTableCell> |
| 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
- QTextTableCell fait partie des API de traitement de texte enrichi.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| QTextTableCell() | |
| QTextTableCell(const QTextTableCell &other) | |
| ~QTextTableCell() | |
| QTextFrame::iterator | begin() const |
| int | column() const |
| int | columnSpan() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| QTextCharFormat | format() const |
| bool | isValid() const |
| QTextCursor | lastCursorPosition() const |
| int | row() const |
| int | rowSpan() const |
| void | setFormat(const QTextCharFormat &format) |
| int | tableCellFormatIndex() const |
| bool | operator!=(const QTextTableCell &other) const |
| QTextTableCell & | operator=(const QTextTableCell &other) |
| bool | operator==(const QTextTableCell &other) const |
Description détaillée
Les cellules de tableau sont des éléments de la structure du document qui appartiennent à un tableau. Le tableau organise les cellules en lignes et colonnes spécifiques ; les cellules peuvent également s’étendre sur plusieurs colonnes et lignes.
Les cellules sont généralement créées lorsqu’un tableau est inséré dans un document à l’aide de la fonction QTextCursor::insertTable(), mais elles sont également créées et détruites lors du redimensionnement d’un tableau.
Les cellules contiennent des informations sur leur emplacement dans un tableau ; vous pouvez obtenir les numéros d'row() et d'column() d'une cellule, ainsi que ses propriétés rowSpan() et columnSpan().
La fonction format() d’une cellule décrit le format de caractère par défaut de son contenu. Les fonctions firstCursorPosition() et lastCursorPosition() permettent d’obtenir l’étendue de la cellule dans le document.
Voir également QTextTable et QTextTableFormat.
Documentation des fonctions membres
QTextTableCell::QTextTableCell()
Crée une cellule de tableau non valide.
Voir aussi isValid().
QTextTableCell::QTextTableCell(const QTextTableCell &other)
Constructeur de copie. Crée un nouvel objet `QTextTableCell` à partir de la cellule ` other `.
[noexcept] QTextTableCell::~QTextTableCell()
Supprime la cellule du tableau.
QTextFrame::iterator QTextTableCell::begin() const
Renvoie un itérateur de trame pointant vers le début de la cellule du tableau.
Voir aussi end().
int QTextTableCell::column() const
Renvoie le numéro de la colonne du tableau qui contient cette cellule.
Voir aussi row().
int QTextTableCell::columnSpan() const
Renvoie le nombre de colonnes que cette cellule couvre. La valeur par défaut est 1.
Voir aussi rowSpan().
QTextFrame::iterator QTextTableCell::end() const
Renvoie un itérateur de trame pointant vers la fin de la cellule du tableau.
Voir aussi begin().
QTextCursor QTextTableCell::firstCursorPosition() const
Renvoie la première position de curseur valide dans cette cellule.
Voir aussi lastCursorPosition().
QTextCharFormat QTextTableCell::format() const
Renvoie le format de caractères de la cellule.
Voir aussi setFormat().
bool QTextTableCell::isValid() const
Renvoie « true » s'il s'agit d'une cellule de tableau valide ; sinon, renvoie « false ».
QTextCursor QTextTableCell::lastCursorPosition() const
Renvoie la dernière position valide du curseur dans cette cellule.
Voir aussi firstCursorPosition().
int QTextTableCell::row() const
Renvoie le numéro de la ligne du tableau qui contient cette cellule.
Voir aussi column().
int QTextTableCell::rowSpan() const
Renvoie le nombre de lignes que cette cellule couvre. La valeur par défaut est 1.
Voir aussi columnSpan().
void QTextTableCell::setFormat(const QTextCharFormat &format)
Définit le format de caractères de la cellule sur « format ». Cela peut par exemple être utilisé pour modifier la couleur d'arrière-plan de l'ensemble de la cellule :
QTextTableCell cell = table->cellAt(2, 3);
QTextCharFormat format = cell.format();
format.setBackground(Qt::blue);
cell.setFormat(format);Notez que cette fonction ne permet pas de modifier la largeur ou la hauteur de la cellule. Vous devez utiliser les fonctions ` QTextTable::mergeCells ` et ` QTextTable::splitCell ` à la place.
Voir également format().
int QTextTableCell::tableCellFormatIndex() const
Renvoie l'index du format de la cellule de tableau dans la liste interne des formats du document.
Voir aussi QTextDocument::allFormats().
bool QTextTableCell::operator!=(const QTextTableCell &other) const
Renvoie « true » si cet objet « cell » et l'objet « cell » de other désignent des cellules différentes ; sinon, renvoie « false ».
QTextTableCell &QTextTableCell::operator=(const QTextTableCell &other)
Attribue la cellule de tableau « other » à cette cellule de tableau.
bool QTextTableCell::operator==(const QTextTableCell &other) const
Renvoie ` true ` si cet objet « cellule » et l'objet « cellule » ` other ` désignent la même cellule ; 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.
