CUserToolsManager 類別

發行項
03/15/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"));
    }