IOleDocumentView::Clone, méthode (docobj.h)
Crée un objet d’affichage en double avec un état interne identique à celui de l’affichage actuel.
Syntaxe
HRESULT Clone(
[in] IOleInPlaceSite *pIPSiteNew,
[out] IOleDocumentView **ppViewNew
);
Paramètres
[in] pIPSiteNew
Pointeur vers une interface IOleInPlaceSite qui représente le site d’affichage dans lequel le nouvel objet d’affichage sera activé. À la réception de ce pointeur, la vue en cours de clonage doit la passer à la méthode IOleDocumentView::SetInPlaceSite de la nouvelle vue. Ce pointeur peut avoir la valeur NULL, auquel cas l’appelant est chargé d’appeler IOleDocumentView::SetInPlaceSite directement sur la nouvelle vue.
[out] ppViewNew
Pointeur vers une variable de pointeur IOleDocumentView qui reçoit le pointeur d’interface vers le nouvel objet d’affichage. L’appelant est responsable de la publication de ppViewNew lorsqu’il n’est plus nécessaire.
Valeur retournée
Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
L'opération a échoué. |
|
La valeur dans ppViewNew est NULL. |
|
L’objet view n’implémente pas cette interface. |
Notes
Cette méthode est utile pour créer une vue avec une autre fenêtre d’affichage et un site d’affichage, mais avec le même contexte d’affichage que la vue en cours de clonage. En règle générale, les conteneurs hébergeant une application MDI appellent cette méthode pour fournir la fonctionnalité « Fenêtre/Nouvelle fenêtre ».
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | docobj.h |