Share via


CUserTool Class

A user tool is a menu item that runs an external application. The Tools tab of the Customize dialog box (CMFCToolBarsCustomizeDialog Class) enables the user to add user tools, and to specify the name, command, arguments, and initial directory for each user tool.

class CUserTool : public CObject

Members

Public Methods

Name

Description

CUserTool::CopyIconToClipboard

 

CUserTool::DrawToolIcon

Draws the user tool icon in a specified rectangle.

CUserTool::GetCommand

Returns a string that contains the text of the command associated with the user tool.

CUserTool::GetCommandId

Returns the command ID of the menu item of the user tool.

CUserTool::Invoke

Executes the command associated with the user tool.

CUserTool::Serialize

Reads or writes this object from or to an archive. (Overrides CObject::Serialize.)

CUserTool::SetCommand

Sets the command associated with the user tool.

CUserTool::SetToolIcon

Loads the icon for the user tool from the application associated with the tool.

Protected Methods

Name

Description

CUserTool::LoadDefaultIcon

Loads the default icon for a user tool.

Data Members

Name

Description

CUserTool::m_strArguments

The command-line arguments for the user tool.

CUserTool::m_strInitialDirectory

The initial directory for the user tool.

CUserTool::m_strLabel

The tool name that is displayed in the menu item for the tool.

Remarks

For more information about how to enable user tools in your application, see CUserToolsManager Class.

Example

The following example demonstrates how to create a tool from a CUserToolsManager object, set the m_strLabel member variable, and set the application that the user tool runs. This code snippet is part of the VisualStudioDemo Sample: MFC Visual Studio Application.

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

Inheritance Hierarchy

CObject

   CUserTool

Requirements

Header: afxusertool.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CWinAppEx Class

CUserToolsManager Class

Other Resources

Classes (MFC Feature Pack)