Sur cette page

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 :

QTextTableFormat

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.

Schéma illustrant la manière dont le remplissage, la bordure et la marge s'organisent autour du rectangle contenant le texte.

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.

ConstanteValeur
QTextFrameFormat::BorderStyle_None0
QTextFrameFormat::BorderStyle_Dotted1
QTextFrameFormat::BorderStyle_Dashed2
QTextFrameFormat::BorderStyle_Solid3
QTextFrameFormat::BorderStyle_Double4
QTextFrameFormat::BorderStyle_DotDash5
QTextFrameFormat::BorderStyle_DotDotDash6
QTextFrameFormat::BorderStyle_Groove7
QTextFrameFormat::BorderStyle_Ridge8
QTextFrameFormat::BorderStyle_Inset9
QTextFrameFormat::BorderStyle_Outset10

Voir également borderStyle() et FrameBorderStyle.

enum QTextFrameFormat::Position

Cette énumération décrit la position d'un cadre par rapport au texte environnant.

ConstanteValeur
QTextFrameFormat::InFlow0
QTextFrameFormat::FloatLeft1
QTextFrameFormat::FloatRight2

Voir également position() et CssFloat.

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.