EM_SETHANDLE Nachricht

Legt den Handle des Arbeitsspeichers fest, der von einem mehrlineilen Bearbeitungssteuerelement verwendet wird.

Parameter

wParam

Ein Handle für den Speicherpuffer, den das Bearbeitungssteuerelement verwendet, um den aktuell angezeigten Text zu speichern, anstatt seinen eigenen Arbeitsspeicher zuzuweisen. Bei Bedarf ordnet das Steuerelement diesen Speicher neu zu.

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Diese Nachricht gibt keinen Wert zurück.

Bemerkungen

Bevor eine Anwendung ein neues Speicherhandle festlegt, sollte sie eine EM_GETHANDLE Nachricht senden, um das Handle des aktuellen Speicherpuffers abzurufen und diesen Arbeitsspeicher freizugeben.

Ein Bearbeitungssteuerelement ordnet den angegebenen Puffer automatisch neu zu, wenn es zusätzlichen Speicherplatz für Text benötigt, oder es entfernt genügend Text, sodass kein zusätzlicher Speicherplatz mehr benötigt wird.

Das Senden einer EM_SETHANDLE Meldung löscht den Rückgängigpuffer (EM_CANUNDO gibt null zurück) und das interne Änderungsflag (EM_GETMODIFY gibt null zurück). Das Fenster "Steuerelement bearbeiten" wird neu gezeichnet.

Rich-Bearbeitung: Die EM_SETHANDLE Nachricht wird nicht unterstützt. Rich-Edit-Steuerelemente speichern Text nicht als einfaches Zeichenarray.

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 (einschließlich Windows.h)

Siehe auch

Referenz

EM_CANUNDO

EM_GETHANDLE

EM_GETMODIFY