IOleDocumentView::Open-Methode (docobj.h)

Artikel
02/26/2024

Zeigt eine Dokumentansicht in einem separaten Popupfenster an. Die Semantik entspricht IOleObject::D oVerb mit OLEIVERB_OPEN.

Syntax

HRESULT Open();

Rückgabewert

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

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Vorgang.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher für den Vorgang.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.
E_NOTIMPL	Das Dokumentobjekt, das diese Ansicht besitzt, unterstützt keine separate Fensteraktivierung.

Hinweise

Ein Benutzer, der ein Dokumentobjekt in einer Containeranwendung wie einem Browser oder "Binder" anzeigt, möchte möglicherweise zwei oder mehr Ansichten oder Dokumente gleichzeitig anzeigen. Da der Browser jeweils nur eine Ansicht anzeigt, benötigt der Container eine Möglichkeit, die anderen Ansichten oder Dokumente aufzufordern, sich selbst nach Bedarf in separaten Fenstern anzuzeigen. Die IOleDocumentView::Open-Methode bietet diese Möglichkeit.

Hinweise für Anrufer

Auf einen erfolgreichen Aufruf von IOleDocumentView::Open sollte ein Aufruf von IOleDocumentView::Show folgen, um das Fenster auszublenden oder das Fenster anzuzeigen und es in den Vordergrund zu bringen. Während die Ansicht in ihrem separaten Fenster aktiv ist, kann ein Container das Fenster beliebig oft anzeigen oder ausblenden.

Hinweise zu Implementierern

Ein Dokumentobjekt gibt an, dass es die Aktivierung in einem separaten Fenster nicht unterstützt, indem es das DOCMISC_CANTOPENEDIT status-Flag festlegt und E_NOTIMPL an Container zurückgibt, die diese Methode aufrufen.

Die Implementierung besteht hauptsächlich aus dem Ansichtsobjekt, das eine eigene IOleInPlaceObject::InPlaceDeactivate-Methode aufruft , wodurch das Dokumentobjekt in einem ausgeführten Zustand bleibt, aber ohne direkte Aktivierung. Die Benutzeroberfläche des Dokumentobjekts ist erst sichtbar, wenn der Container IOleDocumentView::Show aufruft (siehe Notizen zu Anrufern oben).

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	docobj.h