Partager via


COleClientItem, classe

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.

Notes

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++.

Hiérarchie d'héritage

CObject

CCmdTarget

CDocItem

COleClientItem

Configuration requise

Header: afxole.h

Voir aussi

Référence

CDocItem, classe

Graphique de la hiérarchie

COleServerItem, classe

Concepts

MFC exemple MFCBIND

exemple MFC OCLIENT