soui4实现自定义ToolTip

ceffans

首先我们先定义个展示tooltip的xml

1. <?xml version="1.0"?>
   
2. <SOUI name="tip" title="tip" width="-1" height="-1" resizable="0" wndType="normal" toolwindow="1" translucent="1">
   
3.         <root size="-1,-1" colorBkgnd="#212629f0" class="style_tip" padding="10,10,10,10" layout="vbox">
   
4.                 <text name="txt_tip" colorText="#FFFFFFb0" font="face:微软雅黑,size:12" maxWidth="300" multiLines="1"/>
   
5.         </root>
   
6. </SOUI>
   

复制代码

其中txt_tip就是用来展示tip内容的。我们可以在此处指定tooltip的展示样式。
在uires中关联一下这个xml

1.   <LAYOUT>
   
2.           <file name="XML_TOOLTIP" path="xml\tooltip.xml"/>
   
3.   </LAYOUT>
   

复制代码

然后我们实现一个tooltip类

1. //头文件CToolTipEx.h
   
2. #pragma once
   
3. class CToolTipEx : public IToolTip
   
4.         , public IMsgFilter
   
5.         , public SHostWnd
   
6. {
   
7. public:
   
8.         CToolTipEx(void);
   
9.         virtual ~CToolTipEx(void);
   
10. 
    
11.         BOOL CreateWnd();
    
12.         HWND Hwnd();
    
13. 
    
14. public://IToolTip
    
15.         STDMETHOD_(BOOL, Create)(THIS) OVERRIDE;
    
16.         STDMETHOD_(BOOL, Destroy)(THIS) OVERRIDE;
    
17.         STDMETHOD_(BOOL, PreTranslateMessage)(THIS_ MSG* pMsg) OVERRIDE;
    
18.         STDMETHOD_(void, UpdateTip)(THIS_ const TIPID* id, RECT rc, LPCTSTR pszTip, int nScale) OVERRIDE;
    
19.         STDMETHOD_(void, SetToolTip)(THIS_ LPCRECT rc, UINT tipAlign, LPCTSTR pszTip, int nScale) OVERRIDE;
    
20.         STDMETHOD_(void, ClearTip)(THIS) OVERRIDE;
    
21.         STDMETHOD_(void, RelayEvent)(THIS_ const MSG* pMsg) OVERRIDE;
    
22. 
    
23.         STDMETHOD_(long, AddRef)(THIS) OVERRIDE {
    
24.                 return SNativeWnd::AddRef();
    
25.         }
    
26.         STDMETHOD_(long, Release)(THIS) OVERRIDE {
    
27.                 return SNativeWnd::Release();
    
28.         }
    
29.         STDMETHOD_(void, OnFinalRelease)(THIS) OVERRIDE {
    
30.                 delete this;
    
31.         }
    
32. 
    
33.         STDMETHOD_(IMsgFilter*, GetMsgFilter)(THIS) OVERRIDE {
    
34.                 return this;
    
35.         }
    
36.         
    
37.         //要重写这两个接口，不然内部自己建立时会不停建立tip。会导致死循环
    
38.         virtual IToolTip* CreateTooltip() const { return NULL; }
    
39.         virtual void DestroyTooltip(IToolTip* pTooltip) {}
    
40. 
    
41. protected:
    
42.         int OnCreate(LPCREATESTRUCT lpCreateStruct);
    
43.         BOOL OnInitDialog(HWND wndFocus, LPARAM lInitParam);
    
44.         void OnTimer(UINT_PTR idEvent);
    
45. 
    
46.         BEGIN_MSG_MAP_EX(CToolTipEx)
    
47.                 MSG_WM_CREATE(OnCreate)
    
48.                 MSG_WM_INITDIALOG(OnInitDialog)
    
49.                 MSG_WM_TIMER(OnTimer)
    
50.                 CHAIN_MSG_MAP(SHostWnd)
    
51.                 REFLECT_NOTIFICATIONS_EX()
    
52.                 END_MSG_MAP()
    
53. 
    
54.         void ShowTip(BOOL bShow);
    
55. 
    
56. private:
    
57.         HWND        m_hWnd;
    
58.         DWORD        m_Tick;
    
59.         int                m_nDelay;
    
60.         int                m_nShowSpan;
    
61.         SStringT        m_strTip;
    
62.         int                m_nScale;
    
63.         CRect        m_rcTarget;
    
64.         SStatic*        m_txtTip;
    
65.         TIPID        m_id;
    
66.         bool        m_bShow;
    
67. };
    
