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: |
- Lista de todos los miembros, incluidos los heredados
- QTextFrameFormat forma parte de las API de procesamiento de texto enriquecido y de las clases compartidas implícitamente.
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.

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.
| 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
Esta enumeración describe la posición de un marco respecto al texto que lo rodea.
| Constante | Valor |
|---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
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.