bmpcbox.h

Clase wxBitmapComboBox

Un combobox que muestra un mapa de bits delante de los elementos de la lista.

Jerarquía:

Actualmente solo permite utilizar mapas de bits de un tamaño, y se redimensiona para poder mostrar un mapa de bits junto al campo de texto.

Observaciones

Aunque wxBitmapComboBox contiene la API de wxComboBox, puede que en realidad no derive de esa clase. De hecho, si la plataforma no tiene una implementación nativa, wxBitmapComboBox heredará de wxOwnerDrawnComboBox. Se puede determinar si la implementación es genérica comprobando si wxGENERIC_BITMAPCOMBOBOX está definido. Actualmente wxBitmapComboBox está implementado nativamente para MSW y GTK+.

Estilos

Esta clase admite los siguientes estilos:

wxCB_READONLY: Crea un combobox sin editor de texto. En algunas plataformas el control puede aparecer muy diferente cuando se utiliza este estilo.
wxCB_SORT: Ordena alfabéticamente las entradas de la lista.
wxTE_PROCESS_ENTER: El control generará el evento wxEVT_TEXT_ENTER (de lo contrario, pulsar la tecla Intro es procesado internamente por el control o utilizado para la navegación entre controles de diálogo). Solo para Windows.

Eventos emitidos por esta clase

Las siguientes macros manejadoras 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_COMBOBOX(id, func): Procesa un evento wxEVT_COMBOBOX, cuando se selecciona un elemento de la lista.
EVT_TEXT(id, func): Procesa un evento wxEVT_TEXT, cuando el texto del combobox cambia.
EVT_TEXT_ENTER(id, func): Procesa un evento wxEVT_TEXT_ENTER, cuando se pulsa RETURN en el combobox.

Funciones miembro públicas

wxBitmapComboBox()

wxBitmapComboBox::wxBitmapComboBox()

Constructor por defecto.

wxBitmapComboBox()

wxBitmapComboBox::wxBitmapComboBox( wxWindow * parent, wxWindowID id = wxID_ANY, const wxString & value = wxEmptyString, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, int n = 0, const wxString choices[] = NULL, long style = 0, const wxValidator &M validator = wxDefaultValidator, const wxString & name = wxBitmapComboBoxNameStr )

Constructor, crea y muestra un combobox.

Parámetros

parent: Ventana padre. No debe ser NULL.
id: Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
value: Cadena de selección inicial. Una cadena vacía indica que no hay selección.
pos: Posición inicial.
size: Tamaño inicial.
n: Número de cadenas con las que inicializar el control.
choices: Matriz de cadenas con las que inicializar el control.
style: El estilo de la ventana, ver wxCB_* flags.
validator: Validador que puede utilizarse para comprobaciones de datos adicionales.
name: Nombre del control.

wxBitmapComboBox()

wxBitmapComboBox::wxBitmapComboBox( wxWindow * parent, wxWindowID id, const wxString & value, const wxPoint & pos, const wxSize & size, const wxArrayString & choices, long style, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxBitmapComboBoxNameStr )

Constructor, crea y muestra un combobox.

Parámetros

parent: Ventana padre. No debe ser NULL.
id: Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
value: Cadena de selección inicial. Una cadena vacía indica que no hay selección.
pos: Posición inicial.
size: Tamaño inicial.
choices: Una wxArrayString con la que inicializar el control.
style: El estilo de la ventana, ver wxCB_* flags.
validator: Validador que puede utilizarse para comprobaciones de datos adicionales.
name: Nombre del control.

~wxBitmapComboBox()

virtual wxBitmapComboBox::~wxBitmapComboBox()

Destructor, destruye el combobox.

Append()

int wxBitmapComboBox::Append( const wxString & item, const wxBitmap & bitmap, void * clientData )

Añade el elemento al final del cuadro combinado, asociando el puntero de datos de cliente no tipado clientData dado con el elemento.

Append()

int wxBitmapComboBox::Append( const wxString & item, const wxBitmap & bitmap, wxClientData * clientData )

Añade el elemento al final del cuadro combinado, asociando el puntero de datos de cliente clientData dado con el elemento.

Append()

int wxBitmapComboBox::Append( const wxString & item, const wxBitmap & bitmap = wxNullBitmap )

Añade el elemento al final del cuadro combinado.

Create()

bool wxBitmapComboBox::Create( wxWindow * parent, wxWindowID id, const wxString & value, const wxPoint & pos, const wxSize & size, const wxArrayString & choices, long style, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxBitmapComboBoxNameStr )

Crea el combobox para la construcción en dos pasos.

Create()

bool wxBitmapComboBox::Create( wxWindow * parent, wxWindowID id = wxID_ANY, const wxString & value = wxEmptyString, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, int n = 0, const wxString choices[] = NULL, long style = 0, const wxValidator &M validator = wxDefaultValidator, const wxString & name = wxBitmapComboBoxNameStr )

Crea el combobox para la construcción en dos pasos.

GetBitmapSize()

virtual wxSize wxBitmapComboBox::GetBitmapSize() const

Devuelve el tamaño de los mapas de bits utilizados en el cuadro combinado.

Si el cuadro combinado está vacío, se devuelve wxDefaultSize.

GetItemBitmap()

virtual wxBitmap wxBitmapComboBox::GetItemBitmap(unsigned int n) const

Devuelve el mapa de bits del elemento con el índice dado.

Insert()

int wxBitmapComboBox::Insert( const wxString & item, const wxBitmap & bitmap, unsigned int pos )

Inserta el elemento en la lista antes de pos.

No es válido para el estilo wxCB_SORT, utilizar Append() en su lugar.

Insert()

int wxBitmapComboBox::Insert( const wxString & item, const wxBitmap & bitmap, unsigned int pos, void * clientData )

Inserta el elemento en la lista antes de pos, asociando el puntero de datos de cliente no tipado dado con el elemento.

No es válido para el estilo wxCB_SORT, utilizar Append() en su lugar.

Insert()

int wxBitmapComboBox::Insert( const wxString & item, const wxBitmap & bitmap, unsigned int pos, wxClientData * clientData )

Inserta el elemento en la lista antes de pos, asociando el puntero de datos del cliente dado con el elemento.

No es válido para el estilo wxCB_SORT, utilizar Append() en su lugar.

SetItemBitmap()

virtual void wxBitmapComboBox::SetItemBitmap( unsigned int n, const wxBitmapBundle & bitmap )

Establece el mapa de bits para el elemento dado.

Métodos y datos heredados

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