A rich edit control sends EN_LINK messages when it receives various messages, for example, when the user clicks the mouse or when the mouse pointer is over text that has the CFE_LINK effect.

The parent window of the control receives this notification message through a WM_NOTIFY message.

Syntax

EN_LINK

    WPARAM wParam
    LPARAM lParam;
    

Parameters

wParam

Specifies the control identifier.

lParam

Pointer to an ENLINK structure. The structure contains an NMHDR structure, information about the message received by the control, and a CHARRANGE structure that indicates the range of characters that have the CFE_LINK effect.

Return Value

If you return zero, the control proceeds with its normal handling of the message.

If you return a nonzero value, the control does not handle the message.

Remarks

To receive EN_LINK notifications, specify the ENM_LINK flag in the mask sent with the EM_SETEVENTMASK message.

A rich edit control sends EN_LINK notifications when it receives the following messages while the mouse pointer is over text that has the CFE_LINK effect:

• WM_LBUTTONDBLCLK
• WM_LBUTTONDOWN
• WM_LBUTTONUP
• WM_MOUSEMOVE
• WM_RBUTTONDBLCLK
• WM_RBUTTONDOWN
• WM_RBUTTONUP
• WM_SETCURSOR

The CFE_LINK effect typically identifies a range of text that contains an URL. Applications can handle the EN_LINK notification by changing the mouse pointer when it is over the URL, or by starting a browser to view the location identified by the URL.

If you send the EM_AUTOURLDETECT message to enable automatic URL detection, the rich edit control automatically sets the CFE_LINK effect for modified text that it identifies as a URL.

Notification Requirements

Minimum DLL Version	None
Header	Declared in Richedit.h
Minimum operating systems	Windows 95 with Rich Edit 2.0, Windows 98, Windows NT 4.0

See Also

CHARRANGE, EM_AUTOURLDETECT, EM_AUTOURLDETECT, ENLINK, HIWORD, LOWORD, NMHDR