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 |
- Liste de tous les membres, y compris les membres hérités
- QTextTableFormat fait partie de Rich Text Processing APIs et de Implicitly Shared Classes.
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().

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