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

Artigo
02/26/2024

Ativa ou desativa uma exibição.

Sintaxe

HRESULT Show(
  [in] BOOL fShow
);

Parâmetros

[in] fShow

Se TRUE, o modo de exibição será mostrado a si mesmo. Se FALSE, a exibição será ocultar-se.

Retornar valor

Esse método retorna S_OK em caso de ê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 operação.
E_UNEXPECTED	Erro inesperado.

Comentários

Chamar Mostrar é a última etapa na sequência de ativação, pois antes de mostrar a si mesmo um objeto de documento deve saber exatamente qual espaço ele ocupa e ter todas as suas ferramentas disponíveis.

Anotações aos Chamadores

Uma chamada para esse método com a finalidade de ativar uma exibição deve seguir chamadas para IOleDocumentView::SetInPlaceSite, IOleDocumentView::UIActivate e IOleDocumentView::SetRect (ou IOleDocumentView::SetRectComplex).

Observações aos implementadores

As implementações desse método devem incorporar o pseudocódigo a seguir.

if (fShow)
    {
    In-place activate the view but do not UI activate it.
    Show the view window. 
    }
else
    {
    Call IOleDocumentView::UIActivate(FALSE) on this view
    Hide the view window
    }

Todas as exibições de um objeto de documento devem, pelo menos, dar suporte à ativação in-loco; E_NOTIMPL não é um valor aceitável.

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