QTextCursor Class
La clase QTextCursor ofrece una API para acceder a los QTextDocuments y modificarlos. Más información...
| Encabezado: | #include <QTextCursor> |
| 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
- QTextCursor 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 | MoveMode { MoveAnchor, KeepAnchor } |
| enum | MoveOperation { NoMove, Start, StartOfLine, StartOfBlock, StartOfWord, …, PreviousRow } |
| enum | SelectionType { Document, BlockUnderCursor, LineUnderCursor, WordUnderCursor } |
Funciones públicas
| QTextCursor() | |
| QTextCursor(QTextDocument *document) | |
| QTextCursor(QTextFrame *frame) | |
| QTextCursor(const QTextBlock &block) | |
| QTextCursor(const QTextCursor &cursor) | |
| ~QTextCursor() | |
| int | anchor() const |
| bool | atBlockEnd() const |
| bool | atBlockStart() const |
| bool | atEnd() const |
| bool | atStart() const |
| void | beginEditBlock() |
| QTextBlock | block() const |
| QTextCharFormat | blockCharFormat() const |
| QTextBlockFormat | blockFormat() const |
| int | blockNumber() const |
| QTextCharFormat | charFormat() const |
| void | clearSelection() |
| int | columnNumber() const |
| QTextList * | createList(const QTextListFormat &format) |
| QTextList * | createList(QTextListFormat::Style style) |
| QTextFrame * | currentFrame() const |
| QTextList * | currentList() const |
| QTextTable * | currentTable() const |
| void | deleteChar() |
| void | deletePreviousChar() |
| QTextDocument * | document() const |
| void | endEditBlock() |
| bool | hasComplexSelection() const |
| bool | hasSelection() const |
| void | insertBlock() |
| void | insertBlock(const QTextBlockFormat &format) |
| void | insertBlock(const QTextBlockFormat &format, const QTextCharFormat &charFormat) |
| void | insertFragment(const QTextDocumentFragment &fragment) |
| QTextFrame * | insertFrame(const QTextFrameFormat &format) |
| void | insertHtml(const QString &html) |
| void | insertImage(const QTextImageFormat &format) |
| void | insertImage(const QString &name) |
| void | insertImage(const QImage &image, const QString &name = QString()) |
| void | insertImage(const QTextImageFormat &format, QTextFrameFormat::Position alignment) |
| QTextList * | insertList(const QTextListFormat &format) |
| QTextList * | insertList(QTextListFormat::Style style) |
(since 6.4) void | insertMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) |
| QTextTable * | insertTable(int rows, int columns, const QTextTableFormat &format) |
| QTextTable * | insertTable(int rows, int columns) |
| void | insertText(const QString &text) |
| void | insertText(const QString &text, const QTextCharFormat &format) |
| bool | isCopyOf(const QTextCursor &other) const |
| bool | isNull() const |
| void | joinPreviousEditBlock() |
| bool | keepPositionOnInsert() const |
| void | mergeBlockCharFormat(const QTextCharFormat &modifier) |
| void | mergeBlockFormat(const QTextBlockFormat &modifier) |
| void | mergeCharFormat(const QTextCharFormat &modifier) |
| bool | movePosition(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = MoveAnchor, int n = 1) |
| int | position() const |
| int | positionInBlock() const |
| void | removeSelectedText() |
| void | select(QTextCursor::SelectionType selection) |
| void | selectedTableCells(int *firstRow, int *numRows, int *firstColumn, int *numColumns) const |
| QString | selectedText() const |
| QTextDocumentFragment | selection() const |
| int | selectionEnd() const |
| int | selectionStart() const |
| void | setBlockCharFormat(const QTextCharFormat &format) |
| void | setBlockFormat(const QTextBlockFormat &format) |
| void | setCharFormat(const QTextCharFormat &format) |
| void | setKeepPositionOnInsert(bool b) |
| void | setPosition(int pos, QTextCursor::MoveMode m = MoveAnchor) |
| void | setVerticalMovementX(int x) |
| void | setVisualNavigation(bool b) |
| void | swap(QTextCursor &other) |
| int | verticalMovementX() const |
| bool | visualNavigation() const |
| bool | operator!=(const QTextCursor &other) const |
| bool | operator<(const QTextCursor &other) const |
| bool | operator<=(const QTextCursor &other) const |
| QTextCursor & | operator=(const QTextCursor &cursor) |
| bool | operator==(const QTextCursor &other) const |
| bool | operator>(const QTextCursor &other) const |
| bool | operator>=(const QTextCursor &other) const |
Descripción detallada
Los cursores de texto son objetos que se utilizan para acceder y modificar el contenido y la estructura subyacente de los documentos de texto a través de una interfaz de programación que imita el comportamiento de un cursor en un editor de texto. QTextCursor contiene información tanto sobre la posición del cursor dentro de un documento de texto ( QTextDocument ) como sobre cualquier selección que haya realizado.
QTextCursor se basa en el comportamiento de un cursor de texto en un editor de texto, proporcionando un medio programático para realizar acciones estándar a través de la interfaz de usuario. Un documento puede considerarse como una única cadena de caracteres. La posición actual del cursor ( position()) se encuentra, por tanto, siempre entre dos caracteres consecutivos de la cadena, o bien antes del primer carácter o después del último carácter de la misma. Los documentos también pueden contener tablas, listas, imágenes y otros objetos además del texto, pero, desde el punto de vista del desarrollador, el documento puede tratarse como una sola cadena larga. Se puede considerar que algunas partes de esa cadena se encuentran dentro de bloques concretos (p. ej., párrafos), o dentro de la celda de una tabla, o del elemento de una lista, u otros elementos estructurales. Cuando nos referimos al «carácter actual», nos referimos al carácter inmediatamente anterior al cursor position() en el documento. Del mismo modo, el «bloque actual» es el bloque que contiene el cursor position().
Un QTextCursor también tiene una posición anchor(). El texto que se encuentra entre anchor() y position() constituye la selección. Si anchor() == position(), no hay selección.
La posición del cursor se puede modificar mediante programación utilizando setPosition() y movePosition(); esta última también se puede utilizar para seleccionar texto. Para las selecciones, véanse selectionStart(), selectionEnd(), hasSelection(), clearSelection() y removeSelectedText().
Si la función ` position()` se encuentra al principio de un bloque, ` atBlockStart()` devuelve ` true`; y si se encuentra al final de un bloque, ` atBlockEnd()` devuelve `true`. La función ` charFormat()` devuelve el formato del carácter actual, y la función ` blockFormat()` devuelve el formato del bloque actual.
Se puede aplicar formato al documento de texto actual mediante las funciones setCharFormat(), mergeCharFormat(), setBlockFormat() y mergeBlockFormat(). Las funciones de «establecimiento» sustituirán el formato del carácter o del bloque actual del cursor, mientras que las funciones de «fusión» añaden las propiedades de formato indicadas al formato actual del cursor. Si el cursor tiene una selección, el formato especificado se aplica a la selección actual. Ten en cuenta que, cuando solo se selecciona una parte de un bloque, el formato del bloque se aplica a todo el bloque. El texto situado en la posición actual del carácter se puede convertir en una lista utilizando createList().
Las eliminaciones se pueden realizar mediante las funciones « deleteChar » (), « deletePreviousChar » () y « removeSelectedText » ().
Se pueden insertar cadenas de texto en el documento con la función insertText(), y bloques (que representan nuevos párrafos) con insertBlock().
Los fragmentos de texto existentes se pueden insertar con insertFragment(), pero, si se desea insertar fragmentos de texto en diversos formatos, suele ser más sencillo utilizar insertText() e indicar un formato de caracteres.
También se pueden insertar en el documento diversos tipos de estructuras de nivel superior con el cursor:
- Las listas son secuencias ordenadas de elementos de bloque decorados con viñetas o símbolos. Se insertan en un formato especificado con insertList().
- Las tablas se insertan con la función insertTable() y se les puede asignar un formato opcional. Contienen una matriz de celdas por las que se puede navegar utilizando el cursor.
- Las imágenes en línea se insertan con ` insertImage()`. La imagen que se va a utilizar puede especificarse en un formato de imagen o por su nombre.
- Los marcos se insertan llamando a insertFrame() con un formato especificado.
Las acciones se pueden agrupar (es decir, tratarse como una única acción para deshacer/rehacer) utilizando beginEditBlock() y endEditBlock().
Los movimientos del cursor se limitan a posiciones válidas. En la escritura latina, esto significa entre dos caracteres consecutivos del texto, antes del primer carácter o después del último. En otros sistemas de escritura, los movimientos del cursor se limitan a «grupos» (por ejemplo, una sílaba en devanagari o una letra base más diacríticos). Funciones como movePosition() y deleteChar() limitan el movimiento del cursor a estas posiciones válidas.
Véase también «Procesamiento de texto enriquecido».
Documentación sobre tipos de miembro
enum QTextCursor::MoveMode
| Constante | Valor | Descripción |
|---|---|---|
QTextCursor::MoveAnchor | 0 | Mueve el ancla a la misma posición que el propio cursor. |
QTextCursor::KeepAnchor | 1 | Mantiene el ancla en su posición actual. |
Si se mantiene el « anchor » () en su posición y se desplaza el « position » (), se seleccionará el texto que hay entre ambos.
enum QTextCursor::MoveOperation
| Constante | Valor | Descripción |
|---|---|---|
QTextCursor::NoMove | 0 | Mantener el cursor donde está |
QTextCursor::Start | 1 | Ir al principio del documento. |
QTextCursor::StartOfLine | 3 | Ir al principio de la línea actual. |
QTextCursor::StartOfBlock | 4 | Ir al principio del bloque actual. |
QTextCursor::StartOfWord | 5 | Ir al principio de la palabra actual. |
QTextCursor::PreviousBlock | 6 | Ir al principio del bloque anterior. |
QTextCursor::PreviousCharacter | 7 | Ir al carácter anterior. |
QTextCursor::PreviousWord | 8 | Ir al principio de la palabra anterior. |
QTextCursor::Up | 2 | Subir una línea. |
QTextCursor::Left | 9 | Desplazarse un carácter a la izquierda. |
QTextCursor::WordLeft | 10 | Desplázate una palabra a la izquierda. |
QTextCursor::End | 11 | Ir al final del documento. |
QTextCursor::EndOfLine | 13 | Ir al final de la línea actual. |
QTextCursor::EndOfWord | 14 | Ir al final de la palabra actual. |
QTextCursor::EndOfBlock | 15 | Ir al final del bloque actual. |
QTextCursor::NextBlock | 16 | Ir al principio del siguiente bloque. |
QTextCursor::NextCharacter | 17 | Ir al siguiente carácter. Si hay texto seleccionado, la primera llamada a « movePosition(NextCharacter, MoveAnchor) » deselecciona el texto sin mover el cursor. |
QTextCursor::NextWord | 18 | Desplazarse a la siguiente palabra. |
QTextCursor::Down | 12 | Desplazarse una línea hacia abajo. |
QTextCursor::Right | 19 | Desplazarse un carácter a la derecha. |
QTextCursor::WordRight | 20 | Desplázate una palabra a la derecha. |
QTextCursor::NextCell | 21 | Ir al principio de la siguiente celda de la tabla dentro de la tabla actual. Si la celda actual es la última de la fila, el cursor se desplazará a la primera celda de la siguiente fila. |
QTextCursor::PreviousCell | 22 | Ir al principio de la celda anterior de la tabla actual. Si la celda actual es la primera de la fila, el cursor se desplazará a la última celda de la fila anterior. |
QTextCursor::NextRow | 23 | Desplázate a la primera celda nueva de la siguiente fila de la tabla actual. |
QTextCursor::PreviousRow | 24 | Se desplaza a la última celda de la fila anterior de la tabla actual. |
Véase también movePosition().
enum QTextCursor::SelectionType
Esta enumeración describe los tipos de selección que se pueden aplicar con la función select().
| Constante | Valor | Descripción |
|---|---|---|
QTextCursor::Document | 3 | Selecciona todo el documento. |
QTextCursor::BlockUnderCursor | 2 | Selecciona el bloque de texto situado debajo del cursor. |
QTextCursor::LineUnderCursor | 1 | Selecciona la línea de texto situada debajo del cursor. |
QTextCursor::WordUnderCursor | 0 | Selecciona la palabra situada debajo del cursor. Si el cursor no se encuentra dentro de una cadena de caracteres seleccionables, no se selecciona ningún texto. |
Documentación de funciones de miembro
QTextCursor::QTextCursor()
Crea un cursor nulo.
[explicit] QTextCursor::QTextCursor(QTextDocument *document)
Crea un cursor que apunta al principio de ` document`.
[explicit] QTextCursor::QTextCursor(QTextFrame *frame)
Crea un cursor que apunta al principio de frame.
[explicit] QTextCursor::QTextCursor(const QTextBlock &block)
Crea un cursor que apunta al principio del archivo « block ».
QTextCursor::QTextCursor(const QTextCursor &cursor)
Crea un nuevo cursor que es una copia de cursor.
[noexcept] QTextCursor::~QTextCursor()
Destruye el « QTextCursor ».
int QTextCursor::anchor() const
Devuelve la posición del ancla; es lo mismo que position() a menos que haya una selección, en cuyo caso position() marca un extremo de la selección y anchor() marca el otro. Al igual que la posición del cursor, la posición del ancla se encuentra entre caracteres.
Véase también position(), setPosition(), movePosition(), selectionStart() y selectionEnd().
bool QTextCursor::atBlockEnd() const
Devuelve ` true ` si el cursor se encuentra al final de un bloque; en caso contrario, devuelve ` false`.
Véase también atBlockStart() y atEnd().
bool QTextCursor::atBlockStart() const
Devuelve « true » si el cursor se encuentra al principio de un bloque; en caso contrario, devuelve « false ».
Véase también atBlockEnd() y atStart().
bool QTextCursor::atEnd() const
Devuelve « true » si el cursor se encuentra al final del documento; en caso contrario, devuelve « false ».
Véase también atStart() y atBlockEnd().
bool QTextCursor::atStart() const
Devuelve « true » si el cursor se encuentra al principio del documento; en caso contrario, devuelve « false ».
Véase también atBlockStart() y atEnd().
void QTextCursor::beginEditBlock()
Indica el inicio de un bloque de operaciones de edición en el documento que, desde el punto de vista de las funciones de deshacer y rehacer, debe aparecer como una única operación.
Por ejemplo:
QTextCursor cursor(textDocument);
cursor.beginEditBlock();
cursor.insertText("Hello");
cursor.insertText("World");
cursor.endEditBlock();
textDocument->undo();La llamada a undo() provocará que se deshagan ambas inserciones, lo que hará que se eliminen tanto «World» como «Hello».
Es posible anidar llamadas a `beginEditBlock` y ` endEditBlock`. El par situado más arriba determinará el alcance de la operación de deshacer/rehacer.
Véase también ` endEditBlock()`.
QTextBlock QTextCursor::block() const
Devuelve el bloque que contiene el cursor.
QTextCharFormat QTextCursor::blockCharFormat() const
Devuelve el formato de caracteres en bloque del bloque en el que se encuentra el cursor.
El formato de caracteres del bloque es el que se utiliza al insertar texto al principio de un bloque vacío.
Véase también setBlockCharFormat().
QTextBlockFormat QTextCursor::blockFormat() const
Devuelve el formato del bloque en el que se encuentra el cursor.
Véase también setBlockFormat() y charFormat().
int QTextCursor::blockNumber() const
Devuelve el número del bloque en el que se encuentra el cursor, o 0 si el cursor no es válido.
Ten en cuenta que esta función solo tiene sentido en documentos que no contengan objetos complejos, como tablas o marcos.
QTextCharFormat QTextCursor::charFormat() const
Devuelve el formato del carácter situado inmediatamente antes del cursor position(). Si el cursor se encuentra al principio de un bloque de texto que no está vacío, se devuelve el formato del carácter situado inmediatamente después del cursor.
Véase también setCharFormat(), insertText() y blockFormat().
void QTextCursor::clearSelection()
Borra la selección actual estableciendo el punto de anclaje en la posición del cursor.
Ten en cuenta que no elimina el texto de la selección.
Véase también removeSelectedText() y hasSelection().
int QTextCursor::columnNumber() const
Devuelve la posición del cursor dentro de la línea en la que se encuentra.
Ten en cuenta que se trata del número de columna relativo a una línea con salto de línea, no relativo al bloque (es decir, al párrafo).
Probablemente te interese llamar a ` positionInBlock()` en su lugar.
Véase también ` positionInBlock()`.
QTextList *QTextCursor::createList(const QTextListFormat &format)
Crea y devuelve una nueva lista con el « format » indicado, y convierte el párrafo actual en el que se encuentra el cursor en el primer elemento de la lista.
Véase también ` insertList()` y ` currentList()`.
QTextList *QTextCursor::createList(QTextListFormat::Style style)
Crea y devuelve una nueva lista con el valor dado de « style », convirtiendo el párrafo actual del cursor en el primer elemento de la lista.
El estilo que se va a utilizar viene definido por la enumeración ` QTextListFormat::Style `.
Esta es una función sobrecargada.
Véanse también « insertList()» y « currentList()».
QTextFrame *QTextCursor::currentFrame() const
Devuelve un puntero al fotograma actual. Devuelve « nullptr » si el cursor no es válido.
Véase también insertFrame().
QTextList *QTextCursor::currentList() const
Devuelve la lista actual si el cursor position() se encuentra dentro de un bloque que forma parte de una lista; en caso contrario, devuelve nullptr.
Véase también insertList() y createList().
QTextTable *QTextCursor::currentTable() const
Devuelve un puntero a la tabla actual si el cursor position() se encuentra dentro de un bloque que forma parte de una tabla; en caso contrario, devuelve nullptr.
Véase también insertTable().
void QTextCursor::deleteChar()
Si no hay texto seleccionado, borra el carácter situado en la posición actual del cursor; en caso contrario, borra el texto seleccionado.
Véase también deletePreviousChar(), hasSelection() y clearSelection().
void QTextCursor::deletePreviousChar()
Si no hay texto seleccionado, borra el carácter situado antes de la posición actual del cursor; en caso contrario, borra el texto seleccionado.
Véase también deleteChar(), hasSelection() y clearSelection().
QTextDocument *QTextCursor::document() const
Devuelve el documento al que está asociado este cursor.
void QTextCursor::endEditBlock()
Indica el final de un bloque de operaciones de edición en el documento que, desde el punto de vista de las funciones de deshacer y rehacer, debe aparecer como una única operación.
Véase también beginEditBlock().
bool QTextCursor::hasComplexSelection() const
Devuelve ` true ` si el cursor contiene una selección que no sea simplemente un rango comprendido entre ` selectionStart()` y ` selectionEnd()`; en caso contrario, devuelve ` false`.
Las selecciones complejas son aquellas que abarcan al menos dos celdas de una tabla; su extensión se especifica mediante selectedTableCells().
bool QTextCursor::hasSelection() const
Devuelve « true » si el cursor contiene una selección; en caso contrario, devuelve « false ».
void QTextCursor::insertBlock()
Inserta un nuevo bloque vacío en la posición del cursor position() con el blockFormat() y el charFormat() actuales.
Véase también setBlockFormat().
void QTextCursor::insertBlock(const QTextBlockFormat &format)
Inserta un nuevo bloque vacío en la posición del cursor position() con el formato de bloque format y el formato de caracteres de bloque actual charFormat().
Esta es una función sobrecargada.
Véase también setBlockFormat().
void QTextCursor::insertBlock(const QTextBlockFormat &format, const QTextCharFormat &charFormat)
Inserta un nuevo bloque vacío en la posición del cursor position() con el formato de bloque format y charFormat como formato de caracteres del bloque.
Esta es una función sobrecargada.
Véase también setBlockFormat().
void QTextCursor::insertFragment(const QTextDocumentFragment &fragment)
Inserta el texto « fragment » en la posición actual position().
QTextFrame *QTextCursor::insertFrame(const QTextFrameFormat &format)
Inserta un marco con el format especificado en la posición actual del cursor position(), desplaza el cursor position() dentro del marco y devuelve el marco.
Si el cursor contiene una selección, toda la selección se desplaza al interior del marco.
Véase también hasSelection().
void QTextCursor::insertHtml(const QString &html)
Inserta el texto « html » en el position() actual. El texto se interpreta como HTML.
Nota: Al utilizar esta función con una hoja de estilo, esta solo se aplicará al bloque actual del documento. Para aplicar una hoja de estilo a todo el documento, utiliza en su lugar QTextDocument::setDefaultStyleSheet().
void QTextCursor::insertImage(const QTextImageFormat &format)
Inserta la imagen definida en format en la dirección actual position().
void QTextCursor::insertImage(const QString &name)
Método práctico para insertar la imagen con la URL name en la URL actual position().
QImage img;
textDocument->addResource(QTextDocument::ImageResource, QUrl("myimage"), img);
cursor.insertImage("myimage");Se trata de una función sobrecargada.
void QTextCursor::insertImage(const QImage &image, const QString &name = QString())
Función de conveniencia para insertar el image dado, con un name opcional, en el position() actual.
Esta es una función sobrecargada.
void QTextCursor::insertImage(const QTextImageFormat &format, QTextFrameFormat::Position alignment)
Inserta la imagen definida por el « format » proporcionado en la posición actual del cursor con el « alignment » especificado.
Esta es una función sobrecargada.
Véase también position().
QTextList *QTextCursor::insertList(const QTextListFormat &format)
Inserta un nuevo bloque en la posición actual y lo convierte en el primer elemento de una lista recién creada con el format especificado. Devuelve la lista creada.
Véase también currentList(), createList() y insertBlock().
QTextList *QTextCursor::insertList(QTextListFormat::Style style)
Inserta un nuevo bloque en la posición actual y lo convierte en el primer elemento de una lista recién creada con el ` style` indicado. Devuelve la lista creada.
Esta es una función sobrecargada.
Véase también currentList(), createList() y insertBlock().
[since 6.4] void QTextCursor::insertMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)
Inserta el texto markdown en la posición actual position(), con el formato Markdown especificado features. El valor predeterminado es el dialecto de GitHub.
Esta función se introdujo en Qt 6.4.
QTextTable *QTextCursor::insertTable(int rows, int columns, const QTextTableFormat &format)
Crea una nueva tabla con el número indicado de rows y columns en el format especificado, la inserta en la posición actual del cursor position() del documento y devuelve el objeto de la tabla. El cursor se desplaza al principio de la primera celda.
La tabla debe contener al menos una fila y una columna.
Véase también currentTable().
QTextTable *QTextCursor::insertTable(int rows, int columns)
Crea una nueva tabla con el número indicado de rows y columns, la inserta en la posición actual del cursor position() en el documento y devuelve el objeto de la tabla. El cursor se desplaza al principio de la primera celda.
La tabla debe tener al menos una fila y una columna.
Esta es una función sobrecargada.
Véase también currentTable().
void QTextCursor::insertText(const QString &text)
Inserta « text » en la posición actual, utilizando el formato de caracteres actual.
Si hay una selección, esta se elimina y se sustituye por « text », por ejemplo:
cursor.clearSelection();
cursor.movePosition(QTextCursor::NextWord, QTextCursor::KeepAnchor);
cursor.insertText("Hello World");Esto borra cualquier selección existente, selecciona la palabra en la que se encuentra el cursor (es decir, desde position() en adelante) y sustituye la selección por la frase «Hello World».
Cualquier carácter de salto de línea ASCII (\n) presente en el texto insertado se transforma en separadores de bloque Unicode, lo que corresponde a las llamadas a insertBlock().
Véanse también charFormat() y hasSelection().
void QTextCursor::insertText(const QString &text, const QTextCharFormat &format)
Inserta « text » en la posición actual con el valor dado « format ».
Esta es una función sobrecargada.
bool QTextCursor::isCopyOf(const QTextCursor &other) const
Devuelve « true » si este cursor y other son copias el uno del otro, es decir, si uno de ellos se creó como copia del otro y ninguno de los dos se ha desplazado desde entonces. Esto es mucho más estricto que la igualdad.
Véanse también operator=() y operator==().
bool QTextCursor::isNull() const
Devuelve ` true ` si el cursor es nulo; en caso contrario, devuelve ` false`. El constructor por defecto crea un cursor nulo.
void QTextCursor::joinPreviousEditBlock()
Al igual que « beginEditBlock » () indica el inicio de un bloque de operaciones de edición que deben aparecer como una única operación a efectos de deshacer/rehacer. Sin embargo, a diferencia de « beginEditBlock » (), no inicia un nuevo bloque, sino que revierte la llamada anterior a « endEditBlock » () y, por lo tanto, hace que las operaciones siguientes formen parte del bloque de edición anterior creado.
Por ejemplo:
QTextCursor cursor(textDocument);
cursor.beginEditBlock();
cursor.insertText("Hello");
cursor.insertText("World");
cursor.endEditBlock();
// ...
cursor.joinPreviousEditBlock();
cursor.insertText("Hey");
cursor.endEditBlock();
textDocument->undo();La llamada a undo() hará que se deshagan las tres inserciones.
Véase también beginEditBlock() y endEditBlock().
bool QTextCursor::keepPositionOnInsert() const
Devuelve si el cursor debe mantener su posición actual cuando se inserta texto en la posición del cursor.
El valor por defecto es false;
Véase también ` setKeepPositionOnInsert()`.
void QTextCursor::mergeBlockCharFormat(const QTextCharFormat &modifier)
Modifica el formato de caracteres del bloque actual (o de todos los bloques incluidos en la selección) con el formato de bloque especificado en modifier.
Véase también setBlockCharFormat().
void QTextCursor::mergeBlockFormat(const QTextBlockFormat &modifier)
Modifica el formato del bloque actual (o de todos los bloques incluidos en la selección) con el formato especificado en modifier.
Véanse también setBlockFormat() y blockFormat().
void QTextCursor::mergeCharFormat(const QTextCharFormat &modifier)
Combina el formato de carácter actual del cursor con las propiedades descritas en el formato modifier. Si el cursor tiene una selección, esta función aplica todas las propiedades establecidas en modifier a todos los formatos de carácter que forman parte de la selección.
Véanse también hasSelection() y setCharFormat().
bool QTextCursor::movePosition(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = MoveAnchor, int n = 1)
Mueve el cursor realizando la operación indicada operation n veces, utilizando el valor especificado mode, y devuelve true si todas las operaciones se han completado correctamente; en caso contrario, devuelve false.
Por ejemplo, si esta función se utiliza repetidamente para desplazarse hasta el final de la siguiente palabra, acabará fallando cuando se alcance el final del documento.
Por defecto, la operación de desplazamiento se realiza una sola vez (n =1).
Si mode es KeepAnchor, el cursor selecciona el texto sobre el que se desplaza. Este es el mismo efecto que consigue el usuario cuando mantiene pulsada la tecla Mayús y mueve el cursor con las teclas de cursor.
Véase también setVisualNavigation().
int QTextCursor::position() const
Devuelve la posición absoluta del cursor dentro del documento. El cursor se sitúa entre caracteres.
Nota: Los «caracteres» en este caso se refieren a la cadena de objetos ` QChar `, es decir, caracteres Unicode de 16 bits, y la posición se considera un índice dentro de esta cadena. Esto no se corresponde necesariamente con grafemas individuales del sistema de escritura, ya que un único grafema puede estar representado por varios caracteres Unicode, como ocurre en el caso de los pares sustitutos, las ligaduras lingüísticas o los signos diacríticos.
Véanse también setPosition(), movePosition(), anchor() y positionInBlock().
int QTextCursor::positionInBlock() const
Devuelve la posición relativa del cursor dentro del bloque. El cursor se sitúa entre caracteres.
Esto equivale a ` position() - block().position()`.
Nota: Los «caracteres» en este caso se refieren a la cadena de objetos ` QChar `, es decir, caracteres Unicode de 16 bits, y la posición se considera un índice dentro de esta cadena. Esto no se corresponde necesariamente con grafemas individuales del sistema de escritura, ya que un único grafema puede estar representado por varios caracteres Unicode, como ocurre en el caso de los pares sustitutos, las ligaduras lingüísticas o los signos diacríticos.
Véase también position().
void QTextCursor::removeSelectedText()
Si hay una selección, se borra su contenido; en caso contrario, no hace nada.
Véase también hasSelection().
void QTextCursor::select(QTextCursor::SelectionType selection)
Selecciona el texto del documento según el valor indicado en « selection ».
void QTextCursor::selectedTableCells(int *firstRow, int *numRows, int *firstColumn, int *numColumns) const
Si la selección abarca varias celdas de la tabla, en ` firstRow ` se introduce el número de la primera fila de la selección, en ` firstColumn ` el número de la primera columna de la selección, y en ` numRows ` y ` numColumns ` el número de filas y columnas de la selección. Si la selección no abarca ninguna celda de la tabla, los resultados son inofensivos, pero no están definidos.
QString QTextCursor::selectedText() const
Devuelve el texto de la selección actual (que puede estar vacío). Solo devuelve el texto, sin información de formato de texto enriquecido. Si deseas obtener un fragmento de documento (es decir, texto enriquecido con formato), utiliza en su lugar selection().
Nota: Si la selección obtenida de un editor abarca un salto de línea, el texto contendrá un carácter separador de párrafo Unicode U+2029 en lugar de un carácter de salto de línea \n. Utiliza QString::replace() para sustituir estos caracteres por saltos de línea.
QTextDocumentFragment QTextCursor::selection() const
Devuelve la selección actual (que puede estar vacía) con toda su información de formato. Si solo quieres el texto seleccionado (es decir, texto sin formato), utiliza en su lugar selectedText().
Nota: A diferencia de ` QTextDocumentFragment::toPlainText()`, ` selectedText()` puede incluir caracteres Unicode especiales, como QChar::ParagraphSeparator.
Véase también QTextDocumentFragment::toPlainText().
int QTextCursor::selectionEnd() const
Devuelve el final de la selección o ` position()` si el cursor no tiene ninguna selección.
Véase también selectionStart(), position() y anchor().
int QTextCursor::selectionStart() const
Devuelve el inicio de la selección o ` position()` si el cursor no tiene ninguna selección.
Véase también selectionEnd(), position() y anchor().
void QTextCursor::setBlockCharFormat(const QTextCharFormat &format)
Establece el formato de caracteres del bloque actual (o de todos los bloques incluidos en la selección) en « format ».
Véase también blockCharFormat().
void QTextCursor::setBlockFormat(const QTextBlockFormat &format)
Establece el formato del bloque actual (o de todos los bloques incluidos en la selección) en « format ».
Véanse también « blockFormat » () y « mergeBlockFormat » ().
void QTextCursor::setCharFormat(const QTextCharFormat &format)
Establece el formato de carácter actual del cursor en el valor especificado en format. Si el cursor tiene una selección, el valor especificado en format se aplica a la selección actual.
Véanse también charFormat(), hasSelection() y mergeCharFormat().
void QTextCursor::setKeepPositionOnInsert(bool b)
Define si el cursor debe mantener su posición actual cuando se inserta texto en la posición actual del cursor.
Si « b » es «true», el cursor mantiene su posición actual cuando se inserta texto en la posición del cursor. Si « b » es «false», el cursor se desplaza junto con el texto insertado.
El valor por defecto es «false».
Ten en cuenta que el cursor siempre se desplaza cuando se inserta texto antes de su posición actual, y siempre mantiene su posición cuando se inserta texto después de su posición actual.
Véase también keepPositionOnInsert().
void QTextCursor::setPosition(int pos, QTextCursor::MoveMode m = MoveAnchor)
Mueve el cursor a la posición absoluta del documento especificada por pos utilizando un MoveMode especificado por m. El cursor se sitúa entre caracteres.
Nota: Los «caracteres» en este caso se refieren a la cadena de objetos QChar, es decir, caracteres Unicode de 16 bits, y pos se considera un índice dentro de esta cadena. Esto no se corresponde necesariamente con grafemas individuales del sistema de escritura, ya que un único grafema puede estar representado por varios caracteres Unicode, como ocurre en el caso de los pares sustitutos, las ligaduras lingüísticas o los signos diacríticos. Para un enfoque más genérico a la hora de navegar por el documento, utiliza movePosition(), que respetará los límites reales de los grafemas en el texto.
Véase también position(), movePosition() y anchor().
void QTextCursor::setVerticalMovementX(int x)
Establece la posición visual x para los movimientos verticales del cursor en x.
La posición x del movimiento vertical se borra automáticamente cuando el cursor se desplaza horizontalmente, y se mantiene sin cambios cuando el cursor se desplaza verticalmente. Este mecanismo permite que el cursor se desplace hacia arriba y hacia abajo en una línea visualmente recta con fuentes proporcionales, y que «salte» suavemente sobre líneas cortas.
Un valor de -1 indica que no hay ninguna posición x predefinida. En ese caso, se establecerá automáticamente la próxima vez que el cursor se mueva hacia arriba o hacia abajo.
Véase también verticalMovementX().
void QTextCursor::setVisualNavigation(bool b)
Establece la navegación visual en « b ».
La navegación visual consiste en omitir los párrafos de texto ocultos. El valor por defecto es «false».
Véase también visualNavigation() y movePosition().
[noexcept] void QTextCursor::swap(QTextCursor &other)
Cambia esta instancia del cursor de texto por other. Esta operación es muy rápida y nunca falla.
int QTextCursor::verticalMovementX() const
Devuelve la posición x visual para los movimientos verticales del cursor.
Un valor de -1 indica que no hay una posición x predefinida. En ese caso, se establecerá automáticamente la próxima vez que el cursor se mueva hacia arriba o hacia abajo.
Véase también setVerticalMovementX().
bool QTextCursor::visualNavigation() const
Devuelve « true » si el cursor realiza navegación visual; en caso contrario, devuelve « false ».
La navegación visual consiste en saltarse los párrafos de texto ocultos. El valor por defecto es false.
Véase también setVisualNavigation() y movePosition().
bool QTextCursor::operator!=(const QTextCursor &other) const
Devuelve « true » si el cursor « other » se encuentra en una posición diferente del documento respecto a este cursor; en caso contrario, devuelve « false ».
bool QTextCursor::operator<(const QTextCursor &other) const
Devuelve « true » si el cursor « other » se encuentra en una posición posterior en el documento con respecto a este cursor; en caso contrario, devuelve « false ».
bool QTextCursor::operator<=(const QTextCursor &other) const
Devuelve « true » si el cursor other se encuentra en una posición posterior o en la misma posición en el documento que este cursor; en caso contrario, devuelve «false».
QTextCursor &QTextCursor::operator=(const QTextCursor &cursor)
Crea una copia de ` cursor ` y la asigna a ` QTextCursor`. Ten en cuenta que ` QTextCursor ` es una clase compartida implícitamente.
bool QTextCursor::operator==(const QTextCursor &other) const
Devuelve « true » si el cursor « other » se encuentra en la misma posición del documento que este cursor; en caso contrario, devuelve « false ».
bool QTextCursor::operator>(const QTextCursor &other) const
Devuelve « true » si el cursor « other » se encuentra en una posición anterior a la de este cursor en el documento; en caso contrario, devuelve « false ».
bool QTextCursor::operator>=(const QTextCursor &other) const
Devuelve « true » si el cursor « other » se encuentra en una posición anterior o en la misma posición del documento que este cursor; 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.