mensaje de EM_AUTOURLDETECT

Habilita o deshabilita la detección automática de hipervínculos mediante un control de edición enriquecido.

Parámetros

wParam

Especifique 0 para deshabilitar la detección automática de vínculos o uno de los siguientes valores para habilitar varios tipos de detección.

Valor Significado
AURL_DISABLEMIXEDLGC
Windows 8: deshabilite el reconocimiento de nombres de dominio que contienen etiquetas con caracteres que pertenecen a más de uno de los siguientes scripts: Latino, Griego y Cirílico.
AURL_ENABLEDRIVELETTERS
Windows 8: reconozca los nombres de archivo que tienen una especificación de unidad líder, como c:\temp.
AURL_ENABLEEA
Este valor está en desuso; use AURL_ENABLEEAURLS en su lugar.
AURL_ENABLEEAURLS
Reconocer direcciones URL que contienen caracteres asiáticos orientales.
AURL_ENABLEEMAILADDR
Windows 8: reconocer direcciones de correo electrónico.
AURL_ENABLETELNO
Windows 8: reconocer números de teléfono.
AURL_ENABLEURL
Windows 8: reconozca las direcciones URL que incluyen la ruta de acceso.

lParam

Este parámetro determina los esquemas de dirección URL reconocidos si AURL_ENABLEURL está activo. Si lParam es NULL, se usa la lista de nombres de esquema predeterminada (vea Comentarios). Como alternativa, lParam puede apuntar a una cadena terminada en null que consta de hasta 50 nombres de esquema terminados por dos puntos que reemplazan a la lista de nombres de esquema predeterminado. Por ejemplo, la cadena podría ser "news:http:ftp:telnet:". La sintaxis del nombre de esquema se define en el documento Identificadores uniformes de recursos (URI): Sintaxis genérica en el sitio web del Grupo de tareas de ingeniería de Internet (IETF). En concreto, un nombre de esquema puede contener hasta 13 caracteres (incluidos los dos puntos), debe comenzar con un alfabeto ASCII y puede ir seguido de una combinación de alfabetos ASCII, dígitos y los tres caracteres de puntuación: ".", "+" y "-". El tipo de cadena puede ser char* o WCHAR*; el control de edición enriquecida detecta automáticamente el tipo.

Valor devuelto

Si el mensaje se realiza correctamente, el valor devuelto es cero.

Si se produce un error en el mensaje, el valor devuelto es un valor distinto de cero. Por ejemplo, el mensaje podría producir un error debido a memoria insuficiente, una opción de detección no válida o una cadena de nombre de esquema no válida.

Si lParam contiene más de 50 nombres de esquema, se produce un error en el mensaje con un valor devuelto de E_INVALIDARG.

Comentarios

Si la detección automática de direcciones URL está habilitada (es decir, wParam incluye AURL_ENABLEURL), el control de edición enriquecida examina cualquier texto modificado para determinar si el texto coincide con el formato de una dirección URL (o, más generalmente, en Windows 8 o posterior, un identificador de recursos internacional de IRI). Si lParam es NULL, el control detecta direcciones URL que comienzan con los siguientes nombres de esquema:

  • callto
  • archivo
  • ftp
  • gopher
  • http
  • https
  • mailto
  • news
  • HDInsight
  • Nntp
  • onenote
  • Outlook
  • Prospero
  • tel
  • telnet
  • wais
  • webcal

Cuando se habilita la detección automática de vínculos, el control de edición enriquecida quita el efecto CFE_LINK del texto modificado que no tiene un formato reconocido por el control. Si la aplicación usa el efecto CFE_LINK para marcar otros tipos de texto, no habilite la detección automática de vínculos. El control de edición enriquecida no comprueba si existe un vínculo detectado; esa responsabilidad pertenece al cliente.

Un control de edición enriquecido envía la notificación EN_LINK cuando recibe varios mensajes mientras el puntero del mouse está sobre texto que tiene el efecto CFE_LINK . Para obtener más información, vea Hipervínculos RichEdit automáticos y Hipervínculos de nombre descriptivo RichEdit.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Richedit.h

Consulte también

CHARFORMAT2

EN_LINK