TextInput QML Type
Muestra una línea de texto editable. Más...
Propiedades
- acceptableInput : bool
- activeFocusOnPress : bool
- autoScroll : bool
- bottomPadding : real
- canPaste : bool
- canRedo : bool
- canUndo : bool
- color : color
- contentHeight : real
- contentWidth : real
- cursorDelegate : Component
- cursorPosition : int
- cursorRectangle : rectangle
- cursorVisible : bool
- displayText : string
- echoMode : enumeration
- effectiveHorizontalAlignment : enumeration
- font.bold : bool
- font.capitalization : enumeration
- font.contextFontMerging : bool
(since 6.8) - font.family : string
- font.features : object
(since 6.6) - font.hintingPreference : enumeration
- font.italic : bool
- font.kerning : bool
- font.letterSpacing : real
- font.pixelSize : int
- font.pointSize : real
- font.preferShaping : bool
- font.preferTypoLineMetrics : bool
(since 6.8) - font.strikeout : bool
- font.styleName : string
- font.underline : bool
- font.variableAxes : object
(since 6.7) - font.weight : int
- font.wordSpacing : real
- horizontalAlignment : enumeration
- inputMask : string
- inputMethodComposing : bool
- inputMethodHints : enumeration
- leftPadding : real
- length : int
- maximumLength : int
- mouseSelectionMode : enumeration
- overwriteMode : bool
- padding : real
- passwordCharacter : string
- passwordMaskDelay : int
- persistentSelection : bool
- preeditText : string
- readOnly : bool
- renderType : enumeration
- rightPadding : real
- selectByMouse : bool
- selectedText : string
- selectedTextColor : color
- selectionColor : color
- selectionEnd : int
- selectionStart : int
- text : string
- topPadding : real
- validator : Validator
- verticalAlignment : enumeration
- wrapMode : enumeration
Señales
Métodos
- void clear()
- void copy()
- void cut()
- void deselect()
- void ensureVisible(int position)
- string getText(int start, int end)
- void insert(int position, string text)
- bool isRightToLeft(int start, int end)
- void moveCursorSelection(int position, SelectionMode mode)
- void paste()
- int positionAt(real x, real y, CursorPosition position)
- rect positionToRectangle(int pos)
- void redo()
- void remove(int start, int end)
- void select(int start, int end)
- void selectAll()
- void selectWord()
- void undo()
Descripción detallada
El tipo TextInput muestra una sola línea de texto sin formato editable.
TextInput se utiliza para aceptar la introducción de una línea de texto. Se pueden aplicar restricciones de entrada a un elemento TextInput (por ejemplo, mediante un « validator » o un « inputMask »), y al establecer « echoMode » en un valor adecuado, se permite utilizar TextInput como campo de introducción de contraseña.
Para responder a la acción del usuario al aceptar texto mediante las teclas «Retorno» o «Intro», gestiona la señal « accepted()». Cuando se pulsan «Retorno» o «Intro» y el campo de texto pierde el foco, se emite la señal « editingFinished()». Cuando el usuario edita el texto de cualquier forma, se emite la señal « textEdited()». En la mayoría de los casos, es preferible utilizar estas señales en lugar de « textChanged() ».
En macOS, las combinaciones de teclas Arriba/Abajo para Inicio/Fin están desactivadas explícitamente. Si deseas utilizar dichas combinaciones (en cualquier plataforma), tendrás que crearlas en QML.
Véase también TextEdit y Text.
Documentación de propiedades
acceptableInput : bool [read-only]
Esta propiedad siempre es verdadera, salvo que se haya configurado un validador o una máscara de entrada. Si se ha configurado un validador o una máscara de entrada, esta propiedad solo será verdadera si el texto actual es aceptable para el validador o la máscara de entrada como cadena final (no como cadena intermedia).
activeFocusOnPress : bool
Si el « TextInput » debe recibir el foco activo al pulsar el botón del ratón. Por defecto, esta opción está configurada en «true».
autoScroll : bool
Si el elemento « TextInput » debe desplazarse cuando el texto supera el ancho. Por defecto, está configurado en «true».
Véase también ensureVisible().
Estas propiedades definen el relleno alrededor del contenido. Este espacio se reserva además de las propiedades « contentWidth » y « contentHeight ».
Las propiedades de relleno individuales adoptan el valor de la propiedad « padding », a menos que se establezcan explícitamente. Por ejemplo, si « padding » se establece en « 4 » y « leftPadding » en « 8 », se utilizará « 8 » como relleno izquierdo.
Nota: Si se especifica un ancho o una altura explícitos para un « TextInput », hay que asegurarse de que sean lo suficientemente grandes como para dar cabida a los valores de relleno correspondientes. Por ejemplo: si « topPadding » y « bottomPadding » están establecidos en « 10 », pero la altura de « TextInput » solo está establecida en « 20 », el texto no tendrá suficiente espacio vertical para mostrarse y aparecerá recortado.
canPaste : bool [read-only]
Devuelve «true» si el objeto « TextInput » es escribible y el contenido del portapapeles es adecuado para pegarlo en el objeto « TextInput ».
canRedo : bool [read-only]
Devuelve «true» si el objeto « TextInput » es grabable y hay operaciones de « undone » que se pueden deshacer.
canUndo : bool [read-only]
Devuelve «true» si el objeto « TextInput » es modificable y hay operaciones anteriores que se pueden deshacer.
color : color
El color del texto.
contentHeight : real [read-only]
Devuelve la altura del texto, incluida la parte que sobresale de la altura establecida en caso de que el texto no quepa dentro de dicha altura.
contentWidth : real [read-only]
Devuelve la anchura del texto, incluida la parte que sobresale de la anchura cubierta debido a un ajuste de línea insuficiente, si se ha establecido la opción « wrapMode ».
cursorDelegate : Component
El delegado del cursor en ` TextInput`.
Si se establece un `cursorDelegate` para un ` TextInput`, este delegado se utilizará para dibujar el cursor en lugar del cursor estándar. El ` TextInput ` creará y gestionará una instancia del delegado cuando se necesite un cursor, y la propiedad `x` de la instancia del delegado se establecerá de modo que se sitúe un píxel antes de la esquina superior izquierda del carácter actual.
Ten en cuenta que el elemento raíz del componente delegado debe ser un elemento derivado de « QQuickItem » o « QQuickItem ».
cursorPosition : int
La posición del cursor en la cadena TextInput. El cursor se sitúa entre caracteres.
Nota: En este caso,los caracteres 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 solo 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.
displayText es diferente si echoMode se establece en TextInput.Password: en ese caso, cada passwordCharacter es un carácter «estrecho» (la cursorPosition siempre se desplaza 1), incluso si el texto en TextInput no lo es.
cursorRectangle : rectangle [read-only]
El rectángulo en el que se muestra el cursor de texto estándar dentro del campo de entrada de texto. Solo lectura.
La posición y la altura de un « cursorDelegate » personalizado se actualizan para seguir automáticamente el «cursorRectangle» cuando este cambia. La anchura del delegado no se ve afectada por los cambios en el rectángulo del cursor.
cursorVisible : bool
Se establece en «true» cuando el elemento « TextInput » muestra un cursor.
Esta propiedad se activa y desactiva cuando el TextInput obtiene el foco activo, de modo que otras propiedades puedan vincularse a si el cursor se muestra actualmente o no. Dado que se activa y desactiva automáticamente, cuando establezcas el valor tú mismo debes tener en cuenta que tu valor puede ser sobrescrito.
Se puede establecer directamente en un script, por ejemplo, si un KeyProxy reenvía teclas a este elemento y se desea que parezca activo cuando esto ocurra (pero sin otorgarle realmente el foco activo).
No debe establecerse directamente en el elemento, como en el código QML que se muestra a continuación, ya que el valor especificado se anulará y se perderá al cambiar el foco.
TextInput {
text: "Text"
cursorVisible: false
}En el fragmento de código anterior, el cursor seguirá siendo visible cuando el « TextInput » obtenga el foco activo.
displayText : string [read-only]
Este es el texto que se muestra en el campo « TextInput ».
Si echoMode está establecido en TextInput::Normal, esta propiedad contiene el mismo valor que la propiedad TextInput::text. En caso contrario, esta propiedad contiene el texto visible para el usuario, mientras que la propiedad text contiene el texto introducido realmente.
Nota: A diferencia de la propiedad « TextInput::text », esta contiene el texto introducido parcialmente mediante un método de entrada.
Véase también preeditText.
echoMode : enumeration
Especifica cómo debe mostrarse el texto en TextInput.
| Constante | Descripción |
|---|---|
TextInput.Normal | Muestra el texto tal cual. (Predeterminado) |
TextInput.Password | Muestra el « passwordCharacter » en lugar de los caracteres reales. Durante la edición, los caracteres recién introducidos se muestran en texto sin cifrar durante un breve periodo de tiempo especificado por la propiedad « passwordMaskDelay ». |
TextInput.NoEcho | No muestra nada. |
TextInput.PasswordEchoOnEdit | El contenido se enmascara como en el caso de « TextInput.Password ». Durante la edición, los caracteres recién introducidos se muestran en texto sin cifrar mientras el « TextInput » tenga el foco activo. |
effectiveHorizontalAlignment : enumeration [read-only]
Al utilizar la propiedad adjunta LayoutMirroring::enabled para reflejar los diseños de la aplicación, la alineación horizontal del texto también se reflejará. Sin embargo, la propiedad horizontalAlignment permanecerá sin cambios. Para consultar la alineación horizontal efectiva de TextInput, utiliza la propiedad de solo lectura effectiveHorizontalAlignment.
font.bold : bool
Establece si el grosor de la fuente es negrita.
font.capitalization : enumeration
Establece las mayúsculas del texto.
| Constante | Descripción |
|---|---|
Font.MixedCase | el caso normal: no se aplica ningún cambio en las mayúsculas |
Font.AllUppercase | modifica el texto para que se muestre todo en mayúsculas |
Font.AllLowercase | modifica el texto para que se muestre todo en minúsculas |
Font.SmallCaps | modifica el texto para que se muestre en versalitas |
Font.Capitalize | modifica el texto para que se muestre con la primera letra de cada palabra en mayúscula |
font.contextFontMerging : bool [since 6.8]
Si la fuente seleccionada no contiene un carácter determinado, Qt elige automáticamente una fuente alternativa de aspecto similar que sí lo contenga. Por defecto, esto se hace carácter por carácter.
Esto significa que, en ciertos casos poco habituales, pueden utilizarse muchas fuentes diferentes para representar una misma cadena de texto, incluso si pertenece al mismo alfabeto. Al establecer ` contextFontMerging ` en `true`, se intentará encontrar la fuente alternativa que coincida con el mayor subconjunto de la cadena de entrada. Esto supondrá un mayor coste para las cadenas en las que falten glifos, pero puede ofrecer resultados más coherentes. Por defecto, ` contextFontMerging ` tiene el valor « false ».
Esta propiedad se introdujo en Qt 6.8.
Véase también « QFont::StyleStrategy ».
font.family : string
Establece el nombre de la familia de la fuente.
El nombre de la familia no distingue entre mayúsculas y minúsculas y puede incluir, opcionalmente, el nombre de la fundición, por ejemplo, «Helvetica [Cronyx]». Si la familia está disponible en más de una fundición tipográfica y no se especifica ninguna, se elige una fundición al azar. Si la familia no está disponible, se establecerá una utilizando el algoritmo de coincidencia de fuentes.
font.features : object [since 6.6]
Aplica valores enteros a características específicas de OpenType al dar forma al texto en función del contenido. Esto proporciona un acceso avanzado al proceso de modelado de la fuente y puede utilizarse para admitir características de fuente que, de otro modo, no estarían cubiertas por la API.
Las características de la fuente se representan mediante una correspondencia entre etiquetas de cuatro letras y valores enteros. Este valor entero, que se pasa junto con la etiqueta en la mayoría de los casos, representa un valor booleano: un valor cero significa que la característica está desactivada, y un valor distinto de cero significa que está activada. Sin embargo, para determinadas características de la fuente, puede tener otras interpretaciones. Por ejemplo, cuando se aplica a la característica « salt », el valor es un índice que especifica la alternativa estilística que se debe utilizar.
Por ejemplo, la característica tipográfica « frac » convertirá las fracciones diagonales separadas por una barra (como 1/2) en una representación diferente. Normalmente, esto implicará integrar la fracción completa en un solo ancho de carácter (como ½).
Si una fuente es compatible con la característica « frac », se puede habilitar en el shaper tal y como se muestra en el siguiente código:
Text {
text: "One divided by two is 1/2"
font.family: "MyFractionFont"
font.features: { "frac": 1 }
}Se pueden asignar valores a varias características en la misma asignación. Por ejemplo, si también quieres desactivar el kerning de la fuente, puedes desactivarlo explícitamente de la siguiente manera:
Text {
text: "One divided by two is 1/2"
font.family: "MyFractionFont"
font.features: { "frac": 1, "kern": 0 }
}También puedes recopilar las propiedades de la fuente en un objeto:
Text {
text: "One divided by two is 1/2"
font: {
family: "MyFractionFont"
features: { "frac": 1, "kern": 0 }
}
}Nota: Por defecto, Qt activará y desactivará determinadas características de fuente en función de otras propiedades de la misma. En concreto, la función « kern » se activará o desactivará en función de la propiedad « font::kerning ». Además, todas las funciones de ligadura (liga, clig,
dlig, hlig) se desactivarán si se establece font.letterSpacing, pero solo para los sistemas de escritura en los que el uso de ligaduras es meramente estético. En los sistemas de escritura en los que las ligaduras son necesarias, las funciones permanecerán en su estado predeterminado. Los valores establecidos mediante font.features anularán el comportamiento predeterminado. Si, por ejemplo, "kern" se establece en 1, el kerning siempre estará activado, independientemente de si la propiedad font::kerning está establecida en false. Del mismo modo,
si se establece en 0, siempre estará desactivado.
Esta propiedad se introdujo en Qt 6.6.
Véase también QFont::setFeature().
font.hintingPreference : enumeration
Establece el ajuste de contornos preferido para el texto.
Se trata de una indicación para que el sistema de representación de texto subyacente utilice un determinado nivel de «hinting», y su compatibilidad varía según las plataformas. Consulte la tabla de la documentación de QFont::HintingPreference para obtener más detalles.
Nota: Esta propiedad solo surte efecto cuando se utiliza junto con el tipo de representación Text.NativeRendering.
| Constante | Descripción |
|---|---|
Font.PreferDefaultHinting | Utiliza el nivel de hinting predeterminado para la plataforma de destino. |
Font.PreferNoHinting | Si es posible, renderiza el texto sin aplicar hinting a los contornos de los glifos. La disposición del texto será tipográficamente precisa, utilizando las mismas métricas que se emplean, por ejemplo, en la impresión. |
Font.PreferVerticalHinting | Si es posible, renderiza el texto sin hinting horizontal, pero alinea los glifos con la cuadrícula de píxeles en dirección vertical. El texto aparecerá más nítido en pantallas cuya densidad sea demasiado baja para ofrecer una representación precisa de los glifos. Sin embargo, dado que las métricas horizontales de los glifos no están ajustadas, la disposición del texto será escalable a dispositivos de mayor densidad (como las impresoras) sin que se vean afectados detalles como los saltos de línea. |
Font.PreferFullHinting | Si es posible, representa el texto con hinting tanto en dirección horizontal como vertical. El texto se modificará para optimizar la legibilidad en el dispositivo de destino, pero, dado que las métricas dependerán del tamaño de destino del texto, las posiciones de los glifos, los saltos de línea y otros detalles tipográficos no se adaptarán, lo que significa que el diseño del texto puede verse diferente en dispositivos con distintas densidades de píxeles. |
font.italic : bool
Establece si la fuente tiene estilo cursivo.
font.kerning : bool
Activa o desactiva la función OpenType de kerning al dar forma al texto. Desactivarla puede mejorar el rendimiento al crear o modificar el texto, aunque a costa de perder algunas características estéticas. El valor por defecto es « true ».
Text { text: "OATS FLAVOUR WAY"; font.kerning: false }font.letterSpacing : real
Establece el espaciado entre letras de la fuente.
El espaciado entre letras modifica el espaciado predeterminado entre las letras individuales de la fuente. Un valor positivo aumenta el espaciado entre letras en los píxeles correspondientes; un valor negativo lo reduce.
font.pixelSize : int
Establece el tamaño de la fuente en píxeles.
El uso de esta función hace que la fuente dependa del dispositivo. Utiliza pointSize para establecer el tamaño de la fuente de forma independiente del dispositivo.
font.pointSize : real
Establece el tamaño de la fuente en puntos. El tamaño en puntos debe ser superior a cero.
font.preferShaping : bool
A veces, una fuente aplica reglas complejas a un conjunto de caracteres para que se muestren correctamente. En algunos sistemas de escritura, como las escrituras brahmicas, esto es necesario para que el texto sea legible, pero en la escritura latina, por ejemplo, se trata simplemente de una característica estética. Al establecer la propiedad « preferShaping » en «false», se desactivarán todas estas características cuando no sean necesarias, lo que mejorará el rendimiento en la mayoría de los casos.
El valor por defecto es « true ».
Text { text: "Some text"; font.preferShaping: false }font.preferTypoLineMetrics : bool [since 6.8]
Conjuntos alternativos de métricas de líneas verticales que proporcionan el « ascent », el « descent » y el « leading » de la fuente. A menudo se les conoce como métricas «win» (de Windows) y métricas «typo» (tipográficas). Aunque la especificación recomienda utilizar las métricas typo para el interlineado, muchas aplicaciones prefieren las métricas win, a menos que se haya establecido el indicador USE_TYPO_METRICS en el campo fsSelection de la fuente. Por motivos de compatibilidad con versiones anteriores, esto también se aplica a las aplicaciones Qt. Esto no supone ningún problema para las fuentes que establecen el indicador « USE_TYPO_METRICS » para indicar que las métricas « typo » son válidas, ni para aquellas en las que las métricas « win » y « typo » coinciden. Sin embargo, en determinadas fuentes, las métricas « win » pueden ser mayores que el interlineado preferido y el indicador « USE_TYPO_METRICS » puede estar desactivado por error. En el caso de estas fuentes, establecer « font.preferTypoLineMetrics » puede ofrecer mejores resultados.
Por defecto, « preferTypoLineMetrics » está establecido en « false ».
Esta propiedad se introdujo en Qt 6.8.
Véase también QFont::StyleStrategy.
font.strikeout : bool
Establece si la fuente tiene estilo tachado.
font.styleName : string
Establece el nombre del estilo de la fuente.
El nombre del estilo no distingue entre mayúsculas y minúsculas. Si se establece, la fuente se buscará por el nombre del estilo en lugar de por las propiedades de fuente font.weight, font.bold y font.italic.
font.underline : bool
Establece si el texto aparece subrayado.
font.variableAxes : object [since 6.7]
Aplica valores de coma flotante a los ejes variables en las fuentes variables.
Las fuentes variables permiten almacenar múltiples variaciones (con diferentes grosores, anchos o estilos) en un mismo archivo de fuente. Las variaciones se especifican como valores de coma flotante para un conjunto predefinido de parámetros, denominados «ejes variables». El diseñador de la fuente suele asignar nombres a las instancias específicas y, en Qt, estas se pueden seleccionar mediante setStyleName(), al igual que las subfamilias tradicionales.
En algunos casos, también resulta útil proporcionar valores arbitrarios para los diferentes ejes. Por ejemplo, si una fuente tiene una subfamilia Regular y otra Negrita, es posible que se desee un grosor intermedio entre ambas. En ese caso, se podría solicitar manualmente proporcionando un valor personalizado para el eje «wght» de la fuente.
Text {
text: "Foobar"
font.family: "MyVariableFont"
font.variableAxes: { "wght": (Font.Normal + Font.Bold) / 2.0 }
}Si la fuente admite el eje «wght» y el valor proporcionado se encuentra dentro de su rango definido, se proporcionará una fuente correspondiente al peso 550,0.
Hay algunos ejes estándar que ofrecen muchas fuentes, como «wght» (peso), «wdth» (anchura), «ital» (cursiva) y «opsz» (tamaño óptico). Cada uno de ellos tiene rangos individuales definidos en la propia fuente. Por ejemplo, «wght» puede oscilar entre 100 y 900 (QFont::Thin a QFont::Black), mientras que «ital» puede oscilar entre 0 y 1 (de no cursiva a totalmente cursiva).
Una fuente también puede optar por definir ejes personalizados; la única limitación es que el nombre debe cumplir los requisitos de un QFont::Tag (secuencia de cuatro caracteres Latin-1).
Por defecto, no hay ejes variables configurados.
Nota: En Windows, los ejes variables no son compatibles si se utiliza el backend de fuentes GDI opcional.
Esta propiedad se introdujo en Qt 6.7.
Véase también QFont::setVariableAxis().
font.weight : int
El peso solicitado de la fuente. El peso solicitado debe ser un número entero comprendido entre 1 y 1000, o uno de los valores predefinidos:
| Constante | Descripción |
|---|---|
Font.Thin | 100 |
Font.ExtraLight | 200 |
Font.Light | 300 |
Font.Normal | 400 (por defecto) |
Font.Medium | 500 |
Font.DemiBold | 600 |
Font.Bold | 700 |
Font.ExtraBold | 800 |
Font.Black | 900 |
font.wordSpacing : real
Establece el espaciado entre palabras de la fuente.
El espaciado entre palabras modifica el espaciado predeterminado entre las palabras individuales. Un valor positivo aumenta el espaciado entre palabras en la cantidad correspondiente de píxeles, mientras que un valor negativo lo reduce en la misma medida.
Establece la alineación horizontal del texto dentro de la anchura y la altura del elemento ` TextInput `. Por defecto, la alineación del texto sigue la alineación natural del mismo; por ejemplo, el texto que se lee de izquierda a derecha se alineará a la izquierda.
TextInput No tiene alineación vertical, ya que la altura natural es exactamente la altura de una sola línea de texto. Si se establece la altura manualmente en un valor mayor, « TextInput » siempre se alineará verticalmente en la parte superior. Se pueden utilizar anclajes para alinearlo como se desee dentro de otro elemento.
Los valores válidos para « horizontalAlignment » son « TextInput.AlignLeft », « TextInput.AlignRight » y « TextInput.AlignHCenter ».
Los valores válidos para verticalAlignment son TextInput.AlignTop (por defecto), TextInput.AlignBottom y TextInput.AlignVCenter.
Al utilizar la propiedad asociada LayoutMirroring::enabled para reflejar los diseños de la aplicación, la alineación horizontal del texto también se reflejará. Sin embargo, la propiedad horizontalAlignment permanecerá sin cambios. Para consultar la alineación horizontal efectiva de TextInput, utiliza la propiedad de solo lectura effectiveHorizontalAlignment.
inputMask : string
Te permite configurar una máscara de entrada en TextInput, lo que restringe los textos que se pueden introducir. Consulta QLineEdit::inputMask para obtener más detalles, ya que TextInput utiliza exactamente las mismas cadenas de máscara.
Véase también acceptableInput y validator.
inputMethodComposing : bool [read-only]
Esta propiedad indica si el objeto ` TextInput ` contiene texto parcial introducido mediante un método de entrada.
Durante la redacción, un método de entrada puede basarse en eventos del ratón o del teclado procedentes del « TextInput » para editar o confirmar el texto parcial. Esta propiedad se puede utilizar para determinar cuándo desactivar los controladores de eventos que puedan interferir en el correcto funcionamiento de un método de entrada.
inputMethodHints : enumeration
Proporciona indicaciones al método de entrada sobre el contenido esperado de la entrada de texto y cómo debe funcionar.
El valor es una combinación bit a bit de indicadores, o Qt.ImhNone si no se ha establecido ninguna indicación.
Los indicadores que modifican el comportamiento son:
| Constante | Descripción |
|---|---|
Qt.ImhHiddenText | Los caracteres deben ocultarse, como suele hacerse al introducir contraseñas. |
Ten en cuenta que los IME de Android permiten deliberadamente solo la introducción de caracteres latinos/ASCII en los campos de contraseña.
| Constante | Descripción |
|---|---|
Qt.ImhSensitiveData | El texto escrito no debe ser almacenado por el método de entrada activo en ningún almacenamiento persistente, como el diccionario predictivo del usuario. |
Tenga en cuenta que el marco Qt trata esto como una contraseña visible y, en este caso, los IME de Android permiten deliberadamente solo la introducción de caracteres latinos/ASCII.
| Constante | Descripción |
|---|---|
Qt.ImhNoAutoUppercase | El método de entrada no debe intentar cambiar automáticamente a mayúsculas al finalizar una frase. |
Qt.ImhPreferNumbers | Se prefieren los números (aunque no son obligatorios). |
Qt.ImhPreferUppercase | Se prefieren las mayúsculas (aunque no son obligatorias). |
Qt.ImhPreferLowercase | Se prefieren las letras minúsculas (aunque no son obligatorias). |
Qt.ImhNoPredictiveText | No utilices el texto predictivo (es decir, la búsqueda en el diccionario) mientras escribes. |
Qt.ImhDate | El editor de texto funciona como un campo de fecha. |
Qt.ImhTime | El editor de texto funciona como un campo de hora. |
Los indicadores que restringen la entrada (indicadores exclusivos) son:
| Constante | Descripción |
|---|---|
Qt.ImhDigitsOnly | Solo se permiten dígitos. |
Qt.ImhFormattedNumbersOnly | Solo se permite la introducción de números. Esto incluye el punto decimal y el signo menos. |
Qt.ImhUppercaseOnly | Solo se permite la introducción de letras mayúsculas. |
Qt.ImhLowercaseOnly | Solo se permite introducir letras minúsculas. |
Qt.ImhDialableCharactersOnly | Solo se permiten caracteres aptos para marcar un número de teléfono. |
Qt.ImhEmailCharactersOnly | Solo se permiten caracteres adecuados para direcciones de correo electrónico. |
Qt.ImhUrlCharactersOnly | Solo se permiten caracteres adecuados para direcciones URL. |
Máscaras:
| Constante | Descripción |
|---|---|
Qt.ImhExclusiveInputMask | Esta máscara devuelve un valor distinto de cero si se utiliza cualquiera de los indicadores exclusivos. |
length : int [read-only]
Devuelve el número total de caracteres del elemento « TextInput ».
Si el elemento « TextInput » tiene una máscara de longitud ( inputMask ), la longitud incluirá los caracteres de la máscara y puede diferir de la longitud de la cadena devuelta por la propiedad « text ».
Esta propiedad puede resultar más rápida que consultar la longitud de la propiedad « text », ya que no requiere copiar ni convertir los datos internos de la cadena de la « TextInput ».
maximumLength : int
La longitud máxima permitida del texto en TextInput.
Si el texto es demasiado largo, se trunca al alcanzar el límite.
Por defecto, esta propiedad tiene un valor de 32767.
mouseSelectionMode : enumeration
Especifica cómo se debe seleccionar el texto con el ratón.
| Constante | Descripción |
|---|---|
TextInput.SelectCharacters | (por defecto) La selección se actualiza con caracteres individuales. |
TextInput.SelectWords | La selección se actualiza con palabras completas. |
Esta propiedad solo se aplica cuando « selectByMouse » es «true».
overwriteMode : bool
Si el texto introducido por el usuario sobrescribirá el texto existente.
Al igual que en muchos editores de texto, el control de editor de texto se puede configurar para insertar o sobrescribir el texto existente con el nuevo texto introducido por el usuario.
Si esta propiedad se establece en « true », el texto existente se sobrescribe, carácter por carácter, con el nuevo texto; de lo contrario, el texto se inserta en la posición del cursor, desplazando el texto existente.
Por defecto, esta propiedad está p false (el nuevo texto no sobrescribe el texto existente).
passwordCharacter : string
Este es el carácter que se muestra cuando la opción « echoMode » está configurada en «Password» o «PasswordEchoOnEdit». De forma predeterminada, es el carácter de contraseña utilizado por el tema de la plataforma.
Si esta propiedad se establece en una cadena con más de un carácter, se utiliza el primer carácter. Si la cadena está vacía, se ignora el valor y la propiedad no se establece.
passwordMaskDelay : int
Establece el retraso, en milisegundos, antes de que el carácter visible quede oculto por un carácter de contraseña.
El método reset se invocará al asignarle el valor «undefined».
persistentSelection : bool
Si el « TextInput » debe mantener su selección cuando pierde el foco activo en favor de otro elemento de la escena. Por defecto, está configurado en «false»;
preeditText : string [read-only]
Esta propiedad contiene texto parcial introducido mediante un método de entrada.
Para desactivar el texto parcial resultante de las predicciones, configura el indicador « Qt.ImhNoPredictiveText » en inputMethodHints.
Véase también displayText y inputMethodHints.
readOnly : bool
Establece si las entradas del usuario pueden modificar el contenido de ` TextInput`.
Si readOnly se establece en true, las entradas del usuario no afectarán a la propiedad text. Cualquier enlace o intento de establecer la propiedad text seguirá funcionando.
renderType : enumeration
Sobrescribir el tipo de representación predeterminado para este componente.
Los tipos de representación admitidos son:
| Constante | Descripción |
|---|---|
TextInput.QtRendering | El texto se representa utilizando un campo de distancia escalable para cada glifo. |
TextInput.NativeRendering | El texto se representa utilizando una técnica específica de la plataforma. |
TextInput.CurveRendering | El texto se representa mediante un rasterizador de curvas que se ejecuta directamente en el hardware gráfico. (Introducido en Qt 6.7.0.) |
Selecciona « TextInput.NativeRendering » si prefieres que el texto tenga un aspecto nativo en la plataforma de destino y no necesitas funciones avanzadas como la transformación del texto. El uso de dichas funciones en combinación con el tipo de renderizado «NativeRendering» dará lugar a resultados de baja calidad y, en ocasiones, pixelados.
Tanto « TextInput.QtRendering » como « TextInput.CurveRendering » son técnicas aceleradas por hardware. « QtRendering » es la más rápida de las dos, pero consume más memoria y presenta artefactos de renderizado en tamaños grandes. « CurveRendering » debe considerarse como alternativa en los casos en los que « QtRendering » no ofrezca buenos resultados visuales o cuando sea prioritario reducir el consumo de memoria gráfica.
El tipo de renderizado predeterminado viene determinado por QQuickWindow::textRenderType().
selectByMouse : bool
El valor predeterminado es true.
Si se establece en «true», el usuario puede utilizar el ratón para seleccionar texto de la forma habitual.
Nota: En versiones anteriores a la 6.4, el valor predeterminado era « false »; sin embargo, si se habilitaba esta propiedad, también se podía seleccionar texto en una pantalla táctil arrastrando el dedo por ella. Esto interfería con el movimiento rápido («flicking») cuando se utilizaba « TextInput » dentro de un «Flickable». Para mantener la coherencia con TextField, selectByMouse ahora significa realmente lo que dice: si true, solo se puede seleccionar texto arrastrando con el ratón. Si este cambio no se adapta a tu aplicación, puedes establecer selectByMouse en false, o importar una versión anterior de la API (por ejemplo, import QtQuick 6.3) para volver al comportamiento anterior. La opción de revertir el comportamiento cambiando la versión de importación se eliminará en una versión posterior de Qt.
selectedText : string [read-only]
Esta propiedad de solo lectura proporciona el texto seleccionado actualmente en el campo de entrada de texto.
Es equivalente al siguiente fragmento de código, pero es más rápido y fácil de usar.
myTextInput.text.toString().substring(myTextInput.selectionStart,
myTextInput.selectionEnd);selectedTextColor : color
El color del texto resaltado, que se utiliza en las selecciones.
selectionColor : color
El color de resaltado del texto, que se utiliza detrás de las selecciones.
selectionEnd : int [read-only]
La posición del cursor tras el último carácter de la selección actual.
Esta propiedad es de solo lectura. Para modificar la selección, utiliza select(start,end), selectAll() o selectWord().
Véase también ` selectionStart`, ` cursorPosition` y ` selectedText`.
selectionStart : int [read-only]
La posición del cursor antes del primer carácter de la selección actual.
Esta propiedad es de solo lectura. Para modificar la selección, utiliza select(start,end), selectAll() o selectWord().
Véase también ` selectionEnd`, ` cursorPosition` y ` selectedText`.
text : string
El texto de la propiedad TextInput.
Ten en cuenta que algunos teclados utilizan una función predictiva. En este caso, el texto que se está escribiendo mediante el método de entrada no forma parte de esta propiedad. La parte del texto relacionada con las predicciones aparece subrayada y se almacena en la propiedad « preeditText ». Para obtener el texto completo que se muestra en « TextInput », utiliza la propiedad « displayText ».
Véase también clear(), displayText, preeditText, accepted(), editingFinished() y textEdited().
validator : Validator
Permite configurar un validador en el TextInput. Cuando se configura un validador, el TextInput solo aceptará entradas que dejen la propiedad «text» en un estado aceptable o intermedio. La señal «accepted» solo se enviará si el texto se encuentra en un estado aceptable al pulsar la tecla «Enter».
Los validadores compatibles actualmente son ` IntValidator`, ` DoubleValidator ` y ` RegularExpressionValidator`. A continuación se muestra un ejemplo de uso de validadores, que permite introducir números enteros entre 11 y 31 en el campo de texto:
import QtQuick 2.0
TextInput{
validator: IntValidator{bottom: 11; top: 31;}
focus: true
}Véase también acceptableInput y inputMask.
wrapMode : enumeration
Establece esta propiedad para que el texto se ajuste al ancho del elemento « TextInput ». El texto solo se ajustará si se ha establecido un ancho explícito.
| Constante | Descripción |
|---|---|
TextInput.NoWrap | (por defecto) no se realizará ningún ajuste. Si el texto no contiene suficientes saltos de línea, contentWidth sobrepasará el ancho establecido. |
TextInput.WordWrap | El ajuste se realiza únicamente en los límites de las palabras. Si una palabra es demasiado larga, el « contentWidth » superará el ancho establecido. |
TextInput.WrapAnywhere | El ajuste de línea se realiza en cualquier punto de la línea, incluso si se produce en medio de una palabra. |
TextInput.Wrap | Si es posible, el ajuste de línea se produce en el límite de una palabra; de lo contrario, se producirá en el punto adecuado de la línea, incluso en medio de una palabra. |
El valor por defecto es ` TextInput.NoWrap`. Si se establece un ancho, se recomienda utilizar ` TextInput.Wrap`.
Documentación de Signal
accepted()
Esta señal se emite al pulsar la tecla «Retorno» o «Intro». Ten en cuenta que, si se ha configurado un « validator » o un « inputMask » en el campo de entrada de texto, la señal solo se emitirá si la entrada se encuentra en un estado aceptable.
Nota: El controlador correspondiente es onAccepted.
Véase también editingFinished() y textEdited().
editingFinished()
Esta señal se emite cuando se pulsa la tecla «Retorno» o «Intro», o cuando el campo de texto pierde el foco. Ten en cuenta que, si hay un validador o un « inputMask » configurado en el campo de texto y se pulsa «Intro» o «Retorno», esta señal solo se emitirá si el campo de texto cumple con el « inputMask » y el validador devuelve un estado aceptable.
Nota: El controlador correspondiente es onEditingFinished.
Véase también accepted() y textEdited().
textEdited()
Esta señal se emite cada vez que se edita el texto. A diferencia de « textChanged() », esta señal no se emite cuando el texto se modifica mediante código, por ejemplo, al cambiar el valor de la propiedad « text » o al llamar a « clear() ».
Nota: El controlador correspondiente es onTextEdited.
Véase también ` accepted()` y ` editingFinished()`.
Documentación del método
void clear()
Borra el contenido del campo de texto y restablece el texto introducido parcialmente mediante un método de entrada.
Utiliza este método en lugar de establecer la propiedad « text » en una cadena vacía.
Véase también QInputMethod::reset().
void copy()
Copia el texto seleccionado actualmente al portapapeles del sistema.
Nota: Si el modo de eco está configurado en un modo distinto al Normal, la función de copiar no funcionará. Esto se hace para evitar que se utilice la función de copiar como método para eludir las funciones de contraseña del control de línea.
void cut()
Copia el texto seleccionado actualmente al portapapeles del sistema.
Nota: Si el modo de eco está configurado en un modo distinto al Normal, la función «cortar» no funcionará. Esto es para evitar que se utilice la función «cortar» como método para eludir las funciones de contraseña del control de línea.
void deselect()
Elimina la selección de texto activa.
void ensureVisible(int position)
Desplaza el contenido del campo de texto de forma que el carácter especificado position quede visible dentro de los límites del campo de texto.
Véase también autoScroll.
string getText(int start, int end)
Devuelve la sección de texto que se encuentra entre las posiciones start y end.
Si el TextInput tiene un inputMask, la longitud incluirá los caracteres de la máscara.
void insert(int position, string text)
Inserta « text » en la base de datos « TextInput » en position.
bool isRightToLeft(int start, int end)
Devuelve « true » si la dirección natural de lectura del texto del editor que se encuentra entre las posiciones « start » y « end » es de derecha a izquierda.
void moveCursorSelection(int position, SelectionMode mode)
Mueve el cursor a position y actualiza la selección según el parámetro opcional mode. (Para mover solo el cursor, configura la propiedad cursorPosition.)
Cuando se invoca este método, además establece el « selectionStart » o el « selectionEnd » (el que se encontrara en la posición anterior del cursor) en la posición especificada. Esto permite ampliar y reducir fácilmente el rango de texto seleccionado.
El modo de selección especifica si la selección se actualiza carácter a carácter o palabra a palabra. Si no se especifica, el modo de selección será, por defecto, « TextInput.SelectCharacters ».
| Constante | Descripción |
|---|---|
TextInput.SelectCharacters | Establece « selectionStart » o « selectionEnd » (el que se encontrara en la posición anterior del cursor) en la posición especificada. |
TextInput.SelectWords | Establece « selectionStart » y « selectionEnd » de forma que incluyan todas las palabras entre la posición especificada y la posición anterior del cursor. Se incluyen las palabras que se encuentren parcialmente dentro del rango. |
Por ejemplo, consideremos esta secuencia de llamadas:
cursorPosition = 5
moveCursorSelection(9, TextInput.SelectCharacters)
moveCursorSelection(7, TextInput.SelectCharacters)Esto desplaza el cursor a la posición 5, amplía el final de la selección de 5 a 9 y, a continuación, reduce el final de la selección de 9 a 7, dejando seleccionado el texto desde la posición 5 hasta la 7 (los caracteres 6.º y 7.º).
La misma secuencia con ` TextInput.SelectWords` ampliará el inicio de la selección hasta el límite de una palabra anterior o en la posición 5 y ampliará el final de la selección hasta el límite de una palabra en la posición 9 o más allá de ella.
void paste()
Sustituye el texto seleccionado actualmente por el contenido del portapapeles del sistema.
int positionAt(real x, real y, CursorPosition position)
Esta función devuelve la posición del carácter a una distancia de x y y píxeles desde la esquina superior izquierda del campo de entrada de texto. La posición 0 se encuentra antes del primer carácter, la posición 1 está después del primer carácter pero antes del segundo, y así sucesivamente hasta la posición text.length, que se encuentra después de todos los caracteres.
Esto significa que, para todos los valores de x anteriores al primer carácter, esta función devuelve 0, y para todos los valores de x posteriores al último carácter, devuelve text.length. Si el valor de y está por encima del texto, la posición será la del carácter más cercano de la primera línea; si está por debajo del texto, se devolverá la posición del carácter más cercano de la última línea.
El parámetro « position » del cursor especifica cómo debe resolverse la posición del cursor:
| Constante | Descripción |
|---|---|
TextInput.CursorBetweenCharacters | Devuelve la posición entre los caracteres más cercana a x. Este es el valor por defecto. |
TextInput.CursorOnCharacter | Devuelve la posición anterior al carácter más cercano a x. |
rect positionToRectangle(int pos)
Esta función toma una posición de carácter pos y devuelve el rectángulo que ocuparía el cursor si se situara en esa posición de carácter.
Esto es similar a establecer la posición del carácter ( cursorPosition) y, a continuación, consultar el rectángulo del cursor, pero el valor de la posición del cursor ( cursorPosition ) no se modifica.
void redo()
Vuelve a realizar la última operación si la opción «redo» es « available ».
void remove(int start, int end)
Elimina la sección de texto que se encuentra entre las posiciones « start » y « end » de « TextInput ».
void select(int start, int end)
Hace que se seleccione el texto comprendido entre start y end.
Si el inicio o el final están fuera de rango, la selección no se modifica.
Tras llamar a este método, selectionStart pasará a ser el menor y selectionEnd el mayor (independientemente del orden en que se hayan pasado los parámetros a este método).
Véase también selectionStart y selectionEnd.
void selectAll()
Hace que se seleccione todo el texto.
void selectWord()
Hace que se seleccione la palabra más cercana a la posición actual del cursor.
void undo()
Deshace la última operación si «undo» es « available ». Desmarca cualquier selección actual y actualiza el punto inicial de la selección a la posición actual del cursor.
© 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.