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 |
|
Siehe auch
-
Referenz
-
Konzeptionellen
-
Andere Ressourcen