IOleDocumentView::Clone-Methode (docobj.h)
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 |
|---|---|
|
Fehler beim Vorgang. |
|
Der Wert in ppViewNew ist NULL. |
|
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 |