WM _ GETTEXT-Nachricht

Kopiert den Text, der einem Fenster entspricht, in einen vom Aufrufer bereitgestellten Puffer.

#define WM_GETTEXT                      0x000D

Parameter

wParam

Die maximale Anzahl der zu kopierenden Zeichen, einschließlich des abschließenden NULL-Zeichens.

Bei ANSI-Anwendungen kann die Größe der Zeichenfolge im Puffer aufgrund der Konvertierung von ANSI in Unicode auf mindestens die Hälfte des wParam-Werts reduziert werden.

lParam

Ein Zeiger auf den Puffer, der den Text empfangen soll.

Rückgabewert

Typ: LRESULT

Der Rückgabewert ist die Anzahl der kopierten Zeichen, ohne das abschließende NULL-Zeichen.

Hinweise

Die DefWindowProc-Funktion kopiert den dem Fenster zugeordneten Text in den angegebenen Puffer und gibt die Anzahl der kopierten Zeichen zurück. Beachten Sie, dass Sie bei statischen Steuerelementen ohne Text den Text erhalten, mit dem das Steuerelement ursprünglich erstellt wurde, d. h. die ID-Nummer. Sie erhalten jedoch die ID des statischen Steuerelements ohne Text, wie es ursprünglich erstellt wurde. Das heißt, wenn Sie später ein STM _ SETIMAGE verwendet haben, um es zu ändern, wird die ursprüngliche ID weiterhin zurückgegeben.

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 den Text eines Elements in ein Listenfeld zu kopieren, kann eine Anwendung die LB _ GETTEXT-Nachricht verwenden.

Wenn die WM _ GETTEXT-Nachricht an ein statisches Steuerelement mit dem SS _ ICON-Format gesendet wird, wird in den ersten vier Bytes des Puffers, auf den von lParam gezeigt wird, ein Handle für das Symbol zurückgegeben. Dies gilt nur, wenn die WM _ SETTEXT-Meldung zum Festlegen des Symbols verwendet wurde.

Rich Edit: Wenn der zu kopierende Text 64 KB überschreitet, verwenden Sie entweder die EM _ STREAMOUT- oder EM _ GETSELTEXT-Nachricht.

Das Senden einer WM _ GETTEXT-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. Darüber hinaus könnten Anwendungen in frühen Versionen von Windows eine WM _ GETTEXT-Nachricht an ein statisches Steuerelement senden, das keinen Text enthält, um die ID des Steuerelements abzurufen. Um die ID eines Steuerelements abzurufen, können Anwendungen GetWindowLong verwenden, um die _ GWL-ID als Indexwert zu übergeben, oder GetWindowLongPtr mithilfe der _ GWLP-ID.

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 (include Windows.h)

Siehe auch

Referenz

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM _ GETTEXTLENGTH

WM _ SETTEXT

Konzeptionellen

Windows

Andere Ressourcen

EM _ GETSELTEXT

EM _ STREAMOUT

LB _ GETTEXT