CUserToolsManager选件类

项目
03/01/2013

维护 CUserTool选件类对象的集合在应用程序中。用户工具是运行外部应用程序的菜单项。 CUserToolsManager 对象使位用户或开发人员添加新用户工具到应用程序。它支持命令的执行与用户工具，因此，它还保存有关用户工具的信息在Windows注册表。

class CUserToolsManager : public CObject

成员

公共构造函数

名称	说明
CUserToolsManager::CUserToolsManager	构造 CUserToolsManager。

公共方法

名称	说明
CUserToolsManager::CreateNewTool	创建新的用户工具。
CUserToolsManager::FindTool	返回指向与指定的命令ID.的 CMFCUserTool 对象
CUserToolsManager::GetArgumentsMenuID	返回与自定义对话框的工具选项的参数菜单的资源ID。
CUserToolsManager::GetDefExt	返回打开的文件对话框的默认扩展名(CFileDialog::CFileDialog)在自定义对话框的工具选项的命令字段。
CUserToolsManager::GetFilter	返回打开的文件对话框的文件筛选器(CFileDialog选件类)在自定义对话框的工具选项的命令字段。
CUserToolsManager::GetInitialDirMenuID	返回与自定义对话框的工具选项的初始目录菜单的资源ID。
CUserToolsManager::GetMaxTools	返回的用户工具的最大数在应用程序中分配。
CUserToolsManager::GetToolsEntryCmd	返回菜单项占位符的命令ID用户工具。
CUserToolsManager::GetUserTools	返回对用户工具列表。
CUserToolsManager::InvokeTool	执行应用程序与具有指定的命令ID的用户工具.
CUserToolsManager::IsUserToolCmd	确定命令ID是否与用户工具。
CUserToolsManager::LoadState	从Windows注册表加载有关用户工具的信息。
CUserToolsManager::MoveToolDown	将指定的用户工具下在用户工具列表。
CUserToolsManager::MoveToolUp	将指定的用户工具在用户工具列表。
CUserToolsManager::RemoveTool	从应用程序中移除指定的用户工具。
CUserToolsManager::SaveState	在Windows注册表存储有关用户工具的信息。
CUserToolsManager::SetDefExt	指定打开的文件对话框的默认扩展名(CFileDialog选件类)在自定义对话框的工具选项的命令字段。
CUserToolsManager::SetFilter	指定打开的文件对话框的文件筛选器(CFileDialog选件类)在自定义对话框的工具选项的命令字段。

备注

若要将用户工具到应用程序中，您必须:

1. 保留菜单项和一个关联的命令ID用户的工具菜单项。

2. 保留控件续命令ID用户在应用程序中定义的每个用户工具。

3. 调用 CWinAppEx::EnableUserTools 方法并提供了以下参数:菜单命令ID、首次用户工具命令ID和最后一个用户工具命令ID.

只应为每应用程序全局 CUserToolsManager 对象。

有关用户工具的示例，请参见VisualStudioDemo示例项目。

示例

下面的示例演示如何检索对 CUserToolsManager 对象以及如何创建新用户工具。此代码段是 Visual Studio演示示例的一部分。

    CUserToolsManager* pUserToolsManager = theApp.GetUserToolsManager();
    if (pUserToolsManager != NULL && pUserToolsManager->GetUserTools().IsEmpty())
    {
        // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));

        CUserTool* pTool2 = pUserToolsManager->CreateNewTool();
        pTool2->m_strLabel = _T("Paint &Brush");
        pTool2->SetCommand(_T("mspaint.exe"));

        CUserTool* pTool3 = pUserToolsManager->CreateNewTool();
        pTool3->m_strLabel = _T("&Windows Explorer");
        pTool3->SetCommand(_T("explorer.exe"));

        CUserTool* pTool4 = pUserToolsManager->CreateNewTool();
        pTool4->m_strLabel = _T("Microsoft On-&Line");
        pTool4->SetCommand(_T("https://www.microsoft.com"));
    }