IOleInPlaceObject::InPlaceDeactivate-Methode (oleidl.h)

  • Artikel

Deaktiviert ein aktives direktes Objekt und verwirft den Rückgängig-Zustand des Objekts.

Syntax

HRESULT InPlaceDeactivate();

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 eines aktiven Objekts aufgerufen, um das aktive Objekt zu deaktivieren und seinen Rückgängig-Zustand zu verwerfen.

Hinweise für Implementierer

Bei der Rückgabe von IOleInPlaceObject::InPlaceDeactivate verwirft das Objekt seinen Rückgängig-Zustand. Die Objektanwendung sollte nicht unmittelbar nach diesem Aufruf heruntergefahren werden. Stattdessen sollte auf einen expliziten Aufruf von IOleObject::Close oder darauf gewartet werden, dass die Verweisanzahl des Objekts null erreicht.

Vor der Deaktivierung sollte die Objektanwendung dem Container die Möglichkeit geben, seine Benutzeroberfläche wieder auf das Framefenster zu setzen, indem IOleInPlaceSite::OnUIDeactivate aufgerufen wird.

Wenn die direkte Benutzeroberfläche während des Aufrufs von IOleInPlaceObject::InPlaceDeactivate weiterhin sichtbar ist, sollte die Objektanwendung eine eigene IOleInPlaceObject::InPlaceDeactivate-Methode aufrufen, um die Benutzeroberfläche auszublenden. Die direkte Benutzeroberfläche kann optional während aufrufen von IOleInPlaceObject::InPlaceDeactivate und IOleInPlaceObject::InPlaceDeactivate zerstört werden. Wenn die Benutzeroberfläche jedoch noch nicht zerstört wurde, wenn der Container IOleObject::Close aufruft, muss sie während des Aufrufs von IOleObject::Close zerstört werden.

Während des Aufrufs von IOleObject::Close sollte das Objekt überprüfen, ob es noch aktiv ist. Wenn ja, sollte IOleInPlaceObject::InPlaceDeactivate aufgerufen werden.

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

Weitere Informationen

IOleInPlaceObject

IOleInPlaceSite::OnInPlaceDeactivate

IOleInPlaceSite::OnUIDeactivate

IOleObject::Close