CWinAppEx::EnableUserTools

允许用户创建可以减少应用程序的键击的自定义菜单命令。此方法将创建一个 CUserToolsManager 对象。

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

参数

  • [in] uiCmdToolsDummy
    框架使用的无符号整数,当用户的命令ID的占位符的"工具"菜单。

  • [in] uiCmdFirst
    第一个用户工具的命令ID。

  • [in] uiCmdLast
    最后一个用户工具的命令ID。

  • [in] pToolRTC
    CUserToolsManager 对象用于创建新用户的选件类工具。

  • [in] uArgMenuID
    参数菜单ID.

  • [in] uInitDirMenuID
    初始tools目录中的菜单ID。

返回值

TRUE,如果方法创建并初始化一 CUserToolsManager 对象; FALSE,如果方法失败,或者 CUserToolsManager 对象已存在。

备注

在启用用户定义的工具时,框架会自动支持可扩展在自定义项时的动态菜单。框架将每个新项与一个外部命令。当用户选择相应的项从 工具 菜单时,框架调用这些命令。

在用户添加新的项时,结构来创建新的对象。新对象的选件类类型由 pToolRTC定义的。必须从 CUserTool选件类派生 pToolRTC 选件类类型。

有关用户工具的更多信息以及如何将它们合并到应用程序中,请参见 用户定义的工具

要求

标头: afxwinappex.h

请参见

参考

CWinAppEx选件类

层次结构图

CUserToolsManager选件类

CUserTool选件类

概念

用户定义的工具