Clase wxRadioButton
Un elemento de botón de opción es un botón que normalmente denota una de varias opciones mutuamente excluyentes.
Jerarquía:
Tiene una etiqueta de texto junto a un botón (normalmente) redondo.
Los botones de opción se suelen utilizar en grupos de botones mutuamente excluyentes, es decir, se marca exactamente uno de los botones del grupo y los demás se desmarcan automáticamente. Estos grupos se crean implícitamente, pero también pueden iniciarse explícitamente utilizando el estilo wxRB_GROUP: un botón con este estilo inicia un nuevo grupo y se convertirá en la selección inicial de este grupo. Alternativamente, un botón de radio puede ser excluido del grupo al que pertenecería utilizando el estilo wxRB_SINGLE.
Para encontrar los otros elementos del mismo grupo de botones de radio, puede utilizar las funciones GetFirstInGroup(), GetPreviousInGroup(), GetNextInGroup() y GetLastInGroup().
Estilos
Esta clase soporta los siguientes estilos:
- wxRB_GROUP
- Marca el inicio de un nuevo grupo de botones de opción.
- wxRB_SINGLE
- Crea un botón de radio que no forma parte de ningún grupo de botones de radio. Cuando se utiliza este estilo, ningún otro botón de radio se apagará automáticamente cuando este botón se encienda y tal comportamiento tendrá que ser implementado manualmente, en el manejador de eventos para este botón. Este estilo solo está soportado actualmente en wxMSW y wxGTK (desde la versión 3.2.x). En los otros ports se puede especificar, pero los botones de radio simples no se pueden desactivar, lo que los hace poco útiles.
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 de eventos para eventos emitidos por esta clase:
- EVT_RADIOBUTTON(id, func)
- Procesa un evento wxEVT_RADIOBUTTON, cuando el radiobutton es pulsado.
Funciones miembro
wxRadioButton()
wxRadioButton::wxRadioButton()
Constructor por defecto.
wxRadioButton()
wxRadioButton::wxRadioButton( 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 = wxRadioButtonNameStr )
Constructor, crea y muestra un botón de radio.
Parámetros
- parent
- Ventana padre. No debe ser NULL.
- id
- Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
- label
- Etiqueta para el botón de radio.
- 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 se elige un tamaño por defecto.
- style
- Estilo de la ventana. Ver wxRadioButton.
- validator
- Validador de la ventana.
- name
- Nombre de la ventana.
~wxRadioButton()
virtual wxRadioButton::~wxRadioButton()
Destructor, destruye el elemento botón de radio.
Create()
bool wxRadioButton::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 = wxRadioButtonNameStr )
Crea la opción para la construcción en dos pasos.
Ver wxRadioButton() para más detalles.
GetFirstInGroup()
wxRadioButton* wxRadioButton::GetFirstInGroup() const
Devuelve el primer botón del grupo de botones de radio al que pertenece este botón.
Para un botón de radio con estilo wxRB_SINGLE, esta función devuelve este mismo botón, ya que es el único miembro de su grupo. En caso contrario, la función devuelve el botón de radio anterior más cercano con estilo wxRB_GROUP (que podría ser este mismo botón) o el primer botón de radio de la misma ventana.
El valor devuelto nunca es NULL.
GetLastInGroup()
wxRadioButton* wxRadioButton::GetLastInGroup() const
Devuelve el último botón del grupo de botones de radio al que pertenece este botón.
De forma similar a GetFirstInGroup(), esta función devuelve este mismo botón si tiene el estilo wxRB_SINGLE. En caso contrario, la función devuelve el último botón antes del siguiente botón con estilo wxRB_GROUP o el último botón de radio de la misma ventana.
El valor devuelto nunca es NULL.
GetNextInGroup()
wxRadioButton* wxRadioButton::GetNextInGroup() const
Devuelve el siguiente botón de radio del mismo grupo.
El valor devuelto es NULL si no hay sucesor o si este botón tiene el estilo wxRB_SINGLE.
GetPreviousInGroup()
wxRadioButton* wxRadioButton::GetPreviousInGroup() const
Devuelve el botón de opción anterior del mismo grupo.
El valor devuelto es NULL si no hay predecesor o si este botón tiene el estilo wxRB_SINGLE.
GetValue()
virtual bool wxRadioButton::GetValue() const
Devuelve true si el botón de radio está marcado, false en caso contrario.
SetValue()
virtual void wxRadioButton::SetValue(bool value)
Establece el botón de radio en estado marcado o desmarcado.
Esto no provoca que se emita un evento wxEVT_RADIOBUTTON.
Si el botón pertenece a un grupo de botones, solo uno de ellos puede estar marcado, por lo que este método solo puede invocarse con el valor true. Para desmarcar un botón de radio de un grupo se debe marcar otro botón del mismo grupo.
Nota: En MSW, el botón de opción seleccionado siempre está seleccionado, es decir, su valor es verdadero. Y, a la inversa, al llamar a SetValue(true) también se activará el botón de opción si el foco estaba previamente en otro botón de opción del mismo grupo, ya que de lo contrario no funcionaría.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxControl, wxWindow, wxEvtHandler y wxObject.