Método IOleDocumentView::CloseView (docobj.h)

Instrui uma exibição de documento a se fechar e liberar seu ponteiro IOleInPlaceSite .

Sintaxe

HRESULT CloseView(
  [in] DWORD dwReserved
);

Parâmetros

[in] dwReserved

Esse parâmetro é reservado e não pode ser NULL.

Valor retornado

Esse método retorna S_OK com êxito.

Comentários

Quando uma janela separada não é mais necessária, o contêiner chama IOleDocumentView::CloseView, em que a exibição libera o ponteiro do site para a janela separada e destrói a janela. Ao contrário da sequência de desativação in-loco normal para documentos ativos, uma exibição de documento continua a conter o ponteiro IOleInPlaceSite . Esse ponteiro é liberado somente quando o contêiner da exibição chama SetInPlaceSite, com pIPSite definido como NULL ou chama IOleDocumentView::CloseView.

Quando um usuário fecha a janela separada de uma exibição, o modo de exibição não deve se desligar. Em vez disso, ele deve chamar IOleInPlaceSite::OnInPlaceActivate. Em seguida, o site de exibição decide se deseja chamar IOleDocumentView::UIActivate com FALSE imediatamente ou posterior. Dessa forma, uma exibição de documento exibida em uma janela separada permanece disponível para ativação na própria janela do contêiner.

O contêiner deve chamar esse método antes de excluir a exibição, ou seja, liberar sua última referência à exibição. Em geral, a implementação desse método chamará IOleDocumentView::Show com FALSE para ocultar o modo de exibição se ele ainda não estiver oculto e chamar SetInPlaceSite com NULL para se desativar e liberar o ponteiro do site de exibição.

Como IOleDocumentView::CloseView é chamado quando um contêiner vai desligar completamente uma exibição, esse método deve ser implementado e não tem nenhum motivo para falhar.

Requisitos

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

Confira também

Ioledocumentview

IOleDocumentView::SetInPlaceSite

IOleDocumentView::Show