QTextFrameFormat Class
La classe `QTextFrameFormat` fournit des informations de mise en forme pour les cadres d'un ` QTextDocument`. En savoir plus...
| En-tête : | #include <QTextFrameFormat> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QTextFormat |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QTextFrameFormat 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.
Types publics
| enum | BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset } |
| enum | Position { InFlow, FloatLeft, FloatRight } |
Fonctions publiques
| QTextFrameFormat() | |
| qreal | border() const |
| QBrush | borderBrush() const |
| QTextFrameFormat::BorderStyle | borderStyle() const |
| qreal | bottomMargin() const |
| QTextLength | height() const |
| bool | isValid() const |
| qreal | leftMargin() const |
| qreal | margin() const |
| qreal | padding() const |
| QTextFormat::PageBreakFlags | pageBreakPolicy() const |
| QTextFrameFormat::Position | position() const |
| qreal | rightMargin() const |
| void | setBorder(qreal width) |
| void | setBorderBrush(const QBrush &brush) |
| void | setBorderStyle(QTextFrameFormat::BorderStyle style) |
| void | setBottomMargin(qreal margin) |
| void | setHeight(const QTextLength &height) |
| void | setHeight(qreal height) |
| void | setLeftMargin(qreal margin) |
| void | setMargin(qreal margin) |
| void | setPadding(qreal width) |
| void | setPageBreakPolicy(QTextFormat::PageBreakFlags policy) |
| void | setPosition(QTextFrameFormat::Position policy) |
| void | setRightMargin(qreal margin) |
| void | setTopMargin(qreal margin) |
| void | setWidth(const QTextLength &width) |
| void | setWidth(qreal width) |
| qreal | topMargin() const |
| QTextLength | width() const |
Description détaillée
Un cadre de texte regroupe un ou plusieurs blocs de texte, offrant ainsi une structure d'un niveau supérieur à celui du paragraphe. Le format d'un cadre définit la manière dont il est affiché et positionné à l'écran. Il ne spécifie pas directement le comportement de la mise en forme du texte qu'il contient, mais impose des contraintes sur la mise en page de ses éléments enfants.
Le format du cadre définit l’ width() et l’ height() du cadre à l’écran. Chaque cadre peut comporter une « border » () qui entoure son contenu d’un rectangle. La bordure est elle-même entourée d’une « margin » () autour du cadre, et le contenu du cadre est séparé de la bordure par la « padding » () du cadre. Ce schéma est similaire au modèle de boîte utilisé par les feuilles de style en cascade (CSS) pour les pages HTML.

