EM_AUTOURLDETECT消息

  • 项目

启用或禁用富编辑控件对超链接的自动检测。

参数

wParam

指定 0 可禁用自动链接检测，或指定以下值之一以启用各种类型的检测。

值 含义
AURL_DISABLEMIXEDLGC
 Windows 8：禁止识别包含字符属于下列多个脚本的标签的域名：拉丁文、希腊语和西里尔文。
AURL_ENABLEDRIVELETTERS
 Windows 8：识别具有前导驱动器规范的文件名，例如 c：\temp。
AURL_ENABLEEA
 此值已弃用;请改用 AURL_ENABLEEAURLS 。
AURL_ENABLEEAURLS
 识别包含东亚字符的 URL。
AURL_ENABLEEMAILADDR
 Windows 8：识别电子邮件地址。
AURL_ENABLETELNO
 Windows 8：识别电话号码。
AURL_ENABLEURL
 Windows 8：识别包含路径的 URL。

lParam

此参数确定 在AURL_ENABLEURL 处于活动状态时识别的 URL 方案。 如果 lParam 为 NULL，则使用默认方案名称列表 (请参阅备注) 。 或者， lParam 可以指向以 null 结尾的字符串，该字符串由最多 50 个以冒号结尾的方案名称组成，这些名称取代默认方案名称列表。 例如，字符串可以是“news：http：ftp：telnet：”。 方案名称语法在统 一资源标识符 (URI) ： Internet 工程任务组 (IETF) 网站上的通用语法文档中定义。 具体而言，方案名称最多可以包含 13 个字符 (包括冒号) ，必须以 ASCII 字母开头，后跟 ASCII 字母、数字和三个标点符号字符的混合：“.”、“+”和“-”。 字符串类型可以是 char* 或 WCHAR*;Rich Edit 控件会自动检测类型。

返回值

如果消息成功，则返回值为零。

如果消息失败，则返回值为非零值。 例如，由于内存不足、检测选项无效或方案名称字符串无效，消息可能会失败。

如果 lParam 包含超过 50 个方案名称，则消息将失败，返回值 E_INVALIDARG。

备注

如果启用自动 URL 检测 (即 wParam 包含AURL_ENABLEURL) ，则 rich edit 控件会扫描任何修改后的文本，以确定该文本是否与 url 的格式匹配 (或更通常Windows 8或更高版本的 IRI 国际资源标识符) 。 如果 lParam 为 NULL，则控件将检测以以下方案名称开头的 URL：

  • callto
  • 文件
  • ftp
  • gopher
  • http
  • https
  • mailto
  • news
  • 说明
  • nntp
  • onenote
  • Outlook
  • 普洛斯彼罗
  • tel
  • telnet
  • wais
  • webcal

启用自动链接检测后，富编辑控件会从没有控件识别的格式的修改文本中删除 CFE_LINK 效果。 如果应用程序使用 CFE_LINK 效果来标记其他类型的文本，请不要启用自动链接检测。 Rich Edit 控件不检查是否存在检测到的链接;该责任属于客户端。

Rich Edit 控件在收到各种消息时，当鼠标指针位于具有 CFE_LINK 效果的文本上时，它将发送 EN_LINK 通知。 有关详细信息，请参阅 自动 RichEdit 超链接 和 RichEdit 友好名称超链接。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
标头
Richedit.h

另请参阅

CHARFORMAT2

EN_LINK