QTextFrameFormat Class

La clase QTextFrameFormat proporciona información de formato para los marcos en un QTextDocument. Más...

Cabecera:	`#include <QTextFrameFormat>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake:	`QT += gui`
Hereda:	QTextFormat
Heredado por:	QTextTableFormat

Lista de todos los miembros, incluyendo los heredados
QTextFrameFormat es parte de APIs de Procesamiento de Texto Enriquecido y Clases Implícitamente Compartidas.

Nota: Todas las funciones de esta clase son reentrantes.

Tipos Públicos

enum	BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset }
enum	Position { InFlow, FloatLeft, FloatRight }

Funciones Públicas

	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

Descripción Detallada

Un marco de texto agrupa uno o más bloques de texto, proporcionando una capa de estructura mayor que el párrafo. El formato de un marco especifica cómo se renderiza y posiciona en la pantalla. No especifica directamente el comportamiento del formato del texto en su interior, pero proporciona restricciones sobre la disposición de sus hijos.

El formato del marco define width() y height() del marco en la pantalla. Cada marco puede tener un border() que rodea su contenido con una caja rectangular. El borde está rodeado por un margin() alrededor del marco, y el contenido del marco se mantiene separado del borde por el padding() del marco. Este esquema es similar al modelo de caja utilizado por las hojas de estilo en cascada para las páginas HTML.

Diagrama que muestra cómo se colocan el relleno, el borde y el margen alrededor del rectángulo de contenido de texto.

El position() de un marco se establece usando setPosition() y determina cómo está situado en relación al texto circundante.

La validez de un objeto QTextFrameFormat puede determinarse con la función isValid().

Véase también QTextFrame y QTextBlockFormat.

Documentación de tipos de miembros

enum QTextFrameFormat::BorderStyle

Este enum describe diferentes estilos de borde para el marco de texto.

Constante	Valor
`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`

Véase también borderStyle() y FrameBorderStyle.

enum QTextFrameFormat::Position

Este enum describe cómo se sitúa un marco con respecto al texto que lo rodea.

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

Véase también position() y CssFloat.

Documentación de las funciones miembro

QTextFrameFormat::QTextFrameFormat()

Construye un objeto de formato marco de texto con las propiedades por defecto.

qreal QTextFrameFormat::border() const

Devuelve la anchura del borde en píxeles.

Véase también setBorder().

QBrush QTextFrameFormat::borderBrush() const

Devuelve el pincel utilizado para el borde del marco.

Véase también setBorderBrush().

QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const

Devuelve el estilo del borde del marco.

Véase también setBorderStyle().

qreal QTextFrameFormat::bottomMargin() const

Devuelve la anchura del margen inferior del marco en píxeles.

Véase también setBottomMargin().

QTextLength QTextFrameFormat::height() const

Devuelve la altura del rectángulo del borde del marco.

Véase también setHeight().

bool QTextFrameFormat::isValid() const

Devuelve true si la descripción del formato es válida; en caso contrario, devuelve false.

qreal QTextFrameFormat::leftMargin() const

Devuelve la anchura del margen izquierdo del marco en píxeles.

Véase también setLeftMargin().

qreal QTextFrameFormat::margin() const

Devuelve la anchura del margen externo del marco en píxeles.

Véase también setMargin().

qreal QTextFrameFormat::padding() const

Devuelve el ancho del relleno interno del marco en píxeles.

Véase también setPadding().

QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const

Devuelve la política de salto de página actualmente establecida para el marco/tabla. Por defecto es QTextFormat::PageBreak_Auto.

Véase también setPageBreakPolicy().

QTextFrameFormat::Position QTextFrameFormat::position() const

Devuelve la política de posicionamiento para las tramas con este formato de trama.

Véase también setPosition().

qreal QTextFrameFormat::rightMargin() const

Devuelve la anchura del margen derecho del marco en píxeles.

Véase también setRightMargin().

void QTextFrameFormat::setBorder(qreal width)

Establece el width (en píxeles) del borde del marco.

Véase también border().

void QTextFrameFormat::setBorderBrush(const QBrush &brush)

Establece el brush utilizado para el borde del marco.

Véase también borderBrush().

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

Establece el style del borde del marco.

Véase también borderStyle().

void QTextFrameFormat::setBottomMargin(qreal margin)

Establece la parte inferior del marco margin en píxeles.

Véase también bottomMargin().

void QTextFrameFormat::setHeight(const QTextLength &height)

Establece el marco height.

Véase también height().

void QTextFrameFormat::setHeight(qreal height)

Establece el marco height.

Se trata de una función sobrecargada.

void QTextFrameFormat::setLeftMargin(qreal margin)

Establece la izquierda del marco margin en píxeles.

Véase también leftMargin().

void QTextFrameFormat::setMargin(qreal margin)

Establece la dirección margin del marco en píxeles. Este método también establece los márgenes izquierdo, derecho, superior e inferior del marco en el mismo valor. Los márgenes individuales anulan el margen general.

Véase también margin().

void QTextFrameFormat::setPadding(qreal width)

Establece el width del relleno interno del marco en píxeles.

Véase también padding().

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

Establece la política de salto de página para el marco/tabla en policy.

Véase también pageBreakPolicy().

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

Establece el policy para posicionar marcos con este formato de marco.

Véase también position().

void QTextFrameFormat::setRightMargin(qreal margin)

Establece la derecha del marco margin en píxeles.

Véase también rightMargin().

void QTextFrameFormat::setTopMargin(qreal margin)

Establece la parte superior del marco margin en píxeles.

Véase también topMargin().

void QTextFrameFormat::setWidth(const QTextLength &width)

Establece el rectángulo de borde del marco en width.

Véase también width() y QTextLength.

void QTextFrameFormat::setWidth(qreal width)

Método de conveniencia que establece la anchura del rectángulo del borde del marco en el valor fijo especificado width.

Se trata de una función sobrecargada.

qreal QTextFrameFormat::topMargin() const

Devuelve la anchura del margen superior del marco en píxeles.

Véase también setTopMargin().

QTextLength QTextFrameFormat::width() const

Devuelve la anchura del rectángulo del borde del marco.

Véase también setWidth() y 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.