Clase wxButton

Jerarquía:

Un botón es un control que contiene una cadena de texto, y es uno de los elementos más comunes de una GUI.

Puede colocarse en un cuadro de diálogo o en un panel wxPanel, o de hecho en casi cualquier otra ventana.

Por defecto, es decir, si no se especifica ninguno de los estilos de alineación, la etiqueta se centra tanto horizontal como verticalmente. Si el botón tiene una etiqueta y un mapa de bits, los estilos de alineación anteriores especifican la ubicación del rectángulo que combina la etiqueta y el mapa de bits, y la posición del mapa de bits establecida con wxButton::SetBitmapPosition() define la posición relativa del mapa de bits con respecto a la etiqueta (sin embargo, actualmente las combinaciones de alineación no predeterminadas no están implementadas en todas las plataformas).

Desde la versión 2.9.1 wxButton soporta mostrar tanto texto como una imagen (actualmente solo cuando se utilizan los ports wxMSW, wxGTK o wxOSX/Cocoa), ver los métodos SetBitmap() y SetBitmapLabel(), SetBitmapDisabled(). En las versiones anteriores de wxWidgets esta funcionalidad solo estaba disponible en (la ahora trivial) clase wxBitmapButton que sólo era capaz de mostrar una imagen sin texto.

Un botón puede tener una única imagen para todos los estados o diferentes imágenes para los siguientes estados (actualmente no se soportan diferentes imágenes en macOS, donde se utiliza la imagen normal para todos los estados):

• normal: el estado por defecto
• desactivado: mapa de bits que se muestra cuando el botón está desactivado.
• pulsado: bitmap que se muestra cuando el botón está pulsado (por ejemplo, mientras el usuario mantiene pulsado el botón del ratón sobre él)
• focus: bitmap que se muestra cuando el botón tiene el foco del teclado (pero no está pulsado ya que en este caso el botón está en estado pulsado).
• current: bitmap que se muestra cuando el ratón está sobre el botón (pero no está pulsado aunque pueda tener el foco). Tenga en cuenta que si no se especifica el mapa de bits actual pero la interfaz de usuario de la plataforma actual utiliza imágenes hover para los botones (como Windows o GTK+), el mapa de bits de enfoque se utiliza también para el estado hover. Esto permite establecer solo el mapa de bits de enfoque para obtener un comportamiento razonablemente bueno en todas las plataformas.

Todos los mapas de bits deben tener el mismo tamaño y el mapa de bits normal debe establecerse primero (a un mapa de bits válido), antes de establecer cualquier otro. Además, si el tamaño de los mapas de bits se cambia más tarde, es necesario cambiar el tamaño del mapa de bits normal antes de establecer cualquier otro mapa de bits con el nuevo tamaño (y es necesario restablecer todos ellos, ya que sus valores originales se pueden perder cuando el tamaño del mapa de bits normal cambia).

La posición de la imagen dentro del botón se configura usando SetBitmapPosition(). Por defecto la imagen está a la izquierda del texto.

Hay que tener en cuenta también que GTK+ utiliza una configuración global llamada gtk-button-images para determinar si las imágenes deben mostrarse en los botones. Si está desactivado (que es el caso, por ejemplo, en Gnome 2.28 por defecto), no se mostrará ninguna imagen, en consonancia con el comportamiento nativo.

Estilos

Esta clase admite los siguientes estilos:

wxBU_LEFT:

Ajusta la etiqueta a la izquierda. Solo para Windows y GTK+.

wxBU_TOP:

Alinea la etiqueta en la parte superior del botón. Solo para Windows y GTK+.

wxBU_RIGHT:

Ajusta la etiqueta bitmap a la derecha. Solo para Windows y GTK+.

wxBU_BOTTOM:

Alinea la etiqueta en la parte inferior del botón. Solo para Windows y GTK+.

wxBU_EXACTFIT:

Por defecto, todos los botones tienen al menos el tamaño estándar, incluso si su contenido es lo suficientemente pequeño como para caber en un tamaño más pequeño. Esto se hace por consistencia, ya que la mayoría de las plataformas utilizan botones del mismo tamaño en los diálogos nativos, pero se puede anular especificando esta bandera. Si se especifica, el botón será lo suficientemente grande para su contenido. Tenga en cuenta que en MSW el botón seguirá teniendo al menos la altura estándar, incluso con este estilo, si tiene una etiqueta no vacía.

wxBU_NOTEXT:

Desactiva la visualización de la etiqueta de texto en el botón incluso si tiene una o su id es uno de los ids estándar de stock con una etiqueta asociada: sin usar este estilo un botón que se supone que sólo muestra un mapa de bits pero usa un id estándar mostraría también una etiqueta.

wxBORDER_NONE:

Crea un botón sin borde. Actualmente está implementado en MSW, GTK2 y OSX/Cocoa.

Eventos emitidos por esta clase

Las siguientes macros de manejadores de eventos redirigen los eventos a manejadores de funciones miembro 'func' con prototipos como:

void handlerFuncName(wxCommandEvent& event)

Macros de eventos para eventos emitidos por esta clase:

EVT_BUTTON(id, func):

Procesa un evento wxEVT_BUTTON, cuando se pulsa el botón.

Funciones miembro públicas

wxButton()

wxButton()

Create()

GetAuthNeeded()

GetDefaultSize()

GetLabel()

SetAuthNeeded()

SetDefault()

SetLabel()

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxControl, wxWindow y wxObject.