QPushButton Class

Descripción detallada

El botón pulsador, o botón de comando, es quizás el widget más utilizado en cualquier interfaz gráfica de usuario. Pulsa (haz clic) un botón para ordenar al ordenador que realice alguna acción, o para responder a una pregunta. Los botones típicos son Aceptar, Aplicar, Cancelar, Cerrar, Sí, No y Ayuda.

Un botón de comando es rectangular y suele mostrar una etiqueta de texto que describe su acción. Se puede especificar un atajo de teclado precediendo el carácter preferido con un ampersand en el texto. Por ejemplo:

QPushButton *button = new QPushButton("&Download", this);

En este ejemplo el atajo es Alt+D. Consulte la documentación de QShortcut para más detalles (para mostrar un ampersand real, utilice '&&').

Los pulsadores muestran una etiqueta textual y, opcionalmente, un pequeño icono. Estos elementos pueden definirse con los constructores y modificarse posteriormente con setText() y setIcon(). Si el botón está desactivado, el aspecto del texto y del icono se manipulará con respecto al estilo GUI para que el botón parezca "desactivado".

Un pulsador emite la señal clicked() cuando es activado por el ratón, la barra espaciadora o por un atajo de teclado. Conéctese a esta señal para realizar la acción del botón. Los botones pulsadores también proporcionan señales menos utilizadas, por ejemplo pressed() y released().

connect(dispenseButton, &QPushButton::clicked, this, &IceCreamMaker::dispense);

Los botones de comando de los cuadros de diálogo son, por defecto, botones predeterminados, es decir, se convierten automáticamente en el botón pulsador predeterminado cuando reciben el foco de entrada del teclado. Un botón por defecto es un pulsador que se activa cuando el usuario pulsa la tecla Intro o Retorno en un diálogo. Puede cambiar esto con setAutoDefault(). Tenga en cuenta que los botones auto-default reservan un pequeño espacio extra que es necesario para dibujar un indicador de botón default. Si no desea este espacio alrededor de sus botones, llame a setAutoDefault(false).

Al ser tan central, el widget de botón ha crecido para dar cabida a una gran cantidad de variaciones en la última década. La guía de estilo de Microsoft muestra ahora unos diez estados diferentes de los botones de Windows y el texto da a entender que hay docenas más cuando se tienen en cuenta todas las combinaciones de características.

Los modos o estados más importantes son:

• Disponible o no (en gris, desactivado).
• Botón pulsador estándar, botón pulsador de alternancia o botón de menú.
• Activado o desactivado (sólo para los pulsadores basculantes).
• Por defecto o normal. El botón por defecto de un cuadro de diálogo se puede "pulsar" generalmente con la tecla Intro o Retorno.
• Repetición automática o no.
• Pulsado o no.

Como norma general, utilice un botón pulsador cuando la aplicación o ventana de diálogo realice una acción cuando el usuario haga clic en él (como Aplicar, Cancelar, Cerrar y Ayuda) y cuando el widget deba tener una forma amplia y rectangular con una etiqueta de texto. Los botones pequeños, normalmente cuadrados, que cambian el estado de la ventana en lugar de realizar una acción (como los botones de la esquina superior derecha de QFileDialog) no son botones de comando, sino botones de herramienta. Qt proporciona una clase especial (QToolButton) para estos botones.

Si necesitas un comportamiento de conmutación (ver setCheckable()) o un botón que repita automáticamente la señal de activación al ser pulsado como las flechas de una barra de desplazamiento (ver setAutoRepeat()), un botón de comando probablemente no es lo que quieres. En caso de duda, utilice un botón de herramienta.

Una variación de un botón de comando es un botón de menú. Éstos no sólo proporcionan un comando, sino varios, ya que al pulsarlos se despliega un menú de opciones. Utilice el método setMenu() para asociar un menú emergente a un botón de mando.

Otras clases de botones son los botones de opción (véase QRadioButton) y las casillas de verificación (véase QCheckBox).

En Qt, la clase base QAbstractButton proporciona la mayoría de los modos y otras API, y QPushButton proporciona la lógica GUI. Consulte QAbstractButton para obtener más información sobre la API.