68. 
    
69. //源文件CToolTipEx.cpp
    
70. #include "stdafx.h"
    
71. #include "CToolTipEx.h"
    
72. 
    
73. #define TIMERID_DELAY2   1
    
74. #define TIMERID_SPAN2     2
    
75. #define MARGIN_TIP2        5
    
76. 
    
77. CToolTipEx::CToolTipEx(void) : SHostWnd(_T("LAYOUT:XML_TOOLTIP"))
    
78. , m_nDelay(50)
    
79. , m_nShowSpan(5000)
    
80. , m_Tick(0)
    
81. {
    
82.         m_id.dwHi = m_id.dwLow = 0;
    
83.         m_bShow = false;
    
84. }
    
85. 
    
86. CToolTipEx::~CToolTipEx(void)
    
87. {
    
88. }
    
89. 
    
90. BOOL CToolTipEx::CreateWnd()
    
91. {
    
92.         m_hWnd = SHostWnd::Create(::GetActiveWindow(), 0, 0, 0, 0);
    
93.         SendMessage(WM_INITDIALOG);
    
94.         return TRUE;
    
95. }
    
96. 
    
97. HWND CToolTipEx::Hwnd()
    
98. {
    
99.         return m_hWnd;
    
100. }
     
101. 
     
102. BOOL CToolTipEx::Create()
     
103. {
     
104.         CreateWnd();
     
105.         return TRUE;
     
106. }
     
107. 
     
108. BOOL CToolTipEx::Destroy()
     
109. {
     
110.         return TRUE;
     
111. }
     
112. 
     
113. BOOL CToolTipEx::PreTranslateMessage(MSG* pMsg)
     
114. {
     
115.         if (IsWindow())
     
116.                 RelayEvent(pMsg);
     
117. 
     
118.         return FALSE;
     
119. }
     
120. 
     
121. void CToolTipEx::UpdateTip(const TIPID* id, RECT rc, LPCTSTR pszTip, int nScale)
     
122. {
     
123.         if (m_id.dwHi == id->dwHi && m_id.dwLow == id->dwLow) return;
     
124. 
     
125.         m_id = *id;
     
126.         m_rcTarget = rc;
     
127.         m_strTip = pszTip;
     
128.         m_strTip.Replace(_T("\\n"), _T("\n"));
     
129. 
     
130.         if (IsWindowVisible())
     
131.                 ShowTip(TRUE);
     
132. }
     
133. 
     
134. void CToolTipEx::SetToolTip(LPCRECT rc, UINT tipAlign, LPCTSTR pszTip, int nScale)
     
135. {
     
136. }
     
137. 
     
138. void CToolTipEx::ClearTip()
     
139. {
     
140.         m_id.dwHi = m_id.dwLow = 0;
     
141.         ShowTip(FALSE);
     
142. }
     
143. 
     
144. void CToolTipEx::RelayEvent(const MSG* pMsg)
     
145. {
     
146.         switch (pMsg->message)
     
147.         {
     
148.         case WM_LBUTTONDOWN:
     
149.         case WM_LBUTTONUP:
     
150.         case WM_RBUTTONDOWN:
     
151.         case WM_RBUTTONUP:
     
152.         case WM_MBUTTONUP:
     
153.         case WM_MBUTTONDOWN:
     
154.                 OnTimer(TIMERID_SPAN2);//hide tip
     
155.                 break;
     
156.         case WM_MOUSEMOVE:
     
157.         {
     
158.                 CPoint pt(GET_X_LPARAM(pMsg->lParam), GET_Y_LPARAM(pMsg->lParam));
     
159.                 if (!m_rcTarget.PtInRect(pt))
     
160.                 {
     
161.                         OnTimer(TIMERID_SPAN2);//hide tip
     
162.                 }
     
163.                 else if (/*!IsWindowVisible() &&*/ !m_strTip.IsEmpty())
     
164.                 {
     
165.                         DWORD t = ::GetTickCount();
     
166.                         if ((t - m_Tick) > DWORD(m_nDelay))
     
167.                         {
     
168.                                 KillTimer(TIMERID_DELAY2);
     
169.                                 SetTimer(TIMERID_DELAY2, m_nDelay);
     
170.                                 m_Tick = t;
     
171.                         }
     
172.                         ::ClientToScreen(pMsg->hwnd, &pt);
     
173.                         SetWindowPos(0, pt.x, pt.y + 18, 0, 0, SWP_NOSIZE | SWP_NOZORDER | SWP_NOSENDCHANGING | SWP_NOACTIVATE);
     
174.                 }
     
175.         }
     
176.         break;
     
177.         default:
     
178.                 break;
     
179.         }
     
180. }
     
