Partager via

Interface IOleCommandTarget (docobj.h)

  • Article

Permet aux objets et à leurs conteneurs de distribuer des commandes entre eux. Par exemple, les barres d’outils d’un objet peuvent contenir des boutons pour des commandes telles que Imprimer, Aperçu avant impression, Enregistrer, Nouveau et Zoom.

Les instructions d’activation sur place normales recommandent de supprimer ou de désactiver ces boutons, car aucun mécanisme standard efficace n’a été disponible pour les distribuer dans le conteneur. De même, un conteneur n’a jusqu’ici aucun moyen efficace d’envoyer des commandes telles que Imprimer, Mise en page et Propriétés à un objet actif sur place. Un tel routage de commande simple aurait pu être géré par le biais des normes OLE Automation existantes et de l’interface IDispatch , mais la surcharge avec IDispatch est supérieure à ce qui est nécessaire dans le cas d’objets de document. L’interface IOleCommandTarget offre un moyen plus simple d’atteindre les mêmes fins.

Les commandes disponibles sont définies par des identificateurs entiers dans un groupe. Le groupe lui-même est identifié avec un GUID. L’interface permet à un appelant d’interroger la prise en charge d’une ou plusieurs commandes au sein d’un groupe et d’émettre une commande prise en charge pour l’objet .

Héritage

L’interface IOleCommandTarget hérite de l’interface IUnknown. IOleCommandTarget a également les types de membres suivants :

Méthodes

L’interface IOleCommandTarget a ces méthodes.

 
IOleCommandTarget::Exec

Exécute la commande spécifiée ou affiche l’aide pour la commande.
IOleCommandTarget::QueryStatus

Interroge l'objet sur l'état d'une ou de plusieurs commandes générées par les événements d'interface utilisateur.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête docobj.h