IOleInPlaceObject::UIDeactivate-Methode (oleidl.h)

Artikel
03/04/2024

Deaktiviert und entfernt die Benutzeroberfläche eines aktiven direkten Objekts.

Syntax

HRESULT UIDeactivate();

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Hinweise für Anrufer

Diese Methode wird vom unmittelbaren Container des Objekts aufgerufen, wenn der Benutzer beispielsweise in den Clientbereich außerhalb des Objekts geklickt hat.

Wenn der Container IOleInPlaceObject::UIDeactivate aufgerufen hat, sollte er später IOleInPlaceObject::InPlaceDeactivate aufrufen, um Ressourcen ordnungsgemäß sauber. Der Container kann davon ausgehen, dass das Beenden oder Freigeben des Objekts bei Bedarf Ressourcen bereinigt. Das -Objekt muss darauf vorbereitet sein, wenn IOleInPlaceObject::InPlaceDeactivate nicht aufgerufen wurde. Aber entweder IOleInPlaceObject::UIDeactivate oder IOleObject::Close wurde aufgerufen.

Hinweise für Implementierer

Ressourcen wie Menüs und Fenster können entweder bereinigt oder in einem ausgeblendeten Zustand gehalten werden, bis Ihr Objekt durch Aufrufe von IOleInPlaceObject::InPlaceDeactivate oder IOleObject::Close vollständig deaktiviert wird. Die Objektanwendung muss IOleInPlaceSite::OnUIDeactivate aufrufen, bevor sie etwas mit den zusammengesetzten Menüs ausführt, damit der Container zuerst vom Framefenster getrennt werden kann. Beim Deaktivieren der Benutzeroberfläche des direkten Objekts wird das Objekt in einem bereit-Zustand belassen, sodass es schnell reaktiviert werden kann. Das Objekt bleibt in diesem Zustand, bis sich der Rückgängig-Zustand des Dokuments ändert. Der Container sollte dann IOleInPlaceObject::InPlaceDeactivate aufrufen, um das Objekt anzuweisen, seinen Rückgängig-Zustand zu verwerfen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleidl.h