QTextOption Class
La clase QTextOption proporciona una descripción de las propiedades generales del texto enriquecido. Más...
| Cabecera: | #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 es parte de las APIs 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 acerca de la alineación del texto, la dirección del diseño, el ajuste de palabras y otras propiedades estándar asociadas con la representación y el diseño del texto.
Ver también QTextEdit, QTextDocument, y QTextCursor.
Documentación de tipos de miembros
enum QTextOption::Flag
flags QTextOption::Flags
| Constante | Valor | Descripción |
|---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | Cuando esta opción está establecida, QTextLine::naturalTextWidth() y naturalTextRect() devolverán un valor que incluye el ancho de los espacios finales del texto; en caso contrario, este ancho se excluye. |
QTextOption::ShowTabsAndSpaces | 0x1 | Los espacios se visualizan con puntitos y los tabuladores con flechitas. Los espacios que no se rompen se muestran de forma diferente a los espacios que se rompen. |
QTextOption::ShowLineAndParagraphSeparators | 0x2 | Visualice los separadores de línea y de párrafo con los símbolos apropiados. |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | Visualice el final del documento con un signo de sección. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9) | 0x20 | Represente normalmente caracteres no visuales si la fuente los admite. |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | Al determinar las posiciones de los saltos de línea, tenga en cuenta el espacio añadido para dibujar un carácter separador. |
QTextOption::SuppressColors | 0x8 | Suprimir 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á las secuencias emoji en las cadenas de entrada y priorizará el uso de fuentes de color para mostrarlas. Este paso extra puede desactivarse estableciendo la bandera 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 Flag.
enum QTextOption::TabType
Este enum contiene los diferentes tipos de tabulador
| Constante | Valor | Descripción |
|---|---|---|
QTextOption::LeftTab | 0 | Tabulador izquierdo |
QTextOption::RightTab | 1 | A la derecha |
QTextOption::CenterTab | 2 | Una tabulación centrada |
QTextOption::DelimiterTab | 3 | Un tabulador que se detiene en un carácter delimitador determinado |
enum QTextOption::WrapMode
Este enum describe cómo se envuelve 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 envuelve en los límites de palabra. |
QTextOption::ManualWrap | 2 | Igual que QTextOption::NoWrap |
QTextOption::WrapAnywhere | 3 | El texto puede ser envuelto en cualquier punto de la línea, incluso si ocurre en medio de una palabra. |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | Si es posible, el ajuste se produce en el límite de la palabra; de lo contrario, se producirá en el punto apropiado de la línea, incluso en medio de una palabra. |
Documentación de las funciones miembro
QTextOption::QTextOption()
Construye 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 palabras se establece en QTextOption::WordWrap. El indicador de uso de métricas de diseño se establece en false.
QTextOption::QTextOption(Qt::Alignment alignment)
Construye una opción de texto con el texto dado en alignment. La propiedad word wrap se establece en QTextOption::WordWrap. La bandera using of design metrics se establece en false.
QTextOption::QTextOption(const QTextOption &other)
Construye una copia de la opción de texto other.
[noexcept] QTextOption::~QTextOption()
Destruye 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 las banderas asociadas a la opción.
Véase también setFlags().
void QTextOption::setAlignment(Qt::Alignment alignment)
Ajusta la alineación del texto de la opción al valor especificado en alignment.
Véase también alignment().
void QTextOption::setFlags(QTextOption::Flags flags)
Establece las banderas asociadas con la opción en la dirección flags.
Véase también flags().
void QTextOption::setTabArray(const QList<qreal> &tabStops)
Establece las posiciones de tabulación para el diseño de texto a las especificadas por tabStops.
Véase también tabArray(), setTabStopDistance() y setTabs().
void QTextOption::setTabStopDistance(qreal tabStopDistance)
Establece la distancia por defecto en unidades de dispositivo entre los tabuladores al valor especificado por tabStopDistance.
Véase también tabStopDistance(), setTabArray(), setTabs() y tabs().
void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)
Establece las posiciones de tabulación para el diseño de texto a las especificadas por tabStops.
Véase 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 la dirección direction.
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 por defecto).
Véase también useDesignMetrics().
void QTextOption::setWrapMode(QTextOption::WrapMode mode)
Establece el modo de ajuste de texto de la opción en mode.
Véase también wrapMode().
QList<qreal> QTextOption::tabArray() const
Devuelve una lista de las posiciones de tabulación definidas para el diseño del texto.
Véase también setTabArray() y tabStopDistance().
qreal QTextOption::tabStopDistance() const
Devuelve la distancia en unidades de dispositivo entre los topes 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 el diseño 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.
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.
