En esta página

TextField QML Type

Campo de introducción de texto de una sola línea. Más...

Import Statement: import QtQuick.Controls
Inherits:

TextInput

Propiedades

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.

Campo de texto en estado normal

Un campo de texto en su estado normal.

Campo de texto con el foco y resaltado

Un campo de texto que tiene el foco activo.

Campo de texto desactivado

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.

ConstanteDescripción
Qt.MouseFocusReasonSe ha producido una acción del ratón.
Qt.TabFocusReasonSe ha pulsado la tecla Tab.
Qt.BacktabFocusReasonSe ha producido un Backtab. La entrada para esto puede incluir las teclas Mayús o Control; p. ej., Mayús+Tab.
Qt.ActiveWindowFocusReasonEl sistema de ventanas ha activado o desactivado esta ventana.
Qt.PopupFocusReasonLa aplicación ha abierto o cerrado una ventana emergente que ha capturado o liberado el foco del teclado.
Qt.ShortcutFocusReasonEl usuario ha escrito el atajo asociado a una etiqueta
Qt.MenuBarFocusReasonLa barra de menús ha obtenido el foco.
Qt.OtherFocusReasonOtra 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.