Classe CUserToolsManager

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

class CUserToolsManager : public CObject

Membros

Construtores públicos

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

Métodos públicos

Nome	Descrição
CUserToolsManager::CreateNewTool	Cria uma nova ferramenta de usuário.
CUserToolsManager::FindTool	Retorna o ponteiro para o CMFCUserTool objeto que está associado a uma ID de comando especificado.
CUserToolsManager::GetArgumentsMenuID	Retorna a ID de recurso que está associada com o Argumentos menu o Ferramentas Guia de do Personalizar caixa de diálogo.
CUserToolsManager::GetDefExt	Retorna a extensão padrão que o em em aberto arquivo caixa de diálogo CFileDialog::CFileDialog) usa o Comando campo o Ferramentas Guia de do Personalizar caixa de diálogo.
CUserToolsManager::GetFilter	Retorna o filtro de arquivo que o em em aberto arquivo caixa de diálogo Classe CFileDialog) usa o Comando campo o Ferramentas Guia de do Personalizar caixa de diálogo.
CUserToolsManager::GetInitialDirMenuID	Retorna a ID de recurso que está associada com o Diretório inicial menu o Ferramentas Guia de do Personalizar caixa de diálogo.
CUserToolsManager::GetMaxTools	Retorna o número máximo de ferramentas do usuário que pode ser alocado no aplicativo.
CUserToolsManager::GetToolsEntryCmd	Retorna a ID 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 possui uma ID do comando especificado.
CUserToolsManager::IsUserToolCmd	Determina se uma ID de comando está associado com uma ferramenta de usuário.
CUserToolsManager::LoadState	Carrega informações sobre as ferramentas de usuário do registro do Windows.
CUserToolsManager::MoveToolDown	Move a ferramenta de usuário especificado para baixo na lista de ferramentas do usuário.
CUserToolsManager::MoveToolUp	Move a ferramenta de usuário especificado para cima na lista de ferramentas do usuário.
CUserToolsManager::RemoveTool	Remove a ferramenta de usuário especificado do aplicativo.
CUserToolsManager::SaveState	Armazena informações sobre ferramentas de usuário no registro do Windows.
CUserToolsManager::SetDefExt	Especifica a extensão padrão que o em em aberto arquivo caixa de diálogo Classe CFileDialog) usa o Comando campo o Ferramentas Guia de do Personalizar caixa de diálogo.
CUserToolsManager::SetFilter	Especifica o arquivo de filtro que o em em aberto arquivo caixa de diálogo Classe CFileDialog) usa o Comando campo o Ferramentas Guia de do Personalizar caixa de diálogo.

Comentários

Para incorporar as ferramentas de usuário em seu aplicativo, você deve:

1.Reserve um item de menu e uma ID de comando associado para uma entrada de menu de ferramenta do usuário.

2.Reserve um ID de comando seqüencial para cada ferramenta do usuário que um usuário pode definir em seu aplicativo.

3.telefonar the CWinAppEx::EnableUserTools método e forneça os seguintes parâmetros: ID de comando de menu, identificação de comando de ferramenta usuário primeira e último comando de ferramenta do usuário identificação.

Deve haver apenas um global CUserToolsManager objeto por aplicativo.

Para obter um exemplo das ferramentas de usuário, consulte o projeto de amostra VisualStudioDemo.

Exemplo

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

Hierarquia de herança

CObject

   CUserToolsManager

Requisitos

Cabeçalho: afxusertoolsmanager.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CWinAppEx

Classe CUserTool

Outros recursos

Classes (@@)