QTextTableCell Class

La classe QTextTableCell représente les propriétés d'une cellule dans un tableau QTextTable. 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 de Rich Text Processing APIs.

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 ordonne les cellules dans des lignes et des colonnes particulières ; 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 QTextCursor::insertTable(), mais elles sont également créées et détruites lorsqu'un tableau est redimensionné.

Les cellules contiennent des informations sur leur emplacement dans un tableau ; vous pouvez obtenir les numéros row() et column() d'une cellule, ainsi que ses numéros rowSpan() et columnSpan().

Le numéro format() d'une cellule décrit le format de caractère par défaut de son contenu. Les fonctions firstCursorPosition() et lastCursorPosition() sont utilisées pour obtenir l'étendue de la cellule dans le document.

Voir également QTextTable et QTextTableFormat.

Documentation des fonctions membres

QTextTableCell::QTextTableCell()

Construit une cellule de tableau invalide.

Voir aussi isValid().

QTextTableCell::QTextTableCell(const QTextTableCell &other)

Constructeur de copie. Crée un nouvel objet QTextTableCell basé sur la cellule other.

`[noexcept]` QTextTableCell::~QTextTableCell()

Détruit la cellule du tableau.

QTextFrame::iterator QTextTableCell::begin() const

Renvoie un itérateur de cadre pointant vers le début de la cellule du tableau.

Voir également 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 également rowSpan().

QTextFrame::iterator QTextTableCell::end() const

Renvoie un itérateur de cadre pointant vers la fin de la cellule du tableau.

Voir également begin().

QTextCursor QTextTableCell::firstCursorPosition() const

Renvoie la première position valide du curseur 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 également column().

int QTextTableCell::rowSpan() const

Renvoie le nombre de lignes que cette cellule couvre. La valeur par défaut est 1.

Voir également columnSpan().

void QTextTableCell::setFormat(const QTextCharFormat &format)

Définit le format de caractères de la cellule à format. Cela peut par exemple être utilisé pour changer la couleur d'arrière-plan de la cellule entière :

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 l'étendue de la ligne ou de la colonne de la cellule. Vous devez utiliser QTextTable::mergeCells et QTextTable::splitCell à la place.

Voir aussi format().

int QTextTableCell::tableCellFormatIndex() const

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

Voir aussi QTextDocument::allFormats().

bool QTextTableCell::operator!=(const QTextTableCell &other) const

Renvoie true si cet objet cellulaire et l'objet cellulaire other décrivent des cellules différentes ; sinon, renvoie false.

QTextTableCell &QTextTableCell::operator=(const QTextTableCell &other)

Attribue la cellule du tableau other à cette cellule du tableau.

bool QTextTableCell::operator==(const QTextTableCell &other) const

Renvoie true si cet objet cellulaire et l'objet cellulaire other décrivent 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.