EM _ GETHANDLE-Nachricht

Ruft ein Handle des Arbeitsspeichers ab, der derzeit für den Text eines mehrzeilenigen Bearbeitungssteuerfelds zugeordnet ist.

Parameter

wParam

Nicht verwendet; muss 0 (null) sein.

lParam

Nicht verwendet; muss 0 (null) sein.

Rückgabewert

Der Rückgabewert ist ein Speicherhand handle, das den Puffer identifiziert, der den Inhalt des Bearbeitungssteuersteuerpunkts enthält. Wenn ein Fehler auftritt, z. B. das Senden der Nachricht an ein einzeilenbasiertes Bearbeitungssteuer steuerelement, ist der Rückgabewert 0 (null).

Bemerkungen

Wenn die Funktion erfolgreich ist, kann die Anwendung auf den Inhalt des Edit-Steuerelements zugreifen, indem sie den Rückgabewert in HLOCAL umleitet und an LocalLock übergibst. LocalLock gibt einen Zeiger auf einen Puffer zurück, bei dem es sich um ein auf NULL beendetes Array von CHAR s oder WCHAR s handelt, je nachdem, ob das Steuerelement von einer ANSI- oder Unicode-Funktion erstellt wurde. Wenn beispielsweise CreateWindowExA verwendet wurde, ist der Puffer ein Array von CHAR-s, aber wenn CreateWindowExW verwendet wurde, ist der Puffer ein Array von WCHAR-s. Die Anwendung ändert möglicherweise nicht den Inhalt des Puffers. Um den Puffer zu entsperren, ruft die Anwendung LocalUnlock auf, bevor dem Bearbeitungssteuerpunkt das Empfangen neuer Nachrichten erlaubt wird.

Hinweis

Bei Comctl32.dll Version 6 enthält der Puffer immer ein Array von WCHAR-s, unabhängig davon, ob das Bearbeitungssteuerfeld von einer ANSI- oder Unicode-Funktion erstellt wurde. Weitere Informationen zu DLL-Versionen finden Sie unter Allgemeine Steuerelementversionen.

Wenn Ihre Anwendung die von EM _ GETHANDLE festgelegten Einschränkungen nicht ein halten kann, verwenden Sie die Funktionen GetWindowTextLength und GetWindowText, um den Inhalt des Bearbeitungssteuer steuerelements in einen von der Anwendung bereitgestellten Puffer zu kopieren.

Umfangreiche Bearbeitung: Die EM _ GETHANDLE-Nachricht wird nicht unterstützt. Rich-Edit-Steuerelemente speichern Text nicht als einfaches Array von Zeichen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

Verweis

EM _ SETHANDLE

Andere Ressourcen

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock