EDITWORDBREAKPROCA-Rückruffunktion (winuser.h)

Artikel
08/27/2023

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

EDITWORDBREAKPROCA Editwordbreakproca;

int Editwordbreakproca(
  [in] LPSTR 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 Wortumbruch beginnen soll.

[in] cch

Typ: int

Die Anzahl der TCHARs im Steuerelementtext bearbeiten. 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 einen der folgenden Werte annehmen.

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

Rückgabewert

Typ: int

Wenn der CodeparameterWB_ISDELIMITER angibt, ist der Rückgabewert nonzero (TRUE), wenn das Zeichen an der angegebenen Position ein Trennzeichen ist, oder null, wenn dies nicht der Fall ist. Wenn der CodeparameterWB_CLASSIFY angibt, ist der Rückgabewert die Zeichenklasse- und Wortumbruchflags des Zeichens an der angegebenen Position. Andernfalls ist der Rückgabewert ein Index für den Anfang eines Worts im Textpuffer.

Hinweise

Ein Wagenrücklauf gefolgt von einem Zeilenvorschub muss von der Rückruffunktion als einzelnes Wort behandelt werden. Zwei Wagenrückläufe gefolgt von einem Zeilenvorschub müssen ebenfalls 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 EditWordBreakProc. Bei Rich-Edit-Steuerelementen können Sie alternativ die EM_SETWORDBREAKPROCEX Nachricht verwenden, um die standardmäßige erweiterte Wortumbruchprozedur durch eine EditWordBreakProcEx-Rückruffunktion zu ersetzen. Diese Funktion stellt zusätzliche Informationen zum Text bereit, 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 mithilfe von WideCharToMultiByte konvertieren und dann die Indizes entsprechend übersetzen.

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)