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 [仅限桌面应用] |
标头 |
|