CLinkCtrl Class

Article
04/28/2015

Provides the functionality of the Windows common SysLink control.

class CLinkCtrl : public CWnd

Members

Public Constructors

Name	Description
CLinkCtrl::CLinkCtrl	Constructs a CLinkCtrl object.

Public Methods

Name	Description
CLinkCtrl::Create	Creates a link control and attaches it to a CLinkCtrl object.
CLinkCtrl::CreateEx	Creates a link control with extended styles and attaches it to a CLinkCtrl object.
CLinkCtrl::GetIdealHeight	Retrieves the ideal height of the link control.
CLinkCtrl::GetIdealSize	Calculates the preferred height of the link text for the current link control, depending on the specified width of the link.
CLinkCtrl::GetItem	Retrieves the states and attributes of a link control item.
CLinkCtrl::GetItemID	Retrieves the ID of a link control item.
CLinkCtrl::GetItemState	Retrieves the state of the link control item.
CLinkCtrl::GetItemUrl	Retrieves the URL represented by the link control item.
CLinkCtrl::HitTest	Determines whether the user clicked the specified link.
CLinkCtrl::SetItem	Sets the states and attributes of a link control item.
CLinkCtrl::SetItemID	Sets the ID of a link control item.
CLinkCtrl::SetItemState	Sets the state of the link control item.
CLinkCtrl::SetItemUrl	Sets the URL represented by the link control item.

Remarks

A "link control" provides a convenient way to embed hypertext links in a window. The actual control is a window that renders marked-up text and launches appropriate applications when the user clicks an embedded link. Multiple links are supported within one control and can be accessed by a zero-based index.

This control (and therefore the CLinkCtrl class) is available only to programs running under Windows XP and later.

For more information, see SysLink Control in the Windows SDK.

Inheritance Hierarchy

CObject

CCmdTarget

CWnd

CLinkCtrl

Requirements

Header: afxcmn.h