Classe CUserToolsManager

Artigo
06/10/2015

Mantém a coleção de objetos de Classe CUserTool em um aplicativo. Uma ferramenta de usuário é um item de menu que executa um aplicativo externo. O objeto de CUserToolsManager permite que o usuário ou o desenvolvedor para adicionar novas ferramentas de usuário para o aplicativo. Oferece suporte à execução de comandos associados com ferramentas de usuário, e também salva informações sobre ferramentas do usuário no Registro do Windows.

class CUserToolsManager : public CObject

Membros

Construtores public

Nome	Descrição
CUserToolsManager::CUserToolsManager	Constrói CUserToolsManager.

Métodos públicos

Nome	Descrição
CUserToolsManager::CreateNewTool	Cria uma nova ferramenta de usuário.
CUserToolsManager::FindTool	Retorna o ponteiro ao objeto de CMFCUserTool que está associado com um certo ID de comando
CUserToolsManager::GetArgumentsMenuID	Retorna a identificação de recurso que está associado com o menu de Argumentos na guia de Ferramentas da caixa de diálogo de Personalizar .
CUserToolsManager::GetDefExt	Retorna a extensão padrão que a caixa de diálogo de Abrir arquivo (CFileDialog::CFileDialog) usa no campo de Comando na guia de Ferramentas da caixa de diálogo de Personalizar.
CUserToolsManager::GetFilter	Retorna o filtro de arquivo que a caixa de diálogo de Abrir arquivo (Classe CFileDialog) usa no campo de Comando na guia de Ferramentas da caixa de diálogo de Personalizar.
CUserToolsManager::GetInitialDirMenuID	Retorna a identificação de recurso que está associado com o menu de Diretório inicial na guia de Ferramentas da caixa de diálogo de Personalizar .
CUserToolsManager::GetMaxTools	Retorna o número máximo de ferramentas do usuário que podem ser atribuídas no aplicativo.
CUserToolsManager::GetToolsEntryCmd	Retorna a identificação de comando do espaço reservado de item de menu para ferramentas do usuário.
CUserToolsManager::GetUserTools	Retorna uma referência à lista de ferramentas do usuário.
CUserToolsManager::InvokeTool	Executa um aplicativo associado com a ferramenta de usuário que tem um certo ID de comando
CUserToolsManager::IsUserToolCmd	Determina se uma identificação de comando está associado com uma ferramenta de usuário.
CUserToolsManager::LoadState	Carrega informações sobre ferramentas do usuário de Registro do Windows.
CUserToolsManager::MoveToolDown	Move a ferramenta de usuário especificada para baixo na lista de ferramentas do usuário.
CUserToolsManager::MoveToolUp	Move a ferramenta especificada do usuário acima na lista de ferramentas do usuário.
CUserToolsManager::RemoveTool	Remove a ferramenta especificada do usuário do aplicativo.
CUserToolsManager::SaveState	Armazena informações sobre ferramentas do usuário no Registro do Windows.
CUserToolsManager::SetDefExt	Especifica a extensão padrão que a caixa de diálogo de Abrir arquivo (Classe CFileDialog) usa no campo de Comando na guia de Ferramentas da caixa de diálogo de Personalizar .
CUserToolsManager::SetFilter	Especifica o filtro de arquivo que a caixa de diálogo de Abrir arquivo (Classe CFileDialog) usa no campo de Comando na guia de Ferramentas da caixa de diálogo de Personalizar.

Comentários

Para inserir ferramentas do usuário em seu aplicativo, você deve:

1. Permitir a um item de menu e uma identificação associado de comando para uma entrada de menu a ferramenta do usuário.

2. Reservar uma identificação seqüencial de comando para cada ferramenta de usuário que um usuário pode definir em seu aplicativo.

3. Chame o método de CWinAppEx::EnableUserTools e forneça os seguintes parâmetros: identificação de comando de menu, primeiro identificação do ferramenta de linha de comando do usuário, e a identificação a mais recente da ferramenta de linha de comando do usuário

Deve haver apenas um objeto global de CUserToolsManager pelo aplicativo.

Para um exemplo de ferramentas do usuário, consulte o exemplo de VisualStudioDemo projeto.

Exemplo

O exemplo a seguir demonstra como recuperar uma referência a um objeto de CUserToolsManager e como criar novas ferramentas do usuário. Este trecho de código é parte de Exemplo de demonstração do 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"));
    }