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