Clase de COleServerDoc

Artículo
03/15/2013

La clase base para los documentos de servidor OLE.

class AFX_NOVTABLE COleServerDoc : public COleLinkingDoc

Miembros

Constructores públicos

Name	Descripción
COleServerDoc::COleServerDoc	Crea un objeto COleServerDoc.

Métodos públicos

Name	Descripción
COleServerDoc::ActivateDocObject	Genera el documento asociado de DocObject.
COleServerDoc::ActivateInPlace	Genera el documento para la edición en contexto.
COleServerDoc::DeactivateAndUndo	Desactiva la interfaz de usuario del servidor.
COleServerDoc::DiscardUndoState	Información de la fase de reversión-provincia de los descarta.
COleServerDoc::GetClientSite	recupera un puntero a la interfaz subyacente de IOleClientSite .
COleServerDoc::GetEmbeddedItem	Devuelve un puntero a un elemento que representa el documento.
COleServerDoc::GetItemClipRect	Devuelve el rectángulo actual de recorte para la edición en contexto.
COleServerDoc::GetItemPosition	Devuelve el rectángulo de la posición actual, en relación con el área de cliente de la aplicación contenedora, para la edición en contexto.
COleServerDoc::GetZoomFactor	Devuelve el factor de zoom en píxeles.
COleServerDoc::IsDocObject	determina si el documento es un DocObject.
COleServerDoc::IsEmbedded	Indica si el documento se inserta en un documento o contenedor una ejecución independiente.
COleServerDoc::IsInPlaceActive	Devuelve TRUE si el elemento se activa actualmente en contexto.
COleServerDoc::NotifyChanged	Notifica a los contenedores que el usuario ha cambiado el documento.
COleServerDoc::NotifyClosed	Notifica a los contenedores que ha cerrado el usuario el documento.
COleServerDoc::NotifyRename	Notifica a los contenedores que el usuario ha cambiado el documento.
COleServerDoc::NotifySaved	Notifica a los contenedores que el usuario ha guardado el documento.
COleServerDoc::OnDeactivate	Llamado por el marco cuando el usuario desactiva un elemento generado en su lugar.
COleServerDoc::OnDeactivateUI	Llamado por el marco para destruir los controles y otros elementos de interfaz de usuario creados para la activación en contexto.
COleServerDoc::OnDocWindowActivate	Llamado por el marco cuando se activa o desactiva la ventana de marco de documento de contenedor.
COleServerDoc::OnResizeBorder	Llamado por el marco cuando se cambia el tamaño de la ventana o la ventana de documento del cuadro de la aplicación contenedora.
COleServerDoc::OnShowControlBars	Llamado por el marco para mostrar u ocultar las barras de control para la edición en contexto.
COleServerDoc::OnUpdateDocument	Llamado por el marco cuando se guarda un documento de servidor que es un elemento incrustado, actualizando la copia del contenedor del elemento.
COleServerDoc::RequestPositionChange	Cambia la posición del marco de la edición en contexto.
COleServerDoc::SaveEmbedding	Indica la aplicación contenedora para guardar el documento.
COleServerDoc::ScrollContainerBy	desplaza el documento contenedor.
COleServerDoc::UpdateAllItems	Notifica a los contenedores que el usuario ha cambiado el documento.

Métodos protegidos

Name	Descripción
COleServerDoc::CreateInPlaceFrame	Llamado por el marco para crear una ventana de marco para la edición en contexto.
COleServerDoc::DestroyInPlaceFrame	Llamado por el marco para destruir una ventana de marco para la edición en contexto.
COleServerDoc::GetDocObjectServer	invalide esta función para crear un nuevo objeto de CDocObjectServer y para indicar que este documento es un contenedor de DocObject.
COleServerDoc::OnClose	Llamado por el marco cuando solicite un contenedor para cerrar el documento.
COleServerDoc::OnExecOleCmd	Ejecuta un comando o una ayuda especificado de muestra para el comando.
COleServerDoc::OnFrameWindowActivate	Llamado por el marco cuando se activa o desactiva la ventana de marco de contenedor.
COleServerDoc::OnGetEmbeddedItem	Denominado para obtener COleServerItem que representa el documento; se utiliza para obtener un elemento incrustado.Implementación necesaria.
COleServerDoc::OnReactivateAndUndo	Llamado por el marco a deshacer los cambios realizados realizados durante la edición en contexto.
COleServerDoc::OnSetHostNames	Llamado por el marco cuando un contenedor establece el título de la ventana para un objeto incrustado.
COleServerDoc::OnSetItemRects	Llamado por el marco para colocar la ventana cuadro de edición en contexto en la ventana de la aplicación contenedora.
COleServerDoc::OnShowDocument	Llamado por el marco para mostrar u ocultar el documento.

Comentarios

Un documento de servidor puede contener objetos de COleServerItem , que representan al servidor que la interfaz incrustado o vinculado elementos.Cuando una aplicación de servidor es iniciada por un contenedor para editar un elemento incrustado, el elemento se carga como su propio documento de servidor; el objeto de COleServerDoc contiene solo un objeto de COleServerItem , que consta de todo el documento.Cuando una aplicación de servidor es iniciada por un contenedor para editar un elemento vinculado, un documento existente se carga desde el disco; una parte del contenido del documento está resaltado indicar el elemento vinculado.

los objetos deCOleServerDoc también pueden contener elementos de la clase de COleClientItem .Esto permite crear aplicaciones de contenedor-Servidor.El marco de trabajo proporciona funciones para almacenar correctamente los elementos de COleClientItem manteniendo los objetos de COleServerItem .

Si lo hace la aplicación de servidor no admitir vínculos, un documento de servidor contendrá siempre sólo un elemento del servidor, que representa el objeto incrustado completo como documento.Si la aplicación de servidor hace vínculos admiten, debe crear un elemento de servidor cada vez que una selección se copia en el portapapeles.

Para utilizar COleServerDoc, derive una clase de ella y implementar la función miembro de OnGetEmbeddedItem , que permite al servidor admite elementos incrustados.Derive una clase de COleServerItem para implementar elementos en los documentos, y devuelve objetos de esa clase de OnGetEmbeddedItem.

Para admitir vinculados los elementos, COleServerDoc proporciona la función miembro de OnGetLinkedItem .Puede utilizar la implementación predeterminada o reemplazarlo si tiene poseer la manera de administrar los elementos del documento.

Necesita un COleServerDoc- clase derivada para cada tipo de documento del servidor que admite la aplicación.Por ejemplo, si la aplicación de servidor admite hojas de cálculo y gráficos, necesita dos COleServerDoc- clases derivadas.

Para obtener más información sobre los servidores, vea el artículo Servidores: Implementar en un Servidor.