CUserToolsManager, classe

Article
06/10/2015

Met à jour la collection d'objets de CUserTool, classe dans une application. Un outil d'utilisateur est un élément de menu qui exécute une application externe. L'objet d' CUserToolsManager permet à l'utilisateur ou au développeur d'ajouter de nouveaux outils utilisateur à l'application. Il prend en charge l'exécution des commandes associées aux outils utilisateur, et il enregistre également des informations sur les outils utilisateur dans le Registre Windows.

class CUserToolsManager : public CObject

Membres

Constructeurs publics

Nom	Description
CUserToolsManager::CUserToolsManager	Construit un CUserToolsManager.

Méthodes publiques

Nom	Description
CUserToolsManager::CreateNewTool	Crée un nouvel outil d'utilisateur.
CUserToolsManager::FindTool	Retourne le pointeur vers l'objet d' CMFCUserTool associé à un ID de commande spécifiée
CUserToolsManager::GetArgumentsMenuID	Retourne l'ID de ressource associé au menu Arguments sous l'onglet Outils de la boîte de dialogue Personnaliser .
CUserToolsManager::GetDefExt	Retourne l'extension par défaut que la boîte de dialogue Ouvrir (CFileDialog::CFileDialog) utilise dans le domaine Commande sous l'onglet Outils de la boîte de dialogue Personnaliser .
CUserToolsManager::GetFilter	Retourne le filtre de fichiers que la boîte de dialogue Ouvrir (CFileDialog, classe) utilise dans le domaine Commande sous l'onglet Outils de la boîte de dialogue Personnaliser .
CUserToolsManager::GetInitialDirMenuID	Retourne l'ID de ressource associé au menu Répertoire initial sous l'onglet Outils de la boîte de dialogue Personnaliser .
CUserToolsManager::GetMaxTools	Retourne le nombre maximal d'outils utilisateur qui peuvent être alloués dans l'application.
CUserToolsManager::GetToolsEntryCmd	Retourne l'ID de commande de l'espace réservé d'élément de menu pour les outils utilisateur.
CUserToolsManager::GetUserTools	Retourne une référence à la liste d'outils utilisateur.
CUserToolsManager::InvokeTool	Exécute une application associée à l'outil d'utilisateur qui a un ID de commande spécifiée
CUserToolsManager::IsUserToolCmd	Détermine si un ID de commande est associé à un outil d'utilisateur.
CUserToolsManager::LoadState	Charge des informations sur les outils utilisateur du Registre Windows.
CUserToolsManager::MoveToolDown	Déplace l'outil spécifié d'utilisateur vers le bas dans la liste d'outils utilisateur.
CUserToolsManager::MoveToolUp	Déplace l'outil spécifié d'utilisateur dans la liste d'outils utilisateur.
CUserToolsManager::RemoveTool	Supprime l'outil spécifié d'utilisateur de l'application.
CUserToolsManager::SaveState	Stocke des informations sur les outils utilisateur dans le Registre Windows.
CUserToolsManager::SetDefExt	Spécifie l'extension par défaut que la boîte de dialogue Ouvrir (CFileDialog, classe) utilise dans le domaine Commande sous l'onglet Outils de la boîte de dialogue Personnaliser .
CUserToolsManager::SetFilter	Spécifie le filtre de fichiers que la boîte de dialogue Ouvrir (CFileDialog, classe) utilise dans le domaine Commande sous l'onglet Outils de la boîte de dialogue Personnaliser .

Notes

Pour incorporer des outils utilisateur à votre application, vous devez :

1. Réservez un élément de menu et un ID de commande associé à une entrée de menu d'outil d'utilisateur.

2. Réservez un ID de commande séquentiel pour chaque outil d'utilisateur qu'un utilisateur peut définir dans votre application.

3. Appelez la méthode de CWinAppEx::EnableUserTools et fournissez les paramètres suivants : ID de commande de menu, le premier ID de commande d'outil d'utilisateur, et dernière ID de commande d'outil d'utilisateur

Il doit y avoir qu'un objet global d' CUserToolsManager par application.

Pour obtenir un exemple des outils utilisateur, consultez l'exemple de projet VisualStudioDemo.

Exemple

L'exemple suivant montre comment récupérer une référence à un objet d' CUserToolsManager et comment créer de nouveaux outils utilisateur. Cet extrait de code fait partie d' Exemple de démonstration de Visual Studio.

   CUserToolsManager* pUserToolsManager = theApp.GetUserToolsManager();
    if (pUserToolsManager != NULL && pUserToolsManager->GetUserTools().IsEmpty())
    {
        // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));

        CUserTool* pTool2 = pUserToolsManager->CreateNewTool();
        pTool2->m_strLabel = _T("Paint &Brush");
        pTool2->SetCommand(_T("mspaint.exe"));

        CUserTool* pTool3 = pUserToolsManager->CreateNewTool();
        pTool3->m_strLabel = _T("&Windows Explorer");
        pTool3->SetCommand(_T("explorer.exe"));

        CUserTool* pTool4 = pUserToolsManager->CreateNewTool();
        pTool4->m_strLabel = _T("Microsoft On-&Line");
        pTool4->SetCommand(_T("https://www.microsoft.com"));
    }