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