1 /////////////////////////////////////////////////////////////////////////
2 // File: src/msw/taskbar.cpp
3 // Purpose: Implements wxTaskBarIcon class for manipulating icons on
4 // the Windows task bar.
5 // Author: Julian Smart
6 // Modified by: Vaclav Slavik
10 // Licence: wxWindows licence
11 /////////////////////////////////////////////////////////////////////////
13 // For compilers that support precompilation, includes "wx.h".
14 #include "wx/wxprec.h"
21 #include "wx/window.h"
27 #include "wx/msw/private.h"
28 #include "wx/msw/winundef.h"
31 #include "wx/taskbar.h"
38 // initialized on demand
39 UINT gs_msgTaskbar
= 0;
40 UINT gs_msgRestartTaskbar
= 0;
43 IMPLEMENT_DYNAMIC_CLASS(wxTaskBarIcon
, wxEvtHandler
)
45 // ============================================================================
47 // ============================================================================
49 // ----------------------------------------------------------------------------
50 // wxTaskBarIconWindow: helper window
51 // ----------------------------------------------------------------------------
53 // NB: this class serves two purposes:
54 // 1. win32 needs a HWND associated with taskbar icon, this provides it
55 // 2. we need wxTopLevelWindow so that the app doesn't exit when
56 // last frame is closed but there still is a taskbar icon
57 class wxTaskBarIconWindow
: public wxFrame
60 wxTaskBarIconWindow(wxTaskBarIcon
*icon
)
61 : wxFrame(NULL
, wxID_ANY
, wxEmptyString
, wxDefaultPosition
, wxDefaultSize
, 0),
66 WXLRESULT
MSWWindowProc(WXUINT msg
,
67 WXWPARAM wParam
, WXLPARAM lParam
)
69 if (msg
== gs_msgRestartTaskbar
|| msg
== gs_msgTaskbar
)
71 return m_icon
->WindowProc(msg
, wParam
, lParam
);
75 return wxFrame::MSWWindowProc(msg
, wParam
, lParam
);
80 wxTaskBarIcon
*m_icon
;
84 // ----------------------------------------------------------------------------
85 // NotifyIconData: wrapper around NOTIFYICONDATA
86 // ----------------------------------------------------------------------------
88 struct NotifyIconData
: public NOTIFYICONDATA
90 NotifyIconData(WXHWND hwnd
)
92 memset(this, 0, sizeof(NOTIFYICONDATA
));
93 cbSize
= sizeof(NOTIFYICONDATA
);
95 uCallbackMessage
= gs_msgTaskbar
;
98 // we use the same id for all taskbar icons as we don't need it to
99 // distinguish between them
104 // ----------------------------------------------------------------------------
106 // ----------------------------------------------------------------------------
108 wxTaskBarIcon::wxTaskBarIcon()
112 RegisterWindowMessages();
115 wxTaskBarIcon::~wxTaskBarIcon()
125 bool wxTaskBarIcon::SetIcon(const wxIcon
& icon
, const wxString
& tooltip
)
127 // NB: we have to create the window lazily because of backward compatibility,
128 // old applications may create a wxTaskBarIcon instance before wxApp
129 // is initialized (as samples/taskbar used to do)
132 m_win
= new wxTaskBarIconWindow(this);
136 m_strTooltip
= tooltip
;
138 NotifyIconData
notifyData(GetHwndOf(m_win
));
142 notifyData
.uFlags
|= NIF_ICON
;
143 notifyData
.hIcon
= GetHiconOf(icon
);
146 // set NIF_TIP even for an empty tooltip: otherwise it would be impossible
147 // to remove an existing tooltip using this function
148 notifyData
.uFlags
|= NIF_TIP
;
149 if ( !tooltip
.empty() )
151 wxStrncpy(notifyData
.szTip
, tooltip
.c_str(), WXSIZEOF(notifyData
.szTip
));
154 bool ok
= Shell_NotifyIcon(m_iconAdded
? NIM_MODIFY
155 : NIM_ADD
, ¬ifyData
) != 0;
157 if ( !m_iconAdded
&& ok
)
163 bool wxTaskBarIcon::RemoveIcon()
170 NotifyIconData
notifyData(GetHwndOf(m_win
));
172 return Shell_NotifyIcon(NIM_DELETE
, ¬ifyData
) != 0;
176 bool wxTaskBarIcon::PopupMenu(wxMenu
*menu
)
178 wxASSERT_MSG( m_win
!= NULL
, _T("taskbar icon not initialized") );
180 static bool s_inPopup
= false;
188 wxGetMousePosition(&x
, &y
);
192 m_win
->PushEventHandler(this);
196 // the SetForegroundWindow() and PostMessage() calls are needed to work
197 // around Win32 bug with the popup menus shown for the notifications as
198 // documented at http://support.microsoft.com/kb/q135788/
199 ::SetForegroundWindow(GetHwndOf(m_win
));
201 bool rval
= m_win
->PopupMenu(menu
, 0, 0);
203 ::PostMessage(GetHwndOf(m_win
), WM_NULL
, 0, 0L);
205 m_win
->PopEventHandler(false);
211 #endif // wxUSE_MENUS
213 void wxTaskBarIcon::RegisterWindowMessages()
215 static bool s_registered
= false;
219 // Taskbar restart msg will be sent to us if the icon needs to be redrawn
220 gs_msgRestartTaskbar
= RegisterWindowMessage(wxT("TaskbarCreated"));
222 // Also register the taskbar message here
223 gs_msgTaskbar
= ::RegisterWindowMessage(wxT("wxTaskBarIconMessage"));
229 // ----------------------------------------------------------------------------
230 // wxTaskBarIcon window proc
231 // ----------------------------------------------------------------------------
233 long wxTaskBarIcon::WindowProc(unsigned int msg
,
234 unsigned int WXUNUSED(wParam
),
237 wxEventType eventType
= 0;
239 if (msg
== gs_msgRestartTaskbar
) // does the icon need to be redrawn?
242 SetIcon(m_icon
, m_strTooltip
);
245 // this function should only be called for gs_msg(Restart)Taskbar messages
246 wxASSERT(msg
== gs_msgTaskbar
);
251 eventType
= wxEVT_TASKBAR_LEFT_DOWN
;
255 eventType
= wxEVT_TASKBAR_LEFT_UP
;
259 eventType
= wxEVT_TASKBAR_RIGHT_DOWN
;
263 eventType
= wxEVT_TASKBAR_RIGHT_UP
;
266 case WM_LBUTTONDBLCLK
:
267 eventType
= wxEVT_TASKBAR_LEFT_DCLICK
;
270 case WM_RBUTTONDBLCLK
:
271 eventType
= wxEVT_TASKBAR_RIGHT_DCLICK
;
275 eventType
= wxEVT_TASKBAR_MOVE
;
284 wxTaskBarIconEvent
event(eventType
, this);