IOleDocumentView::Clone-Methode (docobj.h)

  • Artikel

Erstellt ein doppeltes Ansichtsobjekt mit einem internen Zustand, der mit dem der aktuellen Ansicht identisch ist.

Syntax

HRESULT Clone(
  [in]  IOleInPlaceSite  *pIPSiteNew,
  [out] IOleDocumentView **ppViewNew
);

Parameter

[in] pIPSiteNew

Ein Zeiger auf eine IOleInPlaceSite-Schnittstelle , die die Ansichtswebsite darstellt, in der das neue Ansichtsobjekt aktiviert wird. Beim Empfangen dieses Zeigers sollte die geklonte Ansicht ihn an die IOleDocumentView::SetInPlaceSite-Methode der neuen Ansicht übergeben. Dieser Zeiger kann NULL sein. In diesem Fall ist der Aufrufer für den direkten Aufruf von IOleDocumentView::SetInPlaceSite in der neuen Ansicht verantwortlich.

[out] ppViewNew

Ein Zeiger auf eine IOleDocumentView-Zeigervariable , die den Schnittstellenzeiger auf das neue Ansichtsobjekt empfängt. Der Aufrufer ist für die Freigabe von ppViewNew verantwortlich, wenn es nicht mehr benötigt wird.

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_POINTER
 Der Wert in ppViewNew ist NULL.
E_NOTIMPL
 Das Ansichtsobjekt implementiert diese Schnittstelle nicht.

Hinweise

Diese Methode ist nützlich, um eine neue Ansicht mit einem anderen Viewport und einer anderen Ansichtswebsite, aber mit demselben Ansichtskontext wie die zu klonende Ansicht zu erstellen. In der Regel rufen Container, die eine MDI-Anwendung hosten, diese Methode auf, um die Funktion "Fenster/Neues Fenster" bereitzustellen.

Anforderungen

   
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

Weitere Informationen

IOleDocumentView

IOleDocumentView::SetInPlaceSite