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

Artigo
08/23/2023

Cria um objeto de exibição de documento no processo do chamador e obtém um ponteiro para a interface IOleDocumentView desse objeto.

Sintaxe

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

Parâmetros

[in] pIPSite

Um ponteiro para a interface IOleInPlaceSite que representa o objeto de site de exibição a ser associado ao novo objeto de exibição de documento. Esse parâmetro pode ser NULL, por exemplo, quando a exibição está contida em um novo objeto de documento não inicializado, nesse caso, o chamador deve inicializar a exibição com uma chamada subsequente para IOleDocumentView::SetInPlaceSite.

[in] pstm

Um ponteiro para um fluxo que contém dados dos quais o novo objeto de exibição de documento deve se inicializar. Se NULL, o objeto de documento inicializará o novo objeto de exibição de documento com um estado padrão.

[in] dwReserved

Esse parâmetro é reservado e precisa ser zero.

[out] ppView

Um ponteiro para uma variável de ponteiro IOleDocumentView que recebe o ponteiro da interface para o novo objeto de exibição de documento. Quando bem-sucedido, o chamador é responsável por chamar IUnknown::Release no ponteiro ppview quando o objeto de exibição não é mais necessário.

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_FAIL	Falha na operação.
E_OUTOFMEMORY	Memória insuficiente disponível para a operação.
E_UNEXPECTED	Ocorreu um erro inesperado.
E_POINTER	O endereço em ppView é NULL.

Comentários

O site de documento de um contêiner de objeto de documento chama CreateView para instruir um objeto de documento a criar uma nova exibição de si mesmo no processo do contêiner, seja de dados padrão ou usando o conteúdo de um fluxo existente.

Chamar CreateView não faz com que o novo modo de exibição seja exibido. Para fazer isso, é necessário uma chamada para IOleDocumentView::Show ou IOleDocumentView::UIActivate.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	docobj.h