Share via


CToolTipCtrl::AddTool

Registra lo strumento con il controllo di descrizione comandi.

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 
);

Parametri

  • pWnd
    Puntatore alla finestra contenente lo strumento.

  • nIDText
    ID di risorsa di tipo stringa contenente il testo dello strumento.

  • lpRectTool
    Puntatore a una struttura RECT che include le coordinate del rettangolo di delimitazione dello strumento.Le coordinate sono relativi all'angolo superiore sinistro dell'area client della finestra identificata da pWnd.

  • nIDTool
    ID dello strumento.

  • lpszText
    Puntatore al testo dello strumento.Se questo parametro contiene il valore LPSTR_TEXTCALLBACK, i messaggi di notifica TTN_NEEDTEXT visitano il padre della finestra che indica pWnd.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

i parametri nIDTool e lpRectTool devono entrambi essere validi, o se lpRectTool è NULL, nIDTool deve essere 0.

Un controllo tooltip può essere associato a più di uno strumento.Chiamare la funzione per registrare uno strumento con il controllo di descrizione comandi, pertanto le informazioni archiviate nella descrizione comandi viene visualizzato quando il cursore si trova sullo strumento.

[!NOTA]

Non è possibile impostare una descrizione comandi a un controllo statico utilizzando AddTool.

Esempio

Vedere l'esempio relativo CPropertySheet::GetTabControl.

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CToolTipCtrl

Grafico della gerarchia

CToolTipCtrl::DelTool