WM_GETTEXT Nachricht

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

#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 Zeichenfolge im Puffer aufgrund der Konvertierung von ANSI in Unicode verkleinert sein (auf mindestens die Hälfte des wParam-Werts ).

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.

Bemerkungen

Die DefWindowProc-Funktion kopiert den dem Fenster zugeordneten Text in den angegebenen Puffer und gibt die Anzahl der kopierten Zeichen zurück. Hinweis: Bei statischen Steuerelementen ohne Text erhalten Sie den Text, mit dem das Steuerelement ursprünglich erstellt wurde, d. h. die ID-Nummer. Sie erhalten jedoch die ID des statischen Nicht-Text-Steuerelements wie ursprünglich erstellt. Das heißt, wenn Sie anschließend eine STM_SETIMAGE verwendet haben, um sie zu ändern, wird die ursprüngliche ID trotzdem 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 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 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 der SS_ICON-Formatvorlage gesendet wird, wird in den ersten vier Bytes des Puffers, auf den lParam verweist, ein Handle für das Symbol zurückgegeben. Dies gilt nur, wenn die WM_SETTEXT Meldung verwendet wurde, um das Symbol festzulegen.

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 null zurückgegeben. Darüber hinaus konnten Anwendungen in frühen Versionen von Windows eine WM_GETTEXT Nachricht an ein statisches Nicht-Text-Steuerelement senden, um die ID des Steuerelements abzurufen. Zum Abrufen der ID eines Steuerelements können Anwendungen GetWindowLong verwenden, die GWL_ID als Indexwert übergeben, oder GetWindowLongPtr mithilfe von 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 (windows.h einschließen)

Siehe auch

Referenz

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM_GETTEXTLENGTH

WM_SETTEXT

Konzept

Windows

Andere Ressourcen

EM_GETSELTEXT

EM_STREAMOUT

LB_GETTEXT