Classe CUserTool

Artigo
06/10/2015

Uma ferramenta de usuário é um item de menu que executa um aplicativo externo. Ferramentas De a guia da caixa de diálogo de Personalizar (Classe CMFCToolBarsCustomizeDialog) permite que o usuário para adicionar ferramentas de usuário, e para especificar o nome, o comando, os argumentos, e o diretório de inicial para cada ferramenta de usuário.

class CUserTool : public CObject

Membros

Métodos públicos

Nome	Descrição
CUserTool::CopyIconToClipboard
CUserTool::DrawToolIcon	Desenha o ícone de ferramentas do usuário em um retângulo especificado.
CUserTool::GetCommand	Retorna uma cadeia de caracteres que contém o texto de comando associado com a ferramenta de usuário.
CUserTool::GetCommandId	Retorna a identificação de comando do item de menu ferramenta de usuário.
CUserTool::Invoke	Executa o comando associado com a ferramenta de usuário.
CUserTool::Serialize	Leitura ou grava este objeto ou um arquivo neutro. Overrides ( CObject::Serialize.)
CUserTool::SetCommand	Define o comando associado com a ferramenta de usuário.
CUserTool::SetToolIcon	Carrega o ícone para a ferramenta de usuário do aplicativo associado com a ferramenta.

Métodos protegidos

Nome	Descrição
CUserTool::LoadDefaultIcon	Carrega o ícone padrão para uma ferramenta de usuário.

Membros de dados

Nome	Descrição
CUserTool::m_strArguments	Os argumentos de linha de comando para a ferramenta de usuário.
CUserTool::m_strInitialDirectory	O diretório inicial para a ferramenta de usuário.
CUserTool::m_strLabel	O nome de ferramenta que é exibido no item de menu para a ferramenta.

Comentários

Para obter mais informações sobre como habilitar ferramentas do usuário em seu aplicativo, consulte Classe CUserToolsManager.

Exemplo

O exemplo a seguir demonstra como criar uma ferramenta de um objeto de CUserToolsManager , defina a variável de membro de m_strLabel , e defina o aplicativo que executa a ferramenta de usuário. Este trecho de código é parte de Exemplo de demonstração do Visual Studio.

      // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));