En esta página

QTextOption Class

La clase QTextOption ofrece una descripción de las propiedades generales del texto con formato. Más información...

Encabezado: #include <QTextOption>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

struct Tab
enum Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, ShowDefaultIgnorables, …, DisableEmojiParsing }
flags Flags
enum TabType { LeftTab, RightTab, CenterTab, DelimiterTab }
enum WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere }

Funciones públicas

QTextOption()
QTextOption(Qt::Alignment alignment)
QTextOption(const QTextOption &other)
~QTextOption()
Qt::Alignment alignment() const
QTextOption::Flags flags() const
void setAlignment(Qt::Alignment alignment)
void setFlags(QTextOption::Flags flags)
void setTabArray(const QList<qreal> &tabStops)
void setTabStopDistance(qreal tabStopDistance)
void setTabs(const QList<QTextOption::Tab> &tabStops)
void setTextDirection(Qt::LayoutDirection direction)
void setUseDesignMetrics(bool enable)
void setWrapMode(QTextOption::WrapMode mode)
QList<qreal> tabArray() const
qreal tabStopDistance() const
QList<QTextOption::Tab> tabs() const
Qt::LayoutDirection textDirection() const
bool useDesignMetrics() const
QTextOption::WrapMode wrapMode() const
QTextOption &operator=(const QTextOption &other)

Descripción detallada

QTextOption se utiliza para encapsular propiedades comunes de texto enriquecido en un único objeto. Contiene información sobre la alineación del texto, la dirección de maquetación, el ajuste de línea y otras propiedades estándar asociadas a la representación y la maquetación del texto.

Véase también QTextEdit, QTextDocument y QTextCursor.

Documentación sobre los tipos de miembros

enum QTextOption::Flag
flags QTextOption::Flags

ConstanteValorDescripción
QTextOption::IncludeTrailingSpaces0x80000000Cuando se activa esta opción, las funciones QTextLine::naturalTextWidth() y naturalTextRect() devolverán un valor que incluye la anchura de los espacios finales del texto; de lo contrario, dicha anchura queda excluida.
QTextOption::ShowTabsAndSpaces0x1Visualiza los espacios con pequeños puntos y las tabulaciones con pequeñas flechas. Los espacios no separables se muestran de forma diferente a los espacios separables.
QTextOption::ShowLineAndParagraphSeparators0x2Visualiza los separadores de línea y de párrafo con los símbolos adecuados.
QTextOption::ShowDocumentTerminator (since Qt 5.7)0x10Visualiza el final del documento con un signo de sección.
QTextOption::ShowDefaultIgnorables (since Qt 6.9)0x20Representa normalmente los caracteres no visuales si la fuente los admite.
QTextOption::AddSpaceForLineAndParagraphSeparators0x4Al determinar las posiciones de salto de línea, ten en cuenta el espacio añadido para dibujar un carácter separador.
QTextOption::SuppressColors0x8Suprime todos los cambios de color en los formatos de caracteres (excepto la selección principal).
QTextOption::DisableEmojiParsing (since Qt 6.9)0x40Por defecto, Qt detectará secuencias de emojis en las cadenas de entrada y dará prioridad al uso de fuentes de color para mostrarlas. Este paso adicional se puede desactivar configurando el indicador DisableEmojiParsing si se sabe de antemano que no será necesario.

El tipo Flags es un typedef para QFlags<Flag>. Almacena una combinación OR de valores de Flag.

enum QTextOption::TabType

Esta enumeración recoge los diferentes tipos de tabuladores

ConstanteValorDescripción
QTextOption::LeftTab0Tabulación a la izquierda
QTextOption::RightTab1Tabulación a la derecha
QTextOption::CenterTab2Una tabulación centrada
QTextOption::DelimiterTab3Una tabulación que se detiene en un determinado carácter delimitador

enum QTextOption::WrapMode

Esta enumeración describe cómo se ajusta el texto en un documento.

ConstanteValorDescripción
QTextOption::NoWrap0El texto no se ajusta en absoluto.
QTextOption::WordWrap1El texto se ajusta en los límites de las palabras.
QTextOption::ManualWrap2Igual que QTextOption::NoWrap
QTextOption::WrapAnywhere3El texto se puede ajustar en cualquier punto de la línea, incluso si se encuentra en medio de una palabra.
QTextOption::WrapAtWordBoundaryOrAnywhere4Si es posible, el ajuste se produce en el límite de una palabra; de lo contrario, se producirá en el punto adecuado de la línea, incluso en medio de una palabra.

Documentación de las funciones miembro

QTextOption::QTextOption()

