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 0 (null) sein.
-
lParam
-
Dieser Parameter wird nicht verwendet und muss 0 (null) sein.
Rückgabewert
Typ: LRESULT
Der Rückgabewert ist die Länge des Texts in Zeichen, ohne das abschließende NULL-Zeichen.
Hinweise
Bei einem Bearbeitungssteuerelement ist der zu kopierende Text der Inhalt des Bearbeitungssteuerelements. Bei einem Kombinationsfeld ist der Text der Inhalt des Bearbeitungssteuerelements (oder des statischen Texts) des Kombinationsfelds. Bei einer Schaltfläche ist der Text der Schaltflächenname. 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 DefWindowProc-Funktion 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 Doppel-Byte-Zeichensatzzeichen (Double-Byte Character Set, DBCS) im Text zulässt. Der Rückgabewert ist jedoch immer mindestens so groß wie die tatsächliche Länge des Texts. Sie können es daher 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 Steuerelement ohne Text, z. B. eine statische Bitmap oder ein statisches Symbolsteuerelement, gibt keinen Zeichenfolgenwert zurück. Stattdessen wird 0 (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 |
|
Siehe auch
-
Referenz
-
Konzeptionellen
-
Andere Ressourcen