TextField QML Type
Campo de entrada de texto de una 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 extiende TextInput con una funcionalidad placeholder text, y añade decoración.
| 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") }
Ver también TextArea, Personalizar TextField, y Controles de Entrada.
Documentación de Propiedades
background : Item
Esta propiedad contiene el elemento de fondo.
Nota: Si el elemento de fondo no tiene un tamaño explícito especificado, sigue automáticamente el tamaño del control. En la mayoría de los casos, no es necesario especificar la anchura o 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 sustituye el elemento de fondo por uno personalizado, también debería considerar la posibilidad de proporcionarle un tamaño implícito razonable (a menos que se trate de un elemento como Image, que tiene su propio tamaño implícito).
Véase también Personalizar TextField.
bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la inserción inferior para el 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 la razón del último cambio de foco.
Nota: Esta propiedad no indica si el ítem tiene active focus, sino la razón por la que el ítem ganó o perdió el foco.
| Constante | Descripción |
|---|---|
Qt.MouseFocusReason | Se ha producido una acción del ratón. |
Qt.TabFocusReason | Se ha pulsado la tecla Tabulador. |
Qt.BacktabFocusReason | Se ha producido un Backtab. La entrada para esto puede incluir las teclas Shift o Control; ej. Shift+Tab. |
Qt.ActiveWindowFocusReason | El sistema de ventanas ha activado o desactivado esta ventana. |
Qt.PopupFocusReason | La aplicación abrió/cerró una ventana emergente que tomó/liberó el foco del teclado. |
Qt.ShortcutFocusReason | El usuario tecleó el atajo de teclado de una etiqueta. |
Qt.MenuBarFocusReason | La barra de menús tomó el foco. |
Qt.OtherFocusReason | Otra razón, normalmente específica de la aplicación. |
Nota: Prefiera QtQuick.Controls::Control::focusReason a esta propiedad.
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad determina si el campo de texto acepta eventos hover. 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 campo de texto está sobrevolado.
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 contiene la inserción izquierda para el 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 TextField antes de que el usuario introduzca el 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 mantiene la inserción derecha para el 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 contiene la inserción superior para el fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Ver también Control Layout y bottomInset.
Documentación de Signal
pressAndHold(MouseEvent event)
Esta señal se emite cuando se produce una pulsación larga (el retardo depende del plugin de la plataforma). El parámetro event proporciona información sobre la pulsación, incluidas las coordenadas x e y de la pulsación, y qué botón se ha pulsado.
Nota: El manejador 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 el campo de texto. El parámetro event proporciona información sobre la pulsación, incluidas las coordenadas x e y de la pulsación, y qué botón se ha pulsado.
Nota: El manejador correspondiente es onPressed.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Ver 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, incluyendo las coordenadas x e y de la pulsación, y qué botón se ha pulsado.
Nota: El manejador correspondiente es onReleased.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Ver 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.
