WM_GETTEXTLENGTH Nachricht

Bestimmt die Länge des Einem Fenster zugeordneten Texts in Zeichen.

#define WM_GETTEXTLENGTH                0x000E

Parameter

wParam

Dieser Parameter wird nicht verwendet und muss null sein.

lParam

Dieser Parameter wird nicht verwendet und muss null sein.

Rückgabewert

Typ: LRESULT

Der Rückgabewert ist die Länge des Texts in Zeichen, ohne das abschließende NULL-Zeichen.

Bemerkungen

Bei einem Bearbeitungssteuerelement ist der zu kopierende Text der Inhalt des Bearbeitungssteuerelements. Bei einem Kombinationsfeld ist der Text der Inhalt des Bearbeitungssteuerelements (oder statischer Text) des Kombinationsfelds. Bei einer Schaltfläche ist der Text der Name der Schaltfläche. Bei anderen Fenstern ist der Text der Fenstertitel. Um die Länge eines Elements in einem Listenfeld zu bestimmen, kann eine Anwendung die LB_GETTEXTLEN Nachricht verwenden.

Wenn die WM_GETTEXTLENGTH Nachricht gesendet wird, gibt die Funktion DefWindowProc die Länge des Texts in Zeichen zurück. Unter bestimmten Bedingungen gibt die DefWindowProc-Funktion einen Wert zurück, der größer als die tatsächliche Länge des Texts ist. Dies tritt bei bestimmten Mischungen von ANSI und Unicode auf und ist darauf zurückzuführen, dass das System das mögliche Vorhandensein von DBCS-Zeichen (Double-Byte Character Set) im Text ermöglicht. Der Rückgabewert ist jedoch immer mindestens so groß wie die tatsächliche Länge des Texts. Sie können sie also immer verwenden, um die Pufferzuordnung zu steuern. Dieses Verhalten kann auftreten, wenn eine Anwendung sowohl ANSI-Funktionen als auch allgemeine Dialoge verwendet, die Unicode verwenden.

Um die genaue Länge des Texts abzurufen, verwenden Sie die WM_GETTEXT, LB_GETTEXT oder CB_GETLBTEXT Nachrichten oder die GetWindowText-Funktion .

Das Senden einer WM_GETTEXTLENGTH Nachricht an ein statisches Nicht-Text-Steuerelement, z. B. eine statische Bitmap oder ein statisches Symbol controlc, gibt keinen Zeichenfolgenwert zurück. Stattdessen wird null zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)

Siehe auch

Referenz

DefWindowProc

GetWindowText

GetWindowTextLength

WM_GETTEXT

Konzept

Windows

Andere Ressourcen

CB_GETLBTEXT

LB_GETTEXT

LB_GETTEXTLEN