IOleInPlaceObject::InPlaceDeactivate-Methode (oleidl.h)
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 |
|---|---|
|
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
IOleInPlaceSite::OnInPlaceDeactivate