Prise en charge du menu contextuel
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]
Microsoft Agent inclut un menu contextuel (également appelé menu contextuel) pour chaque caractère. Le serveur affiche automatiquement ce menu contextuel lorsqu’un utilisateur clique avec le bouton droit sur le caractère. Vous pouvez ajouter des commandes pour votre application cliente au menu en définissant une collection Commands . Pour chaque commande de la collection que vous définissez, vous pouvez spécifier les propriétés Caption et Visible . La légende est le texte qui s’affiche dans le menu lorsque la propriété Visible a la valeur True. Vous pouvez également utiliser la propriété Enabled pour afficher la commande dans le menu comme désactivée et le HelpContextID pour prendre en charge la prise en charge de l’aide pour la propriété. Définissez la clé d’accès pour le texte du menu en incluant un ampersand (&) avant le caractère de texte du paramètre de texte Légende .
Le serveur ajoute automatiquement aux commandes de menu pour ouvrir la fenêtre Commandes vocales et masquer le caractère ainsi que les sous-titres commandes d’autres clients du caractère pour permettre aux utilisateurs de basculer entre les clients. Le serveur ajoute automatiquement un séparateur au menu entre ses entrées de menu et celles définies par le client. Les séparateurs s’affichent uniquement lorsqu’il y a des éléments dans le menu à séparer.
Pour supprimer des commandes d’un menu, utilisez la méthode Remove . Notez que les entrées de menu ne changent pas lorsque le menu s’affiche. Si vous ajoutez ou supprimez des commandes ou modifiez leurs propriétés, le menu affiche les modifications lorsque l’utilisateur réaffiche le menu.
Si vous préférez fournir vos propres services de menu contextuel pour un caractère, vous pouvez utiliser la propriété AutoPopupMenu pour désactiver la gestion du serveur de l’action de clic droit. Vous pouvez ensuite utiliser la notification d’événement Click pour créer votre propre comportement de gestion de menu.
Lorsque l’utilisateur sélectionne une commande dans le menu contextuel d’un caractère ou dans la fenêtre Commandes vocales, le serveur déclenche l’événement Command du client associé et transmet les paramètres de l’entrée à l’aide de l’objet UserInput .
Le serveur fournit également un menu contextuel pour l’icône de barre des tâches du caractère. Lorsque le caractère est visible, cliquer avec le bouton droit sur ce menu affiche les mêmes commandes que celles affichées en cliquant avec le bouton droit sur le caractère. Toutefois, lorsque le caractère est masqué, seules les commandes fournies par le serveur sont incluses.