MFC中CToolTipCtrl显示时间设置方法

源码资源网

MFC中CToolTipCtrl显示时间设置方法
一、延迟时间与显示持续时间配置

设置初始延迟时间‌
使用SetDelayTime(TTDT_INITIAL)定义鼠标悬停后提示框出现的等待时间（单位：毫秒）：

1. m_ToolTip.SetDelayTime(TTDT_INITIAL, 2000);  // 2秒后显示提示

复制代码

设置自动关闭时间‌
通过SetDelayTime(TTDT_AUTOPOP)控制提示框持续显示的时长：

1. m_ToolTip.SetDelayTime(TTDT_AUTOPOP, 5000);  // 显示5秒后自动关闭

复制代码

二、完整配置流程

初始化工具提示控件‌
在窗口类的OnInitDialog或OnCreate函数中创建并绑定控件：

1. <div>m_ToolTip.Create(this);  // 创建ToolTip实例:ml-citation{ref="3,4" data="citationList"}</div><div>m_ToolTip.AddTool(GetDlgItem(IDC_BUTTON1), _T("按钮功能说明"));  // 绑定控件与提示文本</div>

复制代码

激活工具提示‌
启用控件的激活状态：

1. m_ToolTip.Activate(TRUE);  // 开启提示功能:ml-citation{ref="3,4" data="citationList"}

复制代码

处理消息循环‌
在PreTranslateMessage中传递鼠标事件：

1. <div>BOOL CMyDlg::PreTranslateMessage(MSG* pMsg) {</div><div>    if (pMsg->message == WM_MOUSEMOVE) </div><div>        m_ToolTip.RelayEvent(pMsg);  // 转发鼠标移动事件:ml-citation{ref="3,4" data="citationList"}</div><div>    return CDialog::PreTranslateMessage(pMsg);</div><div>}</div>

复制代码

三、扩展设置（可选）

自定义背景与文字颜色‌
通过SetTipBkColor和SetTipTextColor调整提示框样式：

1. <div>m_ToolTip.SetTipBkColor(RGB(255, 255, 200));  // 浅黄色背景</div><div>m_ToolTip.SetTipTextColor(RGB(0, 0, 255));     // 蓝色文字</div>

复制代码

动态更新提示内容‌
在运行时修改提示文本：

1. m_ToolTip.UpdateTipText(_T("新提示内容"), GetDlgItem(IDC_BUTTON1));  // 更新指定控件的提示:ml-citation{ref="3" data="citationList"}

复制代码

四、注意事项
单位一致性‌：所有时间参数均以毫秒为单位，需避免混淆秒与毫秒。
控件绑定范围‌：AddTool的坐标参数若使用CRect，需确保区域为客户端坐标。