Clase de COleClientItem

Artículo
04/10/2013

Define la interfaz del contenedor a elementos de OLE.

class COleClientItem : public CDocItem

Miembros

Constructores públicos

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

Métodos públicos

Name	Descripción
COleClientItem::Activate	Abra el elemento OLE para una operación y después ejecutar el verbo especificado.
COleClientItem::ActivateAs	Genera el elemento como otro tipo.
COleClientItem::AttachDataObject	Tiene acceso a los datos del objeto OLE.
COleClientItem::CanCreateFromData	indica si una aplicación contenedora puede crear un objeto incrustado.
COleClientItem::CanCreateLinkFromData	indica si una aplicación contenedora puede crear un objeto vinculado.
COleClientItem::CanPaste	Indica si el portapapeles contiene un elemento OLE integrable o estático.
COleClientItem::CanPasteLink	Indica si el portapapeles contiene un elemento OLE enlazable.
COleClientItem::Close	Cierra un vínculo a un servidor pero no destruye el elemento.
COleClientItem::ConvertTo	convierte el elemento a otro tipo.
COleClientItem::CopyToClipboard	Copia el elemento OLE en el portapapeles.
COleClientItem::CreateCloneFrom	crea un duplicado de un elemento existente.
COleClientItem::CreateFromClipboard	Crea un elemento incrustado del portapapeles.
COleClientItem::CreateFromData	crea un elemento incrustado de un objeto de datos.
COleClientItem::CreateFromFile	crea un elemento incrustado de un archivo.
COleClientItem::CreateLinkFromClipboard	Crea un elemento vinculado del portapapeles.
COleClientItem::CreateLinkFromData	crea un elemento vinculado de un objeto de datos.
COleClientItem::CreateLinkFromFile	crea un elemento vinculado de un archivo.
COleClientItem::CreateNewItem	Crea un nuevo elemento incrustado iniciar la aplicación de servidor.
COleClientItem::CreateStaticFromClipboard	Crea un elemento estático del portapapeles.
COleClientItem::CreateStaticFromData	crea un elemento estático de un objeto de datos.
COleClientItem::Deactivate	desactiva el elemento.
COleClientItem::DeactivateUI	restablece la interfaz de usuario de la aplicación contenedora a su estado original.
COleClientItem::Delete	Elimina o cerrar el elemento OLE si fuera un elemento vinculado.
COleClientItem::DoDragDrop	Realiza una operación de arrastrar y colocar.
COleClientItem::DoVerb	ejecuta el verbo especificado.
COleClientItem::Draw	Dibuja el elemento.
COleClientItem::GetActiveView	Obtiene la vista en la que el elemento se provoca en contexto.
COleClientItem::GetCachedExtent	Devuelve los límites del rectángulo OLE del elemento.
COleClientItem::GetClassID	Obtiene el identificador de la clase de elemento actual
COleClientItem::GetClipboardData	Obtiene los datos que se colocarían en el portapapeles llamando a la función miembro de CopyToClipboard .
COleClientItem::GetDocument	Devuelve el objeto de COleDocument que contiene el elemento actual.
COleClientItem::GetDrawAspect	Obtiene la vista actual del elemento para generar.
COleClientItem::GetExtent	Devuelve los límites del rectángulo OLE del elemento.
COleClientItem::GetIconFromRegistry	Retrives un identificador a un icono asociado con el servidor de CLSID determinado.
COleClientItem::GetIconicMetafile	Obtiene el metarchivo utilizado para dibujar el icono del elemento.
COleClientItem::GetInPlaceWindow	Devuelve un puntero a la ventana de edición en el contexto del elemento.
COleClientItem::GetItemState	Obtiene el estado actual del elemento.
COleClientItem::GetLastStatus	Devuelve el estado de la operación OLE última.
COleClientItem::GetLinkUpdateOptions	Devuelve el modo de actualización para un elemento vinculado (característica avanzada).
COleClientItem::GetType	Devuelve el tipo (insertado, vinculado, o static) del elemento.
COleClientItem::GetUserType	Obtiene una cadena que describe el tipo de elemento.
COleClientItem::IsInPlaceActive	Devuelve TRUE si el elemento está activo en contexto.
COleClientItem::IsLinkUpToDate	Devuelve TRUE si un elemento vinculado está actualizado con el documento de origen.
COleClientItem::IsModified	Devuelve TRUE si se ha modificado el elemento desde que se guardó por última vez.
COleClientItem::IsOpen	Devuelve TRUE si el elemento está abierto en la aplicación de servidor.
COleClientItem::IsRunning	Devuelve TRUE si la aplicación de servidor de elemento se está ejecutando.
COleClientItem::OnActivate	Llamado por el marco para notificar al elemento que se produce.
COleClientItem::OnActivateUI	Llamado por el marco para notificar al elemento que se activan y debe mostrar la interfaz de usuario.
COleClientItem::OnChange	Se llama cuando el servidor cambia el elemento.Implementación necesaria.
COleClientItem::OnDeactivate	Llamado por el marco cuando se desactiva un elemento.
COleClientItem::OnDeactivateUI	Llamado por el marco cuando el servidor ha quitado la interfaz de usuario en contexto.
COleClientItem::OnGetClipboardData	Llamado por el marco para obtener los datos que se copiarán en el portapapeles.
COleClientItem::OnInsertMenus	Llamado por el marco para crear un menú compuesto.
COleClientItem::OnRemoveMenus	Llamado por el marco para quitar los menús de contenedor de un menú compuesto.
COleClientItem::OnSetMenu	Llamado por el marco para instalar y quitar un menú compuesto.
COleClientItem::OnShowControlBars	Llamado por el marco para mostrar y ocultar las barras de controles.
COleClientItem::OnUpdateFrameTitle	Llamado por el marco para actualizar la barra de título de la ventana de marco.
COleClientItem::ReactivateAndUndo	Reactivar el elemento y deshace la última operación de la edición en contexto.
COleClientItem::Release	Libera la conexión OLE vincularon el elemento y cierre él si estaba abierto.No destruye el elemento customer.
COleClientItem::Reload	Recarga el elemento después de una llamada a ActivateAs.
COleClientItem::Run	Ejecute la aplicación asociado al elemento.
COleClientItem::SetDrawAspect	Establece la vista actual del elemento para generar.
COleClientItem::SetExtent	Establece el rectángulo delimitador del elemento.
COleClientItem::SetHostNames	Establece los nombres que el servidor muestra al editar el elemento.
COleClientItem::SetIconicMetafile	Almacena en memoria caché el metarchivo utilizado para dibujar el icono del elemento.
COleClientItem::SetItemRects	Establece el rectángulo delimitador del elemento.
COleClientItem::SetLinkUpdateOptions	Establece el modo de actualización para un elemento vinculado (característica avanzada).
COleClientItem::SetPrintDevice	Establece el dispositivo de IMPR-destino para este elemento de cliente.
COleClientItem::UpdateLink	Actualiza la memoria caché de un elemento.