L’ position() d’un cadre est définie à l’aide de la fonction setPosition() et détermine son emplacement par rapport au texte environnant.
La validité d’un objet `QTextFrameFormat` peut être déterminée à l’aide de la fonction ` isValid()`.
Voir également QTextFrame et QTextBlockFormat.
Documentation sur les types de membres
enum QTextFrameFormat::BorderStyle
Cette énumération décrit différents styles de bordure pour le cadre de texte.
| Constante | Valeur |
|---|---|
QTextFrameFormat::BorderStyle_None | 0 |
QTextFrameFormat::BorderStyle_Dotted | 1 |
QTextFrameFormat::BorderStyle_Dashed | 2 |
QTextFrameFormat::BorderStyle_Solid | 3 |
QTextFrameFormat::BorderStyle_Double | 4 |
QTextFrameFormat::BorderStyle_DotDash | 5 |
QTextFrameFormat::BorderStyle_DotDotDash | 6 |
QTextFrameFormat::BorderStyle_Groove | 7 |
QTextFrameFormat::BorderStyle_Ridge | 8 |
QTextFrameFormat::BorderStyle_Inset | 9 |
QTextFrameFormat::BorderStyle_Outset | 10 |
Voir également borderStyle() et FrameBorderStyle.
enum QTextFrameFormat::Position
Cette énumération décrit la position d'un cadre par rapport au texte environnant.
| Constante | Valeur |
|---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
Documentation des fonctions membres
QTextFrameFormat::QTextFrameFormat()
Crée un objet de format de cadre de texte avec les propriétés par défaut.
qreal QTextFrameFormat::border() const
Renvoie la largeur de la bordure en pixels.
Voir aussi setBorder().
QBrush QTextFrameFormat::borderBrush() const
Renvoie le pinceau utilisé pour la bordure du cadre.
Voir aussi setBorderBrush().
QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const
Renvoie le style de la bordure du cadre.
Voir aussi setBorderStyle().
qreal QTextFrameFormat::bottomMargin() const
Renvoie la largeur de la marge inférieure du cadre en pixels.
Voir aussi setBottomMargin().
QTextLength QTextFrameFormat::height() const
Renvoie la hauteur du rectangle de bordure du cadre.
Voir aussi setHeight().
bool QTextFrameFormat::isValid() const
Renvoie « true » si la description du format est valide ; sinon, renvoie « false ».
qreal QTextFrameFormat::leftMargin() const
Renvoie la largeur de la marge gauche du cadre en pixels.
Voir aussi setLeftMargin().
qreal QTextFrameFormat::margin() const
Renvoie la largeur de la marge externe du cadre en pixels.
Voir aussi setMargin().
qreal QTextFrameFormat::padding() const
Renvoie la largeur du remplissage interne du cadre en pixels.
Voir aussi setPadding().
QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const
Renvoie la règle de saut de page actuellement définie pour le cadre ou le tableau. La valeur par défaut est « QTextFormat::PageBreak_Auto ».
Voir également setPageBreakPolicy().
QTextFrameFormat::Position QTextFrameFormat::position() const
Renvoie la politique de positionnement pour les cadres utilisant ce format de cadre.
Voir également setPosition().
qreal QTextFrameFormat::rightMargin() const
Renvoie la largeur de la marge droite du cadre en pixels.
Voir aussi setRightMargin().
void QTextFrameFormat::setBorder(qreal width)
Définit l'width e (en pixels) de la bordure du cadre.
Voir aussi border().
void QTextFrameFormat::setBorderBrush(const QBrush &brush)
Définit l'brush e utilisée pour la bordure du cadre.
Voir aussi borderBrush().
void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)
Définit l'style de la bordure du cadre.
Voir aussi borderStyle().
void QTextFrameFormat::setBottomMargin(qreal margin)
Définit l'margin inférieure du cadre en pixels.
Voir aussi bottomMargin().
void QTextFrameFormat::setHeight(const QTextLength &height)
Définit l’ height du cadre.
Voir aussi height().
void QTextFrameFormat::setHeight(qreal height)
Définit l'height de l'image.
Il s'agit d'une fonction surchargée.
void QTextFrameFormat::setLeftMargin(qreal margin)
Définit l'margin gauche du cadre en pixels.
Voir aussi leftMargin().
void QTextFrameFormat::setMargin(qreal margin)
Définit l'margin e du cadre en pixels. Cette méthode définit également les marges gauche, droite, supérieure et inférieure du cadre à la même valeur. Les marges individuelles prévalent sur la marge générale.
Voir également margin().
void QTextFrameFormat::setPadding(qreal width)
Définit l'width e du remplissage interne de l'élément `frame` en pixels.
Voir aussi padding().
void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
Définit la règle de saut de page pour le cadre/le tableau sur « policy ».
Voir également pageBreakPolicy().
void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)
Définit l'policy s de positionnement des images utilisant ce format d'image.
Voir aussi position().
void QTextFrameFormat::setRightMargin(qreal margin)
Définit l'margin e droite du cadre en pixels.
Voir aussi rightMargin().
void QTextFrameFormat::setTopMargin(qreal margin)
Définit l'margin supérieure du cadre en pixels.
Voir aussi topMargin().
void QTextFrameFormat::setWidth(const QTextLength &width)
Définit l'width du rectangle de bordure du cadre.
Voir également width() et QTextLength.
void QTextFrameFormat::setWidth(qreal width)
Méthode pratique qui définit la largeur du rectangle de bordure du cadre sur la valeur fixe spécifiée width.
Il s'agit d'une fonction surchargée.
qreal QTextFrameFormat::topMargin() const
Renvoie la largeur de la marge supérieure du cadre en pixels.
Voir aussi setTopMargin().
QTextLength QTextFrameFormat::width() const
Renvoie la largeur du rectangle de bordure du cadre.
Voir également setWidth() et QTextLength.
© 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.