EM_AUTOURLDETECT message

Active ou désactive la détection automatique des liens hypertexte par un contrôle d’édition enrichi.

Paramètres

wParam

Spécifiez 0 pour désactiver la détection automatique des liens, ou l’une des valeurs suivantes pour activer différents types de détection.

Valeur	Signification
AURL_DISABLEMIXEDLGC	Windows 8 : désactivez la reconnaissance des noms de domaine qui contiennent des étiquettes avec des caractères appartenant à plusieurs des scripts suivants : latin, grec et cyrillique.
AURL_ENABLEDRIVELETTERS	Windows 8 : reconnaître les noms de fichiers qui ont une spécification de lecteur de début, par exemple c:\temp.
AURL_ENABLEEA	Cette valeur est déconseillée ; utilisez AURL_ENABLEEAURLS à la place.
AURL_ENABLEEAURLS	Reconnaître les URL qui contiennent des caractères d’Asie de l’Est.
AURL_ENABLEEMAILADDR	Windows 8 : reconnaître les adresses e-mail.
AURL_ENABLETELNO	Windows 8 : reconnaître les numéros de téléphone.
AURL_ENABLEURL	Windows 8 : reconnaître les URL qui incluent le chemin d’accès.

lParam

Ce paramètre détermine les schémas d’URL reconnus si AURL_ENABLEURL est actif. Si lParam a la valeur NULL, la liste de noms de schéma par défaut est utilisée (voir Remarques). LParam peut également pointer vers une chaîne terminée par null comprenant jusqu’à 50 noms de schémas terminés par deux-points qui remplacent la liste de noms de schéma par défaut. Par exemple, la chaîne peut être « news:http:ftp:telnet: ». La syntaxe du nom du schéma est définie dans le document URI (Uniform Resource Identifiers) : Syntaxe générique sur le site web Internet Engineering Task Force (IETF). Plus précisément, un nom de schéma peut contenir jusqu’à 13 caractères (y compris les deux-points), doit commencer par un alphabet ASCII et peut être suivi d’un mélange d’alphabets ASCII, de chiffres et des trois caractères de ponctuation : « . », « + » et « - ». Le type de chaîne peut être char* ou WCHAR*; le contrôle d’édition enrichi détecte automatiquement le type.

Valeur retournée

Si le message réussit, la valeur de retour est zéro.

Si le message échoue, la valeur de retour est différente de zéro. Par exemple, le message peut échouer en raison d’une mémoire insuffisante, d’une option de détection non valide ou d’une chaîne de nom de schéma non valide.

Si lParam contient plus de 50 noms de schéma, le message échoue avec une valeur de retour de E_INVALIDARG.

Notes

Si la détection automatique d’URL est activée (c’est-à-dire que wParam inclut AURL_ENABLEURL), le contrôle d’édition enrichi analyse tout texte modifié pour déterminer si le texte correspond au format d’une URL (ou plus généralement dans Windows 8 ou ultérieurement un identificateur de ressource international IRI). Si lParam a la valeur NULL, le contrôle détecte les URL qui commencent par les noms de schéma suivants :

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

Lorsque la détection automatique des liens est activée, le contrôle d’édition enrichi supprime l’effet CFE_LINK du texte modifié qui n’a pas de format reconnu par le contrôle. Si votre application utilise l’effet CFE_LINK pour marquer d’autres types de texte, n’activez pas la détection automatique des liens. Le contrôle d’édition enrichi n’case activée pas si un lien détecté existe ; cette responsabilité appartient au client.

Un contrôle d’édition enrichi envoie la notification EN_LINK lorsqu’elle reçoit différents messages alors que le pointeur de la souris est sur du texte qui a l’effet CFE_LINK . Pour plus d’informations, consultez Liens hypertexte RichEdit automatiques et Liens hypertexte de nom convivial RichEdit.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Richedit.h

Voir aussi

CHARFORMAT2

EN_LINK