CWnd::OnToolHitTest

Artículo
02/19/2013

El marco de trabajo llama a esta función miembro al detemine si un punto está en el rectángulo delimitador de la herramienta especificada.

virtual INT_PTR OnToolHitTest(
   CPoint point,
   TOOLINFO* pTI 
) const;

Parámetros

point
Especifica el x y la coordenada y del cursor.Estas coordenadas siempre están en relación con la esquina superior izquierda de la ventana
pTI
Un puntero a una estructura de TOOLINFO .Los valores de la estructura se establecen de forma predeterminada:
- hwnd = identificador de m_hWnd a una ventana
- uId = identificador de (UINT)hWndChild a una ventana secundaria
- uFlags |= Identificador de TTF_IDISHWND de herramienta
- lpszText = puntero de LPSTR_TEXTCALLBACK a la cadena que debe ser mostrada en la ventana especificada

Valor devuelto

Si el control de información sobre herramientas se encontró, el identificador de control de la ventanaSi el control de información sobre herramientas no se encontró, -1.

Comentarios

Si point se encuentra en el rectángulo, recupera información sobre la herramienta.

Si el área a la que está asociada la información sobre herramientas no es un botón, OnToolHitTest establece los marcadores de la estructura a TTF_NOTBUTTON y a TTF_CENTERTIP.

Reemplazo OnToolHitTest para proporcionar información diferente al predeterminado proporciona.

Vea TOOLINFO, en Windows SDK, para obtener más información sobre la estructura.