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 Engineering Task Force (IETF) 網站上的一般語法檔。 具體來說,配置名稱最多可以包含 13 個字元, (包括冒號) 、開頭必須是 ASCII 字母,後面接著 ASCII 字母、數位和三個標點符號字元:「.」、「+」 和 「-」。 字串類型可以是 char* 或 WCHAR*;豐富的編輯控制項會自動偵測類型。
傳回值
如果訊息成功,則傳回值為零。
如果訊息失敗,傳回值為非零值。 例如,訊息可能會因為記憶體不足、偵測選項無效或配置名稱字串無效而失敗。
如果 lParam 包含超過 50 個配置名稱,則訊息會失敗,傳回值為 E_INVALIDARG。
備註
如果啟用自動 URL 偵測 (也就是說,wParam包含AURL_ENABLEURL) ,則 RTF 編輯控制項會掃描任何修改過的文字,以判斷文字是否符合 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 效果來標記其他類型的文字,請勿啟用自動連結偵測。 豐富的編輯控制項不會檢查偵測到的連結是否存在;該責任屬於用戶端。
當滑鼠指標位於具有 CFE_LINK 效果的文字上時,豐富編輯控制項會在收到各種訊息時傳送 EN_LINK 通知。 如需詳細資訊,請參閱 自動 RichEdit 超連結 和 RichEdit 易記名稱超連結。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|