Třída CUserToolsManager

Článek
06/10/2015

Udržuje kolekci Třída CUserTool objektů v aplikaci.Nástroj uživatele je položky nabídky, která spustí externí aplikaci. CUserToolsManager Objekt umožňuje uživateli nebo vývojář aplikace přidat nové uživatele nástroje.Podporuje provádění příkazů přidružené uživatelské nástroje a také ukládá informace o nástrojích pro uživatele v registru systému Windows.

class CUserToolsManager : public CObject

Členy

Veřejné konstruktory

Název	Description
CUserToolsManager::CUserToolsManager	Konstrukce CUserToolsManager .

Veřejné metody

Název	Description
CUserToolsManager::CreateNewTool	Vytvoří nový nástroj pro uživatele.
CUserToolsManager::FindTool	Vrací ukazatel CMFCUserTool objekt, který je spojen s ID zadaný příkaz.
CUserToolsManager::GetArgumentsMenuID	Vrátí ID zdroje, který je spojen s argumenty nabídky na Nástroje kartě vlastní dialogové okno.
CUserToolsManager::GetDefExt	Vrátí výchozí příponu, která Otevřít soubor dialogové okno (CFileDialog::CFileDialog) používá v příkaz pole na Nástroje kartě vlastní dialogové okno.
CUserToolsManager::GetFilter	Vrátí filtru souborů, který Otevřít soubor dialogové okno (Třída CFileDialog) používá příkaz pole na Nástroje na kartě vlastní dialogové okno.
CUserToolsManager::GetInitialDirMenuID	Vrátí ID zdroje, který je spojen s Počáteční adresář nabídky na Nástroje kartě vlastní dialogové okno.
CUserToolsManager::GetMaxTools	Vrátí maximální počet uživatelů nástroje, které mohou být přiděleny v aplikaci.
CUserToolsManager::GetToolsEntryCmd	Vrátí ID příkazu zástupného položku nabídky pro uživatele nástroje.
CUserToolsManager::GetUserTools	Vrátí odkaz na seznam uživatelů nástroje.
CUserToolsManager::InvokeTool	Spustí aplikace přiřazené uživateli nástroj, který má zadaný příkaz ID.
CUserToolsManager::IsUserToolCmd	Určuje, zda je nástroj uživatele přidružen ID příkazu.
CUserToolsManager::LoadState	Načte informace o nástrojích pro uživatele z registru systému Windows.
CUserToolsManager::MoveToolDown	Přesune zadaný uživatel nástroj dolů v seznamu uživatelů nástroje.
CUserToolsManager::MoveToolUp	Přesune zadaný uživatel nástroj v seznamu uživatelů nástroje.
CUserToolsManager::RemoveTool	Zadaný uživatel nástroj odebere z aplikace.
CUserToolsManager::SaveState	Ukládá informace o nástrojích pro uživatele v registru systému Windows.
CUserToolsManager::SetDefExt	Určuje výchozí přípona, Otevřít soubor dialogové okno (Třída CFileDialog) používá příkaz pole na Nástroje kartě vlastní dialogové okno.
CUserToolsManager::SetFilter	Určuje soubor filtru, který Otevřít soubor dialogové okno (Třída CFileDialog) používá příkaz pole na Nástroje kartě vlastní dialogové okno.

Poznámky

Uživatel nástroje začlenit do aplikace, musí:

1.Rezervujte položky nabídky a přidružený příkaz ID uživatele položku nabídky Nástroje.

2.Rezervujte ID sekvenční příkazu pro každého uživatele nástroj, který uživatel můžete definovat v aplikaci.

3.Volání CWinAppEx::EnableUserTools metoda a zadat následující parametry: nabídka ID příkazu, první uživatel nástroje příkaz ID a poslední ID uživatele nástroje příkazu.

Měla by existovat pouze jeden globální CUserToolsManager objektu na jednu žádost.

Například uživatel nástroje viz ukázkový projekt VisualStudioDemo.

Příklad

Následující příklad demonstruje načtení odkaz na CUserToolsManager objektu a jak vytvořit nové nástroje pro uživatele.Tento fragment kódu je součástí Visual Studio Demo vzorku.

  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"));
    }