messaggio EM_AUTOURLDETECT

Articolo
06/13/2023

Abilita o disabilita il rilevamento automatico dei collegamenti ipertestuali da un controllo di modifica avanzato.

Parametri

wParam

Specificare 0 per disabilitare il rilevamento automatico dei collegamenti o uno dei valori seguenti per abilitare vari tipi di rilevamento.

Valore	Significato
AURL_DISABLEMIXEDLGC	Windows 8: disabilitare il riconoscimento dei nomi di dominio che contengono etichette con caratteri appartenenti a più di uno degli script seguenti: latino, greco e cirillico.
AURL_ENABLEDRIVELETTERS	Windows 8: riconoscere i nomi di file con una specifica dell'unità iniziale, ad esempio c:\temp.
AURL_ENABLEEA	Questo valore è deprecato; usare invece AURL_ENABLEEAURLS .
AURL_ENABLEEAURLS	Riconoscere gli URL che contengono caratteri asiatici orientali.
AURL_ENABLEEMAILADDR	Windows 8: riconoscere gli indirizzi di posta elettronica.
AURL_ENABLETELNO	Windows 8: riconoscere i numeri di telefono.
AURL_ENABLEURL	Windows 8: riconoscere GLI URL che includono il percorso.

lParam

Questo parametro determina gli schemi URL riconosciuti se AURL_ENABLEURL è attivo. Se lParam è NULL, viene usato l'elenco dei nomi dello schema predefinito (vedere Osservazioni). In alternativa, lParam può puntare a una stringa con terminazione null costituita da un massimo di 50 nomi di schemi con terminazione dei punti che sostituiscono l'elenco dei nomi dello schema predefinito. Ad esempio, la stringa potrebbe essere "news:http:ftp:telnet:". La sintassi del nome dello schema è definita nel sito Web IETF (Uniform Resource Identifiers): documento di sintassi generica nel sito Web Internet Engineering Task Force (IETF). In particolare, un nome dello schema può contenere fino a 13 caratteri (inclusi i due punti), deve iniziare con un alfabetico ASCII e può essere seguito da una combinazione di alfabetici ASCII, cifre e tre caratteri di punteggiatura: ".", "+" e "-". Il tipo di stringa può essere char* o WCHAR*; il controllo di modifica avanzato rileva automaticamente il tipo.

Valore restituito

Se il messaggio ha esito positivo, il valore restituito è zero.

Se il messaggio ha esito negativo, il valore restituito è un valore diverso da zero. Ad esempio, il messaggio potrebbe non riuscire a causa di memoria insufficiente, di un'opzione di rilevamento non valida o di una stringa di nome schema non valida.

Se lParam contiene più di 50 nomi di schema, il messaggio ha esito negativo con un valore restituito di E_INVALIDARG.

Commenti

Se il rilevamento automatico degli URL è abilitato (ovvero wParam include AURL_ENABLEURL), il controllo di modifica avanzato analizza qualsiasi testo modificato per determinare se il testo corrisponde al formato di un URL (o più in genere in Windows 8 o successivamente un identificatore di risorsa internazionale IRI). Se lParam è NULL, il controllo rileva gli URL che iniziano con i nomi di schema seguenti:

callto
file
ftp
gopher
http
https
mailto
news
di HDInsight
Nntp
onenote
Outlook
prospero
tel
telnet
wais
webcal

Quando il rilevamento automatico dei collegamenti è abilitato, il controllo di modifica avanzato rimuove l'effetto CFE_LINK dal testo modificato che non ha un formato riconosciuto dal controllo. Se l'applicazione usa l'effetto CFE_LINK per contrassegnare altri tipi di testo, non abilitare il rilevamento automatico dei collegamenti. Il controllo di modifica avanzato non verifica se esiste un collegamento rilevato; tale responsabilità appartiene al client.

Un controllo di modifica avanzato invia la notifica di EN_LINK quando riceve vari messaggi mentre il puntatore del mouse è sul testo che ha l'effetto CFE_LINK . Per altre informazioni, vedere Collegamenti ipertestuali RichEdit automatici e Collegamenti ipertestuali RichEdit Friendly Name.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Richedit.h

Vedi anche

CHARFORMAT2
EN_LINK