Métodos protegidos

Name	Descripción
COleClientItem::CanActivate	Llamado por el marco para determinar si la activación en contexto está permitida.
COleClientItem::OnChangeItemPosition	Llamado por el marco cuando cambia de posición de un elemento.
COleClientItem::OnDeactivateAndUndo	Llamado por el marco para deshacer después de activación.
COleClientItem::OnDiscardUndoState	Llamado por el marco para descartar la información de estado de deshacer del elemento.
COleClientItem::OnGetClipRect	Llamado por el marco para obtener el recortes-rectángulo de elemento coordina.
COleClientItem::OnGetItemPosition	Llamado por el marco para obtener la posición del elemento respecto a la vista.
COleClientItem::OnGetWindowContext	Llamado por el marco cuando un elemento se provoca en contexto.
COleClientItem::OnScrollBy	Llamado por el marco para desplazar el elemento en la vista.
COleClientItem::OnShowItem	Llamado por el marco para mostrar el elemento.

Comentarios

Un elemento OLE representa los datos, creados y mantenidos por una aplicación de servidor, que puede ser “sin problemas” escribir en un documento de modo que se presenta al usuario sea un documento único.El resultado es un “documento compuesto” compuesto de elemento OLE y un documento que contiene.

Un elemento OLE puede incrustar o vincular.Si se incrusta, sus datos se almacena como parte del documento compuesto.Si está vinculado, los datos están almacenados como parte de un archivo independiente creado por la aplicación de servidor, y solo un vínculo a ese archivo se almacena en el documento compuesto.Todos los elementos de OLE contienen información que especifica la aplicación de servidor que se debe llamar a para editarlos.

COleClientItem define varias funciones reemplazables que se llama en respuesta a las solicitudes de la aplicación de servidor; estos overridables actúan normalmente como notificaciones.Esto permite que la aplicación de servidor para informar al contenedor cambios que el usuario crea al editar el elemento OLE, o para recuperar la información necesaria durante la edición.

COleClientItem se puede utilizar con la clase de COleDocument, de COleLinkingDoc, o de COleServerDoc .Para utilizar COleClientItem, derive una clase de ella y implementar la función miembro de OnChange , que define cómo el contenedor responde a los cambios realizados en el elemento.Para admitir la activación en contexto, reemplace la función miembro de OnGetItemPosition .Esta función proporciona información sobre la posición indicada del elemento.

Para obtener más información sobre cómo utilizar la interfaz del contenedor, vea los artículos contenedores: implementar un contenedor y activación.

[!NOTA]

Windows SDK hace referencia a elementos incrustados y vinculados como “objetos” y hacer referencia a tipos de elementos como “clases”. Esta referencia utiliza el término “elemento” para distinguir la entidad) del objeto correspondiente de C++ y el término “tipo” para distinguir la categoría OLE de clase de C++.