Partager via


CToolTipCtrl::AddTool

Enregistre un outil avec le contrôle d'info-bulle.

BOOL AddTool( 
   CWnd* pWnd, 
   UINT nIDText, 
   LPCRECT lpRectTool = NULL, 
   UINT_PTR nIDTool = 0  
); 
BOOL AddTool( 
   CWnd* pWnd, 
   LPCTSTR lpszText = LPSTR_TEXTCALLBACK, 
   LPCRECT lpRectTool = NULL, 
   UINT_PTR nIDTool = 0  
);

Paramètres

  • pWnd
    Pointeur vers la fenêtre qui contient l'outil.

  • nIDText
    ID de la ressource de type chaîne qui contient le texte de l'outil.

  • lpRectTool
    Pointeur vers une structure de RECT contenant des coordonnées du rectangle englobant de l'outil. Les coordonnées sont par rapport à l'angle supérieur gauche de la zone cliente de la fenêtre identifiée par pWnd.

  • nIDTool
    ID de l'outil.

  • lpszText
    Pointeur vers le texte de l'outil. Si ce paramètre contient la valeur LPSTR_TEXTCALLBACK, les messages de notification de TTN_NEEDTEXT vont au parent de la fenêtre laquelle pWnd indique.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Les paramètres de lpRectTool et de nIDTool doivent toutes les deux être valides, ou si lpRectTool est NULL, nIDTool doit avoir la valeur 0.

Un contrôle d'info-bulle peut être associé à plusieurs outil. Appelez cette fonction pour stocker un outil avec le contrôle d'info-bulle, afin que les informations stockées dans l'info-bulle sont affichées lorsque le curseur se trouve sur l'outil.

Notes

Vous ne pouvez pas définir une info-bulle à un contrôle statique à l'aide de AddTool.

Exemple

Consultez l'exemple pour CPropertySheet::GetTabControl.

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CToolTipCtrl, classe

Graphique de la hiérarchie

CToolTipCtrl::DelTool