Classe CUserTool

Artigo
08/25/2010

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

class CUserTool : public CObject

Membros

Métodos públicos

Nome	Descrição
CUserTool::CopyIconToClipboard
CUserTool::DrawToolIcon	Desenha o ícone de ferramenta do usuário em um retângulo especificado.
CUserTool::GetCommand	Retorna uma seqüência de caracteres que contém o texto do comando associado com a ferramenta do usuário.
CUserTool::GetCommandId	Retorna a ID de comando do item de menu da ferramenta de usuário.
CUserTool::Invoke	Executa o comando associado com a ferramenta do usuário.
CUserTool::Serialize	Lê ou grava este objeto de ou para um arquivar.(Substitui CObject::Serialize.)
CUserTool::SetCommand	Define o comando associado com a ferramenta do usuário.
CUserTool::SetToolIcon	Carrega o ícone para a ferramenta do usuário do aplicativo associado à 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 do usuário.
CUserTool::m_strInitialDirectory	O diretório inicial para a ferramenta de usuário.
CUserTool::m_strLabel	O nome da ferramenta que é exibido no item de menu para a ferramenta.

Comentários

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

Exemplo

O exemplo a seguir demonstra como criar uma ferramenta a partir de um CUserToolsManager objeto, defina o m_strLabel variável de membro e defina o aplicativo que a ferramenta de usuário é executada. Neste trecho de código faz parte o Exemplo do VisualStudioDemo: Aplicativo do MFC Visual Studio.

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

Hierarquia de herança

CObject

CUserTool

Requisitos

Cabeçalho: afxusertool.h

Consulte também

Compartilhar via