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

Artículo
03/05/2024

Activa o desactiva una vista.

Sintaxis

HRESULT Show(
  [in] BOOL fShow
);

Parámetros

[in] fShow

Si es TRUE, la vista se mostrará a sí misma. Si es FALSE, la vista se ocultará a sí misma.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_FAIL	Error en la operación.
E_OUTOFMEMORY	Memoria insuficiente disponible para la operación.
E_UNEXPECTED	Se ha producido un error inesperado.

Comentarios

Llamar a Show es el último paso de la secuencia de activación, ya que antes de mostrarse un objeto de documento debe saber exactamente qué espacio ocupa y tener todas sus herramientas disponibles.

Notas a los autores de llamadas

Una llamada a este método para activar una vista debe seguir las llamadas a IOleDocumentView::SetInPlaceSite, IOleDocumentView::UIActivate e IOleDocumentView::SetRect (o IOleDocumentView::SetRectComplex).

Notas para los implementadores

Las implementaciones de este método deben incorporar el siguiente pseudocódigo.

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 las vistas de un objeto de documento deben admitir al menos la activación en contexto; E_NOTIMPL no es un valor aceptable.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	docobj.h