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 [僅限桌面應用程式]
標頭
Richedit.h

另請參閱

CHARFORMAT2

EN_LINK