Compartir a través de


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

Muestra una vista de documento en una ventana emergente independiente. La semántica es equivalente a IOleObject::D oVerb con OLEIVERB_OPEN.

Sintaxis

HRESULT Open();

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.
E_NOTIMPL
El objeto de documento que posee esta vista no admite la activación de ventana independiente.

Comentarios

Un usuario que vea un objeto de documento en una aplicación contenedora como un explorador o un "enlazador" puede querer ver dos o más vistas o documentos a la vez. Dado que el explorador solo muestra una vista a la vez, el contenedor necesita una manera de pedir a las demás vistas o documentos que se muestren, según sea necesario, en ventanas independientes. El método IOleDocumentView::Open proporciona de esa manera.

Notas a los autores de llamadas

Una llamada correcta a IOleDocumentView::Open debe ir seguida de una llamada a IOleDocumentView::Show para ocultar la ventana o mostrar la ventana y traerla al primer plano. Mientras la vista está activa en su ventana independiente, un contenedor puede mostrar u ocultar la ventana tantas veces como pueda requerir.

Notas para los implementadores

Un objeto de documento indica que no admite la activación en una ventana independiente estableciendo la marca de estado DOCMISC_CANTOPENEDIT y devolviendo E_NOTIMPL a contenedores que llaman a este método.

La implementación consta principalmente del objeto de vista que llama a su propio método IOleInPlaceObject::InPlaceDeactivate , que deja el objeto de documento en un estado en ejecución, pero sin activación local. La interfaz de usuario del objeto de documento no es visible hasta que el contenedor llama a IOleDocumentView::Show (vea notas a los autores de llamadas anteriores).

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

Consulte también

IOleDocumentView

IOleDocumentView::CloseView

IOleDocumentView::Show

IOleDocumentView::UIActivate

IOleInPlaceObject::InPlaceDeactivate

IOleInPlaceSite

IOleInPlaceSite::OnInPlaceActivate