Simplifié incorporationSimplified Embedding

Incorporation simplifiée est activée dans un éditeur lorsque son objet de vue de document est apparenté à (autrement dit, un enfant de) Visual StudioVisual Studioet le IVsWindowPane interface est implémentée pour gérer ses commandes de fenêtre.Simplified embedding is enabled in an editor when its document view object is parented to (that is, made a child of) Visual StudioVisual Studio, and the IVsWindowPane interface is implemented to handle its window commands. Éditeurs incorporation simplifiés ne peut héberger des contrôles actifs.Simplified embedding editors cannot host active controls. Les objets utilisés pour créer un éditeur avec incorporation simplifié sont affichés dans l’illustration suivante.The objects used to create an editor with simplified embedding are shown in the following illustration.

Graphique de l’éditeur d’incorporation simplifiéSimplified Embedding Editor graphic
Éditeur d’incorporation simplifiéEditor with simplified embedding

Note

Des objets dans cette illustration, uniquement le CYourEditorFactory objet est requis pour créer un éditeur de fichier standard.Of the objects in this illustration, only the CYourEditorFactory object is required to create a standard file-based editor. Si vous créez un éditeur personnalisé, vous ne devez pas implémenter IVsPersistDocData2, car votre éditeur possède probablement son propre mécanisme privé de persistance.If you are creating a custom editor, you are not required to implement IVsPersistDocData2, because your editor will likely have its own private persistence mechanism. Pour les éditeurs non-custom, toutefois, vous devez le faire.For non-custom editors, however, you must do so.

Toutes les interfaces implémentées pour créer un éditeur avec incorporation simplifié sont contenus dans le CYourEditorDocument objet.All interfaces implemented to create an editor with simplified embedding are contained in the CYourEditorDocument object. Toutefois, pour prendre en charge plusieurs vues de données de document, diviser les interfaces sur des objets distincts de données et la vue comme indiqué dans le tableau suivant.However, to support multiple views of document data, split the interfaces onto separate data and view objects as indicated in the following table.

InterfaceInterface Emplacement de l’interfaceLocation of interface UtilisezUse
IVsWindowPane VueView Fournit la connexion à la fenêtre parente.Provides connection to the parent window.
IOleCommandTarget VueView Gère les commandes.Handles commands.
IVsStatusbarUser VueView Permet la mise à jour de la barre d’état.Enables status bar updates.
IVsToolboxUser VueView Permet de boîte à outils éléments.Enables Toolbox items.
IVsFileChangeEvents DonnéesData Envoie des notifications lorsque le fichier change.Sends notifications when the file changes.
IPersistFileFormat DonnéesData Active la fonctionnalité Enregistrer en tant que pour un type de fichier.Enables the Save As feature for a file type.
IVsPersistDocData2 DonnéesData Active la persistance pour le document.Enables persistence for the document.
IVsDocDataFileChangeControl DonnéesData Permet la suppression des événements de changement de fichier, telles que le rechargement de déclenchement.Allows suppression of file change events, such as reload triggering.