Table Of Contents

Previous topic

hyperlink

Next topic

HyperLinkEvent

This Page

Phoenix Logo

phoenix_title HyperLinkCtrl

HyperLinkCtrl is a control for wxPython that acts like a hyper link in a typical browser. Latest features include the ability to capture your own left, middle, and right click events to perform your own custom event handling and ability to open link in a new or current browser window.


class_hierarchy Class Hierarchy

Inheritance diagram for class HyperLinkCtrl:


appearance Control Appearance


wxMSW

wxMSW

wxMAC

wxMAC

wxGTK

wxGTK


super_classes Known Superclasses

lib.stattext.GenStaticText


method_summary Methods Summary

__init__ Default class constructor.
AutoBrowse Automatically browse to URL when clicked.
DisplayError Displays an error message (according to the ReportErrors parameter) in a
DoPopup Sets whether to show popup menu on right click or not.
EnableRollover Enable/disable rollover.
GetBold Returns whether the HyperLinkCtrl has text in bold or not.
GetColours Gets the colours for the link, the visited link and the mouse
GetLinkCursor Gets the link cursor.
GetUnderlines Returns if link is underlined, if the mouse rollover is
GetURL Retrieve the URL associated to the HyperLinkCtrl.
GetVisited Returns whether a link has been visited or not.
GotoURL Goto the specified URL.
OnMouseEvent Handles the EVT_MOUSE_EVENTS events for HyperLinkCtrl.
OnPopUpCopy Handles the EVT_MENU event for HyperLinkCtrl.
OpenInSameWindow Open multiple URL in the same window (if possible).
ReportErrors Set whether to report browser errors or not.
SetBold Sets the HyperLinkCtrl label in bold text.
SetColours Sets the colours for the link, the visited link and the mouse rollover.
SetLinkCursor Sets link cursor properties.
SetUnderlines Sets whether the text should be underlined or not for new links, visited
SetURL Sets the HyperLinkCtrl text to the specified URL.
SetVisited Sets a link as visited.
UpdateLink Updates the link, changing text properties if

api Class API



class HyperLinkCtrl(StaticText)

HyperLinkCtrl is a control for wxPython that acts like a hyper link in a typical browser. Latest features include the ability to capture your own left, middle, and right click events to perform your own custom event handling and ability to open link in a new or current browser window.


Methods



__init__(self, parent, id=-1, label="", pos=DefaultPosition, size=DefaultSize, style=0, name="staticText", URL="")

Default class constructor.

Parameters:
  • parent – the window parent. Must not be None;
  • id – window identifier. A value of -1 indicates a default value;
  • label – the control label;
  • pos – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;
  • size – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform;
  • style – the window style;
  • name – the window name;
  • URL – a string specifying the url link to navigate to.

Note

Pass URL=”” to use the label as the url link to navigate to.



AutoBrowse(self, AutoBrowse=True)

Automatically browse to URL when clicked.

Parameters:AutoBrowseTrue to automatically browse to an URL when clicked, False otherwise.

Note

Set AutoBrowse to False to receive EVT_HYPERLINK_LEFT events.



DisplayError(self, ErrorMessage, ReportErrors=True)

Displays an error message (according to the ReportErrors parameter) in a MessageBox.

Parameters:
  • ErrorMessage – a string representing the error to display;
  • ReportErrorsTrue to display error dialog if an error occurrs navigating to the URL.


DoPopup(self, DoPopup=True)

Sets whether to show popup menu on right click or not.

Parameters:DoPopupTrue to show a popup menu on right click, False otherwise.


EnableRollover(self, EnableRollover=False)

Enable/disable rollover.

Parameters:EnableRolloverTrue to enable text effects during rollover, False to disable them.


GetBold(self)

Returns whether the HyperLinkCtrl has text in bold or not.



GetColours(self)

Gets the colours for the link, the visited link and the mouse rollover.



GetLinkCursor(self)

Gets the link cursor.



GetUnderlines(self)

Returns if link is underlined, if the mouse rollover is underlined and if the visited link is underlined.



GetURL(self)

Retrieve the URL associated to the HyperLinkCtrl.



GetVisited(self)

Returns whether a link has been visited or not.



GotoURL(self, URL, ReportErrors=True, NotSameWinIfPossible=False)

Goto the specified URL.

Parameters:
  • URL – the url link we wish to navigate;
  • ReportErrors – Use True to display error dialog if an error occurrs navigating to the URL;
  • NotSameWinIfPossible – Use True to attempt to open the URL in new browser window.


OnMouseEvent(self, event)

Handles the EVT_MOUSE_EVENTS events for HyperLinkCtrl.

Parameters:event – a MouseEvent event to be processed.


OnPopUpCopy(self, event)

Handles the EVT_MENU event for HyperLinkCtrl.

Parameters:event – a MenuEvent event to be processed.

Note

This method copies the data from the HyperLinkCtrl to the clipboard.



OpenInSameWindow(self, NotSameWinIfPossible=False)

Open multiple URL in the same window (if possible).

Parameters:NotSameWinIfPossibleTrue to open an hyperlink in a new browser window, False to use an existing browser window.


ReportErrors(self, ReportErrors=True)

Set whether to report browser errors or not.

Parameters:ReportErrors – Use True to display error dialog if an error occurrs navigating to the URL;


SetBold(self, Bold=False)

Sets the HyperLinkCtrl label in bold text.

Parameters:BoldTrue to set the HyperLinkCtrl label as bold, False otherwise.


SetColours(self, link=Colour(0, 0, 255), visited=Colour(79, 47, 79), rollover=Colour(0, 0, 255))

Sets the colours for the link, the visited link and the mouse rollover.

  • Visited link: VIOLET
  • Rollover: BLUE
Parameters:
  • link – a valid Colour to use as text foreground for new links (default=RED);
  • visited – a valid Colour to use as text foreground for visited links (default=VIOLET);
  • rollover – a valid Colour to use as text foreground for links rollovers (default=BLUE).


SetLinkCursor(self, cur=CURSOR_HAND)

Sets link cursor properties.

Parameters:cur – an integer representing a Cursor constant.


SetUnderlines(self, link=True, visited=True, rollover=True)

Sets whether the text should be underlined or not for new links, visited links and rollovers.

Parameters:
  • linkTrue to set the text of new links as underlined, False otherwise;
  • visitedTrue to set the text of visited links as underlined, False otherwise;
  • rolloverTrue to set the text of rollovers as underlined, False otherwise.


SetURL(self, URL)

Sets the HyperLinkCtrl text to the specified URL.

Parameters:URL – the new URL associated with HyperLinkCtrl.


SetVisited(self, Visited=False)

Sets a link as visited.

Parameters:VisitedTrue to set a link as visited, False otherwise.


Updates the link, changing text properties if:

  • User specific setting;
  • Link visited;
  • New link;
Parameters:OnRefreshTrue to refresh the control, False otherwise.