activation sur place

Si votre vue de l'éditeur héberge ActiveX ou d'autres contrôles activés, vous devez implémenter votre vue de l'éditeur comme contrôle ActiveX ou d'un objet de données du document actif à l'aide de le modèle d'activation sur place.

Prise en charge des menus, barres d'outils, les commandes et

Visual Studio permet à votre vue d'éditeur pour utiliser les menus et les barres d'outils de l'IDE. Ces extensions désignés par OLE composants sur place. Pour plus d'informations, consultez IOleInPlaceComponent et l' IOleInPlaceComponentUIManager.

Si vous implémentez un contrôle ActiveX, vous pouvez héberger d'autres objets incorporés. Si vous implémentez un objet de données du document, le frame de fenêtre limité votre capacité d'utiliser des contrôles ActiveX.

Notes

Les interfaces d' IOleDocument et d' IOleDocumentView permettent d'une séparation des données et de la vue.Toutefois, Visual Studio ne prend pas en charge cette fonctionnalité, et ces interfaces sont utilisées pour représenter que l'objet de vue du document.

les éditeurs qui utilisent le service d' SOleComponentUIManager peuvent fournir le menu, la barre d'outils, et l'intégration de commande en appelant les méthodes d'interface d' IOleInPlaceComponentUIManager implémentée par le service d' SOleComponentUIManager . Les éditeurs peuvent également offrir l'autre fonctionnalité Visual Studio, par exemple le suivi de sélection, l'enregistrement, et la gestion d'annulation. Pour plus d'informations, consultez Créer des éditeurs de texte personnalisés et des concepteurs.

objets et interfaces utilisés

Les objets utilisés pour créer l'activation sur place sont présentés dans l'illustration suivante.

éditeur d'activation sur place

Notes

Les objets de ce dessin, seul l'objet d' CYourEditorFactory est requis pour créer un éditeur standard.Si vous créez un éditeur personnalisé, vous n'êtes pas tenus d'implémenter IVsPersistDocData2 car votre éditeur aura vraisemblablement son propre mécanisme privé de persistance.Pour plus d'informations, consultez Créer des éditeurs de texte personnalisés et des concepteurs.

Toutes les interfaces qui sont implémentées pour créer un éditeur d'activation sur place sont affichées sur l'objet unique d' CYourEditorDocument , mais cette configuration prend en charge une seule vue unique de données de document. Pour plus d'informations sur plusieurs vues de prise en charge de vos données du document, consultez plusieurs vues de prise en charge de document.

Interface	type d'objet	Utilisation
IOleInPlaceComponent	Vue	Permet aux objets sur place d'un VSPackage pour être exécutée en tant que composants totalement intégrés IDE à l'aide de le service d' SOleComponentUIManager . Ce service s'intègre les menus, les barres d'outils, et les commandes de l'objet dans l'IDE et envoie des notifications de modification d'état.
IOleObject	Vue	Principaux moyens par lesquels un objet incorporé fournit les fonctionnalités de base à son conteneur et communique avec lui.
IOleInPlaceActiveObject	Vue	Gère l'activation et la désactivation des objets sur place, et détermine quel nombre d'objet visuelle doit être visible.
IOleInPlaceObject	Vue	Fournit un canal direct de communication entre un objet sur place, la fenêtre frame en dehors de l'application associée, et la fenêtre de document dans l'application qui contient l'objet incorporé.
IOleDocument	Vue	Implémente un objet ActiveX. Notez que les méthodes d' IOleDocument et d' T:Microsoft.VisualStudio.OLE.Interop.IOleDocumentView que les données et la vue distinctes de document ne sont pas utilisé dans l'IDE.
IOleCommandTarget	vue/données	Permet à l'objet de données du document ou de l'objet de vue ou les deux de document pour participer aux commandes gérer.
IVsStatusbarUser	Vue	Active les mises à jour de barre d'état.
IVsToolboxUser	Vue	Active l'ajout d'éléments à la boîte à outils.
IVsFileChangeEvents	Données	Envoie la notification des modifications apportées au fichier modifié. (Cette interface est facultative).
IPersistFileFormat	Données	Permet d'activer la enregistrer sous fonctionnalités d'un type de fichier.
IVsPersistDocData	Données	active la persistance pour le document. Pour les fichiers en lecture seule, appelez SetDocDataReadOnly pour fournir l'icône « verrouillage » qui lit des fichiers en lecture seule.
IVsDocDataFileChangeControl	Données	Détermine si les modifications apportées aux données du document doivent être ignorées.