Klasa CUserToolsManager

Artykuł
06/10/2015

Utrzymuje zbierania Klasa CUserTool obiektów w aplikacji.Narzędzie użytkownika jest element menu, który uruchamia aplikację zewnętrzną.CUserToolsManager Umożliwia obiektu użytkownika lub autora, aby dodać nowe narzędzia użytkownika do aplikacji.Obsługuje on wykonywanie poleceń związanych z narzędzia użytkownika i również zapisuje informacje o narzędziach użytkownika w rejestrze systemu Windows.

class CUserToolsManager : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CUserToolsManager::CUserToolsManager	Konstrukcje CUserToolsManager.

Metody publiczne

Nazwa	Opis
CUserToolsManager::CreateNewTool	Tworzy nowe narzędzie użytkownika.
CUserToolsManager::FindTool	Zwraca wskaźnik do CMFCUserTool obiekt, który jest skojarzony z identyfikatorem określonego polecenia.
CUserToolsManager::GetArgumentsMenuID	Zwraca identyfikator zasobu, który jest skojarzony z argumenty menu Narzędzia karcie Dostosuj okno dialogowe.
CUserToolsManager::GetDefExt	Zwraca domyślne rozszerzenie Otwórz plik okno dialogowe (CFileDialog::CFileDialog) używane w polecenia pola na Narzędzia karcie Dostosuj okno dialogowe.
CUserToolsManager::GetFilter	Zwraca filtru plików Otwórz plik okno dialogowe (Klasa CFileDialog) używane w polecenia pola na Narzędzia karcie Dostosuj okno dialogowe.
CUserToolsManager::GetInitialDirMenuID	Zwraca identyfikator zasobu, który jest skojarzony z katalogu początkowego menu Narzędzia karcie Dostosuj okno dialogowe.
CUserToolsManager::GetMaxTools	Zwraca maksymalną liczbę narzędzi użytkownika, które mogą zostać zaalokowane w aplikacji.
CUserToolsManager::GetToolsEntryCmd	Zwraca identyfikator polecenia zastępczy element menu Narzędzia użytkownika.
CUserToolsManager::GetUserTools	Zwraca odwołanie do listy narzędzi użytkownika.
CUserToolsManager::InvokeTool	Wykonuje aplikacji skojarzonej z narzędziem użytkownika, który ma identyfikator określonego polecenia.
CUserToolsManager::IsUserToolCmd	Określa, czy identyfikator polecenia jest skojarzony z narzędzia użytkownika.
CUserToolsManager::LoadState	Ładuje informacje o narzędziach użytkownika z rejestru systemu Windows.
CUserToolsManager::MoveToolDown	Przenosi narzędzie określonego użytkownika w dół na liście narzędzi użytkownika.
CUserToolsManager::MoveToolUp	Przenosi narzędzie określonego użytkownika w górę na liście narzędzi użytkownika.
CUserToolsManager::RemoveTool	Narzędzie określony użytkownik usuwa z aplikacji.
CUserToolsManager::SaveState	Przechowuje informacje dotyczące narzędzia użytkownika w rejestrze systemu Windows.
CUserToolsManager::SetDefExt	Określa domyślne rozszerzenie, Otwórz plik okno dialogowe (Klasa CFileDialog) używane w polecenia pola na Narzędzia karcie Dostosuj okno dialogowe.
CUserToolsManager::SetFilter	Określa plik filtr, który Otwórz plik okno dialogowe (Klasa CFileDialog) używane w polecenia pola na Narzędzia karcie Dostosuj okno dialogowe.

Uwagi

Włączenie narzędzi użytkownika do aplikacji, musi:

1.Rezerwy elementu menu i skojarzone polecenie identyfikator wpisu użytkownika menu Narzędzia.

2.Zarezerwować Identyfikatora kolejne polecenia narzędzia każdego użytkownika, który użytkownika można zdefiniować w aplikacji.

3.Wywołanie CWinAppEx::EnableUserTools metody i podać następujące parametry: menu ID polecenia, pierwszy identyfikator polecenia narzędzia użytkownika i nazwy ostatniego użytkownika narzędzie polecenia.

Powinny istnieć tylko jedno globalne CUserToolsManager obiekt w aplikacji.

Na przykład narzędzia użytkownika Zobacz przykładowy projekt VisualStudioDemo.

Przykład

Poniższy przykład ilustruje sposób pobrać odniesienie do CUserToolsManager obiektu oraz tworzenia nowych narzędzi użytkownika.To urywek kodu jest częścią próbki Visual Studio Demo.

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