Clase wxCheckListBox
Un wxCheckListBox es como un wxListBox, pero permite marcar o desmarcar elementos.
Jerarquía:
Cuando se utiliza esta clase bajo Windows wxWidgets debe ser compilado con wxUSE_OWNER_DRAWN establecido en 1.
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_CHECKLISTBOX(id, func)
- Procesa un evento wxEVT_CHECKLISTBOX, cuando se marca o desmarca un elemento del cuadro de lista. wxCommandEvent::GetInt() contendrá el índice del elemento marcado o desmarcado. wxCommandEvent::IsChecked() ¡no es válido! Utilice wxCheckListBox::IsChecked() en su lugar.
Funciones miembro
wxCheckListBox()
wxCheckListBox::wxCheckListBox()
Constructor por defectos.
wxCheckListBox()
wxCheckListBox::wxCheckListBox( 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 = "listBox" )
Constructor que crea y muestra un cuadro de lista.
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, la ventana tendrá el tamaño adecuado.
- n
- Número de cadenas con las que se inicializa el control.
- choices
- Un array de cadenas con las que inicializar el control.
- style
- Estilo de la ventana.
- validator
- Validador de la ventana.
- name
- Nombre de la ventana.
Nota: No soportado por wxPerl.
wxCheckListBox()
wxCheckListBox::wxCheckListBox( wxWindow * parent, wxWindowID id, const wxPoint & pos, const wxSize & size, const wxArrayString & choices, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = "listBox" )
Constructor que crea y muestra un cuadro de lista.
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 el tamaño de la ventana es el adecuado.
- choices
- Un array de cadenas con las que inicializar el control.
- 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.
~wxCheckListBox()
virtual wxCheckListBox::~wxCheckListBox()
Destructor, que destruye el cuadro de lista.
Check()
void wxCheckListBox::Check( unsigned int item, bool check = true )
Marca el elemento dado.
Hay que tener en cuenta que al llamar a este método no se emite ningún evento wxEVT_CHECKLISTBOX.
Parámetros
- item
- Índice del elemento a comprobar.
- check
- true si se comprueba el elemento, false en caso contrario.
Create()
bool wxCheckListBox::Create( wxWindow * parent, wxWindowID id, const wxPoint & pos, const wxSize & size, const wxArrayString & choices, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = "listBox" )
Función de creación de CheckListBox en dos pasos.
Create()
bool wxCheckListBox::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 = "listBox" )
Función de creación de CheckListBox en dos pasos.
GetCheckedItems()
unsigned int wxCheckListBox::GetCheckedItems(wxArrayInt & checkedItems) const
Devuelve los índices de los elementos comprobados.
Parámetros
- checkedItems
- Una referencia al array que se rellena con los índices de los elementos marcados.
Valor de retorno
El número de elementos marcados.
IsChecked()
bool wxCheckListBox::IsChecked(unsigned int item) const
Devuelve true si el elemento dado está marcado, false en caso contrario.
Parámetros
- item
- Índice del elemento cuyo estado de comprobación debe devolverse.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject. wxEvtHandler, wxWindow, wxControl, wxListBox, wxItemContainer y wxItemContainerImmutable.