сообщение 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

Этот параметр определяет схемы URL-адресов, распознанные , если AURL_ENABLEURL активна. Если lParam имеет значение NULL, используется список имен схем по умолчанию (см. примечания). Кроме того, lParam может указывать на строку, завершающуюся нулевым значением, которая содержит до 50 имен схем, завершаемых двоеточием, которые заменяют список имен схем по умолчанию. Например, строка может быть "news:http:ftp:telnet:". Синтаксис имени схемы определен в документе Универсальные идентификаторы ресурсов (URI): универсальный синтаксис на веб-сайте Internet Engineering Task Force (IETF). В частности, имя схемы может содержать до 13 символов (включая двоеточие), должно начинаться с алфавита ASCII, а за ним может следовать сочетание алфавита, цифр и трех знаков препинания: ".", "+" и "-". Тип строки может быть char* или WCHAR*; элемент управления полнофункционально редактирует тип автоматически.

Возвращаемое значение

Если сообщение завершается успешно, возвращаемое значение равно нулю.

Если сообщение завершается ошибкой, возвращаемое значение будет ненулевым. Например, сообщение может завершиться ошибкой из-за нехватки памяти, недопустимого параметра обнаружения или недопустимой строки имени схемы.

Если lParam содержит более 50 имен схем, сообщение завершается ошибкой с возвращаемым значением E_INVALIDARG.

Комментарии

Если включено автоматическое обнаружение URL-адресов (то есть wParam включает AURL_ENABLEURL), элемент управления расширенным редактированием сканирует любой измененный текст, чтобы определить, соответствует ли текст формату URL-адреса (или, в более общем случае, в Windows 8 или более поздней версии международный идентификатор ресурса IRI). Если lParam имеет значение NULL, элемент управления обнаруживает URL-адреса, начинающиеся со следующих имен схем:

  • callto
  • файл
  • ftp
  • gopher
  • http
  • HTTPS
  • mailto
  • news
  • HDInsight
  • Nntp
  • onenote
  • outlook
  • Просперо
  • tel
  • telnet
  • wais
  • webcal

Если включено автоматическое обнаружение ссылок, элемент управления расширенным редактированием удаляет эффект CFE_LINK из измененного текста, который не имеет формата, распознаваемого элементом управления. Если приложение использует эффект CFE_LINK для пометки других типов текста, не включайте автоматическое обнаружение ссылок. Элемент управления многофункциональным редактированием не проверка, существует ли обнаруженная ссылка; эта ответственность лежит на клиенте.

Элемент управления многофункциональным редактированием отправляет уведомление EN_LINK при получении различных сообщений, когда указатель мыши находится на тексте, который имеет CFE_LINK эффект. Дополнительные сведения см. в разделах Автоматические гиперссылки RichEdit и Гиперссылки с понятными именами RichEdit.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Richedit.h

См. также раздел

CHARFORMAT2

EN_LINK