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 |
---|---|
|
Error en la operación. |
|
Memoria insuficiente disponible para la operación. |
|
Se ha producido un error inesperado. |
|
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 |