Clase wxBitmapButton
Un botón de mapa de bits es un control que contiene un mapa de bits.
Jerarquía:
Hay que tener cuenta que desde wxWidgets 2.9.1 la visualización de mapas de bits está soportada por la propia clase base wxButton y la única pequeña ventaja de usar esta clase es que permite especificar el mapa de bits en su constructor, a diferencia de wxButton. Consultar la documentación de la clase base para más información sobre el soporte de imágenes en wxButton.
Estilos
Esta clase admite los siguientes estilos:
- wxBU_LEFT
- Ajusta a la izquierda la etiqueta del mapa de bits.
- wxBU_TOP
- Alinea la etiqueta bitmap en la parte superior del botón.
- wxBU_RIGHT
- Ajusta la etiqueta bitmap a la derecha.
- wxBU_BOTTOM:
- Alinea la etiqueta bitmap en la parte inferior del botón.
Hay que tener en cuenta que el estilo wxBU_EXACTFIT soportado por wxButton no es utilizado por esta clase ya que los botones de mapa de bits no tienen ningún tamaño estándar mínimo por defecto.
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 para eventos emitidos por esta clase:
- EVT_BUTTON(id, func)
- Procesa un evento wxEVT_BUTTON, cuando el botón es pulsado.
Funciones miembro
wxBitmapButton()
wxBitmapButton::wxBitmapButton()
Constructor por defecto.
wxBitmapButton()
wxBitmapButton::wxBitmapButton( wxWindow * parent, wxWindowID id, const wxBitmapBundle & bitmap, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxButtonNameStr )
Constructor, crea y muestra un botón.
Parámetros
- parent
- Ventana padre. No debe ser NULL.
- id
- Identificador del botón. El valor wxID_ANY indica un valor por defecto.
- bitmap
- Mapa de bits a mostrar.
- pos
- Posición del botón. Si se especifica wxDefaultPosition se elige una posición por defecto.
- size
- Tamaño del botón. Si se especifica wxDefaultSize el tamaño del botón se ajusta al mapa de bits.
- style
- Estilo de la ventana.
- validator
- Validador de la ventana.
- name
- Nombre de la ventana.
Observaciones
El parámetro bitmap es normalmente el único bitmap que se necesita proporcionar, y wxWidgets dibujará el botón correctamente en sus diferentes estados. Si se quiere más control, llamar a cualquiera de las funciones SetBitmapPressed(), SetBitmapFocus(), SetBitmapDisabled().
Create()
bool wxBitmapButton::Create( wxWindow * parent, wxWindowID id, const wxBitmapBundle & bitmap, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxButtonNameStr )
Función de creación de botones en dos pasos.
CreateCloseButton()
bool wxBitmapButton::CreateCloseButton( wxWindow * parent, wxWindowID winid, const wxString & name = wxString() )
Función de creación en dos pasos del botón "Cerrar".
Normalmente no es necesario utilizar esta función directamente ya que NewCloseButton() es más conveniente, pero, si se requiere, puede ser llamada sobre un objeto wxBitmapButton construido por defecto para conseguir el mismo efecto.
Parámetros
- parent
- La ventana padre del botón, debe ser no NULL.
- winid
- El identificador del nuevo botón.
- name
- El nombre del nuevo botón.
NewCloseButton()
static wxBitmapButton* wxBitmapButton::NewCloseButton( wxWindow * parent, wxWindowID winid, const wxString & name = wxString )
Función de ayuda para crear un botón "Cerrar" de aspecto estándar.
Para obtener los mejores resultados, puede ser necesario utilizar código específico de la plataforma para crear un botón "Cerrar" pequeño y con aspecto de barra de título. Esta función se proporciona para evitar la necesidad de realizar pruebas para la plataforma actual y crea el botón con un aspecto lo más nativo posible.
Parámetros
- parent
- La ventana padre del botón, debe ser no NULL.
- winid
- El identificador del nuevo botón.
- name
- El nombre para el nuevo botón (disponible desde wxWidgets 3.1.5)
Valor de retorno
El nuevo botón.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow, wxControl, wxButton y wxAnyButton.