QTextFrameFormat Class

La classe QTextFrameFormat fournit des informations de formatage pour les cadres dans une page QTextDocument. 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 :	QTextFormat
Hérité par :	QTextTableFormat

Liste de tous les membres, y compris les membres hérités
QTextFrameFormat fait partie de Rich Text Processing APIs et de Implicitly Shared Classes.

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 bloc de texte regroupe un ou plusieurs blocs de texte, fournissant une couche de structure plus importante que le paragraphe. Le format d'un bloc spécifie la manière dont il est rendu et positionné à l'écran. Il ne spécifie pas directement le comportement de la mise en forme du texte à l'intérieur, mais fournit des contraintes sur la disposition de ses enfants.

Le format du cadre définit les width() et height() du cadre à l'écran. Chaque cadre peut avoir un border() qui entoure son contenu d'une boîte rectangulaire. La bordure est 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 pour les pages HTML.

Diagramme montrant comment le rembourrage, la bordure et la marge sont disposés autour du rectangle de contenu du texte.

Le position() d'un cadre est défini à l'aide du setPosition() et détermine sa position 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 bloc 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 aussi borderStyle() et FrameBorderStyle.

enum QTextFrameFormat::Position

Cette énumération décrit l'emplacement d'un cadre par rapport au texte qui l'entoure.

Constante	Valeur
`QTextFrameFormat::InFlow`	`0`
`QTextFrameFormat::FloatLeft`	`1`
`QTextFrameFormat::FloatRight`	`2`

Voir également position() et CssFloat.

Documentation des fonctions membres

QTextFrameFormat::QTextFrameFormat()

Construit un objet de format de bloc de texte avec les propriétés par défaut.

qreal QTextFrameFormat::border() const

Renvoie la largeur de la bordure en pixels.

Voir également setBorder().

QBrush QTextFrameFormat::borderBrush() const

Renvoie la brosse utilisée 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 également 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 également 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 de l'espacement interne du cadre en pixels.

Voir aussi setPadding().

QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const

Renvoie la politique de saut de page actuellement définie pour le cadre/la table. La valeur par défaut est QTextFormat::PageBreak_Auto.

Voir aussi setPageBreakPolicy().

QTextFrameFormat::Position QTextFrameFormat::position() const

Renvoie la politique de positionnement des images avec ce format d'image.

Voir aussi setPosition().

qreal QTextFrameFormat::rightMargin() const

Renvoie la largeur de la marge droite du cadre en pixels.

Voir également setRightMargin().

void QTextFrameFormat::setBorder(qreal width)

Définit l'adresse width (en pixels) de la bordure du cadre.

Voir également border().

void QTextFrameFormat::setBorderBrush(const QBrush &brush)

Définit l'adresse brush utilisée pour la bordure du cadre.

Voir également borderBrush().

void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)

Définit l'adresse style de la bordure du cadre.

Voir également borderStyle().

void QTextFrameFormat::setBottomMargin(qreal margin)

Définit le bas du cadre margin en pixels.

Voir également bottomMargin().

void QTextFrameFormat::setHeight(const QTextLength &height)

Définit l'adresse height du cadre.

Voir aussi height().

void QTextFrameFormat::setHeight(qreal height)

Définit l'adresse height du cadre.

Il s'agit d'une fonction surchargée.

void QTextFrameFormat::setLeftMargin(qreal margin)

Définit la gauche du cadre margin en pixels.

Voir également leftMargin().

void QTextFrameFormat::setMargin(qreal margin)

Définit l'adresse margin 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'adresse width de l'espacement interne du cadre en pixels.

Voir également padding().

void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)

Définit la politique de saut de page pour le cadre/table à policy.

Voir aussi pageBreakPolicy().

void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)

Définit l'adresse policy pour le positionnement des images avec ce format d'image.

Voir aussi position().

void QTextFrameFormat::setRightMargin(qreal margin)

Définit la droite du cadre margin en pixels.

Voir aussi rightMargin().

void QTextFrameFormat::setTopMargin(qreal margin)

Définit le haut du cadre margin en pixels.

Voir également topMargin().

void QTextFrameFormat::setWidth(const QTextLength &width)

Définit le rectangle de bordure du cadre width.

Voir aussi width() et QTextLength.

void QTextFrameFormat::setWidth(qreal width)

Méthode pratique qui définit la largeur du rectangle de bordure du cadre à 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 également setTopMargin().

QTextLength QTextFrameFormat::width() const

Renvoie la largeur du rectangle de bordure du cadre.

Voir aussi 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.