Freigeben über


CToolTipCtrl::AddTool

Registriert ein Tool mit dem ToolTip-Steuerelement.

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

Parameter

  • pWnd
    Zeiger auf das Fenster, das das Tool enthält.

  • nIDText
    ID der Zeichenfolgenressource, die den Text für das Tool enthält.

  • lpRectTool
    Zeiger auf eine Struktur RECT, die Koordinaten des umgebenden Rechtecks des Tools enthält. Die Koordinaten sind relativ zur linken oberen Ecke des Clientbereichs des Fensters, das von pWnd identifiziert wird.

  • nIDTool
    ID des Tools.

  • lpszText
    Zeiger auf den Text für das Tool. Wenn dieser Parameter den Wert LPSTR_TEXTCALLBACK enthält, wechseln TTN_NEEDTEXT Benachrichtigungsmeldungen an den übergeordneten des Fensters, dass pWnd auf zeigt.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Die lpRectTool und nIDTool-Parameter müssen beide gültig sein, oder, wenn lpRectTool NULL ist, muss nIDTool 0 sein.

Ein ToolTip-Steuerelement kann mit mehr als einem Tool zugeordnet werden. Rufen Sie diese Funktion auf, um ein Tool mit dem ToolTip-Steuerelement zu registrieren, damit die Informationen, die in der QuickInfo gespeichert werden, angezeigt werden, wenn der Cursor auf dem Tool ist.

Hinweis

Sie können eine QuickInfo nicht auf einen statischen Steuerelement mithilfe AddTool festlegen.

Beispiel

Im Beispiel für CPropertySheet::GetTabControl.

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CToolTipCtrl-Klasse

Hierarchiediagramm

CToolTipCtrl::DelTool