En esta página

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

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

ConstanteValorDescripción
QTextCursor::MoveAnchor0Mueve el ancla a la misma posición que el propio cursor.
QTextCursor::KeepAnchor1Mantiene 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

ConstanteValorDescripción
QTextCursor::NoMove0Mantener el cursor donde está
QTextCursor::Start1Ir al principio del documento.
QTextCursor::StartOfLine3Ir al principio de la línea actual.
QTextCursor::StartOfBlock4Ir al principio del bloque actual.
QTextCursor::StartOfWord5Ir al principio de la palabra actual.
QTextCursor::PreviousBlock6Ir al principio del bloque anterior.
QTextCursor::PreviousCharacter7Ir al carácter anterior.
QTextCursor::PreviousWord8Ir al principio de la palabra anterior.
QTextCursor::Up2Subir una línea.
QTextCursor::Left9Desplazarse un carácter a la izquierda.
QTextCursor::WordLeft10Desplázate una palabra a la izquierda.
QTextCursor::End11Ir al final del documento.
QTextCursor::EndOfLine13Ir al final de la línea actual.
QTextCursor::EndOfWord14Ir al final de la palabra actual.
QTextCursor::EndOfBlock15Ir al final del bloque actual.
QTextCursor::NextBlock16Ir al principio del siguiente bloque.
QTextCursor::NextCharacter17Ir al siguiente carácter. Si hay texto seleccionado, la primera llamada a « movePosition(NextCharacter, MoveAnchor) » deselecciona el texto sin mover el cursor.
QTextCursor::NextWord18Desplazarse a la siguiente palabra.
QTextCursor::Down12Desplazarse una línea hacia abajo.
QTextCursor::Right19Desplazarse un carácter a la derecha.
QTextCursor::WordRight20Desplázate una palabra a la derecha.
QTextCursor::NextCell21Ir 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::PreviousCell22Ir 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::NextRow23Desplázate a la primera celda nueva de la siguiente fila de la tabla actual.
QTextCursor::PreviousRow24Se 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().

ConstanteValorDescripción
QTextCursor::Document3Selecciona todo el documento.
QTextCursor::BlockUnderCursor2Selecciona el bloque de texto situado debajo del cursor.
QTextCursor::LineUnderCursor1Selecciona la línea de texto situada debajo del cursor.
QTextCursor::WordUnderCursor0Selecciona 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.