Partager via


CWinAppEx::EnableUserTools

Permet à l'utilisateur de créer des commandes de menu personnalisées qui réduisent les séquences de touches dans votre application. Cette méthode crée un objet de CUserToolsManager .

BOOL EnableUserTools(
   const UINT uiCmdToolsDummy,
   const UINT uiCmdFirst,
   const UINT uiCmdLast,
   CRuntimeClass* pToolRTC = RUNTIME_CLASS(CUserTool),
   UINT uArgMenuID = 0,
   UINT uInitDirMenuID = 0 
);

Paramètres

  • [in] uiCmdToolsDummy
    Entier non signé que l'infrastructure utilise comme espace réservé pour l'ID de commande de l'utilisateur ordinateurs le menu.

  • [in] uiCmdFirst
    l'ID de commande pour la première commande d'outil d'utilisateur.

  • [in] uiCmdLast
    l'ID de commande pour la dernière commande d'outil d'utilisateur.

  • [in] pToolRTC
    Une classe que l'objet d' CUserToolsManager utilise pour créer l'utilisateur ordinateurs.

  • [in] uArgMenuID
    L'ID de menu d'argument

  • [in] uInitDirMenuID
    L'ID de menu pour le répertoire initial d'outils.

Valeur de retour

TRUE si la méthode crée et initialise un objet d' CUserToolsManager ; FALSE si la méthode échoue ou si un objet d' CUserToolsManager existe déjà.

Notes

Lorsque vous activez les outils définis par l'utilisateur, l'infrastructure prend en charge automatiquement un menu dynamique qui peut être étendu lors de la personnalisation. l'infrastructure associe chaque nouvel élément avec une commande externe. L'infrastructure appelle ces commandes lorsque l'utilisateur sélectionne l'élément approprié dans le menu Outils .

Chaque fois que l'utilisateur ajoute un nouvel élément, l'infrastructure crée un nouvel objet. Le type de classe pour le nouvel objet est défini par pToolRTC. Le type de classe d' pToolRTC doit être dérivé de CUserTool, classe.

Pour plus d'informations sur les outils utilisateur et comment les incorporer dans votre application, consultez l' outils définis par l'utilisateur.

Configuration requise

en-tête : afxwinappex.h

Voir aussi

Référence

CWinAppEx, classe

Graphique de la hiérarchie

CUserToolsManager, classe

CUserTool, classe

Concepts

outils définis par l'utilisateur