IExtendContextMenu ::Command, méthode (mmc.h)

Article
02/29/2024

La méthode IExtendContextMenu ::Command est appelée si l’un des éléments que vous avez ajoutés au menu contextuel avec IExtendContextMenu ::AddMenuItems est sélectionné par la suite. MMC appelle Command avec l’ID de commande que vous avez spécifié et un autre pointeur vers la même interface IDataObject .

Syntaxe

HRESULT Command(
  [in] long         lCommandID,
  [in] LPDATAOBJECT piDataObject
);

Paramètres

[in] lCommandID

Valeur qui spécifie l’identificateur de commande de l’élément de menu.

[in] piDataObject

Pointeur vers l’interface IDataObject sur l’objet dont le menu contextuel était affiché.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

MMC réserve des ID de commande à valeur négative pour les ID de commande de menu prédéfinis qu’elle envoie à la méthode IExtendContextMenu ::Command d’un composant logiciel enfichable. L’ID de commande –1 est la valeur d’énumérateur MMCC_STANDARD_VIEW_SELECT définie dans mmc.h. Ce message est envoyé à IExtendContextMenu ::Command lorsque l’utilisateur clique sur une commande d’affichage standard dans le menu Affichage (Grand, Petit, Liste ou Détail). Cela avertit le composant logiciel enfichable que l’utilisateur quitte une vue personnalisée (OCX, HTML). Après avoir obtenu une commande MMCC_STANDARD_VIEW_SELECT, le composant logiciel enfichable doit demander une vue standard la prochaine fois que sa méthode IComponent ::GetResultViewType est appelée et ne pas demander une vue personnalisée tant que l’un de ses éléments de menu d’affichage personnalisé n’est pas sélectionné. Si le composant logiciel enfichable utilise uniquement des vues standard ou des vues personnalisées, il peut ignorer la commande MMCC_STANDARD_VIEW_SELECT.

MMC envoie le composant logiciel enfichable MMCC_STANDARD_VIEW_SELECT commande lorsque l’utilisateur clique sur le bouton Précédent dans la barre d’outils. MMC utilise cette commande pour indiquer au composant logiciel enfichable d’afficher la vue précédente du volet de résultats.