QTextLength Class
La classe `QTextLength` regroupe les différents types de longueur utilisés dans une ` QTextDocument`. En savoir plus...
| En-tête : | #include <QTextLength> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- QTextLength fait partie des API de traitement de texte enrichi.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Types publics
| enum | Type { VariableLength, FixedLength, PercentageLength } |
Fonctions publiques
| QTextLength() | |
| QTextLength(QTextLength::Type type, qreal value) | |
| qreal | rawValue() const |
| QTextLength::Type | type() const |
| qreal | value(qreal maximumLength) const |
| operator QVariant() const | |
| bool | operator!=(const QTextLength &other) const |
| bool | operator==(const QTextLength &other) const |
Description détaillée
Lorsque l'on spécifie une valeur pour la longueur d'un élément dans un document texte, il est souvent nécessaire de fournir des informations supplémentaires afin que cette longueur soit utilisée comme prévu. Par exemple, lorsque l'on spécifie la largeur d'un tableau, la valeur peut correspondre à un nombre fixe de pixels ou à un pourcentage. Cette information modifie à la fois la signification de la valeur et la manière dont elle est utilisée.
En général, cette classe est utilisée pour spécifier la largeur des tableaux. Celle-ci peut être définie soit sous la forme d’un nombre fixe de pixels, soit sous la forme d’un pourcentage de la largeur du cadre qui la contient, soit sous la forme d’une largeur variable lui permettant de n’occuper que l’espace dont elle a besoin.
Voir également QTextTable.
Documentation sur les types de membres
enum QTextLength::Type
Cette énumération décrit les différents types que peut prendre un objet de longueur.
| Constante | Valeur | Description |
|---|---|---|
QTextLength::VariableLength | 0 | La largeur de l'objet est variable |
QTextLength::FixedLength | 1 | La largeur de l'objet est fixe |
QTextLength::PercentageLength | 2 | La largeur de l’objet est exprimée en pourcentage de la largeur maximale |
Voir aussi type().
Documentation sur les fonctions membres
QTextLength::QTextLength()
Crée un nouvel objet « length » représentant une taille variable.
[explicit] QTextLength::QTextLength(QTextLength::Type type, qreal value)
Crée un nouvel objet de type « longueur » à partir des paramètres « type » et « value » fournis.
qreal QTextLength::rawValue() const
Renvoie la valeur de contrainte spécifique au type de la longueur. Si la longueur est de type « QTextLength::PercentageLength », la valeur brute est exprimée en pourcentage, comprise entre 0 et 100. Si la longueur est de type « QTextLength::FixedLength », c'est cette valeur fixe qui est renvoyée. Pour les longueurs variables, la valeur renvoyée est zéro.
QTextLength::Type QTextLength::type() const
Renvoie le type de cet objet « length ».
Voir aussi QTextLength::Type.
qreal QTextLength::value(qreal maximumLength) const
Renvoie la longueur effective, limitée par le type de l'objet « length » et par la valeur spécifiée « maximumLength ».
Voir également ` type()`
QTextLength::operator QVariant() const
Renvoie la longueur du texte sous la forme d'un QVariant
bool QTextLength::operator!=(const QTextLength &other) const
Renvoie « true » si la longueur de ce texte diffère de celle du texte « other ».
bool QTextLength::operator==(const QTextLength &other) const
Renvoie « true » si la longueur de ce texte est identique à celle du texte « other ».
© 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.
