Comment : Implémentez la gestion d'annulation
L'interface principale utilisée pour la gestion d'annulation est IOleUndoManager, implémentée par l'environnement. Pour prendre en charge la gestion d'annulation, implémentez les unités séparées undo (autrement dit, IOleUndoUnit, qui peut contenir plusieurs des étapes différentes.
La manière dont vous implémentez la gestion d'annulation varie selon que vos vues provenant d'éditeur plusieurs ou pas. les procédures pour chaque implémentation sont détaillées dans les sections suivantes.
cas où un éditeur prend en charge une vue unique
Dans ce scénario, l'éditeur ne prend pas en charge plusieurs affichages. Il n'existe qu'un éditeur et un document, et ils prennent en charge l'annulation. Utilisez la procédure suivante pour implémenter la gestion d'annulation.
Pour prendre en charge la gestion d'annulation pour un éditeur d'unique-vue
Appelez QueryInterface à l'interface d' IServiceProvider sur le frame de fenêtre pour IOleUndoManager, de l'objet de vue du document pour accéder au gestionnaire de commandes undo (IID_IOLEUndoManager).
Lorsqu'une vue se trouve dans un frame de fenêtre, elle obtient un pointeur de site, qu'il peut utiliser pour appeler QueryInterface pour IServiceProvider.
Cas où un éditeur prend en charge plusieurs affichages
Si vous avez le document et séparation de vue, il y a généralement un gestionnaire d'annulation associé au document lui-même. Toutes les unités undo sont placées dans un gestionnaire d'annulation associé à l'objet de données du document.
Au lieu de la vue recherchant le gestionnaire d'annulation, dont il existe un pour chaque affichage, l'objet de données du document appelle l' CreateInstance pour instancier le gestionnaire d'annulation, en spécifiant un identificateur de classe de CLSID_OLEUndoManager. l'identificateur de classe est défini dans le fichier d'OCUNDOID.h.
En utilisant l' CreateInstance pour créer votre propre instance du gestionnaire d'annulation, utilisez la procédure suivante pour connecter votre gestionnaire d'annulation à l'environnement.
Pour connecter votre gestionnaire d'annulation dans l'environnement
appelez QueryInterface sur l'objet retourné d' ILocalRegistry2 pour IID_IOleUndoManager. enregistrez le pointeur à IOleUndoManager.
appelez QueryInterface sur IOleUndoManager pour IID_IOleCommandTarget. enregistrez le pointeur à IOleCommandTarget.
Escalader par effectuer votre QueryStatus et appels d' Exec dans l'interface stockée d' IOleCommandTarget pour les commandes StandardCommandSet97 suivantes :
cmdidUndo
cmdidMultiLevelUndo
cmdidRedo
cmdidMultiLevelRedo
cmdidMultiLevelUndoList
cmdidMultiLevelRedoList
Appelez QueryInterface à IOleUndoManager pour IID_IVsChangeTrackingUndoManager. enregistrez le pointeur à IVsChangeTrackingUndoManager.
Utilisez le pointeur à IVsChangeTrackingUndoManager pour appeler MarkCleanState, l' AdviseTrackingClient, et les méthodes d' UnadviseTrackingClient .
Appelez QueryInterface à IOleUndoManager pour IID_IVsLinkCapableUndoManager.
Appelez l' AdviseLinkedUndoClient avec votre document, qui doit également implémenter l'interface de IVsLinkedUndoClient . Lorsque la fermeture du document, appelez IVsLinkCapableUndoManager::UnadviseLinkedUndoClient.
Lorsque la fermeture du document, appelez QueryInterface sur votre gestionnaire d'annulation pour IID_IVsLifetimeControlledObject.
Appelez SeverReferencesToOwner.
Lorsque des modifications sont apportées au document, appelez Add dans le gestionnaire avec une classe d' OleUndoUnit . La méthode d' Add conserve une référence à l'objet, et en général vous version il juste après Add.
La classe d' OleUndoManager représente une instance unique de pile d'annulations. Par conséquent, il existe un objet de gestionnaire d'annulation par entité de données est suivie pour l'annulation ou la de rétablissement.
Notes
Alors que l'objet de gestionnaire d'annulation est largement utilisé par l'éditeur de texte, il s'agit d'un composant général qui n'a pas d'assistance spécifique de l'éditeur de texte.Si vous souhaitez prendre en charge l'annulation multiniveau ou la phase de rétablissement, vous pouvez utiliser cet objet pour le faire.
Voir aussi
Tâches
Comment : Désactivez la pile d'annulations