Partager via


IAgentCharacterEx ::SetHelpModeOn

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

HRESULT SetHelpModeOn(
   long bHelpModeOn  // help mode setting
);

Définit le mode d’aide contextuel activé pour le caractère.

  • Retourne S_OK pour indiquer que l’opération a réussi.

bHelpModeOn

Indicateur de mode d’aide. Si ce paramètre est True, Microsoft Agent active le mode d’aide pour le caractère.

Lorsque vous définissez cette propriété sur True, le pointeur de la souris passe à l’image d’aide contextuelle lorsqu’elle est déplacée sur le caractère ou sur le menu contextuel du caractère. Lorsque l’utilisateur clique ou fait glisser le caractère ou clique sur un élément dans le menu contextuel du caractère, le serveur déclenche l’événement IAgentNotifySinkEx ::HelpComplete et quitte le mode d’aide.

En mode Aide, le serveur n’envoie pas les événements Click, DragStart, DragCompleteet Command, sauf si la propriétéGetAutoPopupMenurenvoie True. Dans ce cas, le serveur envoie l’événement Click (ne quitte pas le mode Aide), mais uniquement pour le bouton droit de la souris afin que vous puissiez afficher le menu contextuel.

Cette propriété s’applique uniquement à l’utilisation de votre application cliente du caractère ; le paramètre n’affecte pas d’autres clients du caractère ou d’autres caractères de votre application cliente.

Voir aussi

IAgentCharacterEx ::GetHelpModeOn, IAgentNotifySinkEx ::HelpComplete