Classe de COleClientItem

Article
03/15/2013

Définit l'interface de conteneur à OLE éléments.

class COleClientItem : public CDocItem

Membres

Constructeurs publics

Nom	Description
COleClientItem::COleClientItem	Construit un objet COleClientItem.

Méthodes publiques

Nom	Description
COleClientItem::Activate	Ouvre un élément OLE pour une opération puis exécute le verbe spécifié.
COleClientItem::ActivateAs	Active l'élément comme un autre type.
COleClientItem::AttachDataObject	Accède aux données dans l'objet OLE.
COleClientItem::CanCreateFromData	Indique si une application conteneur peut créer un objet incorporé.
COleClientItem::CanCreateLinkFromData	Indique si une application conteneur peut créer un objet lié.
COleClientItem::CanPaste	Indique si le presse-papiers contient un élément OLE encastrable ou statique.
COleClientItem::CanPasteLink	Indique si le presse-papiers contient un élément OLE liable.
COleClientItem::Close	Ferme un lien vers un serveur mais ne supprime pas le élément OLE.
COleClientItem::ConvertTo	Convertit l'élément vers un autre type.
COleClientItem::CopyToClipboard	Copie le élément OLE dans le presse-papiers.
COleClientItem::CreateCloneFrom	Crée un doublon d'un élément existant.
COleClientItem::CreateFromClipboard	Crée un élément incorporé dans le presse-papiers.
COleClientItem::CreateFromData	Crée un élément incorporé d'un objet de données.
COleClientItem::CreateFromFile	Crée un élément inline à partir d'un fichier.
COleClientItem::CreateLinkFromClipboard	Crée un élément lié dans le presse-papiers.
COleClientItem::CreateLinkFromData	Crée un élément lié à un objet de données.
COleClientItem::CreateLinkFromFile	Crée un élément lié à partir d'un fichier.
COleClientItem::CreateNewItem	Crée un élément incorporé en activant l'application serveur.
COleClientItem::CreateStaticFromClipboard	Crée un élément statique du presse-papiers.
COleClientItem::CreateStaticFromData	Crée un élément statique d'un objet de données.
COleClientItem::Deactivate	Place l'élément.
COleClientItem::DeactivateUI	Restaure l'interface utilisateur de l'application conteneur à son état d'origine.
COleClientItem::Delete	Supprime ou ferme le OLE rubrique s'il s'agissait d'un élément lié.
COleClientItem::DoDragDrop	Effectue une opération de glisser-déplacer.
COleClientItem::DoVerb	Exécute le verbe spécifié.
COleClientItem::Draw	Dessine un élément OLE.
COleClientItem::GetActiveView	Obtient la vue dans laquelle l'élément est activé en place.
COleClientItem::GetCachedExtent	Retourne les limites du rectangle OLE de l'élément.
COleClientItem::GetClassID	Obtient l'ID de la classe de l'élément actuel
COleClientItem::GetClipboardData	Obtient les données qui seraient placées dans le presse-papiers en appelant la fonction membre d' CopyToClipboard .
COleClientItem::GetDocument	Retourne l'objet d' COleDocument qui contient l'élément actuel.
COleClientItem::GetDrawAspect	Obtient l'affichage actuel de l'élément pour le rendu.
COleClientItem::GetExtent	Retourne les limites du rectangle OLE de l'élément.
COleClientItem::GetIconFromRegistry	Retrives un handle à une icône associée au serveur CLSID particulier.
COleClientItem::GetIconicMetafile	Obtient le métafichier utilisé pour dessiner l'icône de l'élément.
COleClientItem::GetInPlaceWindow	Retourne un pointeur vers la fenêtre de la modification sur place de l'élément.
COleClientItem::GetItemState	Obtient l'état actuel de l'élément.
COleClientItem::GetLastStatus	Retourne l'état de la dernière exécution. OLE
COleClientItem::GetLinkUpdateOptions	Retourne le mode mise à jour d'un élément lié (fonctionnalité avancée).
COleClientItem::GetType	Retourne le type (incorporé, attaché, ou statique) du élément OLE.
COleClientItem::GetUserType	Obtient une chaîne décrivant le type de l'élément.
COleClientItem::IsInPlaceActive	Retourne TRUE si l'élément est actif sur place.
COleClientItem::IsLinkUpToDate	Retourne TRUE si un élément est lié à jour avec son document source.
COleClientItem::IsModified	Retourne TRUE si l'élément a été modifié depuis lequel il a été en dernier enregistrement.
COleClientItem::IsOpen	Retourne TRUE si l'élément est ouvert dans l'application serveur.
COleClientItem::IsRunning	Retourne TRUE si l'application serveur de l'élément s'exécute.
COleClientItem::OnActivate	Appelé par l'infrastructure pour informer l'élément qu'il est activé.
COleClientItem::OnActivateUI	Appelé par l'infrastructure pour informer l'élément qu'il est lancé et doit afficher son interface utilisateur.
COleClientItem::OnChange	Appelé lorsque le serveur modifie le élément OLE.Implémentation requise.
COleClientItem::OnDeactivate	Appelé par l'infrastructure lorsqu'un élément est désactivé.
COleClientItem::OnDeactivateUI	Appelé par l'infrastructure lorsque le serveur a supprimé son interface utilisateur visuelle.
COleClientItem::OnGetClipboardData	Appelé par l'infrastructure pour obtenir les données soient copiés dans le presse-papiers.
COleClientItem::OnInsertMenus	Appelé par l'infrastructure pour créer un menu composite.
COleClientItem::OnRemoveMenus	Appelé par l'infrastructure pour supprimer les menus du conteneur d'un menu composite.
COleClientItem::OnSetMenu	Appelé par l'infrastructure pour installer et supprimer un menu composite.
COleClientItem::OnShowControlBars	Appelé par l'infrastructure pour afficher et masquer des barres de contrôles.
COleClientItem::OnUpdateFrameTitle	Appelé par l'infrastructure pour mettre à jour la barre de titre de la fenêtre frame.
COleClientItem::ReactivateAndUndo	Réactive l'élément et annule la dernière opération de modification sur place.
COleClientItem::Release	Libère la connexion à un élément OLE lié et la batterie si elle a été ouverte.Ne supprime pas l'élément client.
COleClientItem::Reload	Recharge l'élément après un appel à ActivateAs.
COleClientItem::Run	Exécute l'application associée à l'élément.
COleClientItem::SetDrawAspect	Définit l'affichage actuel de l'élément pour le rendu.
COleClientItem::SetExtent	Définit le rectangle englobant d'un élément OLE.
COleClientItem::SetHostNames	Définit les noms que le serveur affiche en modifiant le élément OLE.
COleClientItem::SetIconicMetafile	Met en cache le métafichier utilisé pour dessiner l'icône de l'élément.
COleClientItem::SetItemRects	Définit le rectangle englobant de l'élément.
COleClientItem::SetLinkUpdateOptions	Définit le mode mise à jour d'un élément lié (fonctionnalité avancée).
COleClientItem::SetPrintDevice	Définit le périphérique de copie- cible pour cet élément client.
COleClientItem::UpdateLink	Met à jour le cache de présentation d'un élément.

