Compartilhar via


CUserToolsManager::CreateNewTool

Cria uma nova ferramenta de usuário.

CUserTool* CreateNewTool();

Valor de retorno

Um ponteiro para a ferramenta de usuário recém-criado, ou NULL se o número de ferramentas do usuário excedeu o máximo.O tipo retornado é o mesmo que o tipo que é passado para CWinAppEx::EnableUserTools como o parâmetro de pToolRTC .

Comentários

Este método localiza o primeiro identificação disponível no comando de menu no intervalo que é fornecido na chamada a CWinAppEx::EnableUserTools e atribui à ferramenta esta identificação de usuário

O método falhar se o número de ferramentas alcançar o máximo.Isso ocorre quando todos os IDs comando dentro do intervalo são atribuídos às ferramentas do usuário.Você pode recuperar o número máximo de ferramentas chamando CUserToolsManager::GetMaxTools.Você pode obter acesso às ferramentas lista chamando o método de CUserToolsManager::GetUserTools .

Requisitos

Cabeçalho: afxusertoolsmanager.h

Consulte também

Referência

Classe de CUserToolsManager

Gráfico de hierarquia