开源项目CuteSqlite开发笔记（八）：Windows 64位/32位使用GetWindowLongPtr钩子函数

本文介绍: 在开发 CuteSqlite 的时候，有一个功能需要实现，鼠标移到 WTL::CStatic 上后，发送消息通知 CToolTipCtrl 弹出。文章介绍Windows 64 位 / 32 位如何用正确的姿势使用 GetWindowLongPtr 钩子函数。

需求描述

在开发CuteSqlite的时候，有一个功能需要实现，鼠标移到WTL::CStatic上后，发送消息通知CToolTipCtrl弹出。

遇到问题

WTL::CStatic控件没有相应 WM_MOUSEMOVE 消息，需要返回一个HTCLIENT消息来让窗口处理函数执行 WM_MOUSEMOVE消息，因为控件实例的鼠标消息，比如WM_MOUSEMOVE不会发送到父窗口上，只会发送到它本身，所以我们不能在父窗口的消息映射里添加处理CStatic的WM_MOUSEMOVE消息处理函数。针对这种情况，我们可以通过钩子的方式hook掉CStatic的原窗口处理内部函数。

如果是开发win 32位的应用程序，这个时候需要用到两个32位的勾子函数：GetWindowLong和SetWindowLong。

class QParamElem: public CWindowImpl<QParamElem> {
...
    CStatic desLabel; // 需要显示tooltip的文本框

    CToolTipCtrl tooltipCtrl; // tooltip提示控件
    std::pair<WNDPROC, HWND> procWndPair; // 钩子使用的变量，保存原来CStatic消息处理函数的地址和控件句柄HWND
    WNDPROC m_pWndProc; // 原来CStatic消息处理函数的地址
...
    // 初始化和绑定tooltipCtrl提示控件
    void createAndBindToolTip();
...
    // CStatic消息替换函数
    static LRESULT funcLabelProcWnd(HWND hWnd, UINT nMsg, WPARAM wParam, LPARAM lParam);
...
}

// 初始化和绑定tooltipCtrl
void QParamElem::createAndBindToolTip()
{
	if (tooltipCtrl.IsWindow() || !desLabel.IsWindow() ) {
		return;
	}
	tooltipCtrl.Create(desLabel.m_hWnd, NULL, NULL, WS_POPUP | TTS_NOPREFIX | TTS_ALWAYSTIP);
	tooltipCtrl.AddTool(desLabel.m_hWnd, data.description.c_str());
	tooltipCtrl.Activate(TRUE);		
	
	// 拦截鼠标消息.
	m_pWndProc = (WNDPROC)::GetWindowLongPtr(desLabel.m_hWnd, GWLP_WNDPROC); // 获取原窗口处理函数
	procWndPair.first = m_pWndProc; // 这个是用户定义的类型1,不重要
	procWndPair.second = tooltipCtrl.m_hWnd; // 这个是用户定义的类型2,不重要
	::SetWindowLongPtr(desLabel.m_hWnd, GWLP_USERDATA, (LONG_PTR)&procWndPair); // 设置窗口的自定义数据,用于存储原处理函数和ToolTip句柄
	::SetWindowLongPtr(desLabel.m_hWnd, GWLP_WNDPROC, (LONG_PTR)QParamElem::funcLabelProcWnd); // 自定义一个窗口处理函数，对鼠标消息预先过滤.
}

// 钩子替换的消息处理函数
LRESULT QParamElem::funcLabelProcWnd(HWND hWnd, UINT nMsg, WPARAM wParam, LPARAM lParam)
{
	auto pp = (std::pair<WNDPROC, HWND> *)::GetWindowLongPtr(hWnd, GWLP_USERDATA);
	WNDPROC funcOld = pp->first;
	auto tooltip_hwnd = pp->second;
	if(nMsg == WM_NCHITTEST){
		// 1.static 控件没有相应 WM_MOUSEMOVE 消息,需要返回一个HTCLIENT来让窗口处理函数执行 WM_MOUSEMOVE 消息.
		// 2.就是把 WM_NCHITTEST 消息转换为 WM_MOUSEMOVE消息.
		return HTCLIENT;
	} else if(nMsg == WM_MOUSEMOVE){
		// WM_MOUSEMOVE
		// WM_NCHITTEST
		// 1.发送一格WM_MOUSEMOVE消息给tooltip控件处理.这样tooltip才会在指定位置显示.
		MSG msg = { hWnd, nMsg, wParam, lParam };
		CToolTipCtrl tip;
		tip.Attach(tooltip_hwnd);
		tip.RelayEvent(&msg);
	}
	return CallWindowProc(funcOld, hWnd, nMsg, wParam, lParam);
}