QTextList Class
La clase QTextList proporciona una lista decorada de elementos en un ` QTextDocument`. Más información...
| Encabezado: | #include <QTextList> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QTextBlockGroup |
- Lista de todos los miembros, incluidos los heredados
- QTextList forma parte de las API de procesamiento de texto enriquecido.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| void | add(const QTextBlock &block) |
| int | count() const |
| QTextListFormat | format() const |
| QTextBlock | item(int i) const |
| int | itemNumber(const QTextBlock &block) const |
| QString | itemText(const QTextBlock &block) const |
| void | remove(const QTextBlock &block) |
| void | removeItem(int i) |
| void | setFormat(const QTextListFormat &format) |
Descripción detallada
Una lista contiene una secuencia de bloques de texto, cada uno de los cuales está marcado con una viñeta u otro símbolo. Se pueden utilizar varios niveles de listas, y la función de numeración automática permite crear listas ordenadas numéricamente y alfabéticamente.
Las listas se crean utilizando un cursor de texto para insertar una lista vacía en la posición actual o moviendo texto existente a una nueva lista. La función QTextCursor::insertList() inserta un bloque vacío en el documento en la posición del cursor y lo convierte en el primer elemento de una lista.
QTextListFormat listFormat;
if (list) {
listFormat = list->format();
listFormat.setIndent(listFormat.indent() + 1);
}
listFormat.setStyle(QTextListFormat::ListDisc);
cursor.insertList(listFormat);La función QTextCursor::createList() toma el contenido del bloque actual del cursor y lo convierte en el primer elemento de una nueva lista.
La lista actual del cursor se obtiene con QTextCursor::currentList().
El número de elementos de una lista se obtiene mediante la función « count()». Cada elemento puede obtenerse por su índice en la lista con la función « item()». Del mismo modo, el índice de un elemento determinado puede obtenerse con la función « itemNumber()». El texto de cada elemento puede obtenerse con la función « itemText()».
Ten en cuenta que los elementos de la lista pueden no ser elementos contiguos en el documento. Por ejemplo, los elementos de nivel superior de una lista de varios niveles estarán separados por los elementos de los niveles inferiores de la lista.
Los elementos de la lista se pueden eliminar por su índice mediante la función removeItem(). La función remove() elimina el elemento especificado de la lista.
El formato de la lista se establece con ` setFormat()` y se lee con ` format()`. El formato describe la presentación de la propia lista, y no la de los elementos individuales.
Véase también QTextBlock, QTextListFormat y QTextCursor.
Documentación de las funciones de miembro
void QTextList::add(const QTextBlock &block)
Incluye el elemento block en la lista.
Véase también remove() y removeItem().
int QTextList::count() const
Devuelve el número de elementos de la lista.
QTextListFormat QTextList::format() const
Devuelve el formato de la lista.
Véase también ` setFormat()`.
QTextBlock QTextList::item(int i) const
Devuelve el bloque de texto número i de la lista.
Véase también count() y itemText().
int QTextList::itemNumber(const QTextBlock &block) const
Devuelve el índice del elemento de la lista que corresponde al ` block` indicado. Devuelve -1 si el bloque no estaba presente en la lista.
QString QTextList::itemText(const QTextBlock &block) const
Devuelve el texto del elemento de la lista que se corresponde con el ` block` indicado.
void QTextList::remove(const QTextBlock &block)
Elimina el elemento « block » indicado de la lista.
Véase también add() y removeItem().
void QTextList::removeItem(int i)
Elimina de la lista el elemento situado en la posición i. Cuando se elimina el último elemento de la lista, el QTextDocument al que pertenece la elimina automáticamente.
Véase también add() y remove().
void QTextList::setFormat(const QTextListFormat &format)
Establece el formato de la lista en « format ».
Véase también format().
© 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.