Класс CUserToolsManager

Статья
06/10/2015

Поддерживает коллекцию объектов Класс CUserTool в приложении. Средство пользователя пункт меню, выполняемый внешнее приложение. Объект CUserToolsManager позволяет пользователю или разработчик для добавления новых средств пользователя к приложению. Он поддерживает выполнение команд, связанных со средствами пользователя, а также сохраняет сведения о средствах пользователя в реестре Windows.

class CUserToolsManager : public CObject

Члены

Открытые конструкторы

Имя	Описание
CUserToolsManager::CUserToolsManager	Конструирует CUserToolsManager.

Открытые методы

Имя	Описание
CUserToolsManager::CreateNewTool	Создает новое средство пользователя.
CUserToolsManager::FindTool	Возвращает указатель на объект CMFCUserTool, который связан с указанным идентификатором команды
CUserToolsManager::GetArgumentsMenuID	Возвращает идентификатор ресурса, сопоставлено с меню Аргументы на вкладке Сервис диалогового окна Настроить.
CUserToolsManager::GetDefExt	Получает расширение по умолчанию, диалоговое окно Открытие файла (CFileDialog::CFileDialog) в поле Команда на вкладке Сервис диалогового окна Настроить.
CUserToolsManager::GetFilter	Возвращает фильтр файлов, диалоговое окно Открытие файла (Класс CFileDialog) в поле Команда на вкладке Сервис диалогового окна Настроить.
CUserToolsManager::GetInitialDirMenuID	Возвращает идентификатор ресурса, сопоставлено с меню Исходный каталог на вкладке Сервис диалогового окна Настроить.
CUserToolsManager::GetMaxTools	Возвращает максимальное число средств пользователя, которые могут быть выбраны в приложении.
CUserToolsManager::GetToolsEntryCmd	Возвращает идентификатор команды заполнителя пункта меню для средств пользователя.
CUserToolsManager::GetUserTools	Возвращает ссылку на список средств пользователя.
CUserToolsManager::InvokeTool	Выполняет приложение, связанное со средством пользователя, имеющего указанный идентификатор команды.
CUserToolsManager::IsUserToolCmd	Определяет, является ли сопоставлено идентификатор команды с помощью инструмента пользователя.
CUserToolsManager::LoadState	Загружает сведения о средствах пользователя из реестра Windows.
CUserToolsManager::MoveToolDown	Перемещает средство указанного пользователя вниз по списку средств пользователя.
CUserToolsManager::MoveToolUp	Перемещает средство указанного пользователя вверх по списку средств пользователя.
CUserToolsManager::RemoveTool	Удаляет инструмент указанного пользователя из приложения.
CUserToolsManager::SaveState	Хранит сведения о средствах пользователя в реестре Windows.
CUserToolsManager::SetDefExt	Определяет расширение по умолчанию, диалоговое окно Открытие файла (Класс CFileDialog) в поле Команда на вкладке Сервис диалогового окна Настроить.
CUserToolsManager::SetFilter	Задает фильтр файлов, диалоговое окно Открытие файла (Класс CFileDialog) в поле Команда на вкладке Сервис диалогового окна Настроить.

Заметки

Включить средства пользователя в приложение.

1. Зарезервируйте пункт меню и связанное идентификатор команды меню средства для записи пользователя.

2. Зарезервируйте последовательное идентификатор команды для каждого средства пользователя, пользователь может определить в приложении.

3. Вызовите метод CWinAppEx::EnableUserTools и укажите следующие параметры: идентификатор команды меню, идентификатор команды средства первого пользователя и последнее идентификатор команды средства пользователя

Составление существует только один объект CUserToolsManager глобального в приложение.

Пример средств пользователя см. образец VisualStudioDemo проектов.

Пример

В следующем примере показано, как получить ссылку на объект CUserToolsManager и создании новых средств пользователя. Этот фрагмент кода является частью Пример demo 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"));
    }