Sur cette page

QTextTableFormat Class

La classe `QTextTableFormat` fournit des informations de mise en forme pour les tableaux d'un fichier ` QTextDocument`. En savoir plus...

En-tête : #include <QTextTableFormat>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite de : QTextFrameFormat

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QTextTableFormat()
Qt::Alignment alignment() const
bool borderCollapse() const
qreal cellPadding() const
qreal cellSpacing() const
void clearColumnWidthConstraints()
QList<QTextLength> columnWidthConstraints() const
int columns() const
int headerRowCount() const
bool isValid() const
void setAlignment(Qt::Alignment alignment)
void setBorderCollapse(bool borderCollapse)
void setCellPadding(qreal padding)
void setCellSpacing(qreal spacing)
void setColumnWidthConstraints(const QList<QTextLength> &constraints)
void setHeaderRowCount(int count)

Description détaillée

Un tableau est un ensemble de cellules organisées en lignes et en colonnes. Chaque tableau contient au moins une ligne et une colonne. Chaque cellule contient un bloc. Les tableaux des documents en texte enrichi sont mis en forme à l'aide des propriétés définies dans cette classe.

Les tableaux sont alignés horizontalement au sein de leur cadre parent en fonction de l’alignement du tableau. Ce paramètre peut être lu à l’aide de la fonction alignment() et défini à l’aide de setAlignment().

Les cellules d’un tableau sont séparées par un espacement entre cellules. Le nombre de pixels entre les cellules est défini à l’aide de ` setCellSpacing()` et lu à l’aide de ` cellSpacing()`. Le contenu de chaque cellule est entouré d’un remplissage de cellule. Le nombre de pixels entre chaque bord de la cellule et son contenu est défini à l’aide de ` setCellPadding()` et lu à l’aide de ` cellPadding()`.

Schéma illustrant la manière dont l'espacement entre les cellules et le remplissage sont répartis autour du rectangle contenant le contenu de la cellule.

La couleur d’arrière-plan du tableau peut être lue à l’aide de la fonction background() et définie à l’aide de setBackground(). La couleur d’arrière-plan de chaque cellule peut être définie indépendamment et détermine la couleur de la cellule à l’intérieur de la zone de remplissage.

Le format du tableau permet également de limiter la largeur des colonnes. On peut attribuer aux colonnes une largeur fixe, une largeur variable ou un pourcentage de la largeur disponible (voir QTextLength). La fonction columns() renvoie le nombre de colonnes soumises à des contraintes, et la fonction columnWidthConstraints() renvoie les contraintes définies pour le tableau. Ces valeurs peuvent également être définies en appelant setColumnWidthConstraints() avec une liste contenant de nouvelles contraintes. Si aucune contrainte n’est requise, clearColumnWidthConstraints() peut être utilisé pour les supprimer.

Voir également QTextTable, QTextTableCell et QTextLength.

Documentation des fonctions membres

QTextTableFormat::QTextTableFormat()

Crée un nouvel objet de format de tableau.

Qt::Alignment QTextTableFormat::alignment() const

Renvoie l'alignement du tableau.

Voir aussi setAlignment().

bool QTextTableFormat::borderCollapse() const

Renvoie « true » si les bordures du tableau doivent être masquées. La valeur par défaut est « true ».

Voir également setBorderCollapse().

qreal QTextTableFormat::cellPadding() const

Renvoie le remplissage des cellules du tableau. Il s'agit de la distance entre la bordure d'une cellule et son contenu.

Voir aussi setCellPadding().

qreal QTextTableFormat::cellSpacing() const

Renvoie l'espacement entre les cellules du tableau. Il s'agit de la distance entre deux cellules adjacentes.

Voir aussi setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints()

Supprime les contraintes de largeur des colonnes du tableau.

Voir également columnWidthConstraints() et setColumnWidthConstraints().

QList<QTextLength> QTextTableFormat::columnWidthConstraints() const

Renvoie une liste des contraintes utilisées par ce format de tableau pour contrôler l'apparence des colonnes d'un tableau.

Voir également setColumnWidthConstraints().

int QTextTableFormat::columns() const

Renvoie le nombre de colonnes défini par le format du tableau.

int QTextTableFormat::headerRowCount() const

Renvoie le nombre de lignes de la table qui définissent l'en-tête.

Voir aussi setHeaderRowCount().

bool QTextTableFormat::isValid() const

Renvoie « true » si ce format de tableau est valide ; sinon, renvoie « false ».

void QTextTableFormat::setAlignment(Qt::Alignment alignment)

Définit l'alignment de la table.

Voir aussi alignment().

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

Par défaut, la propriété ` borderCollapse()` est définie sur ` true`, ce qui a les implications suivantes :

  • Les bordures et la grille du tableau seront affichées conformément aux règles CSS relatives à l'border-collapse: collapse
  • Si l’on définit la propriété ` border ` sur sa valeur minimale ` 1 `, une grille interne pleine d’un pixel sera affichée à l’aide de la propriété ` borderBrush `, ainsi qu’une bordure externe telle que spécifiée
  • Les différentes propriétés de style de bordure de ` QTextTableCellFormat ` peuvent être utilisées pour personnaliser la grille et ont priorité sur la bordure et la grille du tableau
  • La propriété cellSpacing sera ignorée
  • Pour la pagination à l’impression :
    • Les colonnes qui se prolongent sur une autre page ne verront pas leur bordure supérieure affichée
    • Les lignes d’en-tête répétées verront toujours leur bordure inférieure de cellule affichée

Lorsque la propriété ` borderCollapse ` est définie sur ` false`, les bordures des cellules peuvent toujours être stylisées à l’aide de ` QTextTableCellFormat `, mais le style ne s’appliquera qu’à l’intérieur du cadre de la cellule, ce qui n’est probablement pas très utile dans la pratique.

Remarque : dans les versions de Qt antérieures à la version 6.8, la valeur par défaut était ` false`.

Voir également borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle() et QTextTableCellFormat.

void QTextTableFormat::setCellPadding(qreal padding)

Définit l'padding des cellules du tableau. Ce paramètre détermine la distance entre la bordure d'une cellule et son contenu.

Voir aussi cellPadding().

void QTextTableFormat::setCellSpacing(qreal spacing)

Définit l'spacing e des cellules du tableau. Ce paramètre détermine la distance entre les cellules adjacentes.

Cette propriété sera ignorée si l'borderCollapse est activée.

Voir aussi cellSpacing().

void QTextTableFormat::setColumnWidthConstraints(const QList<QTextLength> &constraints)

Définit la largeur des colonnes constraints pour le tableau.

Voir également columnWidthConstraints() et clearColumnWidthConstraints().

void QTextTableFormat::setHeaderRowCount(int count)

Définit les count premières lignes du tableau comme en-tête. Les lignes d'en-tête sont répétées lorsqu'un tableau s'étend sur plusieurs pages.

Voir aussi headerRowCount().

© 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.