Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QTextTableFormat Class Reference
[QtGui module]

The QTextTableFormat class provides formatting information for tables in a QTextDocument. More...

 #include <QTextTableFormat>

Inherits QTextFrameFormat.

Note: All functions in this class are reentrant.


Public Functions

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

Detailed Description

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

A table is a group of cells ordered into rows and columns. Each table contains at least one row and one column. Each cell contains a block. Tables in rich text documents are formatted using the properties defined in this class.

Tables are horizontally justified within their parent frame according to the table's alignment. This can be read with the alignment() function and set with setAlignment().

Cells within the table are separated by cell spacing. The number of pixels between cells is set with setCellSpacing() and read with cellSpacing(). The contents of each cell is surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().

The table's background color can be read with the background() function, and can be specified with setBackground(). The background color of each cell can be set independently, and will control the color of the cell within the padded area.

The table format also provides a way to constrain the widths of the columns in the table. Columns can be assigned a fixed width, a variable width, or a percentage of the available width (see QTextLength). The columns() function returns the number of columns with constraints, and the columnWidthConstraints() function returns the constraints defined for the table. These quantities can also be set by calling setColumnWidthConstraints() with a vector containing new constraints. If no constraints are required, clearColumnWidthConstraints() can be used to remove them.

See also QTextTable, QTextTableCell, and QTextLength.


Member Function Documentation

QTextTableFormat::QTextTableFormat ()

Constructs a new table format object.

Qt::Alignment QTextTableFormat::alignment () const

Returns the table's alignment.

See also setAlignment().

qreal QTextTableFormat::cellPadding () const

Returns the table's cell padding. This describes the distance between the border of a cell and its contents.

See also setCellPadding().

qreal QTextTableFormat::cellSpacing () const

Returns the table's cell spacing. This describes the distance between adjacent cells.

See also setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints ()

Clears the column width constraints for the table.

See also columnWidthConstraints() and setColumnWidthConstraints().

QVector<QTextLength> QTextTableFormat::columnWidthConstraints () const

Returns a list of constraints used by this table format to control the appearance of columns in a table.

See also setColumnWidthConstraints().

int QTextTableFormat::columns () const

Returns the number of columns specified by the table format.

int QTextTableFormat::headerRowCount () const

Returns the number of rows in the table that define the header.

This function was introduced in Qt 4.2.

See also setHeaderRowCount().

bool QTextTableFormat::isValid () const

Returns true if this table format is valid; otherwise returns false.

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

Sets the table's alignment.

See also alignment().

void QTextTableFormat::setCellPadding ( qreal padding )

Sets the cell padding for the table. This determines the distance between the border of a cell and its contents.

See also cellPadding().

void QTextTableFormat::setCellSpacing ( qreal spacing )

Sets the cell spacing for the table. This determines the distance between adjacent cells.

See also cellSpacing().

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

Sets the column width constraints for the table.

See also columnWidthConstraints() and clearColumnWidthConstraints().

void QTextTableFormat::setHeaderRowCount ( int count )

Declares the first count rows of the table as table header. The table header rows get repeated when a table is broken across a page boundary.

This function was introduced in Qt 4.2.

See also headerRowCount().

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. La rubrique Qt a besoin de vous ! 1
Page suivante

Le Qt Quarterly au hasard

Logo

Réordonner les boutons

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.6
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web