Compartir a través de


CToolTipCtrl::AddTool

Registra una herramienta en el control de información sobre herramientas.

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

Parámetros

  • pWnd
    puntero a la ventana que contiene la herramienta.

  • nIDText
    Identificador de recursos de cadena que contiene el texto de la herramienta.

  • lpRectTool
    Puntero a una estructura de RECT que contiene las coordenadas del rectángulo delimitador de la herramienta. Las coordenadas son relativas a la esquina superior izquierda del área de cliente de la ventana identificada por pWnd.

  • nIDTool
    identificador de la herramienta.

  • lpszText
    Puntero al texto para la herramienta. Si este parámetro contiene el valor LPSTR_TEXTCALLBACK, los mensajes de notificación de TTN_NEEDTEXT ir al elemento primario de la ventana a la que pWnd señala.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

Los parámetros de lpRectTool y de nIDTool deben válidos, o si lpRectTool es NULL, nIDTool debe ser 0.

Un control de información sobre herramientas puede estar asociado a más de una herramienta. Llame a esta función para registrar una herramienta en el control de información sobre herramientas, para mostrar la información almacenada en la información sobre herramientas cuando el cursor está en la herramienta.

Nota

No se puede establecer una información sobre herramientas a un control estático mediante AddTool.

Ejemplo

Vea el ejemplo para CPropertySheet:: GetTabControl.

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

CToolTipCtrl Class

Gráfico de jerarquías

CToolTipCtrl::DelTool