Clase wxItemContainerImmutable
wxItemContainer define una interfaz que es implementada por todos los controles que tienen subelementos de cadena, cada uno de los cuales puede ser seleccionado.
Jerarquía:
Se descompone en wxItemContainerImmutable que omite todos los métodos de añadir/eliminar elementos y es utilizado por wxRadioBox y el propio wxItemContainer.
Hay que tener en cuenta que esto no es un control, es una interfaz mixta de la que las clases tienen que derivar además de wxControl o wxWindow.
Ejemplos: wxListBox, wxCheckListBox, wxChoice y wxComboBox (que implementa una interfaz extendida que deriva de ésta).
Funciones miembro
wxItemContainerImmutable()
wxItemContainerImmutable::wxItemContainerImmutable()
Constructor.
FindString()
virtual int wxItemContainerImmutable::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 en wxRadioBox, wxListBox, wxComboBox y wxChoice.
GetCount()
virtual unsigned int wxItemContainerImmutable::GetCount() const
Devuelve el número de elementos del control.
Reimplementado en wxRadioBox, wxListBox, wxComboBox y wxChoice.
GetSelection()
virtual int wxItemContainerImmutable::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.
Reimplementado en wxRadioBox, wxListBox, wxComboBox y wxChoice.
GetString()
virtual wxString wxItemContainerImmutable::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.
Reimplementado en wxRadioBox, wxListBox, wxComboBox y wxChoice.
GetStrings()
wxArrayString wxItemContainerImmutable::GetStrings() const
Devuelve el array de las etiquetas de todos los elementos del control.
GetStringSelection()
virtual wxString wxItemContainerImmutable::GetStringSelection() const
Devuelve la etiqueta del elemento seleccionado o una cadena vacía si no hay ningún elemento seleccionado.
Reimplementado en wxComboBox.
IsEmpty()
bool wxItemContainerImmutable::IsEmpty() const
Devuelve true si el control está vacío o false si tiene algunos elementos.
Select()
void wxItemContainerImmutable::Select(int n)
Esto es lo mismo que SetSelection() y existe solo porque es un poco más natural para los controles que soportan selección múltiple.
SetSelection()
virtual void wxItemContainerImmutable::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.
Reimplementado en wxRadioBox, wxListBox, wxComboBox y wxChoice.
SetString()
virtual void wxItemContainerImmutable::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.
Reimplementado en wxRadioBox, wxListBox, wxComboBox y wxChoice.
SetStringSelection()
bool wxItemContainerImmutable::SetStringSelection(const wxString & String)
Selecciona el elemento con la cadena especificada en el control.
Este método no provoca la emisión de ningún evento de comando.
Hay que tener en cuenta que este método no distingue entre mayúsculas y minúsculas, es decir, la cadena se compara con todos los elementos del control de forma insensible a mayúsculas y minúsculas y se selecciona la primera entrada que coincida, incluso si no tiene exactamente las mismas mayúsculas y minúsculas que esta cadena y después hay una coincidencia exacta.
Parámetros
- string
- La cadena a seleccionar.
Valor de retorno
true si se ha seleccionado la cadena especificada, false si no se ha encontrado en el control.