Compartilhar via


EM_AUTOURLDETECT mensagem

Habilita ou desabilita a detecção automática de hiperlinks por um controle de edição avançada.

Parâmetros

wParam

Especifique 0 para desabilitar a detecção automática de link ou um dos valores a seguir para habilitar vários tipos de detecção.

Valor Significado
AURL_DISABLEMIXEDLGC
Windows 8: desabilite o reconhecimento de nomes de domínio que contêm rótulos com caracteres pertencentes a mais de um dos seguintes scripts: latino, grego e cirílico.
AURL_ENABLEDRIVELETTERS
Windows 8: reconhecer nomes de arquivo que têm uma especificação de unidade à esquerda, como c:\temp.
AURL_ENABLEEA
Esse valor foi preterido; use AURL_ENABLEEAURLS em vez disso.
AURL_ENABLEEAURLS
Reconhecer URLs que contêm caracteres do Leste Asiático.
AURL_ENABLEEMAILADDR
Windows 8: reconhecer endereços de email.
AURL_ENABLETELNO
Windows 8: reconhecer números de telefone.
AURL_ENABLEURL
Windows 8: reconhecer URLs que incluem o caminho.

lParam

Esse parâmetro determina os esquemas de URL reconhecidos se AURL_ENABLEURL está ativo. Se lParam for NULL, a lista de nomes de esquema padrão será usada (consulte Comentários). Como alternativa, lParam pode apontar para uma cadeia de caracteres terminada em nulo que consiste em até 50 nomes de esquema terminados por dois-pontos que substituem a lista de nomes de esquema padrão. Por exemplo, a cadeia de caracteres pode ser "news:http:ftp:telnet:". A sintaxe do nome do esquema é definida no documento URI (Uniform Resource Identifiers): Sintaxe genérica no site IETF (Internet Engineering Task Force). Especificamente, um nome de esquema pode conter até 13 caracteres (incluindo os dois-pontos), deve começar com um alfabético ASCII e pode ser seguido por uma mistura de alfabéticos ASCII, dígitos e os três caracteres de pontuação: ".", "+" e "-". O tipo de cadeia de caracteres pode ser char* ou WCHAR*; o controle de edição avançada detecta automaticamente o tipo.

Valor retornado

Se a mensagem for bem-sucedida, o valor retornado será zero.

Se a mensagem falhar, o valor retornado será um valor diferente de zero. Por exemplo, a mensagem pode falhar devido à memória insuficiente, a uma opção de detecção inválida ou a uma cadeia de caracteres de nome de esquema inválida.

Se lParam contiver mais de 50 nomes de esquema, a mensagem falhará com um valor retornado de E_INVALIDARG.

Comentários

Se a detecção automática de URL estiver habilitada (ou seja, o wParam inclui AURL_ENABLEURL), o controle de edição avançada examinará qualquer texto modificado para determinar se o texto corresponde ao formato de uma URL (ou, mais geralmente, em Windows 8 ou posterior, um Identificador de Recurso Internacional do IRI). Se lParam for NULL, o controle detectará URLs que começam com os seguintes nomes de esquema:

  • callto
  • file
  • FTP
  • gopher
  • http
  • HTTPS
  • mailto
  • notícias
  • HDInsight
  • Nntp
  • onenote
  • outlook
  • Prospero
  • tel
  • telnet
  • wais
  • webcal

Quando a detecção automática de link está habilitada, o controle de edição avançada remove o efeito CFE_LINK do texto modificado que não tem um formato reconhecido pelo controle. Se o aplicativo usar o efeito CFE_LINK para marcar outros tipos de texto, não habilite a detecção automática de link. O controle de edição avançada não marcar se existe um link detectado; essa responsabilidade pertence ao cliente.

Um controle de edição avançada envia a notificação de EN_LINK quando recebe várias mensagens enquanto o ponteiro do mouse está sobre o texto que tem o efeito CFE_LINK . Para obter mais informações, consulte Hiperlinks RichEdit automáticos e Hiperlinks richedit friendly name.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Richedit.h

Confira também

CHARFORMAT2

EN_LINK