Méthode IOleDocument ::CreateView (docobj.h)

Article
02/26/2024

Crée un objet d’affichage de document dans le processus de l’appelant et obtient un pointeur vers l’interface IOleDocumentView de cet objet.

Syntaxe

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

Paramètres

[in] pIPSite

Pointeur vers l’interface IOleInPlaceSite qui représente l’objet de site d’affichage à associer au nouvel objet d’affichage de document. Ce paramètre peut être NULL, par exemple, lorsque la vue est contenue dans un nouvel objet document non initialisé, auquel cas l’appelant doit initialiser la vue avec un appel ultérieur à IOleDocumentView ::SetInPlaceSite.

[in] pstm

Pointeur vers un flux contenant des données à partir de laquelle le nouvel objet d’affichage de document doit s’initialiser. Si la valeur est NULL, l’objet document initialise le nouvel objet d’affichage de document avec un état par défaut.

[in] dwReserved

Ce paramètre est réservé et doit être égal à zéro.

[out] ppView

Pointeur vers une variable de pointeur IOleDocumentView qui reçoit le pointeur d’interface vers le nouvel objet d’affichage de document. En cas de réussite, l’appelant est chargé d’appeler IUnknown ::Release sur le pointeur ppview lorsque l’objet d’affichage 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
E_FAIL	L'opération a échoué.
E_OUTOFMEMORY	Mémoire insuffisante disponible pour l’opération.
E_UNEXPECTED	Une erreur inattendue s’est produite.
E_POINTER	L’adresse dans ppView est NULL.

Remarques

Le site de documents d’un conteneur d’objets de document appelle CreateView pour indiquer à un objet document de créer une vue d’elle-même dans le processus du conteneur, à partir de données par défaut ou à l’aide du contenu d’un flux existant.

L’appel de CreateView n’entraîne pas l’affichage de la nouvelle vue. Pour ce faire, vous devez appeler IOleDocumentView ::Show ou IOleDocumentView ::UIActivate.

Configuration requise

Condition requise	Valeur
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