Metodo IOleDocument::CreateView (docobj.h)

Articolo
08/23/2023

Crea un oggetto visualizzazione documento nel processo del chiamante e ottiene un puntatore all'interfaccia IOleDocumentView dell'oggetto.

Sintassi

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

Parametri

[in] pIPSite

Puntatore all'interfaccia IOleInPlaceSite che rappresenta l'oggetto sito di visualizzazione da associare al nuovo oggetto visualizzazione documento. Questo parametro può essere NULL, ad esempio, quando la vista è contenuta in un nuovo oggetto documento non inizializzato, nel qual caso il chiamante deve inizializzare la vista con una chiamata successiva a IOleDocumentView::SetInPlaceSite.

[in] pstm

Puntatore a un flusso contenente dati da cui deve essere inizializzato il nuovo oggetto vista documento. Se NULL, l'oggetto documento inizializza il nuovo oggetto vista documento con uno stato predefinito.

[in] dwReserved

Questo parametro è riservato e deve essere zero.

[out] ppView

Puntatore a una variabile puntatore IOleDocumentView che riceve il puntatore dell'interfaccia al nuovo oggetto visualizzazione documento. In caso di esito positivo, il chiamante è responsabile della chiamata a IUnknown::Release nel puntatore ppview quando l'oggetto di visualizzazione non è più necessario.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
E_OUTOFMEMORY	Memoria insufficiente disponibile per l'operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.
E_POINTER	L'indirizzo in ppView è NULL.

Commenti

Il sito del documento di un contenitore di oggetti documento chiama CreateView per indicare a un oggetto documento di creare una nuova visualizzazione di se stessa nel processo del contenitore, dai dati predefiniti o usando il contenuto di un flusso esistente.

La chiamata a CreateView non causa la visualizzazione della nuova visualizzazione. A tale scopo, è necessaria una chiamata a IOleDocumentView::Show o IOleDocumentView::UIActivate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	docobj.h