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 |
- Lista de todos los miembros, incluidos los heredados
- QTextOption forma parte de las API de procesamiento de texto enriquecido.
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
| Constante | Valor | Descripción |
|---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | Cuando 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::ShowTabsAndSpaces | 0x1 | Visualiza 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::ShowLineAndParagraphSeparators | 0x2 | Visualiza los separadores de línea y de párrafo con los símbolos adecuados. |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | Visualiza el final del documento con un signo de sección. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9) | 0x20 | Representa normalmente los caracteres no visuales si la fuente los admite. |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | Al determinar las posiciones de salto de línea, ten en cuenta el espacio añadido para dibujar un carácter separador. |
QTextOption::SuppressColors | 0x8 | Suprime todos los cambios de color en los formatos de caracteres (excepto la selección principal). |
QTextOption::DisableEmojiParsing (since Qt 6.9) | 0x40 | Por 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
| Constante | Valor | Descripción |
|---|---|---|
QTextOption::LeftTab | 0 | Tabulación a la izquierda |
QTextOption::RightTab | 1 | Tabulación a la derecha |
QTextOption::CenterTab | 2 | Una tabulación centrada |
QTextOption::DelimiterTab | 3 | Una 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.
| Constante | Valor | Descripción |
|---|---|---|
QTextOption::NoWrap | 0 | El texto no se ajusta en absoluto. |
QTextOption::WordWrap | 1 | El texto se ajusta en los límites de las palabras. |
QTextOption::ManualWrap | 2 | Igual que QTextOption::NoWrap |
QTextOption::WrapAnywhere | 3 | El texto se puede ajustar en cualquier punto de la línea, incluso si se encuentra en medio de una palabra. |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | Si 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.