CToolTipCtrl使用详细解说

 

很多的界面设计都需要有Tip提示，下面描述一下Tip的简单使用方法：

 

1. 首先要New一个CToolTipCtrl的对象m_pContentTip

2. 调用CToolTipCtrl的create函数，指定其父窗口。可以为某个控件，也可以为this。一般设为this。

   m_pContentTip->Create( this, TTS_ALWAYSTIP );

3. AddTool。此函数是设置与某个控件关联的Tip文本。此处可以为多个控件添加不同的提示信息。

　 m_pButtonTip->AddTool( GetDlgItem( 控件ID ), 文本 );  //#add 一定要用AddTool 否则不会显示 AddTool(this,文本);也行.

4. SetTipBkColor设置背景颜色。

5. SetTipTextColor设置文本颜色。

6. 最重要的一步。在PreTranslateMessage函数中添加下面语句：

 

BOOL CTestToolTipDlg::PreTranslateMessage(MSG* pMsg)

{

    // TODO: Add your specialized code here and/or call the base class

    if(pMsg->message== WM_LBUTTONDOWN ||

       pMsg->message== WM_LBUTTONUP ||

       pMsg->message== WM_MOUSEMOVE)

       m_pToolTipCtrl.RelayEvent(pMsg);

 

    return CDialog::PreTranslateMessage(pMsg);

}

 

另外，还可以使用m_pContentTip->UpdateTipText函数来更新Tip信息。

 

动态改变ToolTip的显示内容的方法及步骤：

上面所讲的1、2、4步骤。

在增加ToolTip时不指定显示的字串，而是使用LPSTR_TEXTCALLBACK。

在窗口中增加消息映射 ON_NOTIFY_EX( TTN_NEEDTEXT, 0, SetTipText )。

在窗口中增加一个函数用于动态提供显示内容，其原型为 BOOL SetTipText( UINT id, NMHDR * pTTTStruct, LRESULT * pResult )，下面的代码可以根据传入的参数判定应该显示的内容。

BOOL CWndYour::SetTipText( UINT id, NMHDR * pTTTStruct, LRESULT * pResult )
{
TOOLTIPTEXT *pTTT = (TOOLTIPTEXT *)pTTTStruct;  
UINT nID =pTTTStruct->idFrom; //得到相应窗口ID，有可能是HWND
if (pTTT->uFlags & TTF_IDISHWND)    //表明nID是否为HWND
{
         nID = ::GetDlgCtrlID((HWND)nID);//从HWND得到ID值，当然你也可以通过HWND值来判断
switch(nID)

        {
        case(IDC_YOUR_CONTROL1)      
              strcpy(pTTT->lpszText,your_string1);//设置
              return TRUE;
              break;
        case(IDC_YOUR_CONTROL2)
              //设置相应的显示字串
              return TRUE;
              break;

        }
}
return TRUE;
}

 

 

 

注:

实际项目中常常重写该类得到 不同风格,甚至是在其中添加图片,如CXInfoTip.

常用的扩展按钮控件一般均封装了一个CToolTipCtrl控件.

 

另一篇:

    ToolTip是Win32中一个通用控件，MFC中为其生成了一个类CToolTipCtrl，总的说来其使用方法是较简单的，下面讲一下它的一般用法和高级用法。 
    

一般用法步骤： 
    1.添加CToolTipCtrl成员变量 m_tt。 
    2.在父窗口中调用EnableToolTips(TRUE); 
    3.在窗口的OnCreate（或者其他适当的位置）中向ToolTip中添加需要显示Tip的子窗口，并同时指定相应的显示字串CToolTipCtrl::AddTool(pWnd,"string to display")。 
    4.重载父窗口的 BOOL PreTranslateMessage(MSG* pMsg) ，在函数中调用 m_tt.RelayEvent(pMsg)。 

    下面假设在窗口CWndYour中使用CToolTipCtrl 
    在类定义中添加变量说明： 
    class CWndYour:xxx 
    { 
     CToolTipCtrl m_tt; 
    } 
     
    在OnCreate中添加需要显示Tip的子窗口 
    CWndYour::OnCreate(....) 
    { 
     EnableToolTips(TRUE); 
     m_tt.Create(this); 
     m_tt.Activate(TRUE); 
     CWnd* pW=GetDlgItem(IDC_CHECK1);//得到窗口指针
     m_tooltip.AddTool(pW,"Check1");//添加 
     
    ........  
    } 
     
    在BOOL PreTranslateMessage(MSG* pMsg)中添加代码 
    BOOL CWndYour::PreTranslateMessage(MSG* pMsg) 
    { 
     { 
     m_tt.RelayEvent(pMsg); 
     } 
     return CParentClass::PreTranslateMessage(pMsg); 
    } 
     
    这样当鼠标移动到相应的子窗口上时会显示出相应的ToolTip。 

二,动态改变ToolTip的显示内容的方法及步骤： 
    1.上面所讲的1、2、4步骤。 
    2.在增加ToolTip时不指定显示的字串，而是使用LPSTR_TEXTCALLBACK。 
    3.在窗口中增加消息映射 ON_NOTIFY_EX( TTN_NEEDTEXT, 0, SetTipText )。 
    4.在窗口中增加一个函数用于动态提供显示内容，其原型为 BOOL SetTipText( UINT id, NMHDR * pTTTStruct, LRESULT * pResult )，下面的代码可以根据传入的参数判定应该显示的内容。 
 
    BOOL CWndYour::SetTipText( UINT id, NMHDR * pTTTStruct, LRESULT * pResult ) 
    { 
     TOOLTIPTEXT *pTTT = (TOOLTIPTEXT *)pTTTStruct; 
     UINT nID =pTTTStruct->idFrom; //得到相应窗口ID，有可能是HWND 
     if (pTTT->uFlags & TTF_IDISHWND) //表明nID是否为HWND 
     { 
     nID = ::GetDlgCtrlID((HWND)nID);//从HWND得到ID值，当然你也可以通过HWND值来判断 
     switch(nID) 
     case(IDC_YOUR_CONTROL1) 
     strcpy(pTTT->lpszText,your_string1);//设置 
     return TRUE; 
     break; 
     case(IDC_YOUR_CONTROL2) 
     //设置相应的显示字串 
     return TRUE; 
     break; 
     } 
     
     return(FALSE); 
    }