Clase wxCommandLinkButton
Los objetos de esta clase son similares en apariencia a los wxButtons normales pero son similares a los enlaces de una página web en funcionalidad.
Jerarquía:
Al pulsar este botón, normalmente se cambia a otra ventana del programa, por lo que se puede utilizar como sustituto del botón "Siguiente" en un diálogo multipágina (como wxWizard), por ejemplo.
Su ventaja frente a los wxButtons ordinarios es que enfatizan la acción de cambiar de ventana y también que permiten dar una explicación más detallada al usuario porque, además de la etiqueta corta del botón, también muestran una cadena de descripción más larga.
La parte corta, parecida a un título, de la etiqueta se llama etiqueta principal y la descripción más larga es la nota. Ambas pueden establecerse y consultarse independientemente utilizando métodos específicos de wxCommandLinkButton como SetMainLabel() o GetNote() o también mediante los métodos SetLabel() y GetLabel() heredados de wxButton. Cuando se utiliza este último, la etiqueta principal y la nota se concatenan en una sola cadena utilizando un carácter de nueva línea entre ellas (nótese que la parte de la nota puede tener más líneas nuevas en ella).
wxCommandLinkButton genera el mismo evento que wxButton pero no soporta ninguno de los estilos específicos de wxButton ni añade nuevos estilos propios.
Actualmente esta clase utiliza una implementación nativa bajo Windows Vista y versiones posteriores y una implementación genérica para el resto de plataformas y versiones anteriores de Windows.
Funciones miembro
wxCommandLinkButton()
wxCommandLinkButton::wxCommandLinkButton()
Constructor por defecto.
Utilizar Create() para crear realmente el control.
wxCommandLinkButton()
wxCommandLinkButton::wxCommandLinkButton( wxWindow * parent, wxWindowID id, const wxString & mainLabel = wxEmptyString, const wxString & note = wxEmptyString, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxButtonNameStr )
Constructor que realmente crea un botón command Link.
El botón será decorado con iconos stock bajo GTK+ 2.
Parámetros
- parent
- Ventana padre. No debe ser NULL.
- id
- Identificador del botón. Un valor de wxID_ANY indica un valor por defecto.
- mainLabel
- Primera línea de texto del botón, normalmente la etiqueta de una acción que se realizará al pulsar el botón.
- note
- Segunda línea de texto que describe la acción que se realizará al pulsar el botón.
- pos
- Posición del botón.
- size
- Tamaño del botón. Si se especifica el tamaño por defecto, el botón tendrá el tamaño adecuado para el texto.
- style
- Estilo de la ventana. Ver descripción de la clase wxButton.
- validator
- Validador de la ventana.
- name
- Nombre de la ventana.
Create()
bool wxCommandLinkButton::Create( wxWindow * parent, wxWindowID id, const wxString & mainLabel = wxEmptyString, const wxString & note = wxEmptyString, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxButtonNameStr )
Función de creación de botones para la creación en dos pasos.
GetLabel()
wxString wxCommandLinkButton::GetLabel() const
Devuelve la etiqueta del botón.
Ver también Véase también SetLabel().
Valor de retorno
Una cadena con la etiqueta principal y la nota concatenadas con una nueva línea separándolas.
Reimplementado de wxButton.
GetMainLabel()
wxString wxCommandLinkButton::GetMainLabel() const
Devuelve la etiqueta principal actual.
Valor de retorno
Etiqueta principal mostrada actualmente.
GetNote()
wxString wxCommandLinkButton::GetNote() const
Devuelve la nota utilizada actualmente.
Valor de retorno
Nota mostrada actualmente.
SetLabel()
virtual void wxCommandLinkButton::SetLabel(const wxString & label)
Establece la etiqueta y la nota del botón.
Parámetros
- label
- La etiqueta y la nota a establecer, con las dos separadas por la primera nueva línea o none para establecer una nota en blanco.
Reimplementado de wxButton.
SetMainLabel()
void wxCommandLinkButton::SetMainLabel(const wxString & mainLabel)
Cambia la etiqueta principal.
Parámetros
- mainLabel
- Nueva etiqueta principal a utilizar.
SetMainLabelAndNote()
Establece una nueva etiqueta principal y nota para el botón.
Ninguno de los argumentos puede estar vacío, si se necesita cambiar solo la etiqueta o solo la nota, utilizar SetMainLabel() o SetNote() en lugar de esta función.
Parámetros
- mainLabel
- Nueva etiqueta principal a utilizar.
- note
- Nueva nota a utilizar.
SetNote()
void wxCommandLinkButton::SetNote(const wxString & note)
Cambia la nota.
Parámetros
- note
- Nueva nota a utilizar.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow, wxControl, wxButton y wxAnyButton.