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 de usuário excedeu o máximo. O tipo retornado é o mesmo que o tipo que é passado para CWinAppEx::EnableUserTools sistema autônomo o pToolRTC parâmetro.

Comentários

Este método localiza a primeira ID de comando de menu disponível no intervalo que é fornecido na telefonar para CWinAppEx::EnableUserTools e o atribui a ferramenta do usuário essa ID.

O método falhará se a quantidade de ferramentas atingiu o máximo.Isso ocorre quando todas as identificações de comando dentro do intervalo são atribuídas às ferramentas de usuário.Você pode recuperar o número máximo de ferramentas chamando CUserToolsManager::GetMaxTools. Você pode obter acesso à lista de ferramentas chamando o CUserToolsManager::GetUserTools método.

Requisitos

Cabeçalho: afxusertoolsmanager.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CUserToolsManager