En esta página

Controles de entrada

Qt Quick La sección «Controles» ofrece una variedad de controles de entrada tanto para datos numéricos como para texto.

ComboBox

Botón combinado y lista desplegable para seleccionar opciones

Dial

Dial circular que se gira para establecer un valor

DoubleSpinBox

Permite al usuario seleccionar entre un conjunto de valores de coma flotante predefinidos

RangeSlider

Se utiliza para seleccionar un rango de valores deslizando dos controladores a lo largo de una barra

SearchField

Un campo de entrada especializado diseñado para la función de búsqueda

Slider

Se utiliza para seleccionar un valor deslizando un controlador a lo largo de una pista

SpinBox

Permite al usuario seleccionar entre un conjunto de valores preestablecidos

TextArea

Área de entrada de texto de varias líneas

TextField

Campo de entrada de texto de una sola línea

Tumbler

Rueda giratoria con elementos que se pueden seleccionar

Cada tipo de control de entrada tiene su propio caso de uso específico. Las siguientes secciones ofrecen directrices para elegir el tipo adecuado de control de entrada, en función del caso de uso.

Control ComboBox

ComboBox se utiliza para seleccionar un valor de una lista desplegable estática de varias líneas. No es posible añadir nuevos valores y solo se puede seleccionar una opción.

Recomendaciones:

  • Si el número de valores es muy elevado, plantéate aplicar un filtro.
  • Si la lista es muy limitada, plantéate utilizar « RadioButton ». Esto tiene la ventaja de que el usuario puede ver todas las opciones al mismo tiempo.
  • Selecciona un valor por defecto, es decir, el valor que se elegirá con más frecuencia.

Véase también: Control CheckBox, Control Tumbler.

El control «Dial»

Control de dial para la selección de valores circulares

Dial es similar a un mando giratorio tradicional que se encuentra en dispositivos como equipos de música o maquinaria industrial.

El dial se gira haciendo clic y arrastrando, y el indicador muestra el valor del dial.

Para aplicaciones en las que es importante la rapidez de introducción de datos, resulta útil el « input mode » circular, ya que al hacer clic en el dial este se desplaza directamente a esa posición.

Para aplicaciones en las que es importante la precisión en la introducción de datos, se recomiendan los modos de introducción horizontal y vertical, ya que permiten realizar pequeños ajustes en relación con el punto en el que se hace clic en el dial. Estos modos también son más adecuados para diales en los que los grandes saltos de valores podrían resultar peligrosos, como un dial que controla el volumen del audio.

Véase también «Control Tumbler».

Control TextArea

Área de texto para introducir texto de varias líneas

TextArea es un editor de texto de varias líneas.

Control «TextField»

Campo de texto para introducir texto de una sola línea

TextField es un editor de texto de una sola línea.

Véase también el control Tumbler.

Control Slider

Slider Se utiliza para seleccionar un valor deslizando un controlador a lo largo de una pista.

Control RangeSlider

RangeSlider Se utiliza para seleccionar un rango especificado por dos valores, deslizando cada controlador a lo largo de una pista.

Véase también «Control deslizante».

Control de tambor

Control de valor que permite desplazarse por los valores disponibles

Tumbler es una rueda giratoria con elementos que se pueden seleccionar.

Véase también el control ComboBox.

© 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.