Partager via


CUserToolsManager::CreateNewTool

Crée un nouvel outil d'utilisateur.

CUserTool* CreateNewTool();

Valeur de retour

Pointeur vers l'outil de création récente d'utilisateur, ou NULL si le nombre d'outils utilisateur a dépassé le maximum. Le type retourné est identique au type qui est passé à CWinAppEx::EnableUserTools comme paramètre d' pToolRTC .

Notes

Cette méthode recherche le premier ID disponible de commande de menu dans la plage fourni dans l'appel à CWinAppEx::EnableUserTools et assigne à l'outil d'utilisateur cet ID.

La méthode échoue si le nombre d'outils a atteint le maximum. Cela se produit lorsque tous les ID de commande dans la plage sont assignés aux outils utilisateur. Vous pouvez récupérer le nombre maximal d'outils en appelant CUserToolsManager::GetMaxTools. Vous pouvez accéder à la liste d'outils en appelant la méthode de CUserToolsManager::GetUserTools .

Configuration requise

en-tête : afxusertoolsmanager.h

Voir aussi

Référence

CUserToolsManager, classe

Graphique de la hiérarchie