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 |
- Liste de tous les membres, y compris les membres hérités
- QTextTableFormat fait partie des API de traitement de texte enrichi et des classes partagées implicitement.
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()`.

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.