LB_GETTEXTLEN Nachricht

Ruft die Länge einer Zeichenfolge in einem Listenfeld ab.

Parameter

wParam

Der nullbasierte Index der Zeichenfolge.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): Der wParam-Parameter ist auf 16-Bit-Werte beschränkt. Dies bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, wird die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Der Rückgabewert ist die Länge der Zeichenfolge in TCHARs, ohne das abschließende NULL-Zeichen. Unter bestimmten Bedingungen kann dieser Wert tatsächlich größer als die Länge des Texts sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Wenn der wParam-Parameter keinen gültigen Index angibt, wird der Rückgabewert LB_ERR.

Bemerkungen

Unter bestimmten Bedingungen ist der Rückgabewert größer als die tatsächliche Länge des Texts. Dies tritt bei bestimmten Mischungen von ANSI und Unicode auf und ist darauf zurückzuführen, dass das Betriebssystem 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 .

Wenn das Listenfeld eine vom Besitzer gezeichnete Formatvorlage, aber nicht die LBS_HASSTRINGS Hat, ist der Rückgabewert immer die Größe eines DWORD in Byte.

Anforderungen

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

Weitere Informationen

Referenz

CB_GETLBTEXT

LB_GETTEXT

Andere Ressourcen

GetWindowText

WM_GETTEXT