Clase de COleServerItem

Artículo
04/10/2013

Proporciona la interfaz del servidor a los elementos de OLE.

class COleServerItem : public CDocItem

Miembros

Constructores protegidos

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

Métodos públicos

Name	Descripción
COleServerItem::AddOtherClipboardData	Formatos de presentación y la conversión de los lugares de un objeto de COleDataSource .
COleServerItem::CopyToClipboard	Copia el elemento en el portapapeles.
COleServerItem::DoDragDrop	Realiza una operación de arrastrar y colocar.
COleServerItem::GetClipboardData	Obtiene el origen de datos para su uso en la transferencia de datos (arrastrar y colocar o portapapeles).
COleServerItem::GetDocument	Devuelve el documento del servidor que contiene el elemento.
COleServerItem::GetEmbedSourceData	Obtiene los datos de CF_EMBEDSOURCE para un elemento.
COleServerItem::GetItemName	Devuelve el nombre del elemento.Se usa para los elementos vinculados sólo.
COleServerItem::GetLinkSourceData	Obtiene los datos de CF_LINKSOURCE para un elemento.
COleServerItem::GetObjectDescriptorData	Obtiene los datos de CF_OBJECTDESCRIPTOR para un elemento.
COleServerItem::IsConnected	Indica si el elemento está asociado actualmente a un contenedor activo.
COleServerItem::IsLinkedItem	Indica si el elemento representa un elemento OLE vinculado.
COleServerItem::NotifyChanged	Actualiza todos los contenedores con actualización de vínculo automático.
COleServerItem::OnDoVerb	denominado para ejecutar un verbo.
COleServerItem::OnDraw	Se invoca cuando las solicitudes de contenedor para dibujar el elemento; implementación necesaria.
COleServerItem::OnDrawEx	Denominado para el gráfico especializado del elemento.
COleServerItem::OnGetClipboardData	Llamado por el marco para obtener los datos que se copian en el portapapeles.
COleServerItem::OnGetExtent	Llamado por el marco para recuperar el tamaño del elemento.
COleServerItem::OnInitFromData	Llamado por el marco para inicializar un elemento OLE mediante el contenido del objeto de transferencia de datos especificado.
COleServerItem::OnQueryUpdateItems	denominado para determinar si algunos elementos vinculados requieren actualizar.
COleServerItem::OnRenderData	Recupera los datos como parte de generar retrasada.
COleServerItem::OnRenderFileData	Recupera datos de un objeto de CFile como parte de generar retrasada.
COleServerItem::OnRenderGlobalData	Recupera datos de HGLOBAL como parte de generar retrasada.
COleServerItem::OnSetColorScheme	Denominado para establecer la combinación de colores del elemento.
COleServerItem::OnSetData	Denominado para establecer los datos de elemento.
COleServerItem::OnSetExtent	Llamado por el marco para establecer el tamaño del elemento.
COleServerItem::OnUpdate	Se invoca cuando pertenece un poco del documento el elemento en cambia.
COleServerItem::OnUpdateItems	Denominado para actualizar la memoria caché de todos los elementos del documento del servidor.
COleServerItem::SetItemName	Establece el nombre del elemento.Se usa para los elementos vinculados sólo.

Métodos protegidos

Name	Descripción
COleServerItem::GetDataSource	Obtiene el objeto utilizado a formatos almacenados de conversión.
COleServerItem::OnHide	Llamado por el marco para ocultar el elemento.
COleServerItem::OnOpen	Llamado por el marco para mostrar el elemento OLE en su propia ventana de nivel superior.
COleServerItem::OnShow	Se invoca cuando las solicitudes de contenedor para mostrar el elemento.

Miembros de datos públicos

Name	Descripción
COleServerItem::m_sizeExtent	Informa al servidor sobre cuánto de elemento OLE está visible.

Comentarios

Un elemento vinculado puede representar parte o todo el documento del servidor.Un elemento incrustado siempre representa un documento completo del servidor.

La clase de COleServerItem define varias funciones overridable miembro que son llamadas por las bibliotecas de vínculos dinámicos del sistema OLE (DLLs), normalmente en respuesta a las solicitudes de la aplicación contenedora.Estas funciones miembro permiten la aplicación contenedora para manipular el elemento indirectamente de varias maneras, por ejemplo mostrarla, ejecutar los verbos, o recuperar los datos en diferentes formatos.

Para utilizar COleServerItem, derive una clase de ella y implementar el miembro de OnDraw y de serialice funciona.La función de OnDraw proporciona la representación de metarchivo de un elemento, lo que se mostrará cuando abra una aplicación contenedora un documento compuesto.La función de Serialize de CObject proporciona la representación nativa de un elemento, permitiendo que un elemento incrustado se transfieren entre el servidor y las aplicaciones contenedoras.OnGetExtent proporciona el tamaño natural del elemento al contenedor, habilitando el contenedor para ajustar el tamaño del elemento.

Para obtener más información sobre servidores y temas relacionados, vea el artículo Servidores: Implementar en un Servidor y “crear un contenedor o una aplicación de servidor” en el artículo contenedores: Características avanzadas.