Sur cette page

QTextLength Class

La classe QTextLength encapsule les différents types de longueur utilisés dans un site QTextDocument. Plus....

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

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 nous spécifions une valeur pour la longueur d'un élément dans un document texte, nous devons souvent fournir d'autres informations pour que la longueur soit utilisée comme nous le souhaitons. Par exemple, lorsque nous spécifions la largeur d'un tableau, la valeur peut représenter un nombre fixe de pixels ou un pourcentage. Ces informations modifient à 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. Celles-ci peuvent être spécifiées sous la forme d'un nombre fixe de pixels, d'un pourcentage de la largeur du cadre contenant, ou d'une largeur variable qui lui permet d'occuper 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 d'objets de longueur.

ConstanteValeurDescription de l'objet
QTextLength::VariableLength0La largeur de l'objet est variable
QTextLength::FixedLength1La largeur de l'objet est fixe
QTextLength::PercentageLength2La largeur de l'objet est en pourcentage de la largeur maximale.

Voir également type().

Documentation des fonctions membres

QTextLength::QTextLength()

Construit un nouvel objet longueur qui représente une taille variable.

[explicit] QTextLength::QTextLength(QTextLength::Type type, qreal value)

Construit un nouvel objet de longueur à partir des données type et value.

qreal QTextLength::rawValue() const

Renvoie la valeur de la contrainte spécifique au type de longueur. Si la longueur est QTextLength::PercentageLength, la valeur brute est exprimée en pourcentage, entre 0 et 100. Si la longueur est QTextLength::FixedLength, la valeur fixe est renvoyée. Pour les longueurs variables, zéro est renvoyé.

QTextLength::Type QTextLength::type() const

Renvoie le type de cet objet de longueur.

Voir aussi QTextLength::Type.

qreal QTextLength::value(qreal maximumLength) const

Renvoie la longueur effective, contrainte par le type de l'objet longueur et la valeur spécifiée maximumLength.

Voir également type().

QTextLength::operator QVariant() const

Renvoie la longueur du texte sous forme de QVariant

bool QTextLength::operator!=(const QTextLength &other) const

Renvoie true si la longueur du texte est différente de la longueur du texte other.

bool QTextLength::operator==(const QTextLength &other) const

Renvoie true si la longueur du texte est identique à la longueur 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.