Click here to Skip to main content
13,046,176 members (70,459 online)
Click here to Skip to main content


42 bookmarked
Posted 16 Oct 2003

XHyperLink - yet another hyperlink control

, 16 Oct 2003
XHyperLink is a simple drop-in hyperlink control with optional parent notification.
// XHyperLink.h  Version 1.0
// XHyperLink static control. Will open the default browser with the given URL
// when the user clicks on the link.
// Copyright Chris Maunder, 1997-1999 (
// Feel free to use and distribute. May not be sold for profit. 
// 2/29/00 -- P. Shaffer standard font mod.
// Modified by:  Hans Dietrich



// CXHyperLink window

class CXHyperLink : public CStatic
// Construction/destruction
    virtual ~CXHyperLink();

    enum UnderLineOptions { ulHover = -1, ulNone = 0, ulAlways = 1};

// Attributes
    void SetURL(CString strURL);
	CString GetURL() const
		return m_strURL; 

	void EnableURL(BOOL bFlag) { m_bIsURLEnabled = bFlag; }
	BOOL IsURLEnabled() const { return m_bIsURLEnabled; }

    void SetColours(COLORREF crLinkColour, 
					COLORREF crVisitedColour, 
                    COLORREF crHoverColour = -1);

	COLORREF GetLinkColour() const
		return m_crLinkColour; 

	COLORREF GetVisitedColour() const
		return m_crVisitedColour; 

	COLORREF GetHoverColour() const
		return m_crHoverColour;

	void SetBackgroundColour(COLORREF crBackground);
	COLORREF GetBackgroundColour() const
		return m_crBackground;

    void SetVisited(BOOL bVisited = TRUE);
	BOOL GetVisited() const
		return m_bVisited; 

    void SetLinkCursor(HCURSOR hCursor);
	HCURSOR CXHyperLink::GetLinkCursor() const
		return m_hLinkCursor;

    void SetUnderline(int nUnderline = ulHover);
	int GetUnderline() const
		return m_nUnderline; 

    void SetAutoSize(BOOL bAutoSize = TRUE);
	BOOL GetAutoSize() const
		return m_bAdjustToFit; 

	void SetNotifyParent(BOOL bFlag) { m_bNotifyParent = bFlag; }
	BOOL GetNotifyParent() const { return m_bNotifyParent; }

	void EnableTooltip(BOOL bFlag) 
		m_bToolTip = bFlag; 
	BOOL IsTooltipEmabled() const 
		return m_bToolTip; 

	void SetAlwaysOpenNew(BOOL bFlag) 
		m_bAlwaysOpenNew = bFlag; 
	BOOL GetAlwaysOpenNew() const 
		return m_bAlwaysOpenNew; 

	void SetWindowText(LPCTSTR lpszString);

// Operations
	static HINSTANCE GotoURL(LPCTSTR url, int showcmd,  BOOL bAlwaysOpenNew = FALSE);

// Overrides
    // ClassWizard generated virtual function overrides
    virtual BOOL PreTranslateMessage(MSG* pMsg);
	virtual BOOL DestroyWindow();
    virtual void PreSubclassWindow();

// Implementation
	static LONG GetRegKey(HKEY key, LPCTSTR subkey, LPTSTR retdata);
	void NotifyParent();
	void PositionWindow();
	void ReportError(int nError);
	void SetDefaultCursor();

// Protected attributes
    COLORREF		m_crLinkColour;		// Hyperlink colours
	COLORREF		m_crVisitedColour;
    COLORREF		m_crHoverColour;	// Hover colour
	COLORREF		m_crBackground;		// background color
	CBrush			m_Brush;			// background brush
    BOOL			m_bOverControl;		// cursor over control?
    BOOL			m_bVisited;			// Has it been visited?
    int				m_nUnderline;		// underline hyperlink?
    BOOL			m_bAdjustToFit;		// Adjust window size to fit text?
    CString			m_strURL;			// hyperlink URL
    CFont			m_UnderlineFont;	// Font for underline display
    CFont			m_StdFont;			// Standard font
    HCURSOR			m_hLinkCursor;		// Cursor for hyperlink
    CToolTipCtrl	m_ToolTip;			// The tooltip
    UINT			m_nTimerID;
	BOOL			m_bIsURLEnabled;	// TRUE = navigate to url
	BOOL			m_bNotifyParent;	// TRUE = notify parent
	BOOL			m_bToolTip;			// TRUE = display tooltip
	BOOL			m_bAlwaysOpenNew;	// TRUE = always open new browser window

    // Generated message map functions
    afx_msg HBRUSH CtlColor(CDC* pDC, UINT nCtlColor);
    afx_msg BOOL OnSetCursor(CWnd* pWnd, UINT nHitTest, UINT message);
    afx_msg void OnMouseMove(UINT nFlags, CPoint point);
	afx_msg BOOL OnEraseBkgnd(CDC* pDC);
	afx_msg void OnTimer(UINT nIDEvent);
    afx_msg void OnClicked();


// Microsoft Developer Studio will insert additional declarations immediately before the previous line.


By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Hans Dietrich
Software Developer (Senior) Hans Dietrich Software
United States United States
I attended St. Michael's College of the University of Toronto, with the intention of becoming a priest. A friend in the University's Computer Science Department got me interested in programming, and I have been hooked ever since.

Recently, I have moved to Los Angeles where I am doing consulting and development work.

For consulting and custom software development, please see

You may also be interested in...

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170713.1 | Last Updated 17 Oct 2003
Article Copyright 2003 by Hans Dietrich
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid