EM_GETHANDLE Nachricht

Ruft ein Handle des derzeit für den Text eines Mehrzeilenbearbeitungssteuerelements zugeordneten Arbeitsspeichers ab.

Parameter

wParam

Nicht verwendet; muss null sein.

lParam

Nicht verwendet; muss null sein.

Rückgabewert

Der Rückgabewert ist ein Speicherhandle, das den Puffer identifiziert, der den Inhalt des Bearbeitungssteuerelements enthält. Wenn ein Fehler auftritt, z. B. das Senden der Nachricht an ein einzeiliges Bearbeitungssteuerelement, ist der Rückgabewert null.

Bemerkungen

Wenn die Funktion erfolgreich ist, kann die Anwendung auf den Inhalt des Bearbeitungssteuerelements zugreifen, indem sie den Rückgabewert in HLOCAL umwandeln und an LocalLock übergibt. LocalLock gibt einen Zeiger auf einen Puffer zurück, bei dem es sich um ein NULL-endendes Array von CHARs oder WCHARs 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 CHARs, aber wenn CreateWindowExW verwendet wurde, ist der Puffer ein Array von WCHARs. Die Anwendung darf den Inhalt des Puffers nicht ändern. Zum Entsperren des Puffers ruft die Anwendung LocalUnlock auf, bevor das Bearbeitungssteuerelement neue Nachrichten empfangen kann.

Hinweis

Für Comctl32.dll Version 6 enthält der Puffer immer ein Array von WCHARs, unabhängig davon, ob das Bearbeitungssteuerelement von einer ANSI- oder Unicode-Funktion erstellt wurde. Weitere Informationen zu DLL-Versionen finden Sie unter Common Control Versions.

Wenn Ihre Anwendung die Einschränkungen durch EM_GETHANDLE nicht einhalten kann, verwenden Sie die Funktionen GetWindowTextLength und GetWindowText , um den Inhalt des Bearbeitungssteuerelements in einen von der Anwendung bereitgestellten Puffer zu kopieren.

Rich Edit: Die EM_GETHANDLE Meldung wird nicht unterstützt. Rich-Edit-Steuerelemente speichern Text nicht als einfaches Array von Zeichen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)

Siehe auch

Referenz

EM_SETHANDLE

Andere Ressourcen

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock