QTextFormat Class
La clase QTextFormat proporciona información de formato para un objeto ` QTextDocument`. Más información...
| Encabezado: | #include <QTextFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado por: | QTextBlockFormat, QTextCharFormat, QTextFrameFormat y QTextListFormat |
- Lista de todos los miembros, incluidos los heredados
- QTextFormat 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 | FormatType { InvalidFormat, BlockFormat, CharFormat, ListFormat, FrameFormat, UserFormat } |
| enum | ObjectTypes { NoObject, ImageObject, TableObject, TableCellObject, UserObject } |
| enum | PageBreakFlag { PageBreak_Auto, PageBreak_AlwaysBefore, PageBreak_AlwaysAfter } |
| flags | PageBreakFlags |
| enum | Property { ObjectIndex, CssFloat, LayoutDirection, OutlinePen, ForegroundBrush, …, UserProperty } |
Funciones públicas
| QTextFormat() | |
| QTextFormat(int type) | |
| QTextFormat(const QTextFormat &other) | |
| ~QTextFormat() | |
| QBrush | background() const |
| bool | boolProperty(int propertyId) const |
| QBrush | brushProperty(int propertyId) const |
| void | clearBackground() |
| void | clearForeground() |
| void | clearProperty(int propertyId) |
| QColor | colorProperty(int propertyId) const |
| qreal | doubleProperty(int propertyId) const |
| QBrush | foreground() const |
| bool | hasProperty(int propertyId) const |
| int | intProperty(int propertyId) const |
| bool | isBlockFormat() const |
| bool | isCharFormat() const |
| bool | isEmpty() const |
| bool | isFrameFormat() const |
| bool | isImageFormat() const |
| bool | isListFormat() const |
| bool | isTableCellFormat() const |
| bool | isTableFormat() const |
| bool | isValid() const |
| Qt::LayoutDirection | layoutDirection() const |
| QTextLength | lengthProperty(int propertyId) const |
| QList<QTextLength> | lengthVectorProperty(int propertyId) const |
| void | merge(const QTextFormat &other) |
| int | objectIndex() const |
| int | objectType() const |
| QPen | penProperty(int propertyId) const |
| QMap<int, QVariant> | properties() const |
| QVariant | property(int propertyId) const |
| int | propertyCount() const |
| void | setBackground(const QBrush &brush) |
| void | setForeground(const QBrush &brush) |
| void | setLayoutDirection(Qt::LayoutDirection direction) |
| void | setObjectIndex(int index) |
| void | setObjectType(int type) |
| void | setProperty(int propertyId, const QList<QTextLength> &value) |
| void | setProperty(int propertyId, const QVariant &value) |
| QString | stringProperty(int propertyId) const |
| void | swap(QTextFormat &other) |
| QTextBlockFormat | toBlockFormat() const |
| QTextCharFormat | toCharFormat() const |
| QTextFrameFormat | toFrameFormat() const |
| QTextImageFormat | toImageFormat() const |
| QTextListFormat | toListFormat() const |
| QTextTableCellFormat | toTableCellFormat() const |
| QTextTableFormat | toTableFormat() const |
| int | type() const |
| operator QVariant() const | |
| bool | operator!=(const QTextFormat &other) const |
| QTextFormat & | operator=(const QTextFormat &other) |
| bool | operator==(const QTextFormat &other) const |
Descripción detallada
Una clase QTextFormat es una clase genérica que se utiliza para describir el formato de partes de un documento de texto enriquecido ( QTextDocument). Las clases derivadas QTextCharFormat, QTextBlockFormat, QTextListFormat y QTextTableFormat suelen ser más útiles y describen el formato que se aplica a partes específicas del documento.
Un formato tiene un tipo de formato ( FormatType ) que especifica los tipos de elementos de texto que puede formatear; por ejemplo, un bloque de texto, una lista, una tabla, etc. Un formato también tiene diversas propiedades (algunas específicas de determinados tipos de formato), tal y como se describe en la enumeración Property. Cada propiedad tiene una propiedad correspondiente.
El tipo de formato viene determinado por ` type()` y el formato se puede comprobar con ` isCharFormat()`, ` isBlockFormat()`, ` isListFormat()`, ` isTableFormat()`, ` isFrameFormat()` y ` isImageFormat()`. Si se determina el tipo, este se puede recuperar con ` toCharFormat()`, ` toBlockFormat()`, ` toListFormat()`, ` toTableFormat()`, ` toFrameFormat()` y ` toImageFormat()`.
Las propiedades de un formato se pueden establecer con las funciones setProperty(), y recuperarse con boolProperty(), intProperty(), doubleProperty() y stringProperty(), según corresponda. Todos los identificadores de propiedad utilizados en el formato se pueden recuperar con allPropertyIds(). Se puede fusionar un formato con otro utilizando merge().
El índice de objeto de un formato se puede establecer mediante setObjectIndex() y recuperarse con objectIndex(). Estos métodos se pueden utilizar para asociar el formato a un QTextObject. Se utiliza para representar listas, marcos y tablas dentro del documento.
Véase también «Procesamiento de texto enriquecido».
Documentación sobre tipos de miembros
enum QTextFormat::FormatType
Esta enumeración describe el elemento de texto que está formateando un objeto ` QTextFormat `.
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::InvalidFormat | -1 | Un formato no válido creado por el constructor por defecto |
QTextFormat::BlockFormat | 1 | El objeto formatea un bloque de texto |
QTextFormat::CharFormat | 2 | El objeto da formato a un único carácter |
QTextFormat::ListFormat | 3 | El objeto da formato a una lista |
QTextFormat::FrameFormat | 5 | El objeto da formato a un marco |
QTextFormat::UserFormat | 100 |
Véase también QTextCharFormat, QTextBlockFormat, QTextListFormat, QTextTableFormat y type().
enum QTextFormat::ObjectTypes
Esta enumeración describe a qué tipo de « QTextObject » está asociado este formato.
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::NoObject | 0 | |
QTextFormat::ImageObject | 1 | |
QTextFormat::TableObject | 2 | |
QTextFormat::TableCellObject | 3 | |
QTextFormat::UserObject | 0x1000 | El primer objeto que se puede utilizar para fines específicos de la aplicación. |
Véase también QTextObject, QTextTable y QTextObject::format().
enum QTextFormat::PageBreakFlag
flags QTextFormat::PageBreakFlags
Esta enumeración describe cómo se realizan los saltos de página al imprimir. Se corresponde con las propiedades CSS pertinentes.
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::PageBreak_Auto | 0 | El salto de página se determina automáticamente en función del espacio disponible en la página actual |
QTextFormat::PageBreak_AlwaysBefore | 0x001 | El salto de página se realiza siempre antes del párrafo o la tabla |
QTextFormat::PageBreak_AlwaysAfter | 0x010 | Siempre se inicia una nueva página después del párrafo o la tabla |
El tipo `PageBreakFlags` es una definición de tipo (`typedef`) para ` QFlags<PageBreakFlag>`. Almacena una combinación OR de valores de `PageBreakFlag`.
Véase también QTextBlockFormat::pageBreakPolicy(), QTextFrameFormat::pageBreakPolicy() y PageBreakPolicy.
enum QTextFormat::Property
Esta enumeración describe las diferentes propiedades que puede tener un formato.
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::ObjectIndex | 0x0 | El índice del objeto formateado. Véase objectIndex(). |
Propiedades de párrafo y carácter
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::CssFloat | 0x0800 | Cómo se sitúa un marco con respecto al texto circundante |
QTextFormat::LayoutDirection | 0x0801 | La dirección de maquetación del texto en el documento (Qt::LayoutDirection). |
QTextFormat::OutlinePen | 0x810 | |
QTextFormat::ForegroundBrush | 0x821 | |
QTextFormat::BackgroundBrush | 0x820 | |
QTextFormat::BackgroundImageUrl | 0x823 |
Propiedades del párrafo
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::BlockAlignment | 0x1010 | |
QTextFormat::BlockTopMargin | 0x1030 | |
QTextFormat::BlockBottomMargin | 0x1031 | |
QTextFormat::BlockLeftMargin | 0x1032 | |
QTextFormat::BlockRightMargin | 0x1033 | |
QTextFormat::TextIndent | 0x1034 | |
QTextFormat::TabPositions | 0x1035 | Especifica las posiciones de tabulación. Las posiciones de tabulación son estructuras de tipo « QTextOption::Tab » que se almacenan en un « QList » (internamente, en un « QList » <QVariant>). |
QTextFormat::BlockIndent | 0x1040 | |
QTextFormat::LineHeight | 0x1048 | |
QTextFormat::LineHeightType | 0x1049 | |
QTextFormat::BlockNonBreakableLines | 0x1050 | |
QTextFormat::BlockTrailingHorizontalRulerWidth | 0x1060 | El ancho de un elemento de regla horizontal. |
QTextFormat::HeadingLevel | 0x1070 | El nivel de un encabezado; por ejemplo, 1 corresponde a una etiqueta H1 de HTML; en caso contrario, 0. Este valor de enumeración se ha añadido en Qt 5.12. |
QTextFormat::BlockCodeFence | 0x1091 | El carácter utilizado en los «marcos» que rodean un bloque de código Markdown. Si el bloque de código se ha sangrado en lugar de enmarcarse, el bloque no debería tener esta propiedad. Este valor de enumeración se ha añadido en Qt 5.14. |
QTextFormat::BlockQuoteLevel | 0x1080 | La profundidad de las citas anidadas en este bloque: 1 significa que el bloque es una cita de nivel superior. Los bloques que no sean citas no deben tener esta propiedad. Este valor de enumeración se ha añadido en Qt 5.14. |
QTextFormat::BlockCodeLanguage | 0x1090 | El lenguaje de programación de un bloque preformateado o de código. Los bloques que no contengan código no deben tener esta propiedad. Este valor de enumeración se ha añadido en Qt 5.14. |
QTextFormat::BlockMarker | 0x10A0 | El « type of adornment » que se mostrará junto al bloque. Este valor de enumeración se ha añadido en Qt 5.14. |
Propiedades de los caracteres
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::FontFamily | 0x2000 | e{Esta propiedad ha quedado obsoleta.} Utiliza QTextFormat::FontFamilies en su lugar. |
QTextFormat::FontFamilies | 0x1FE7 | |
QTextFormat::FontStyleName | 0x1FE8 | |
QTextFormat::FontPointSize | 0x2001 | |
QTextFormat::FontPixelSize | 0x2009 | |
QTextFormat::FontSizeAdjustment | 0x2002 | Especifica un ajuste entero que se suma al tamaño de fuente base establecido mediante ` FontPointSize ` o ` FontPixelSize`. |
QTextFormat::FontFixedPitch | 0x2008 | |
QTextFormat::FontWeight | 0x2003 | |
QTextFormat::FontItalic | 0x2004 | |
QTextFormat::FontUnderline | 0x2005 | Esta propiedad ha quedado obsoleta. Utilice en su lugar QTextFormat::TextUnderlineStyle. |
QTextFormat::FontOverline | 0x2006 | |
QTextFormat::FontStrikeOut | 0x2007 | |
QTextFormat::FontCapitalization | FirstFontProperty | Especifica el tipo de mayúsculas que se aplicará al texto. |
QTextFormat::FontLetterSpacingType | 0x1FE9 | Especifica el significado de la propiedad FontLetterSpacing. El valor por defecto es QFont::PercentageSpacing. |
QTextFormat::FontLetterSpacing | 0x1FE1 | Modifica el espaciado predeterminado entre las letras individuales de la fuente. El valor se especifica como porcentaje o como valor absoluto, dependiendo de FontLetterSpacingType. El valor predeterminado es 100 %. |
QTextFormat::FontWordSpacing | 0x1FE2 | Modifica el espaciado predeterminado entre palabras. Un valor positivo aumenta el espaciado entre palabras en los píxeles correspondientes; un valor negativo lo reduce. |
QTextFormat::FontStretch | 0x1FEA | Corresponde a la propiedad « QFont::Stretch » |
QTextFormat::FontStyleHint | 0x1FE3 | Corresponde a la propiedad QFont::StyleHint |
QTextFormat::FontStyleStrategy | 0x1FE4 | Corresponde a la propiedad QFont::StyleStrategy |
QTextFormat::FontKerning | 0x1FE5 | Especifica si el kerning de la fuente está activado. |
QTextFormat::FontHintingPreference | 0x1FE6 | Controla el uso del hinting según los valores de la enumeración ` QFont::HintingPreference `. |
QTextFormat::FontFeatures | 0x2010 | [desde la versión 6.11] Asigna números enteros a las características tipográficas. Consulta QFont::setFeature() para obtener más información. |
QTextFormat::FontVariableAxes | 0x2011 | [desde la versión 6.11] Asigna números de coma flotante a los ejes variables en las fuentes variables. Véase QFont::setVariableAxis() para obtener más información. |
QTextFormat::TextUnderlineColor | 0x2020 | Especifica el color para dibujar subrayados, sobrelineados y tachados. |
QTextFormat::TextVerticalAlignment | 0x2021 | Especifica el tipo de alineación vertical del texto según los valores de la enumeración QTextCharFormat::VerticalAlignment. |
QTextFormat::TextOutline | 0x2022 | Especifica una QPen utilizada para dibujar el contorno del texto. |
QTextFormat::TextUnderlineStyle | 0x2023 | Especifica el estilo del subrayado del texto según los valores de la enumeración QTextCharFormat::UnderlineStyle. |
QTextFormat::TextToolTip | 0x2024 | Especifica la información sobre herramientas (opcional) que se mostrará para un fragmento de texto. |
QTextFormat::TextSuperScriptBaseline | 0x2025 | Especifica la línea de base (en % de la altura) de los textos en superíndice. |
QTextFormat::TextSubScriptBaseline | 0x2026 | Especifica la línea de base (en % de la altura) de los textos en subíndice. |
QTextFormat::TextBaselineOffset | 0x2027 | Especifica la línea de base (en % de la altura) del texto. Un valor positivo desplaza el texto hacia arriba en el porcentaje correspondiente; un valor negativo lo desplaza hacia abajo. |
QTextFormat::IsAnchor | 0x2030 | |
QTextFormat::AnchorHref | 0x2031 | |
QTextFormat::AnchorName | 0x2032 | |
QTextFormat::ObjectType | 0x2f00 |
Propiedades de la lista
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::ListStyle | 0x3000 | Especifica el estilo utilizado para los elementos de una lista, descrito por los valores de la enumeración « QTextListFormat::Style ». |
QTextFormat::ListIndent | 0x3001 | Especifica la cantidad de sangría utilizada para una lista. |
QTextFormat::ListNumberPrefix | 0x3002 | Define el texto que se antepone a los números de los elementos en las listas numéricas. |
QTextFormat::ListNumberSuffix | 0x3003 | Define el texto que se añade al final de los números de los elementos en las listas numéricas. |
QTextFormat::ListStart (since Qt 6.6) | 0x3004 | Define el primer valor de una lista. |
Propiedades de tablas y marcos
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::FrameBorder | 0x4000 | |
QTextFormat::FrameBorderBrush | 0x4009 | |
QTextFormat::FrameBorderStyle | 0x4010 | Consulte la enumeración « BorderStyle ». |
QTextFormat::FrameBottomMargin | 0x4006 | |
QTextFormat::FrameHeight | 0x4004 | |
QTextFormat::FrameLeftMargin | 0x4007 | |
QTextFormat::FrameMargin | 0x4001 | |
QTextFormat::FramePadding | 0x4002 | |
QTextFormat::FrameRightMargin | 0x4008 | |
QTextFormat::FrameTopMargin | 0x4005 | |
QTextFormat::FrameWidth | 0x4003 | |
QTextFormat::TableCellSpacing | 0x4102 | |
QTextFormat::TableCellPadding | 0x4103 | |
QTextFormat::TableColumns | 0x4100 | |
QTextFormat::TableColumnWidthConstraints | 0x4101 | |
QTextFormat::TableHeaderRowCount | 0x4104 | |
QTextFormat::TableBorderCollapse | 0x4105 | Especifica la propiedad « QTextTableFormat::borderCollapse ». |
Propiedades de las celdas de la tabla
| Constante | Valor |
|---|---|
QTextFormat::TableCellRowSpan | 0x4810 |
QTextFormat::TableCellColumnSpan | 0x4811 |
QTextFormat::TableCellLeftPadding | 0x4814 |
QTextFormat::TableCellRightPadding | 0x4815 |
QTextFormat::TableCellTopPadding | 0x4812 |
QTextFormat::TableCellBottomPadding | 0x4813 |
Propiedades de las celdas de la tabla destinadas a utilizarse con la función « QTextTableFormat::borderCollapse » activada
| Constante | Valor |
|---|---|
QTextFormat::TableCellTopBorder | 0x4816 |
QTextFormat::TableCellBottomBorder | 0x4817 |
QTextFormat::TableCellLeftBorder | 0x4818 |
QTextFormat::TableCellRightBorder | 0x4819 |
QTextFormat::TableCellTopBorderStyle | 0x481a |
QTextFormat::TableCellBottomBorderStyle | 0x481b |
QTextFormat::TableCellLeftBorderStyle | 0x481c |
QTextFormat::TableCellRightBorderStyle | 0x481d |
QTextFormat::TableCellTopBorderBrush | 0x481e |
QTextFormat::TableCellBottomBorderBrush | 0x481f |
QTextFormat::TableCellLeftBorderBrush | 0x4820 |
QTextFormat::TableCellRightBorderBrush | 0x4821 |
Propiedades de la imagen
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::ImageName | 0x5000 | El nombre del archivo o la fuente de la imagen. |
QTextFormat::ImageTitle | 0x5001 | El atributo «title» de una etiqueta de imagen HTML, o la cadena entre comillas que aparece después de la URL en un enlace de imagen Markdown. Este valor de enumeración se ha añadido en Qt 5.14. |
QTextFormat::ImageAltText | 0x5002 | El atributo «alt» de una etiqueta de imagen HTML, o la descripción de la imagen en un enlace de imagen de Markdown. Este valor de la enumeración se ha añadido en Qt 5.14. |
QTextFormat::ImageWidth | 0x5010 | |
QTextFormat::ImageHeight | 0x5011 | |
QTextFormat::ImageQuality | 0x5014 | |
QTextFormat::ImageMaxWidth | 0x5015 | Este valor de enumeración se ha añadido en Qt 6.8. |
Propiedades de selección
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::FullWidthSelection | 0x06000 | Cuando se establece en el `characterFormat` de una selección, se mostrará seleccionado todo el ancho del texto. |
Propiedades de salto de página
| Constante | Valor | Descripción |
|---|---|---|
QTextFormat::PageBreakPolicy | 0x7000 | Especifica cómo se dividen las páginas. Véase la enumeración « PageBreakFlag ». |
QTextFormat::UserProperty | 0x100000 |
Véase también property() y setProperty().
Documentación de las funciones de miembro
QTextFormat::QTextFormat()
Crea un nuevo formato de texto con un ` InvalidFormat`.
Véase también « FormatType ».
[explicit] QTextFormat::QTextFormat(int type)
Crea un nuevo formato de texto a partir del archivo type.
Véase también FormatType.
QTextFormat::QTextFormat(const QTextFormat &other)
Crea un nuevo formato de texto con los mismos atributos que el formato de texto « other ».
[noexcept] QTextFormat::~QTextFormat()
Elimina este formato de texto.
QBrush QTextFormat::background() const
Devuelve el pincel utilizado para pintar el fondo del documento.
Véase también setBackground(), clearBackground() y foreground().
bool QTextFormat::boolProperty(int propertyId) const
Devuelve el valor de la propiedad especificada mediante ` propertyId`. Si la propiedad no es de tipo `QTextFormat::Bool`, se devuelve `false` en su lugar.
Véase también setProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() y Property.
QBrush QTextFormat::brushProperty(int propertyId) const
Devuelve el valor de la propiedad especificada en propertyId; si la propiedad no es de tipo QMetaType::QBrush, se devuelve en su lugar Qt::NoBrush.
Véase también setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() y Property.
void QTextFormat::clearBackground()
Borra el pincel utilizado para pintar el fondo del documento. Se utilizará el pincel predeterminado.
Véase también background(), setBackground() y clearForeground().
void QTextFormat::clearForeground()
Borra el pincel utilizado para pintar el primer plano del documento. Se utilizará el pincel predeterminado.
Véase también foreground(), setForeground() y clearBackground().
void QTextFormat::clearProperty(int propertyId)
Borra el valor de la propiedad indicada por propertyId
Véase también Property.
QColor QTextFormat::colorProperty(int propertyId) const
Devuelve el valor de la propiedad indicada en propertyId; si la propiedad no es de tipo QMetaType::QColor, se devuelve un color no válido.
Véase también setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() y Property.
qreal QTextFormat::doubleProperty(int propertyId) const
Devuelve el valor de la propiedad especificada por propertyId. Si la propiedad no es de tipo QMetaType::Double o QMetaType::Float, se devuelve 0 en su lugar.
Véase también setProperty(), boolProperty(), intProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() y Property.
QBrush QTextFormat::foreground() const
Devuelve el pincel utilizado para representar los detalles del primer plano, como el texto, los contornos de los marcos y los bordes de las tablas.
Véase también setForeground(), clearForeground() y background().
bool QTextFormat::hasProperty(int propertyId) const
Devuelve « true » si el formato de texto tiene una propiedad con el valor « propertyId » indicado; en caso contrario, devuelve « false ».
Véase también properties() y Property.
int QTextFormat::intProperty(int propertyId) const
Devuelve el valor de la propiedad especificada por ` propertyId`. Si la propiedad no es de tipo `QTextFormat::Integer`, se devuelve 0 en su lugar.
Véase también setProperty(), boolProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() y Property.
bool QTextFormat::isBlockFormat() const
Devuelve « true » si este formato de texto es « BlockFormat »; en caso contrario, devuelve « false ».
bool QTextFormat::isCharFormat() const
Devuelve « true » si este formato de texto es « CharFormat »; en caso contrario, devuelve « false ».
bool QTextFormat::isEmpty() const
Devuelve «true» si el formato no almacena ninguna propiedad; en caso contrario, devuelve «false».
Véase también propertyCount() y properties().
bool QTextFormat::isFrameFormat() const
Devuelve « true » si este formato de texto es « FrameFormat »; en caso contrario, devuelve « false ».
bool QTextFormat::isImageFormat() const
Devuelve « true » si este formato de texto es un formato de imagen; en caso contrario, devuelve « false ».
bool QTextFormat::isListFormat() const
Devuelve « true » si este formato de texto es « ListFormat »; en caso contrario, devuelve « false ».
bool QTextFormat::isTableCellFormat() const
Devuelve « true » si este formato de texto es « TableCellFormat »; en caso contrario, devuelve « false ».
bool QTextFormat::isTableFormat() const
Devuelve « true » si este formato de texto es « TableFormat »; en caso contrario, devuelve « false ».
bool QTextFormat::isValid() const
Devuelve « true » si el formato es válido (es decir, si no es « InvalidFormat »); en caso contrario, devuelve « false ».
Qt::LayoutDirection QTextFormat::layoutDirection() const
Devuelve la dirección de maquetación del documento.
Véase también setLayoutDirection().
QTextLength QTextFormat::lengthProperty(int propertyId) const
Devuelve el valor de la propiedad indicada en propertyId.
Véase también setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthVectorProperty() y Property.
QList<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const
Devuelve el valor de la propiedad especificada mediante ` propertyId`. Si la propiedad no es de tipo `QTextFormat::LengthVector`, se devuelve una lista vacía en su lugar.
Véase también setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty() y Property.
void QTextFormat::merge(const QTextFormat &other)
Combina el formato de other con este formato; en caso de conflicto, prevalece el formato de other.
int QTextFormat::objectIndex() const
Devuelve el índice del objeto de formato, o -1 si el objeto de formato no es válido.
Véase también setObjectIndex().
int QTextFormat::objectType() const
Devuelve el tipo de objeto del formato de texto.
Véase también ObjectTypes y setObjectType().
QPen QTextFormat::penProperty(int propertyId) const
Devuelve el valor de la propiedad indicada en propertyId; si la propiedad no es de tipo QMetaType::QPen, se devuelve en su lugar Qt::NoPen.
Véase también setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() y Property.
QMap<int, QVariant> QTextFormat::properties() const
Devuelve un mapa con todas las propiedades de este formato de texto.
QVariant QTextFormat::property(int propertyId) const
Devuelve la propiedad especificada por el propertyId dado.
Véase también setProperty() y Property.
int QTextFormat::propertyCount() const
Devuelve el número de propiedades almacenadas en el formato.
void QTextFormat::setBackground(const QBrush &brush)
Establece el pincel que se utilizará para pintar el fondo del documento según lo especificado en brush.
Véase también background(), clearBackground() y setForeground().
void QTextFormat::setForeground(const QBrush &brush)
Establece el pincel de primer plano en el valor especificado brush. El pincel de primer plano se utiliza principalmente para renderizar texto.
Véase también foreground(), clearForeground() y setBackground().
void QTextFormat::setLayoutDirection(Qt::LayoutDirection direction)
Establece la dirección de maquetación del documento en la especificada en direction.
Véase también ` layoutDirection()`.
void QTextFormat::setObjectIndex(int index)
Establece el objeto de formato index.
Véase también objectIndex().
void QTextFormat::setObjectType(int type)
Establece el tipo de objeto del formato de texto como « type ».
Véase también ObjectTypes y objectType().
void QTextFormat::setProperty(int propertyId, const QList<QTextLength> &value)
Establece el valor de la propiedad indicada en propertyId en value.
Véase también property(), lengthVectorProperty() y Property.
void QTextFormat::setProperty(int propertyId, const QVariant &value)
Establece la propiedad especificada por ` propertyId ` con el valor ` value` indicado.
Véase también Property.
QString QTextFormat::stringProperty(int propertyId) const
Devuelve el valor de la propiedad indicada en propertyId; si la propiedad no es de tipo QMetaType::QString, se devuelve una cadena vacía en su lugar.
Véase también setProperty(), boolProperty(), intProperty(), doubleProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() y Property.
void QTextFormat::swap(QTextFormat &other)
Cambia el formato de este texto por « other ». Esta operación es muy rápida y nunca falla.
QTextBlockFormat QTextFormat::toBlockFormat() const
Devuelve este formato como formato de bloque.
QTextCharFormat QTextFormat::toCharFormat() const
Devuelve este formato como formato de caracteres.
QTextFrameFormat QTextFormat::toFrameFormat() const
Devuelve este formato como formato de fotograma.
QTextImageFormat QTextFormat::toImageFormat() const
Devuelve este formato como formato de imagen.
QTextListFormat QTextFormat::toListFormat() const
Devuelve este formato en forma de lista.
QTextTableCellFormat QTextFormat::toTableCellFormat() const
Devuelve este formato como formato de celda de tabla.
QTextTableFormat QTextFormat::toTableFormat() const
Devuelve este formato en forma de tabla.
int QTextFormat::type() const
Devuelve el tipo de este formato.
Véase también FormatType.
QTextFormat::operator QVariant() const
Devuelve el formato de texto como un QVariant
bool QTextFormat::operator!=(const QTextFormat &other) const
Devuelve « true » si este formato de texto es diferente del formato de texto « other ».
QTextFormat &QTextFormat::operator=(const QTextFormat &other)
Asigna el formato de texto « other » a este formato de texto y devuelve una referencia a este formato de texto.
bool QTextFormat::operator==(const QTextFormat &other) const
Devuelve « true » si este formato de texto es el mismo que el formato de texto « other ».
© 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.