En esta página

QTextFrameFormat Class

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

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

QTextTableFormat

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 un nivel de estructura superior al del párrafo. El formato de un marco especifica cómo se representa y se coloca en la pantalla. No especifica directamente el comportamiento del formato del texto que contiene, pero establece restricciones sobre la disposición de sus elementos hijos.

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

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

La posición de la « position » () de un marco se establece mediante « setPosition » () y determina cómo se sitúa este respecto 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 sobre los tipos de miembros

enum QTextFrameFormat::BorderStyle

Esta enumeración describe los diferentes estilos de borde del marco de texto.

ConstanteValor
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

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

enum QTextFrameFormat::Position

Esta enumeración describe la posición de un marco respecto al texto que lo rodea.

ConstanteValor
QTextFrameFormat::InFlow0
QTextFrameFormat::FloatLeft1
QTextFrameFormat::FloatRight2

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

Documentación de las funciones de miembro

QTextFrameFormat::QTextFrameFormat()

Crea un objeto de formato de marco de texto con las propiedades predeterminadas.

qreal QTextFrameFormat::border() const

Devuelve el ancho 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 el ancho 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 el ancho del margen izquierdo del marco en píxeles.

Véase también setLeftMargin().

qreal QTextFrameFormat::margin() const

Devuelve el ancho 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 saltos de página establecida actualmente para el marco o la tabla. El valor por defecto es « QTextFormat::PageBreak_Auto ».

Véase también setPageBreakPolicy().

QTextFrameFormat::Position QTextFrameFormat::position() const

Devuelve la política de posicionamiento para los marcos con este formato de marco.

Véase también setPosition().

qreal QTextFrameFormat::rightMargin() const

Devuelve el ancho 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 estilo « brush » que se utiliza para el borde del marco.

Véase también borderBrush().

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

Establece el valor de « 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 valor de « height » del fotograma.

Véase también height().

void QTextFrameFormat::setHeight(qreal height)

Establece el valor de « height » del fotograma.

Esta es una función sobrecargada.

void QTextFrameFormat::setLeftMargin(qreal margin)

Establece la coordenada izquierda margin del marco en píxeles.

Véase también leftMargin().

void QTextFrameFormat::setMargin(qreal margin)

Establece el margen superior ( 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 tienen prioridad sobre el margen general.

Véase también margin().

void QTextFrameFormat::setPadding(qreal width)

Establece el valor de « 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 saltos de página del marco o la tabla en « policy ».

Véase también pageBreakPolicy().

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

Establece el parámetro « policy » para el posicionamiento de fotogramas con este formato de fotograma.

Véase también position().

void QTextFrameFormat::setRightMargin(qreal margin)

Establece el borde derecho margin del marco en píxeles.

Véase también rightMargin().

void QTextFrameFormat::setTopMargin(qreal margin)

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

Véase también topMargin().

void QTextFrameFormat::setWidth(const QTextLength &width)

Establece el rectángulo del borde del marco width.

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

void QTextFrameFormat::setWidth(qreal width)

Método de conveniencia que establece el ancho 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 el ancho del margen superior del marco en píxeles.

Véase también setTopMargin().

QTextLength QTextFrameFormat::width() const

Devuelve el ancho 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.