/////////////////////////////////////////////////////////////////////////
-// File: taskbar.cpp
-// Purpose: Implements wxTaskBarIcon class for manipulating icons on
+// File: src/msw/taskbar.cpp
+// Purpose: Implements wxTaskBarIcon class for manipulating icons on
// the Windows task bar.
// Author: Julian Smart
-// Modified by:
+// Modified by: Vaclav Slavik
// Created: 24/3/98
// RCS-ID: $Id$
// Copyright: (c)
-// Licence: wxWindows licence
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////
-#ifdef __GNUG__
-#pragma implementation "taskbar.h"
-#endif
-
// For compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"
#ifdef __BORLANDC__
-#pragma hdrstop
+ #pragma hdrstop
#endif
+#if wxUSE_TASKBARICON
+
#ifndef WX_PRECOMP
-#include "wx/defs.h"
+ #include "wx/window.h"
+ #include "wx/frame.h"
+ #include "wx/utils.h"
+ #include "wx/menu.h"
#endif
-#ifdef __WIN95__
+#include "wx/msw/private.h"
+#include "wx/msw/winundef.h"
-#include <wx/msw/taskbar.h>
#include <string.h>
-#include <windows.h>
-#include <wx/msw/private.h>
+#include "wx/taskbar.h"
-#ifdef __GNUWIN32__
-#include <wx/msw/gnuwin32/extra.h>
+#ifdef __WXWINCE__
+ #include <winreg.h>
+ #include <shellapi.h>
#endif
-LRESULT APIENTRY _EXPORT wxTaskBarIconWindowProc( HWND hWnd, unsigned msg,
- UINT wParam, LONG lParam );
+// initialized on demand
+UINT gs_msgTaskbar = 0;
+UINT gs_msgRestartTaskbar = 0;
-char *wxTaskBarWindowClass = "wxTaskBarWindowClass";
-wxList wxTaskBarIcon::sm_taskBarIcons;
-bool wxTaskBarIcon::sm_registeredClass = FALSE;
-UINT wxTaskBarIcon::sm_taskbarMsg = 0;
+IMPLEMENT_DYNAMIC_CLASS(wxTaskBarIcon, wxEvtHandler)
-wxTaskBarIcon::wxTaskBarIcon(void)
-{
- m_hWnd = 0;
- m_iconAdded = FALSE;
+// ============================================================================
+// implementation
+// ============================================================================
- AddObject(this);
+// ----------------------------------------------------------------------------
+// wxTaskBarIconWindow: helper window
+// ----------------------------------------------------------------------------
- if (RegisterWindowClass())
- m_hWnd = CreateTaskBarWindow();
-}
-
-wxTaskBarIcon::~wxTaskBarIcon(void)
+// NB: this class serves two purposes:
+// 1. win32 needs a HWND associated with taskbar icon, this provides it
+// 2. we need wxTopLevelWindow so that the app doesn't exit when
+// last frame is closed but there still is a taskbar icon
+class wxTaskBarIconWindow : public wxFrame
{
- RemoveObject(this);
+public:
+ wxTaskBarIconWindow(wxTaskBarIcon *icon)
+ : wxFrame(NULL, wxID_ANY, wxEmptyString, wxDefaultPosition, wxDefaultSize, 0),
+ m_icon(icon)
+ {
+ }
- if (m_iconAdded)
+ WXLRESULT MSWWindowProc(WXUINT msg,
+ WXWPARAM wParam, WXLPARAM lParam)
{
- RemoveIcon();
+ if (msg == gs_msgRestartTaskbar || msg == gs_msgTaskbar)
+ {
+ return m_icon->WindowProc(msg, wParam, lParam);
+ }
+ else
+ {
+ return wxFrame::MSWWindowProc(msg, wParam, lParam);
+ }
}
- if (m_hWnd)
+private:
+ wxTaskBarIcon *m_icon;
+};
+
+
+// ----------------------------------------------------------------------------
+// NotifyIconData: wrapper around NOTIFYICONDATA
+// ----------------------------------------------------------------------------
+
+struct NotifyIconData : public NOTIFYICONDATA
+{
+ NotifyIconData(WXHWND hwnd)
{
- ::DestroyWindow((HWND) m_hWnd);
- m_hWnd = 0;
+ memset(this, 0, sizeof(NOTIFYICONDATA));
+ cbSize = sizeof(NOTIFYICONDATA);
+ hWnd = (HWND) hwnd;
+ uCallbackMessage = gs_msgTaskbar;
+ uFlags = NIF_MESSAGE;
+
+ // we use the same id for all taskbar icons as we don't need it to
+ // distinguish between them
+ uID = 99;
}
+};
+
+// ----------------------------------------------------------------------------
+// wxTaskBarIcon
+// ----------------------------------------------------------------------------
+
+wxTaskBarIcon::wxTaskBarIcon()
+{
+ m_win = NULL;
+ m_iconAdded = false;
+ RegisterWindowMessages();
+}
+
+wxTaskBarIcon::~wxTaskBarIcon()
+{
+ if (m_iconAdded)
+ RemoveIcon();
+
+ if (m_win)
+ m_win->Destroy();
}
// Operations
bool wxTaskBarIcon::SetIcon(const wxIcon& icon, const wxString& tooltip)
{
- if (!IsOK())
- return FALSE;
+ // NB: we have to create the window lazily because of backward compatibility,
+ // old applications may create a wxTaskBarIcon instance before wxApp
+ // is initialized (as samples/taskbar used to do)
+ if (!m_win)
+ {
+ m_win = new wxTaskBarIconWindow(this);
+ }
- NOTIFYICONDATA notifyData;
+ m_icon = icon;
+ m_strTooltip = tooltip;
- memset(¬ifyData, 0, sizeof(notifyData));
- notifyData.cbSize = sizeof(notifyData);
- notifyData.hWnd = (HWND) m_hWnd;
- notifyData.uCallbackMessage = sm_taskbarMsg;
- notifyData.uFlags = NIF_MESSAGE ;
- if (icon.Ok())
+ NotifyIconData notifyData(GetHwndOf(m_win));
+
+ if (icon.Ok())
{
- notifyData.uFlags |= NIF_ICON;
- notifyData.hIcon = (HICON) icon.GetHICON();
+ notifyData.uFlags |= NIF_ICON;
+ notifyData.hIcon = GetHiconOf(icon);
}
- if (((const char*) tooltip != NULL) && (tooltip != ""))
+ // set NIF_TIP even for an empty tooltip: otherwise it would be impossible
+ // to remove an existing tooltip using this function
+ notifyData.uFlags |= NIF_TIP;
+ if ( !tooltip.empty() )
{
- notifyData.uFlags |= NIF_TIP ;
- lstrcpyn(notifyData.szTip, (char*) (const char*) tooltip, sizeof(notifyData.szTip));
+ wxStrncpy(notifyData.szTip, tooltip.c_str(), WXSIZEOF(notifyData.szTip));
}
- notifyData.uID = 99;
+ bool ok = Shell_NotifyIcon(m_iconAdded ? NIM_MODIFY
+ : NIM_ADD, ¬ifyData) != 0;
- if (m_iconAdded)
- return (Shell_NotifyIcon(NIM_MODIFY, & notifyData) != 0);
- else
- {
- m_iconAdded = (Shell_NotifyIcon(NIM_ADD, & notifyData) != 0);
- return m_iconAdded;
- }
+ if ( !m_iconAdded && ok )
+ m_iconAdded = true;
+
+ return ok;
}
-bool wxTaskBarIcon::RemoveIcon(void)
+bool wxTaskBarIcon::RemoveIcon()
{
if (!m_iconAdded)
- return FALSE;
+ return false;
- NOTIFYICONDATA notifyData;
+ m_iconAdded = false;
- memset(¬ifyData, 0, sizeof(notifyData));
- notifyData.cbSize = sizeof(notifyData);
- notifyData.hWnd = (HWND) m_hWnd;
- notifyData.uCallbackMessage = sm_taskbarMsg;
- notifyData.uFlags = NIF_MESSAGE;
- notifyData.hIcon = 0 ; // hIcon;
- notifyData.uID = 99;
- m_iconAdded = FALSE;
+ NotifyIconData notifyData(GetHwndOf(m_win));
- return (Shell_NotifyIcon(NIM_DELETE, & notifyData) != 0);
+ return Shell_NotifyIcon(NIM_DELETE, ¬ifyData) != 0;
}
-// Overridables
-void wxTaskBarIcon::OnMouseMove(void)
+#if wxUSE_MENUS
+bool wxTaskBarIcon::PopupMenu(wxMenu *menu)
{
-}
+ wxASSERT_MSG( m_win != NULL, _T("taskbar icon not initialized") );
-void wxTaskBarIcon::OnLButtonDown(void)
-{
-}
+ static bool s_inPopup = false;
-void wxTaskBarIcon::OnLButtonUp(void)
-{
-}
+ if (s_inPopup)
+ return false;
-void wxTaskBarIcon::OnRButtonDown(void)
-{
-}
+ s_inPopup = true;
-void wxTaskBarIcon::OnRButtonUp(void)
-{
-}
+ int x, y;
+ wxGetMousePosition(&x, &y);
-void wxTaskBarIcon::OnLButtonDClick(void)
-{
-}
+ m_win->Move(x, y);
-void wxTaskBarIcon::OnRButtonDClick(void)
-{
+ m_win->PushEventHandler(this);
+
+ menu->UpdateUI();
+
+ // the SetForegroundWindow() and PostMessage() calls are needed to work
+ // around Win32 bug with the popup menus shown for the notifications as
+ // documented at http://support.microsoft.com/kb/q135788/
+ ::SetForegroundWindow(GetHwndOf(m_win));
+
+ bool rval = m_win->PopupMenu(menu, 0, 0);
+
+ ::PostMessage(GetHwndOf(m_win), WM_NULL, 0, 0L);
+
+ m_win->PopEventHandler(false);
+
+ s_inPopup = false;
+
+ return rval;
}
+#endif // wxUSE_MENUS
-wxTaskBarIcon* wxTaskBarIcon::FindObjectForHWND(WXHWND hWnd)
+void wxTaskBarIcon::RegisterWindowMessages()
{
- wxNode*node = sm_taskBarIcons.First();
- while (node)
+ static bool s_registered = false;
+
+ if ( !s_registered )
{
- wxTaskBarIcon* obj = (wxTaskBarIcon*) node->Data();
- if (obj->GetHWND() == hWnd)
- return obj;
- node = node->Next();
- }
- return NULL;
-}
+ // Taskbar restart msg will be sent to us if the icon needs to be redrawn
+ gs_msgRestartTaskbar = RegisterWindowMessage(wxT("TaskbarCreated"));
-void wxTaskBarIcon::AddObject(wxTaskBarIcon* obj)
-{
- sm_taskBarIcons.Append(obj);
-}
+ // Also register the taskbar message here
+ gs_msgTaskbar = ::RegisterWindowMessage(wxT("wxTaskBarIconMessage"));
-void wxTaskBarIcon::RemoveObject(wxTaskBarIcon* obj)
-{
- sm_taskBarIcons.DeleteObject(obj);
+ s_registered = true;
+ }
}
-bool wxTaskBarIcon::RegisterWindowClass()
-{
- if (sm_registeredClass)
- return TRUE;
-
- // Also register the taskbar message here
- sm_taskbarMsg = ::RegisterWindowMessage("wxTaskBarIconMessage");
-
- WNDCLASS wc;
- bool rc;
-
- HINSTANCE hInstance = GetModuleHandle(NULL);
-
- /*
- * set up and register window class
- */
- wc.style = CS_HREDRAW | CS_VREDRAW;
- wc.lpfnWndProc = (WNDPROC) wxTaskBarIconWindowProc;
- wc.cbClsExtra = 0;
- wc.cbWndExtra = 0;
- wc.hInstance = hInstance;
- wc.hIcon = 0;
- wc.hCursor = 0;
- wc.hbrBackground = 0;
- wc.lpszMenuName = NULL;
- wc.lpszClassName = wxTaskBarWindowClass ;
- rc = (::RegisterClass( &wc ) != 0);
-
- sm_registeredClass = (rc != 0);
-
- return( (rc != 0) );
-}
+// ----------------------------------------------------------------------------
+// wxTaskBarIcon window proc
+// ----------------------------------------------------------------------------
-WXHWND wxTaskBarIcon::CreateTaskBarWindow()
+long wxTaskBarIcon::WindowProc(unsigned int msg,
+ unsigned int WXUNUSED(wParam),
+ long lParam)
{
- HINSTANCE hInstance = GetModuleHandle(NULL);
-
- HWND hWnd = CreateWindowEx (0, wxTaskBarWindowClass,
- "wxTaskBarWindow",
- WS_OVERLAPPED,
- 0,
- 0,
- 10,
- 10,
- NULL,
- (HMENU) 0,
- hInstance,
- NULL);
-
- return (WXHWND) hWnd;
-}
+ wxEventType eventType = 0;
-long wxTaskBarIcon::WindowProc( WXHWND hWnd, unsigned int msg, unsigned int wParam, long lParam )
-{
- if (msg != sm_taskbarMsg)
- return DefWindowProc((HWND) hWnd, msg, wParam, lParam);
+ if (msg == gs_msgRestartTaskbar) // does the icon need to be redrawn?
+ {
+ m_iconAdded = false;
+ SetIcon(m_icon, m_strTooltip);
+ }
+
+ // this function should only be called for gs_msg(Restart)Taskbar messages
+ wxASSERT(msg == gs_msgTaskbar);
switch (lParam)
{
- case WM_LBUTTONDOWN:
- OnLButtonDown();
- break;
+ case WM_LBUTTONDOWN:
+ eventType = wxEVT_TASKBAR_LEFT_DOWN;
+ break;
- case WM_LBUTTONUP:
- OnLButtonUp();
- break;
+ case WM_LBUTTONUP:
+ eventType = wxEVT_TASKBAR_LEFT_UP;
+ break;
- case WM_RBUTTONDOWN:
- OnRButtonDown();
- break;
+ case WM_RBUTTONDOWN:
+ eventType = wxEVT_TASKBAR_RIGHT_DOWN;
+ break;
- case WM_RBUTTONUP:
- OnRButtonUp();
- break;
+ case WM_RBUTTONUP:
+ eventType = wxEVT_TASKBAR_RIGHT_UP;
+ break;
- case WM_LBUTTONDBLCLK:
- OnLButtonDClick();
- break;
+ case WM_LBUTTONDBLCLK:
+ eventType = wxEVT_TASKBAR_LEFT_DCLICK;
+ break;
- case WM_RBUTTONDBLCLK:
- OnRButtonDClick();
- break;
+ case WM_RBUTTONDBLCLK:
+ eventType = wxEVT_TASKBAR_RIGHT_DCLICK;
+ break;
- case WM_MOUSEMOVE:
- OnMouseMove();
- break;
+ case WM_MOUSEMOVE:
+ eventType = wxEVT_TASKBAR_MOVE;
+ break;
+
+ default:
+ break;
+ }
+
+ if (eventType)
+ {
+ wxTaskBarIconEvent event(eventType, this);
+
+ ProcessEvent(event);
+ }
- default:
- break;
- }
return 0;
}
-LRESULT APIENTRY _EXPORT wxTaskBarIconWindowProc( HWND hWnd, unsigned msg,
- UINT wParam, LONG lParam )
-{
- wxTaskBarIcon* obj = wxTaskBarIcon::FindObjectForHWND((WXHWND) hWnd);
- if (obj)
- return obj->WindowProc((WXHWND) hWnd, msg, wParam, lParam);
- else
- return DefWindowProc(hWnd, msg, wParam, lParam);
-}
+#endif // wxUSE_TASKBARICON
-#endif
- // __WIN95__