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

Artigo
03/05/2024

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
E_FAIL	Falha na operação.
E_OUTOFMEMORY	Memória insuficiente disponível para a operação.
E_UNEXPECTED	Erro inesperado.
E_NOTIMPL	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