Clase de CUserTool

Artículo
04/10/2013

Una herramienta de usuario es un elemento de menú que ejecuta una aplicación externa.La ficha de Herramientas del cuadro de diálogo de Personalizar (Clase de CMFCToolBarsCustomizeDialog) permita agregar las herramientas de usuario, y especificar el nombre, el comando, los argumentos, y el directorio inicial para cada herramienta de usuario.

class CUserTool : public CObject

Miembros

Métodos públicos

Name	Descripción
CUserTool::CopyIconToClipboard
CUserTool::DrawToolIcon	Dibuja el icono del usuario en un rectángulo especificado.
CUserTool::GetCommand	Devuelve una cadena que contiene el texto del comando asociado al usuario.
CUserTool::GetCommandId	Devuelve el identificador del elemento de menú del usuario.
CUserTool::Invoke	Ejecuta el comando asociado al usuario.
CUserTool::Serialize	Lee o escribe este objeto o un archivo.(Reemplaza CObject::Serialize.)
CUserTool::SetCommand	Establece el comando asociado al usuario.
CUserTool::SetToolIcon	Carga el icono para el usuario de la aplicación asociada con la herramienta.

Métodos protegidos

Name	Descripción
CUserTool::LoadDefaultIcon	Carga el icono predeterminado para una herramienta de usuario.

miembros de datos

Name	Descripción
CUserTool::m_strArguments	Los argumentos de la línea de comandos para la herramienta de usuario.
CUserTool::m_strInitialDirectory	El directorio inicial para el usuario.
CUserTool::m_strLabel	El nombre de la herramienta que se muestra en el elemento de menú para la herramienta.

Comentarios

Para obtener más información sobre cómo habilitar las herramientas de usuario en la aplicación, vea Clase de CUserToolsManager.

Ejemplo

El ejemplo siguiente se muestra cómo crear una herramienta de un objeto de CUserToolsManager , establece la variable miembro de m_strLabel , y establece la aplicación que el usuario ejecuta.Este fragmento de código es parte de Ejemplo de demostración de Visual Studio.

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