Clase wxHyperlinkCtrl
Esta clase muestra un elemento de texto estático que enlaza con una URL.
Jerarquía:
Su apariencia y comportamiento son totalmente personalizables.
De hecho, cuando el usuario hace clic en el hipervínculo, se envía un wxHyperlinkEvent, pero si ese evento no se gestiona (o se omite; ver wxEvent::Skip), se realiza una llamada a wxLaunchDefaultBrowser() con la URL del hipervínculo.
Hay que tener en cuenta que las funciones estándar de wxWindow, como wxWindow::SetBackgroundColour, wxWindow::SetFont, wxWindow::SetCursor y wxWindow::SetLabel, se pueden utilizar para personalizar la apariencia del hipervínculo.
Estilos
Esta clase admite los siguientes estilos:
- wxHL_ALIGN_LEFT
- Alinea el texto a la izquierda.
- wxHL_ALIGN_RIGHT
- Alinea el texto a la derecha. Este estilo no es compatible con Windows.
- wxHL_ALIGN_CENTRE
- Centrar el texto (horizontalmente). Este estilo no es compatible con Windows.
- wxHL_CONTEXTMENU
- Abrir un menú contextual al hacer clic con el botón derecho del ratón sobre el hipervínculo. El menú contextual contiene una opción llamada "Copiar URL" que es gestionada automáticamente por el hipervínculo y que simplemente copia en el portapapeles la URL (no la etiqueta) del control.
- wxHL_DEFAULT_STYLE
- El estilo predeterminado para wxHyperlinkCtrl: wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
Eventos emitidos por esta clase
Las siguientes macros de controlador de eventos redirigen los eventos a los controladores de funciones miembro "func" con prototipos como:
void handlerFuncName(wxHyperlinkEvent& event)
Macros de eventos para eventos emitidos por esta clase:
- EVT_HYPERLINK(id, func)
- Se ha hecho clic con el botón izquierdo del ratón en el hipervínculo. Si ese evento no se gestiona (o se omite; ver wxEvent::Skip), se realiza una llamada a wxLaunchDefaultBrowser() con la URL del hipervínculo.
Actualmente, esta clase se implementa utilizando el soporte nativo en wxGTK y wxMSW, y las demás versiones utilizan una versión genérica.
Funciones miembro
wxHyperlinkCtrl()
wxHyperlinkCtrl::wxHyperlinkCtrl()
Constructor por defecto.
wxHyperlinkCtrl()
wxHyperlinkCtrl::wxHyperlinkCtrl( wxWindow * parent, wxWindowID id, const wxString & label, const wxString & url, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxHL_DEFAULT_STYLE, const wxString & name = wxHyperlinkCtrlNameStr )
Constructor.
Consultar Create() para obtener más información.
Create()
bool wxHyperlinkCtrl::Create( wxWindow * parent, wxWindowID id, const wxString & label, const wxString & url, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxHL_DEFAULT_STYLE, const wxString & name = wxHyperlinkCtrlNameStr )
Crea el control de hipervínculo.
Parámetros
- parent
- Ventana principal. No debe ser nullptr.
- id
- Identificador de la ventana. El valor wxID_ANY indica un valor predeterminado.
- label
- Etiqueta del hipervínculo.
- url
- URL asociada a la etiqueta dada.
- pos
- Posición de la ventana.
- size
- Tamaño de la ventana. Si se especifica wxDefaultSize, la ventana se dimensiona adecuadamente.
- style
- Estilo de la ventana.
- name
- Nombre de la ventana.
GetHoverColour()
virtual wxColour wxHyperlinkCtrl::GetHoverColour() const
Devuelve el color utilizado para imprimir la etiqueta del hipervínculo cuando el ratón se encuentra sobre el control.
En la versión nativa wxMSW de este control, el color al pasar el ratón por encima es siempre el mismo que el color normal, es decir, el control no cambia su apariencia cuando el ratón se encuentra sobre él.
GetNormalColour()
virtual wxColour wxHyperlinkCtrl::GetNormalColour() const
Devuelve el color utilizado para imprimir la etiqueta cuando nunca se ha hecho clic en el enlace (es decir, el enlace no se ha visitado) y el ratón no se encuentra sobre el control.
GetURL()
virtual wxString wxHyperlinkCtrl::GetURL() const
Devuelve la URL asociada al hipervínculo.
GetVisited()
virtual bool wxHyperlinkCtrl::GetVisited() const
Devuelve verdadero si el usuario ya ha hecho clic en el hipervínculo al menos una vez.
GetVisitedColour()
virtual wxColour wxHyperlinkCtrl::GetVisitedColour() const
Devuelve el color utilizado para imprimir la etiqueta cuando el ratón no se encuentra sobre el control y ya se ha hecho clic en el enlace anteriormente (es decir, se ha visitado el enlace).
SetHoverColour()
virtual void wxHyperlinkCtrl::SetHoverColour(const wxColour & colour)
Establece el color utilizado para imprimir la etiqueta del hipervínculo cuando el ratón se encuentra sobre el control.
El cambio de este color no es compatible con la versión nativa de wxMSW.
SetNormalColour()
virtual void wxHyperlinkCtrl::SetNormalColour(const wxColour & colour)
Establece el color utilizado para imprimir la etiqueta cuando nunca se ha hecho clic en el enlace (es decir, el enlace no se ha visitado) y el ratón no se encuentra sobre el control.
SetURL()
virtual void wxHyperlinkCtrl::SetURL(const wxString & url)
Establece la URL asociada al hipervínculo.
SetVisited()
virtual void wxHyperlinkCtrl::SetVisited(bool visited = true)
Marca el hipervínculo como visitado (véase wxHyperlinkCtrl::SetVisitedColour).
SetVisitedColour()
virtual void wxHyperlinkCtrl::SetVisitedColour(const wxColour & colour)
Establece el color utilizado para imprimir la etiqueta cuando el ratón no se encuentra sobre el control y ya se ha hecho clic en el enlace anteriormente (es decir, el enlace ya se ha visitado).
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow y wxControl.