TextSelection QML Type
Representa una selección contigua de texto y sus propiedades. Más...
| Import Statement: | import QtQuick |
| Since: | Qt 6.7 |
Propiedades
- alignment : enumeration
- color : color
- document : TextDocument
(since 6.11) - font : color
- selectionEnd : int
(since 6.11) - selectionStart : int
(since 6.11) - text : string
Métodos
- void duplicate()
(since 6.11) - void linkTo(url destination)
(since 6.11) - void moveSelectionEnd(MoveOperation op, int n)
(since 6.11) - bool moveSelectionStart(MoveOperation op, int n)
(since 6.11)
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:
| Constante | Descripción |
|---|---|
TextSelection.NoMove | Mantener el cursor donde está |
TextSelection.Start | Desplazarse al principio del documento. |
TextSelection.StartOfLine | Desplazarse al principio de la línea actual. |
TextSelection.StartOfBlock | Ir al principio del bloque actual. |
TextSelection.StartOfWord | Ir al principio de la palabra actual. |
TextSelection.PreviousBlock | Ir al principio del bloque anterior. |
TextSelection.PreviousCharacter | Ir al carácter anterior. |
TextSelection.PreviousWord | Ir al principio de la palabra anterior. |
TextSelection.Up | Subir una línea. |
TextSelection.Left | Desplazarse un carácter a la izquierda. |
TextSelection.WordLeft | Desplázate una palabra a la izquierda. |
TextSelection.End | Ir al final del documento. |
TextSelection.EndOfLine | Ir al final de la línea actual. |
TextSelection.EndOfWord | Ir al final de la palabra actual. |
TextSelection.EndOfBlock | Ir al final del bloque actual. |
TextSelection.NextBlock | Ir al principio del siguiente bloque. |
TextSelection.NextCharacter | Ir al siguiente carácter. |
TextSelection.NextWord | Ir a la siguiente palabra. |
TextSelection.Down | Desplázate una línea hacia abajo. |
TextSelection.Right | Desplazarse un carácter a la derecha. |
TextSelection.WordRight | Desplázate una palabra hacia la derecha. |
TextSelection.NextCell | Ir 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.PreviousCell | 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. |
TextSelection.NextRow | Desplázate a la primera celda nueva de la siguiente fila de la tabla actual. |
TextSelection.PreviousRow | Se 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.