Méthodes protégées

Nom	Description
COleClientItem::CanActivate	Appelé par l'infrastructure pour déterminer si l'activation sur place.
COleClientItem::OnChangeItemPosition	Appelé par l'infrastructure lorsque la position d'un élément change.
COleClientItem::OnDeactivateAndUndo	Appelé par l'infrastructure pour l'annulation après l'activation.
COleClientItem::OnDiscardUndoState	Appelé par l'infrastructure pour ignorer les informations d'état d'annulation de l'élément.
COleClientItem::OnGetClipRect	Appelé par l'infrastructure pour obtenir les coordonnées du rectangle de découpage de l'élément.
COleClientItem::OnGetItemPosition	Appelé par l'infrastructure pour obtenir la position de l'élément par rapport à la vue.
COleClientItem::OnGetWindowContext	Appelé par l'infrastructure lorsqu'un élément est activé en place.
COleClientItem::OnScrollBy	Appelé par l'infrastructure pour faire défiler l'élément dans la vue.
COleClientItem::OnShowItem	Appelé par l'infrastructure pour afficher un élément OLE.

Notes

Un élément OLE représente des données, créées et mises à jour par une application serveur, qui peut être « » de façon transparente incorporée dans un document afin qu'elle semble à l'utilisateur être un document unique.Le résultat est un « document composite » composé d'un élément OLE et d'un document contenant.

Un élément OLE peut être inclus ou lié.S'il est incorporé, ses données sont stockées dans le cadre de le document composite.Si elles sont attachées, ses données sont stockées dans le cadre d'un fichier séparé créé par l'application serveur, ainsi qu'un lien vers ce fichier est stocké dans le document composite.Tous les éléments OLE contiennent des informations spécifiant l'application serveur qui doit être appelée pour les modifier.

COleClientItem définit plusieurs fonctions substituables qui sont appelées en réponse à les demandes de l'application serveur ; ces overridables interagissent généralement comme notifications.Cela permet à l'application serveur d'informer le conteneur de modifications que l'utilisateur effectue en modifiant le élément OLE, ou d'extraire les informations requises lors de la modification.

COleClientItem peut être utilisé avec la classe de COleDocument, de COleLinkingDoc, ou de COleServerDoc .Pour utiliser COleClientItem, dérivez une classe de celle-ci et implémentez la fonction membre d' OnChange , qui définit comment le conteneur répond aux modifications apportées à l'élément.Pour prendre en charge l'activation sur place, substituez la fonction membre d' OnGetItemPosition .Cette fonction fournit des informations sur la position affichée du élément OLE.

Pour plus d'informations sur l'utilisation de l'interface de conteneur, consultez les articles conteneurs : implémenter un conteneur et lancement.

[!REMARQUE]

Kit de développement logiciel Windows fait référence incorporé et des éléments liés comme « objets et » fait référence aux types d'éléments en tant que « classe ». Les utilisations de cette référence le terme « élément » de distinguer OLE entité de l'objet correspondant C++ et le terme « type » pour distinguer OLE catégorie de la classe C++.