En esta página

Controles de entrada

Qt Quick Controls ofrece una variedad de controles de entrada tanto numéricos como textuales.

ComboBox

Botón combinado y lista emergente 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 preestablecidos

RangeSlider

Se utiliza para seleccionar un intervalo de valores deslizando dos tiradores por una pista.

SearchField

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

Slider

Permite seleccionar un valor deslizando un tirador por una pista

SpinBox

Permite al usuario seleccionar entre un conjunto de valores preestablecidos

TextArea

Campo de entrada de texto multilínea

TextField

Campo de entrada de texto de una línea

Tumbler

Rueda giratoria de elementos seleccionables

Cada tipo de control de entrada tiene su propio caso de uso específico. En las secciones siguientes se ofrecen directrices para elegir el tipo de control de entrada adecuado, 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 sólo se puede seleccionar una opción.

Recomendaciones:

  • Si el número de valores es muy grande, considere aplicar un filtro.
  • Si la lista es muy limitada, considere la posibilidad de utilizar RadioButton. Esto tiene la ventaja de que el usuario puede ver todas las opciones al mismo tiempo.
  • Seleccione un valor por defecto, el valor que se elegirá más a menudo.

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

Control de esfera

Mando giratorio para seleccionar el valor circular

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

El dial se gira haciendo clic y arrastrando, con el mango indicando el valor del dial.

Para aplicaciones en las que es importante introducir datos con rapidez, resulta útil la función circular input mode, ya que al hacer clic en el dial, éste se desplaza directamente a esa posición.

Para aplicaciones en las que es importante una introducción precisa, se recomiendan los modos de introducción horizontal y vertical, ya que permiten realizar pequeños ajustes en relación con el lugar en el que se pulsa el dial. Estos modos también son mejores para diales donde grandes saltos en los valores podrían ser inseguros, como un dial que controla el volumen de audio.

Véase también Control de Tumbler.

Control TextArea

Área de texto para la introducción de texto multilínea

TextArea es un editor de texto multilínea.

Control TextField

Campo de texto de una línea

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

Véase también Tumbler Control.

Control deslizante

Slider se utiliza para seleccionar un valor deslizando un tirador a lo largo de una pista.

Control RangeSlider

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

Véase también Control deslizante.

Control Tumbler

Vagoneta con selección de valores desplazable

Tumbler es una rueda giratoria de elementos que pueden seleccionarse.

Véase también 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.