Crea una opción de texto con las propiedades predeterminadas para el texto. La propiedad de alineación del texto se establece en « Qt::AlignLeft ». La propiedad de ajuste de línea se establece en « QTextOption::WordWrap ». El indicador de uso de métricas de diseño se establece en «false».

Nota: Al llamar a este constructor, se establecerá la dirección predeterminada del texto en « Qt::LayoutDirectionAuto ».

QTextOption::QTextOption(Qt::Alignment alignment)

Crea una opción de texto con la configuración de alineación de texto ( alignment ) especificada. La propiedad de ajuste de línea se establece en « QTextOption::WordWrap ». El indicador de uso de métricas de diseño se establece en «false».

Nota: Al llamar a este constructor, la dirección predeterminada del texto se establecerá en el valor actual de ` QGuiApplication::layoutDirection()` (que depende de la configuración regional del sistema). Por motivos de compatibilidad con versiones anteriores, esto no coincide con la dirección predeterminada del texto establecida por el constructor predeterminado.

QTextOption::QTextOption(const QTextOption &other)

Crea una copia de la opción de texto « other ».

[noexcept] QTextOption::~QTextOption()

Elimina la opción de texto.

Qt::Alignment QTextOption::alignment() const

Devuelve la alineación del texto definida por la opción.

Véase también setAlignment().

QTextOption::Flags QTextOption::flags() const

Devuelve los indicadores asociados a la opción.

Véase también setFlags().

void QTextOption::setAlignment(Qt::Alignment alignment)

Establece la alineación del texto de la opción según el valor especificado en alignment.

Véase también ` alignment()`.

void QTextOption::setFlags(QTextOption::Flags flags)

Establece los indicadores asociados a la opción en el valor indicado flags.

Véase también flags().

void QTextOption::setTabArray(const QList<qreal> &tabStops)

Establece las posiciones de las tabulaciones para la disposición del texto según lo especificado en tabStops.

Véase también tabArray(), setTabStopDistance() y setTabs().

void QTextOption::setTabStopDistance(qreal tabStopDistance)

Establece la distancia predeterminada, en unidades del dispositivo, entre los puntos de tabulación en el valor especificado en tabStopDistance.

Véase también tabStopDistance(), setTabArray(), setTabs() y tabs().

void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)

Establece las posiciones de las tabulaciones para la disposición del texto según las especificadas en tabStops.

Véanse también tabs() y tabStopDistance().

void QTextOption::setTextDirection(Qt::LayoutDirection direction)

Establece la dirección de la disposición del texto definida por la opción en el direction indicado.

Véase también textDirection().

void QTextOption::setUseDesignMetrics(bool enable)

Si enable es verdadero, el diseño utilizará las métricas de diseño; en caso contrario, utilizará las métricas del dispositivo de pintura (que es el comportamiento predeterminado).

Véase también useDesignMetrics().

void QTextOption::setWrapMode(QTextOption::WrapMode mode)

Establece el modo de ajuste de texto de la opción en el valor especificado: mode.

Véase también wrapMode().

QList<qreal> QTextOption::tabArray() const

Devuelve una lista de las posiciones de tabulación definidas para la disposición del texto.

Véase también setTabArray() y tabStopDistance().

qreal QTextOption::tabStopDistance() const

Devuelve la distancia, en unidades del dispositivo, entre los puntos de tabulación.

Véase también setTabStopDistance(), tabArray(), setTabs() y tabs().

QList<QTextOption::Tab> QTextOption::tabs() const

Devuelve una lista de las posiciones de tabulación definidas para la disposición del texto.

Véase también tabStopDistance(), setTabs() y setTabStopDistance().

Qt::LayoutDirection QTextOption::textDirection() const

Devuelve la dirección de la disposición del texto definida por la opción.

Nota: Por motivos de compatibilidad con versiones anteriores, el valor por defecto de la dirección del texto varía en función del constructor que se utilice. Consulta la documentación de cada constructor para obtener más detalles.

Véase también setTextDirection().

bool QTextOption::useDesignMetrics() const

Devuelve « true » si el diseño utiliza métricas de diseño en lugar de métricas de dispositivo; en caso contrario, devuelve « false ».

Véase también setUseDesignMetrics().

QTextOption::WrapMode QTextOption::wrapMode() const

Devuelve el modo de ajuste de texto definido por la opción.

Véase también setWrapMode().

QTextOption &QTextOption::operator=(const QTextOption &other)

Devuelve « true » si la opción de texto es la misma que la opción de texto « other »; en caso contrario, devuelve « false ».

© 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.