choice.h

Clase wxChoice

Un elemento de elección se utiliza para seleccionar una de una lista de cadenas.

Jerarquía:

A diferencia de wxListBox, solo la selección es visible hasta que el usuario despliega el menú de opciones.

Estilos

Esta clase admite los siguientes estilos:

wxCB_SORT: Ordena las entradas alfabéticamente.

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_CHOICE(id, func): Procesa un evento wxEVT_CHOICE, cuando se selecciona un elemento de la lista.

Funciones miembro

wxChoice()

wxChoice::wxChoice()

Constructor por defecto.

wxChoice()

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

Constructor, creando y mostrando una elección.

Parámetros

parent: Ventana padre. No debe ser NULL.
id: Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
pos: Posición de la ventana. Si se especifica wxDefaultPosition se elige una posición por defecto.
size: Tamaño de la ventana. Si se especifica wxDefaultSize entonces se elige un tamaño adecuado.
n: Número de cadenas con las que se inicializa el control de selección.
choices: Un array de cadenas con las que inicializar el control de elección.
style: Estilo de la ventana.
validator: Validador de la ventana.
name: Nombre de la ventana.

Nota: No soportado por wxPerl.

wxChoice()

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

Constructor, creando y mostrando una elección.

Parámetros

parent: Ventana padre. No debe ser NULL.
id: Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
pos: Posición de la ventana.
size: Tamaño de la ventana. Si se especifica wxDefaultSize, la elección tendrá el tamaño adecuado.
choices: Un array de cadenas con las que inicializar el control de elección.
style: Estilo de la ventana.
validator: Validador de la ventana.
name: Nombre de la ventana.

Nota: Utilizar una referencia de array para el parámetro choices.

~wxChoice()

virtual wxChoice::~wxChoice()

Destructor, destruye el elemento de elección.

Create()

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

Crea la opción de construcción en dos fases.

Create()

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

Crea la opción de construcción en dos fases.

FindString()

virtual int wxChoice::FindString( const wxString & string, bool caseSensitive = false ) const

Busca un elemento cuya etiqueta coincida con la cadena dada.

Parámetros

string: Cadena a buscar.
caseSensitive: Si la búsqueda distingue entre mayúsculas y minúsculas (por defecto no).

Valor de retorno

La posición basada en cero del elemento, o wxNOT_FOUND si no se encontró la cadena.

Reimplementado de wxItemContainerImmutable.

GetColumns()

virtual int wxChoice::GetColumns() const

Obtiene el número de columnas de este elemento de elección.

Observaciones

Esto se implementa solo para GTK y Motif y siempre devuelve 1 para las otras plataformas.

GetCount()

virtual unsigned int wxChoice::GetCount() const

Devuelve el número de elementos del control.

Implementa wxItemContainerImmutable.

GetCurrentSelection()

virtual int wxChoice::GetCurrentSelection() const

A diferencia de wxControlWithItems::GetSelection() que solo devuelve el valor de selección aceptado (la selección en el control una vez que el usuario cierra la lista desplegable), esta función devuelve la selección actual.

Es decir, mientras se muestra la lista desplegable, devuelve el elemento actualmente seleccionado en ella. Cuando no se muestra, su resultado es el mismo que el de la otra función.

GetSelection()

virtual int wxChoice::GetSelection() const

Devuelve el índice del elemento seleccionado o wxNOT_FOUND si no hay ningún elemento seleccionado.

Valor de retorno

La posición de la selección actual.

Implementa wxItemContainerImmutable.

GetString()

virtual wxString wxChoice::GetString(unsigned int n) const

Devuelve la etiqueta del elemento con el índice dado.

El índice debe ser válido, es decir, menor que el valor devuelto por GetCount(), de lo contrario se lanza un assert. Esta función no puede invocarse si el control está vacío.

Parámetros

n: El índice basado en cero.

Valor de retorno

La etiqueta del elemento.

Implementa wxItemContainerImmutable.

IsSorted()

virtual bool wxChoice::IsSorted() const

Devuelve true si los elementos están ordenados alfabéticamente.

SetColumns()

virtual void wxChoice::SetColumns(int n = 1)

Establece el número de columnas de este elemento de elección.

Parámetros

n: Número de columnas.

Observaciones

Esto está implementado solo para GTK y Motif y no hace nada bajo otras plataformas.

SetSelection()

virtual void wxChoice::SetSelection(int n)

Establece la selección en el elemento n dado o elimina la selección por completo si n == wxNOT_FOUND.

Hay que tener en cuenta que esto no provoca la emisión de ningún evento de comando ni deselecciona ningún otro elemento de los controles que admiten selecciones múltiples.

Parámetros

n: La posición de la cadena a seleccionar, empezando por cero.

SetString()

virtual void wxChoice::SetString( unsigned int n, const wxString & string )

Establece la etiqueta para el elemento dado.

Parámetros

n: El índice del elemento en base cero.
string: La etiqueta a establecer.

Implementa wxItemContainerImmutable.

Métodos y datos heredados

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