Sur cette page

QTextTableFormat Class

La classe QTextTableFormat fournit des informations de formatage pour les tableaux dans un site QTextDocument. Plus....

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

Note : 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 groupe de cellules ordonnées en lignes et en colonnes. Chaque tableau contient au moins une ligne et une colonne. Chaque cellule contient un bloc. Dans les documents de texte riche, les tableaux sont formatés à l'aide des propriétés définies dans cette classe.

Les tableaux sont justifiés horizontalement dans leur cadre parent en fonction de l'alignement du tableau. Cet alignement peut être lu à l'aide de la fonction alignment() et défini à l'aide de la fonction setAlignment().

Les cellules du tableau sont séparées par un espacement. Le nombre de pixels entre les cellules est défini par la fonction setCellSpacing() et lu par la fonction cellSpacing(). Le contenu de chaque cellule est entouré d'un espacement entre les cellules. Le nombre de pixels entre chaque bord de cellule et son contenu est défini avec setCellPadding() et lu avec cellPadding().

Diagramme montrant comment l'espacement et le remplissage des cellules sont disposés autour du rectangle de contenu de la cellule.

La couleur d'arrière-plan du tableau peut être lue avec la fonction background() et peut être spécifiée avec setBackground(). La couleur d'arrière-plan de chaque cellule peut être définie indépendamment et contrôlera la couleur de la cellule à l'intérieur de la zone de remplissage.

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

Voir également QTextTable, QTextTableCell, et QTextLength.

Documentation des fonctions membres

QTextTableFormat::QTextTableFormat()

Construit un nouvel objet de format de table.

Qt::Alignment QTextTableFormat::alignment() const

Renvoie l'alignement du tableau.

Voir également setAlignment().

bool QTextTableFormat::borderCollapse() const

Renvoie true si les bordures du tableau doivent être réduites. La valeur par défaut est true.

Voir aussi setBorderCollapse().

qreal QTextTableFormat::cellPadding() const

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

Voir également setCellPadding().

qreal QTextTableFormat::cellSpacing() const

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

Voir également setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints()

Efface les contraintes de largeur de colonne pour le tableau.

Voir aussi columnWidthConstraints() et setColumnWidthConstraints().

QList<QTextLength> QTextTableFormat::columnWidthConstraints() const

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

Voir aussi setColumnWidthConstraints().

int QTextTableFormat::columns() const

Renvoie le nombre de colonnes spécifié par le format du tableau.

int QTextTableFormat::headerRowCount() const

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

Voir aussi setHeaderRowCount().

bool QTextTableFormat::isValid() const

Renvoie true si ce format de table est valide ; sinon, renvoie false.

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

Définit l'adresse alignment de la table.

Voir aussi alignment().

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

Par défaut, borderCollapse() est true, ce qui a les implications suivantes :

  • Les bordures et la grille du tableau seront rendues conformément aux règles CSS du tableau border-collapse: collapse.
  • La définition de la propriété border à une valeur minimale de 1 rendra une grille intérieure de tableau solide d'un pixel en utilisant la propriété borderBrush et une bordure extérieure telle que spécifiée.
  • Les diverses propriétés de style de bordure de QTextTableCellFormat peuvent être utilisées pour personnaliser la grille et ont la priorité sur la bordure et la grille du tableau.
  • La propriété cellSpacing est ignorée.
  • Pour la pagination d'impression :
    • Les colonnes qui se poursuivent sur une page n'auront pas leur bordure de cellule supérieure rendue
    • Les lignes d'en-tête répétées auront toujours leur bordure de cellule inférieure rendue.

Si borderCollapse est défini sur false, les bordures des cellules peuvent toujours être stylisées à l'aide de QTextTableCellFormat, mais le style ne sera appliqué 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 la cellule padding pour le tableau. Cela détermine la distance entre le bord d'une cellule et son contenu.

Voir également cellPadding().

void QTextTableFormat::setCellSpacing(qreal spacing)

Définit la cellule spacing pour le tableau. Cette propriété détermine la distance entre les cellules adjacentes.

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

Voir également 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éclare les premières count lignes du tableau comme étant l'en-tête du tableau. Les lignes d'en-tête du tableau sont répétées lorsqu'un tableau est divisé par une limite de page.

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