CUserTool, classe

Article
06/10/2015

Un outil d'utilisateur est un élément de menu qui exécute une application externe. L'onglet Outils de la boîte de dialogue Personnaliser (CMFCToolBarsCustomizeDialog, classe) permet à l'utilisateur d'ajouter des outils utilisateur, et de spécifier le nom, la commande, les arguments, et le dossier d'origine pour chaque outil d'utilisateur.

class CUserTool : public CObject

Membres

Méthodes publiques

Nom	Description
CUserTool::CopyIconToClipboard
CUserTool::DrawToolIcon	Dessine l'icône d'outil d'utilisateur dans un rectangle spécifié.
CUserTool::GetCommand	Retourne une chaîne qui contient le texte de la commande associée à l'outil d'utilisateur.
CUserTool::GetCommandId	Retourne l'ID de commande de l'élément de menu de l'outil d'utilisateur.
CUserTool::Invoke	Exécute la commande associée à l'outil d'utilisateur.
CUserTool::Serialize	Lit ou écrit cet objet ou y retourne une archive. (Substitutions CObject::Serialize.)
CUserTool::SetCommand	Définit la commande associée à l'outil d'utilisateur.
CUserTool::SetToolIcon	Charge l'icône de l'outil d'utilisateur de l'application associée à l'outil.

Méthodes protégées

Nom	Description
CUserTool::LoadDefaultIcon	Charge l'icône par défaut par un outil d'utilisateur.

Membres de données

Nom	Description
CUserTool::m_strArguments	Les arguments de ligne de commande pour l'outil d'utilisateur.
CUserTool::m_strInitialDirectory	Le répertoire initial de l'outil d'utilisateur.
CUserTool::m_strLabel	Le nom d'outil qui s'affiche dans l'élément de menu pour l'outil.

Notes

Pour plus d'informations sur l'activation des outils utilisateur dans votre application, consultez CUserToolsManager, classe.

Exemple

L'exemple suivant montre comment créer un outil d'un objet d' CUserToolsManager , définir la variable membre d' m_strLabel , et définir l'application que l'outil d'utilisateur exécute. Cet extrait de code fait partie d' Exemple de démonstration de Visual Studio.

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