EM _ AUTOURLDETECT-Meldung

Aktiviert oder deaktiviert die automatische Erkennung von Links 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, die über eine führende Laufwerkspezifikation verfügen, z. B. c: \ temp.
AURL _ ENABLEEA
Dieser Wert ist veraltet. Verwenden Sie stattdessen AURL _ ENABLERLRLS.
AURL _ ENABLERLS
Erkennen von URLs, die ostasiatische Zeichen enthalten.
AURL _ ENABLEEMAILADDR
Windows 8: E-Mail-Adressen erkennen.
AURL _ ENABLETELNO
Windows 8: Telefonnummern erkennen.
AURL _ ENABLEURL
Windows 8: Erkennt 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 auf NULL endende Zeichenfolge verweisen, die aus bis zu 50 mit Doppelpunkt endenden Schemanamen besteht, die die Standardschemanamenliste absetzen. Die Zeichenfolge kann beispielsweise "news:http:ftp:telnet:" sein. Die Syntax des Schemanamens wird im Dokument Uniform Resource Identifiers (URI): Generic Syntax auf der Website der Internet Engineering Task Force (IETF) definiert. Insbesondere kann ein Schemaname bis zu 13 Zeichen (einschließlich des Doppelpunkts) enthalten, muss mit einem ASCII-Alphabet beginnen und gefolgt von einer Mischung aus ASCII-Alphabetik, Ziffern und den drei Interpunktionszeichen werden: ".", "+" und "-". Der Zeichenfolgentyp kann entweder char _ oder * _ WCHAR * sein. Das Rich Edit-Steuerelement erkennt den Typ automatisch.

Rückgabewert

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

Wenn die Nachricht fehlschlägt, ist der Rückgabewert ein Wert ungleich 0 (null). Die Meldung kann z. B. 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. h. wParam enthält AURL _ ENABLEURL), scannt das Rich Edit-Steuerelement jeden geänderten Text, um zu bestimmen, 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änderten Text, für den kein Format vom Steuerelement erkannt wird. 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 über Text befindet, der den CFE _ LINK-Effekt hat. Weitere Informationen finden Sie unter Automatische RichEdit-Hyperlinks und RichEdit-Anzeigenamenlinks.

Requirements (Anforderungen)

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

Weitere Informationen

CHARFORMAT2

EN _ LINK