Controles de botón
Qt Quick La sección «Controles» ofrece una selección de controles similares a botones.
Tipo base abstracto que proporciona la funcionalidad común a los botones | |
Botón pulsable sobre el que se puede hacer clic para ejecutar un comando o responder a una pregunta | |
Botón de selección que se puede activar o desactivar | |
Botón de selección que se activa al mantenerlo pulsado el tiempo suficiente | |
Botón de opción exclusivo que se puede activar o desactivar | |
Un control de botón con esquinas redondeadas en el que el usuario puede hacer clic | |
Botón que se puede activar o desactivar | |
Botón con un aspecto adecuado para una barra de herramientas |
Cada tipo de botón tiene su propio caso de uso específico. Las siguientes secciones ofrecen directrices para elegir el tipo de botón adecuado, en función del caso de uso.
Control de botón
Button es un control en el que se puede hacer clic para iniciar una acción, o para 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 una ventana emergente o un cuadro de diálogo debe 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 va a abrir.
- No utilices un botón para establecer un estado. Para eso, es más adecuado un « Switch ».
- Utiliza la fuente predeterminada, a menos que las directrices de interfaz de usuario especifiquen lo contrario.
- Si el texto está localizado, ten en cuenta cómo afecta un texto más largo al diseño.
Véase también Button y AbstractButton
el control CheckBox
CheckBox se utiliza para crear listas de opciones de selección múltiple. Se puede seleccionar cualquier número de opciones, incluso ninguna, pero las opciones no deben ser mutuamente excluyentes.
Utiliza un único control « CheckBox » para una elección de «sí» o «no», como cuando tienes que aceptar los términos del acuerdo de servicio en un formulario.
Para una única elección de «sí» o «no», también es posible utilizar un «switch». Si la elección se refiere a una opción, es mejor utilizar un « CheckBox ». Si se refiere a una acción que se debe realizar, se recomienda un «switch».
Cuando las opciones se pueden agrupar, puedes utilizar una casilla de selección ( CheckBox ) parcialmente marcada para representar a todo el grupo. Utiliza la casilla de selección « partially checked state » cuando un usuario seleccione algunos subelementos del grupo, pero no todos.
Los tres estados disponibles de la casilla de selección son: marcada, parcialmente marcada y desmarcada.
Las opciones que se pueden marcar suelen aparecer en una lista vertical.
Recomendaciones:
- La etiqueta de la casilla de selección debe ser una afirmación que se considere verdadera si la casilla está marcada y falsa si no lo está.
- La etiqueta de la casilla de selección no debe contener una afirmación negativa.
- Utiliza la fuente predeterminada, a menos que las directrices de interfaz de usuario especifiquen lo contrario.
- Si el texto está localizado, ten en cuenta la influencia que puede tener un texto más largo en el diseño.
Véase también CheckBox
Control DelayButton
DelayButton es un botón que incorpora un retraso antes de activar una acción. Este retraso evita pulsaciones accidentales.
Recomendaciones:
- Úsalo en interfaces de usuario táctiles.
- Utilícelo para acciones que deban activarse con cuidado.
Véase también el control « Button » y AbstractButton
Control RadioButton
RadioButton se utiliza para seleccionar solo una opción de entre un conjunto de opciones. Al seleccionar una opción, se deselecciona automáticamente la que estaba seleccionada anteriormente.
Si solo hay dos opciones mutuamente excluyentes, combínalas en una única casilla de selección o en un conmutador.
Recomendaciones:
- Limita el texto de la etiqueta a una sola línea.
- Asegúrate de que la opción predeterminada sea razonable y esté marcada.
- Enumera las opcione RadioButton es verticalmente.
- Si el texto está traducido, ten en cuenta cómo un texto más largo puede afectar al diseño.
- Utiliza la fuente predeterminada, a menos que las directrices de la interfaz de usuario especifiquen lo contrario.
- Al igual que con « CheckBox », no hagas que la lista sea demasiado larga.
- Para evitar confusiones, no coloques dos grupos de botones de opción uno al lado del otro.
Véase también RadioButton
Control RoundButton
RoundButton es un control en el que se puede hacer clic para iniciar una acción, o para abrir o cerrar una ventana emergente. Un botón redondo con un icono de imagen cuadrada o un icono tipográfico de una sola letra es circular. Un « RoundButton » circular ocupa menos espacio que un « Button » normal, y también se puede utilizar como botón de acción flotante.

Recomendaciones:
- Mantén las etiquetas breves y concisas.
- Si el texto está localizado, ten en cuenta cómo un texto más largo puede afectar al diseño.
Véase también RoundButton
Control de conmutador

Switch representa un interruptor físico que permite a los usuarios elegir entre el estado «activado» o «desactivado». Utiliza un interruptor para operaciones binarias que surtan efecto inmediatamente después de activarlo. Por ejemplo, un interruptor para activar o desactivar el wifi.
Recomendaciones:
- Mantén las etiquetas breves y concisas.
- Si el texto está localizado, ten en cuenta cómo un texto más largo puede afectar al diseño.
Véase también Switch
Control ToolButton

ToolButton es prácticamente 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.