En esta página

TextSelection QML Type

Representa una selección contigua de texto y sus propiedades. Más...

Import Statement: import QtQuick
Since: Qt 6.7

Propiedades

Métodos

Descripción detallada

TextEdit.cursorSelection representa el fragmento de texto que está seleccionado actualmente (por ejemplo, al arrastrar el ratón). Se puede utilizar para consultar y modificar el texto seleccionado, así como las propiedades en los formatos character y block.

Además, desde la versión 6.11 es posible crear instancias explícitas no visuales:

TextEdit {
    id: textEdit

    TextSelection {
        id: sel1
    }
}

TextEdit.cursorSelection y cualquier instancia explícita de `TextSelection` puede utilizarse para consultar y modificar los rangos de texto especificados, así como las propiedades en los formatos character y block.

Nota: Esta API se considera una vista previa técnica y puede sufrir cambios o ser eliminada en futuras versiones de Qt.

Véase también TextEdit y QTextCursor.

Documentación de propiedades

alignment : enumeration

La alineación del bloque que contiene el texto seleccionado.

Véase también QTextBlockFormat::alignment().

color : color

El color de primer plano del texto seleccionado.

Véase también QTextCharFormat::foreground().

document : TextDocument [since 6.11]

El objeto ` QQuickTextDocument ` que contiene el texto seleccionado.

Esta propiedad se introdujo en Qt 6.11.

Véase también QtQuick::TextEdit::textDocument.

font : color

La fuente del texto seleccionado.

Véase también QTextCharFormat::font().

selectionEnd : int [since 6.11]

La posición situada después del último carácter de la selección.

Esta propiedad se introdujo en Qt 6.11.

Véase también QtQuick::TextEdit::selectionEnd.

selectionStart : int [since 6.11]

La posición situada antes del primer carácter de la selección.

Esta propiedad se introdujo en Qt 6.11.

Véase también QtQuick::TextEdit::selectionStart.

text : string

El texto seleccionado, sin ningún tipo de formato de texto enriquecido.

Al establecer esta propiedad, el texto seleccionado se sustituye por la cadena indicada.

Documentación del método

[since 6.11] void duplicate()

Copia el texto seleccionado hacia delante, conservando todo el formato en la copia, y termina con la copia como selección.

Por ejemplo, si se selecciona una línea completa, esta función inserta una copia de esa línea justo debajo y selecciona la copia. Si se selecciona una palabra, esta función la copia a la derecha y la selecciona.

Este método se introdujo en Qt 6.11.

[since 6.11] void linkTo(url destination)

Crea un hipervínculo desde el texto seleccionado a destination.

Este método se introdujo en Qt 6.11.

Véase también QTextCharFormat::setAnchorHref().

[since 6.11] void moveSelectionEnd(MoveOperation op, int n)

Mueve selectionEnd n veces según op, que es uno de los valores de la enumeración tal y como se utiliza en moveSelectionStart().

Si se ha llamado a moveSelectionStart() inmediatamente antes, selectionEnd == selectionStart, y esta función lo desplaza desde allí para que quede seleccionado un fragmento de texto.

Este método se introdujo en Qt 6.11.

Véase también QTextCursor::movePosition, QTextCursor::KeepAnchor, moveSelectionStart() y QTextCursor::MoveOperation.

[since 6.11] bool moveSelectionStart(MoveOperation op, int n)

Deselecciona el texto y desplázalo selectionStart n veces según op, que es uno de los siguientes valores de la enumeración:

ConstanteDescripción
TextSelection.NoMoveMantener el cursor donde está
TextSelection.StartDesplazarse al principio del documento.
TextSelection.StartOfLineDesplazarse al principio de la línea actual.
TextSelection.StartOfBlockIr al principio del bloque actual.
TextSelection.StartOfWordIr al principio de la palabra actual.
TextSelection.PreviousBlockIr al principio del bloque anterior.
TextSelection.PreviousCharacterIr al carácter anterior.
TextSelection.PreviousWordIr al principio de la palabra anterior.
TextSelection.UpSubir una línea.
TextSelection.LeftDesplazarse un carácter a la izquierda.
TextSelection.WordLeftDesplázate una palabra a la izquierda.
TextSelection.EndIr al final del documento.
TextSelection.EndOfLineIr al final de la línea actual.
TextSelection.EndOfWordIr al final de la palabra actual.
TextSelection.EndOfBlockIr al final del bloque actual.
TextSelection.NextBlockIr al principio del siguiente bloque.
TextSelection.NextCharacterIr al siguiente carácter.
TextSelection.NextWordIr a la siguiente palabra.
TextSelection.DownDesplázate una línea hacia abajo.
TextSelection.RightDesplazarse un carácter a la derecha.
TextSelection.WordRightDesplázate una palabra hacia la derecha.
TextSelection.NextCellIr al principio de la siguiente celda 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.
TextSelection.PreviousCellIr 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.
TextSelection.NextRowDesplázate a la primera celda nueva de la siguiente fila de la tabla actual.
TextSelection.PreviousRowSe desplaza a la última celda de la fila anterior de la tabla actual.

Devuelve ` true ` si todas las operaciones se han completado correctamente; en caso contrario, devuelve ` false`.

Este método se introdujo en Qt 6.11.

Véase también QTextCursor::movePosition, QTextCursor::MoveAnchor y QTextCursor::MoveOperation.

© 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.