Freigeben über

EM_AUTOURLDETECT Nachricht

  • Artikel

Aktiviert oder deaktiviert die automatische Erkennung von Hyperlinks durch ein Rich-Edit-Steuerelement.

Parameter

wParam

Geben Sie 0 an, um die automatische Linkerkennung zu deaktivieren, oder einen der folgenden Werte, um verschiedene Arten der Erkennung zu aktivieren.

Wert Bedeutung
AURL_DISABLEMIXEDLGC
 Windows 8: Deaktivieren Sie die Erkennung von Domänennamen, die Bezeichnungen mit Zeichen enthalten, die zu mehr als einem der folgenden Skripts gehören: Lateinisch, Griechisch und Kyrillisch.
AURL_ENABLEDRIVELETTERS
 Windows 8: Erkennen Sie Dateinamen mit einer führenden Laufwerksspezifikation, z. B. c:\temp.
AURL_ENABLEEA
 Dieser Wert ist veraltet. verwenden Sie stattdessen AURL_ENABLEEAURLS .
AURL_ENABLEEAURLS
 Erkennen sie URLs, die ostasiatische Zeichen enthalten.
AURL_ENABLEEMAILADDR
 Windows 8: E-Mail-Adressen erkennen.
AURL_ENABLETELNO
 Windows 8: Telefonnummern erkennen.
AURL_ENABLEURL
 Windows 8: Erkennen Sie URLs, die den Pfad enthalten.

lParam

Dieser Parameter bestimmt die URL-Schemas, die erkannt werden, wenn AURL_ENABLEURL aktiv ist. Wenn lParam NULL ist, wird die Standardschemanamenliste verwendet (siehe Hinweise). Alternativ kann lParam auf eine NULL-beendete Zeichenfolge verweisen, die aus bis zu 50 Doppelpunkt-beendeten Schemanamen besteht, die die Standardschemanamenliste ablösen. Die Zeichenfolge könnte beispielsweise "news:http:ftp:telnet:" sein. Die Schemanamensyntax wird im Dokument Uniform Resource Identifiers (URI): Generic Syntax auf der IETF-Website (The Internet Engineering Task Force) definiert. Insbesondere kann ein Schemaname bis zu 13 Zeichen (einschließlich des Doppelpunkts) enthalten, muss mit einem ASCII-Alphabet beginnen und kann von einer Mischung aus ASCII-Alphabetik, Ziffern und den drei Satzzeichen ".", "+" und "-" gefolgt werden. Der Zeichenfolgentyp kann entweder char* oder WCHAR*; das Rich-Edit-Steuerelement erkennt den Typ automatisch.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert 0.

Wenn die Nachricht fehlschlägt, ist der Rückgabewert ein Wert ohne Zero. Beispielsweise kann die Meldung aufgrund von unzureichendem Arbeitsspeicher, einer ungültigen Erkennungsoption oder einer ungültigen Schemanamenzeichenfolge fehlschlagen.

Wenn lParam mehr als 50 Schemanamen enthält, schlägt die Nachricht mit dem Rückgabewert E_INVALIDARG fehl.

Bemerkungen

Wenn die automatische URL-Erkennung aktiviert ist (d. a. wParam enthält AURL_ENABLEURL), überprüft das Rich-Edit-Steuerelement jeden geänderten Text, um festzustellen, ob der Text dem Format einer URL entspricht (oder allgemeiner in Windows 8 oder höher einem IRI International Resource Identifier). Wenn lParam NULL ist, erkennt das Steuerelement URLs, die mit den folgenden Schemanamen beginnen:

  • callto
  • file
  • ftp
  • Gopher
  • http
  • https
  • mailto
  • news
  • notes
  • Nntp
  • onenote
  • Outlook
  • Prospero
  • tel
  • telnet
  • wais
  • Webcal

Wenn die automatische Linkerkennung aktiviert ist, entfernt das Rich-Edit-Steuerelement den CFE_LINK Effekt aus geändertem Text, der kein vom Steuerelement erkanntes Format aufweist. Wenn Ihre Anwendung den CFE_LINK Effekt verwendet, um andere Texttypen zu markieren, aktivieren Sie die automatische Linkerkennung nicht. Das Rich-Edit-Steuerelement überprüft nicht, ob ein erkannter Link vorhanden ist. diese Verantwortung liegt beim Client.

Ein Rich-Edit-Steuerelement sendet die EN_LINK Benachrichtigung, wenn es verschiedene Nachrichten empfängt, während sich der Mauszeiger auf Text befindet, der den CFE_LINK Effekt hat. Weitere Informationen finden Sie unter Automatische RichEdit-Hyperlinks und RichEdit-Hyperlinks für Anzeigenamen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Richedit.h

Siehe auch

CHARFORMAT2

EN_LINK