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 |
|