Método IOleDocumentView::Open (docobj.h)
Exibe uma exibição de documento em uma janela pop-up separada. A semântica é equivalente a IOleObject::D oVerb com OLEIVERB_OPEN.
Sintaxe
HRESULT Open();
Retornar valor
Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
Falha na operação. |
|
Memória insuficiente disponível para a operação. |
|
Erro inesperado. |
|
O objeto de documento que possui essa exibição não dá suporte à ativação de janela separada. |
Comentários
Um usuário exibindo um objeto de documento em um aplicativo de contêiner, como um navegador ou um "associador", pode querer ver duas ou mais exibições ou documentos ao mesmo tempo. Como o navegador exibe apenas uma exibição de cada vez, o contêiner precisa de uma maneira de solicitar que os outros modos de exibição ou documentos se exibam, conforme necessário, em janelas separadas. O método IOleDocumentView::Open fornece essa maneira.
Anotações para chamadores
Uma chamada bem-sucedida para IOleDocumentView::Open deve ser seguida por uma chamada para IOleDocumentView::Show para ocultar a janela ou para mostrar a janela e trazê-la para o primeiro plano. Embora o modo de exibição esteja ativo em sua janela separada, um contêiner pode mostrar ou ocultar a janela quantas vezes for necessário.Anotações aos implementadores
Um objeto de documento indica que ele não dá suporte à ativação em uma janela separada definindo o sinalizador DOCMISC_CANTOPENEDIT status e retornando E_NOTIMPL para contêineres que chamam esse método.A implementação consiste principalmente no objeto de exibição que chama seu próprio método IOleInPlaceObject::InPlaceDeactivate , que deixa o objeto de documento em um estado em execução, mas sem ativação in-loco. A interface do usuário do objeto de documento não fica visível até que o contêiner chame IOleDocumentView::Show (consulte Anotações para chamadores acima).
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 |