TextField QML Type
Campo de introducción de texto de una sola línea. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- background : Item
- bottomInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - focusReason : enumeration
- hoverEnabled : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - hovered : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - implicitBackgroundHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitBackgroundWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - leftInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - placeholderText : string
- placeholderTextColor : color
(since QtQuick.Controls 2.5 (Qt 5.12)) - rightInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - topInset : real
(since QtQuick.Controls 2.5 (Qt 5.12))
Señales
- pressAndHold(MouseEvent event)
- pressed(MouseEvent event)
(since QtQuick.Controls 2.1 (Qt 5.8)) - released(MouseEvent event)
(since QtQuick.Controls 2.1 (Qt 5.8))
Descripción detallada
TextField es un editor de texto de una sola línea. TextField hereda de TextInput, incorpora la funcionalidad « placeholder text » y añade elementos decorativos.
| Un campo de texto en su estado normal. |
| Un campo de texto que tiene el foco activo. |
| Un campo de texto desactivado. |
TextField {
placeholderText: qsTr("Enter name")
}Véase también « TextArea» , «Personalización de TextField» y «Controles de entrada».
Documentación de propiedades
background : Item
Esta propiedad contiene el elemento de fondo.
Nota: Si no se ha especificado un tamaño explícito para el elemento de fondo, este adopta automáticamente el tamaño del control. En la mayoría de los casos, no es necesario especificar el ancho ni la altura de un elemento de fondo.
Nota: La mayoría de los controles utilizan el tamaño implícito del elemento de fondo para calcular el tamaño implícito del propio control. Si sustituyes el elemento de fondo por uno personalizado, también deberías considerar la posibilidad de proporcionarle un tamaño implícito adecuado (a menos que se trate de un elemento como « Image », que tiene su propio tamaño implícito).
Véase también Personalización deTextField.
bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad define el margen inferior del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y topInset.
focusReason : enumeration
Esta propiedad contiene el motivo del último cambio de foco.
Nota: Esta propiedad no indica si el elemento tiene el atributo « active focus », sino el motivo por el que el elemento ha ganado o perdido el foco.
| Constante | Descripción |
|---|---|
Qt.MouseFocusReason | Se ha producido una acción del ratón. |
Qt.TabFocusReason | Se ha pulsado la tecla Tab. |
Qt.BacktabFocusReason | Se ha producido un Backtab. La entrada para esto puede incluir las teclas Mayús o Control; p. ej., Mayús+Tab. |
Qt.ActiveWindowFocusReason | El sistema de ventanas ha activado o desactivado esta ventana. |
Qt.PopupFocusReason | La aplicación ha abierto o cerrado una ventana emergente que ha capturado o liberado el foco del teclado. |
Qt.ShortcutFocusReason | El usuario ha escrito el atajo asociado a una etiqueta |
Qt.MenuBarFocusReason | La barra de menús ha obtenido el foco. |
Qt.OtherFocusReason | Otra razón, normalmente específica de la aplicación. Nota: Es preferible utilizar « QtQuick.Controls::Control::focusReason » en lugar de esta propiedad. |
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad determina si el campo de texto admite eventos de paso del cursor. El valor por defecto es « false ».
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también hovered.
hovered : bool [read-only, since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad indica si el cursor se encuentra sobre el campo de texto.
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también hoverEnabled.
implicitBackgroundHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la altura implícita del fondo.
El valor es igual a ` background ? background.implicitHeight : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitBackgroundWidth.
implicitBackgroundWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el ancho implícito del fondo.
El valor es igual a ` background ? background.implicitWidth : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitBackgroundHeight.
leftInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad define el margen izquierdo del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y rightInset.
placeholderText : string
Esta propiedad contiene la sugerencia que se muestra en el campo « TextField » antes de que el usuario introduzca texto.
placeholderTextColor : color [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el color de placeholderText.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también placeholderText.
rightInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad establece el margen derecho del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y leftInset.
topInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad define el margen superior del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y bottomInset.
Documentación sobre señales
pressAndHold(MouseEvent event)
Esta señal se emite cuando se produce una pulsación prolongada (el retraso depende del complemento de la plataforma). El parámetro ` event ` proporciona información sobre la pulsación, incluidas las coordenadas x e y de la misma y qué botón se ha pulsado.
Nota: El controlador correspondiente es onPressAndHold.
Véase también pressed y released.
[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)
Esta señal se emite cuando el usuario pulsa sobre el campo de texto. El parámetro ` event ` proporciona información sobre la pulsación, incluidas las coordenadas x e y de la misma y qué botón se ha pulsado.
Nota: El controlador correspondiente es onPressed.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también « released » y « pressAndHold ».
[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)
Esta señal se emite cuando el usuario suelta el campo de texto. El parámetro event proporciona información sobre la liberación, incluidas las coordenadas x e y del punto de pulsación y qué botón se ha pulsado.
Nota: El controlador correspondiente es onReleased.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también pressed y pressAndHold.
© 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.


