CToolTipCtrl::AddTool

Artículo
02/19/2013

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.