Compartilhar via


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
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

Confira também

Ioledocumentview

IOleDocumentView::CloseView

IOleDocumentView::Show

IOleDocumentView::UIActivate

IOleInPlaceObject::InPlaceDeactivate

Ioleinplacesite

IOleInPlaceSite::OnInPlaceActivate