Controles de botón
Qt Quick Controls ofrece una selección de controles de tipo botón.
Tipo base abstracto que proporciona funcionalidades comunes a los botones | |
Botón que se puede pulsar para ejecutar un comando o responder a una pregunta | |
Botón de verificación que se puede activar o desactivar | |
Botón de verificación que se activa cuando se mantiene pulsado el tiempo suficiente | |
Botón de opción exclusivo que puede activarse o desactivarse | |
Botón de control con esquinas redondeadas en el que el usuario puede hacer clic | |
Botón activable o desactivable | |
Botón con un aspecto adecuado para una barra de herramientas |
Cada tipo de botón tiene un caso de uso específico. En las secciones siguientes se ofrecen directrices para elegir el tipo de botón adecuado, en función del caso de uso.
Botón de control
Button es un control en el que se puede hacer clic para iniciar una acción o abrir o cerrar una ventana emergente. Un botón suele tener una etiqueta de texto, pero también puede contener un icono.
El botón es un control muy adecuado cuando un popup o diálogo necesita realizar una acción. Los ejemplos más comunes son Aplicar, Cancelar, Guardar, Cerrar y Ayuda.
Recomendaciones:
- El texto del botón debe ser un verbo que describa la acción, o un sustantivo que coincida con el título de la ventana emergente que se abrirá.
- No utilice un botón para establecer el estado. Switch es más adecuado para eso.
- Utiliza la fuente por defecto a menos que tengas directrices de interfaz de usuario que especifiquen lo contrario.
- Si el texto está localizado, ten en cuenta la influencia de un texto más largo en el diseño.
Véase también Button y AbstractButton
Control CheckBox
CheckBox se utiliza para construir listas de opciones multiselección. Se puede seleccionar cualquier número de opciones, incluyendo ninguna, pero las opciones no deben ser mutuamente excluyentes.
Utilice un único CheckBox para una elección sí/no, como cuando tiene que aceptar los términos del acuerdo de servicio en un formulario.
Para una única opción sí/no, también es posible utilizar un conmutador. Si la elección se refiere a una opción, es mejor utilizar CheckBox. Si se refiere a una acción que debe realizarse, se recomienda utilizar un conmutador.
Cuando las opciones pueden agruparse, puede utilizar una CheckBox parcialmente marcada para representar todo el grupo. Utilice la casilla de verificación partially checked state cuando un usuario seleccione algunos subelementos del grupo, pero no todos.
Los tres estados de marcación disponibles son: marcada, parcialmente marcada y desmarcada.
Las opciones marcables suelen aparecer en una lista vertical.
Recomendaciones:
- La etiqueta de la casilla de verificación debe ser una declaración que la marca de verificación convierte en verdadero, y que la ausencia de marca de verificación convierte en falso.
- La etiqueta de la casilla de verificación no debe contener una declaración negativa.
- Utilice la fuente predeterminada, a menos que haya directrices de interfaz de usuario que especifiquen lo contrario.
- Si el texto está localizado, tenga en cuenta la influencia de un texto más largo en el diseño.
Véase también CheckBox
Control DelayButton
DelayButton es un botón que incorpora un retardo antes de desencadenar una acción. Este retardo evita pulsaciones accidentales.
Recomendaciones:
- Utilizar en interfaces de usuario táctiles.
- Utilizar para acciones que deban activarse con cuidado.
Véase también Button y AbstractButton
Control RadioButton
RadioButton se utiliza para seleccionar sólo una opción de un conjunto de opciones. Al seleccionar una opción, se anula automáticamente la selección de la opción anterior.
Si sólo hay dos opciones mutuamente excluyentes, combínelas en una sola casilla de verificación o un conmutador.
Recomendaciones:
- Limite el texto de la etiqueta a una línea.
- Asegúrese de que está marcada una opción por defecto razonable.
- Enumere verticalmente las opciones de RadioButton.
- Si el texto está localizado, tenga en cuenta la influencia de un texto más largo en el diseño.
- Utilice la fuente predeterminada, a menos que tenga directrices de interfaz de usuario que especifiquen lo contrario.
- Al igual que con CheckBox, no haga la lista demasiado grande.
- Para evitar confusiones, no ponga dos grupos de botones de opción uno al lado del otro.
Véase también RadioButton
Control RoundButton
RoundButton es un control clicable que inicia una acción, o abre o cierra una ventana emergente. Un botón redondo con un icono de imagen cuadrado o un icono de fuente de una letra es circular. Un RoundButton circular ocupa menos espacio que un Button normal, y también puede utilizarse como botón de acción flotante.

Recomendaciones:
- Las etiquetas deben ser breves y concisas.
- Si el texto está localizado, considere la influencia de un texto más largo en el diseño.
Véase también RoundButton
Interruptor de control

Switch Representa un interruptor físico que permite a los usuarios elegir entre un estado "encendido" o "apagado". Utilice un interruptor para operaciones binarias que surtan efecto inmediatamente después de encenderlo. Por ejemplo, un interruptor para activar o desactivar WIFI.
Recomendaciones:
- Las etiquetas deben ser breves y concisas.
- Si el texto está localizado, tenga en cuenta la influencia de un texto más largo en el diseño.
Véase también Switch
Control ToolButton

ToolButton es casi idéntico a Button, pero tiene un aspecto gráfico que lo hace más adecuado para su inserción en un ToolBar.
Véase también ToolButton
Información relacionada
© 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.