Clase wxCheckBox
Un checkbox es una casilla etiquetada que, por defecto, está activada (la marca de verificación es visible) o desactivada (sin marca de verificación).
Jerarquía:
Opcionalmente (cuando la bandera de estilo wxCHK_3STATE está activada) puede tener un tercer estado, llamado estado mixto o indeterminado. A menudo se utiliza como estado "No se aplica".
Estilos
Esta clase admite los siguientes estilos:
- wxCHK_2STATE
- Crea una casilla de verificación de 2 estados. Este es el valor predeterminado.
- wxCHK_3STATE
- Crea una casilla de verificación de 3 estados.
- wxCHK_ALLOW_3RD_STATE_FOR_USER
- Por defecto un usuario no puede poner un checkbox de 3 estados en el tercer estado. Solo se puede hacer desde código. El uso de estas banderas permite al usuario establecer la casilla de verificación en el tercer estado haciendo clic.
- wxALIGN_RIGHT
- Hace que el texto aparezca a la izquierda de la casilla de verificación.
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_CHECKBOX(id, func)
- Procesa un evento wxEVT_CHECKBOX, cuando se pulsa la casilla de verificación.
Funciones miembro
wxCheckBox()
wxCheckBox::wxCheckBox()
Constructor por defecto.
wxCheckBox()
wxCheckBox::wxCheckBox( wxWindow * parent, wxWindowID id, const wxString & label, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxCheckBoxNameStr )
Constructor, crea y muestra una casilla de verificación.
Parámetros
- parent
- Ventana padre. No debe ser NULL.
- id
- Identificador de la casilla de verificación. El valor wxID_ANY indica un valor por defecto.
- label
- Texto que se mostrará junto a la casilla de verificación.
- pos
- Posición de la casilla de verificación. Si se especifica wxDefaultPosition se elige una posición por defecto.
- size
- Tamaño de la casilla. Si se especifica wxDefaultSize se elige un tamaño por defecto.
- style
- Estilo de la ventana. Ver wxCheckBox.
- validator
- Validador de la ventana.
- name
- Nombre de la ventana.
~wxCheckBox()
virtual wxCheckBox::~wxCheckBox()
Destructor, que destruye la casilla de verificación.
Create()
bool wxCheckBox::Create( wxWindow * parent, wxWindowID id, const wxString & label, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxCheckBoxNameStr )
Crea la casilla de verificación para la construcción en dos pasos.
Ver el constructor para más detalles.
Get3StateValue()
wxCheckBoxState wxCheckBox::Get3StateValue() const
Obtiene el estado de una casilla de 3 estados.
Se activa cuando la función se utiliza con una casilla de verificación de 2 estados.
GetValue()
virtual bool wxCheckBox::GetValue() const
Obtiene el estado de una casilla de verificación de 2 estados.
Valor de retorno
Devuelve true si está marcada, false en caso contrario.
Is3rdStateAllowedForUser()
bool wxCheckBox::Is3rdStateAllowedForUser() const
Devuelve si el usuario puede o no poner la casilla de verificación en el tercer estado.
Valor de retorno
true si el usuario puede establecer el tercer estado de esta casilla de verificación, false si solo se puede establecer mediante programación o si es una casilla de verificación de 2 estados.
Is3State()
bool wxCheckBox::Is3State() const
Devuelve si la casilla de verificación es de 3 estados o no.
Valor de retorno
true si este checkbox es un checkbox de 3 estados, false si es un checkbox de 2 estados.
IsChecked()
bool wxCheckBox::IsChecked() const
Se trata de un sinónimo quizás más legible de GetValue(): al igual que esta última, devuelve true si la casilla está marcada y false en caso contrario.
Set3StateValue()
void wxCheckBox::Set3StateValue(wxCheckBoxState state)
Pone la casilla de verificación en el estado indicado.
Esto no provoca que se emita un evento wxEVT_CHECKBOX.
Se activa cuando la casilla de verificación es de 2 estados y el estado es wxCHK_UNDETERMINED.
SetValue()
virtual void wxCheckBox::SetValue(bool state)
Pone la casilla de verificación en el estado indicado.
Esto no provoca que se emita un evento wxEVT_CHECKBOX.
Parámetros
- state
- Si es true, la casilla está activada, en caso contrario está desactivada.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow y wxControl.