Interface IOleCommandTarget (docobj.h)

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