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 |