EDITWORDBREAKPROCW-Rückruffunktion (winuser.h)

Artikel
11/20/2024

Eine anwendungsdefinierte Rückruffunktion, die mit der EM_SETWORDBREAKPROC Nachricht verwendet wird. Ein mehrzeiliges Bearbeitungssteuerelement oder ein Rich-Edit-Steuerelement ruft eine EditWordBreakProc--Funktion auf, um eine Textzeile zu unterbrechen.

Der EDITWORDBREAKPROC- Typ definiert einen Zeiger auf diese Rückruffunktion. EditWordBreakProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

EDITWORDBREAKPROCW Editwordbreakprocw;

int Editwordbreakprocw(
  [in] LPWSTR lpch,
  [in] int ichCurrent,
  [in] int cch,
  [in] int code
)
{...}

Parameter

[in] lpch

Typ: LPTSTR-

Ein Zeiger auf den Text des Bearbeitungssteuerelements.

[in] ichCurrent

Typ: int

Ein Index zu einer Zeichenposition im Textpuffer, der den Punkt angibt, an dem die Funktion mit der Überprüfung auf einen Wortwechsel beginnen soll.

[in] cch

Typ: int

Die Anzahl der TCHARs im Bearbeitungssteuerelementtext. Für den ANSI-Text ist dies die Anzahl der Bytes; für den Unicode-Text ist dies die Anzahl der WCHARs.

[in] code

Typ: int

Die Aktion, die von der Rückruffunktion ausgeführt werden soll. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
WB_CLASSIFY	Ruft die Zeichenklasse und die Wörtertrennungskennzeichnungen des Zeichens an der angegebenen Position ab. Dieser Wert dient zur Verwendung mit Rich-Edit-Steuerelementen.
WB_ISDELIMITER	Überprüft, ob das Zeichen an der angegebenen Position ein Trennzeichen ist.
WB_LEFT	Sucht den Anfang eines Worts links neben der angegebenen Position.
WB_LEFTBREAK	Sucht das End-of-Word-Trennzeichen links neben der angegebenen Position. Dieser Wert dient zur Verwendung mit Rich-Edit-Steuerelementen.
WB_MOVEWORDLEFT	Sucht den Anfang eines Worts links neben der angegebenen Position. Dieser Wert wird während der STRG+NACH-LINKS-Tastenverarbeitung verwendet. Dieser Wert dient zur Verwendung mit Rich-Edit-Steuerelementen.
WB_MOVEWORDRIGHT	Sucht den Anfang eines Worts rechts neben der angegebenen Position. Dieser Wert wird während der STRG+RECHTS-Tastenverarbeitung verwendet. Dieser Wert dient zur Verwendung mit Rich-Edit-Steuerelementen.
WB_RIGHT	Sucht den Anfang eines Worts rechts neben der angegebenen Position. Dies ist nützlich bei rechts ausgerichteten Bearbeitungssteuerelementen.
WB_RIGHTBREAK	Sucht das End-of-Word-Trennzeichen rechts neben der angegebenen Position. Dies ist nützlich bei rechts ausgerichteten Bearbeitungssteuerelementen. Dieser Wert dient zur Verwendung mit Rich-Edit-Steuerelementen.

Rückgabewert

Typ: int

Wenn der Code Parameter WB_ISDELIMITERangibt, ist der Rückgabewert ungleich Null (TRUE), wenn das Zeichen an der angegebenen Position ein Trennzeichen oder null ist, wenn dies nicht der Fall ist. Wenn der Code Parameter WB_CLASSIFYangibt, ist der Rückgabewert die Zeichenklasse und Die Zeichentrennzeichen des Zeichens an der angegebenen Position. Andernfalls ist der Rückgabewert ein Index am Anfang eines Worts im Textpuffer.

Bemerkungen

Ein Wagenrücklauf, gefolgt von einem Zeilenvorschub, muss von der Rückruffunktion als einzelnes Wort behandelt werden. Zwei Wagenrücklaufrücklauf, gefolgt von einem Zeilenvorschub, müssen auch als einzelnes Wort behandelt werden.

Eine Anwendung muss die Rückruffunktion installieren, indem sie die Adresse der Rückruffunktion in einer EM_SETWORDBREAKPROC Nachricht angibt.

Rich Edit 1.0:Microsoft Rich Edit 1.0 übergibt nur ANSI-Zeichen an EditWordBreakProczurück. Für Rich-Edit-Steuerelemente können Sie alternativ die EM_SETWORDBREAKPROCEX Nachricht verwenden, um die standardmäßige erweiterte Worttrennung durch eine EditWordBreakProcEx- Rückruffunktion zu ersetzen. Diese Funktion enthält zusätzliche Informationen zum Text, z. B. den Zeichensatz.

Rich Edit 2.0 und höher:Microsoft Rich Edit 2.0 und höher übergeben nur Unicode-Zeichen an EditWordBreakProc. Daher würde eine ANSI-Anwendung die von Rich Edit bereitgestellte Unicode-Zeichenfolge mit WideCharToMultiBytekonvertieren und dann die Indizes entsprechend übersetzen.

Anmerkung

Der winuser.h-Header definiert EDITWORDBREAKPROC als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)