181. 
     
182. int CToolTipEx::OnCreate(LPCREATESTRUCT lpCreateStruct)
     
183. {
     
184.         SHostWnd::OnCreate(lpCreateStruct);
     
185. 
     
186.         return 0;
     
187. }
     
188. 
     
189. BOOL CToolTipEx::OnInitDialog(HWND wndFocus, LPARAM lInitParam)
     
190. {
     
191.         m_txtTip = FindChildByName2<SStatic>(L"txt_tip");
     
192.         return TRUE;
     
193. }
     
194. 
     
195. void CToolTipEx::OnTimer(UINT_PTR idEvent)
     
196. {
     
197.         SetMsgHandled(FALSE);
     
198.         switch (idEvent)
     
199.         {
     
200.         case TIMERID_DELAY2:
     
201.         {
     
202.                 if (!m_bShow)
     
203.                 {
     
204.                         KillTimer(TIMERID_DELAY2);
     
205.                         ShowTip(TRUE);
     
206.                         m_bShow = true;
     
207.                 }
     
208.                 SetTimer(TIMERID_SPAN2, m_nShowSpan);
     
209.         }
     
210.         break;
     
211.         case TIMERID_SPAN2:
     
212.         {
     
213.                 ShowTip(FALSE);
     
214.                 KillTimer(TIMERID_SPAN2);
     
215.                 m_bShow = false;
     
216.         }
     
217.         break;
     
218.         }
     
219. }
     
220. 
     
221. void CToolTipEx::ShowTip(BOOL bShow)
     
222. {
     
223.         if (!bShow)
     
224.         {
     
225.                 ShowWindow(SW_HIDE);
     
226.                 m_rcTarget.SetRect(0, 0, 0, 0);
     
227.                 m_strTip = _T("");
     
228.         }
     
229.         else if (!m_strTip.IsEmpty())
     
230.         {
     
231.                 ShowWindow(SW_SHOW);
     
232.                 m_txtTip->SetWindowText(m_strTip);
     
233.         }
     
234. }
     

复制代码

控件使用：
我们需要在cpp中实现一个SToolTipFactory，然后将SToolTipFactory注册到App中。

1. #include "CToolTipEx.h"
   
2. class SToolTipFactory : public TObjRefImpl<IToolTipFactory>
   
3. {
   
4. public:
   
5.         IToolTip* CreateToolTip(HWND hHost)
   
6.         {
   
7.                 CToolTipEx* pTipCtrl = new CToolTipEx;
   
8.                 if (!pTipCtrl->CreateWnd())
   
9.                 {
   
10.                         delete pTipCtrl;
    
11.                         return NULL;
    
12.                 }
    
13.                 return pTipCtrl;
    
14.         }
    
15. 
    
16.         void DestroyToolTip(IToolTip* pToolTip)
    
17.         {
    
18.                 if (pToolTip)
    
19.                 {
    
20.                         CToolTipEx* pTipCtrl = (CToolTipEx*)pToolTip;
    
21.                         pTipCtrl->DestroyWindow();
    
22.                 }
    
23.         }
    
24. };
    
25. 
    
26. //注册
    
27.         //注册用户自定义皮肤和控件
    
28.         void Regitercustom()
    
29.         {
    
30.                 m_theApp->SetToolTipFactory(new SToolTipFactory);
    
31.         }
    

复制代码

效果如下：

代码地址：
https://github.com/JeanPenty/ToolTipExDemo

ToolTipExDemo-main.zip (33.81 KB, 下载次数: 0)

2025-9-22 21:57 上传

点击文件名下载附件

admin

谢谢分享，论坛有你更精彩！