X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/8907154c1a8a6882c6797d1f16393ddfb23e7f3a..dd9f8b6bb6935360a8271dc3e8749fb026b601a8:/src/msw/taskbar.cpp diff --git a/src/msw/taskbar.cpp b/src/msw/taskbar.cpp index ac7491bef0..cc52113434 100644 --- a/src/msw/taskbar.cpp +++ b/src/msw/taskbar.cpp @@ -1,5 +1,5 @@ ///////////////////////////////////////////////////////////////////////// -// File: taskbar.cpp +// File: src/msw/taskbar.cpp // Purpose: Implements wxTaskBarIcon class for manipulating icons on // the Windows task bar. // Author: Julian Smart @@ -14,53 +14,81 @@ #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" + #include "wx/window.h" + #include "wx/frame.h" + #include "wx/utils.h" + #include "wx/menu.h" #endif -#if defined(__WIN95__) - -#include "wx/msw/private.h" -#include "wx/msw/winundef.h" +#include "wx/msw/wrapshl.h" #include #include "wx/taskbar.h" +#include "wx/dynlib.h" -#ifdef __WXWINCE__ - #include - #include +#ifndef NIN_BALLOONTIMEOUT + #define NIN_BALLOONTIMEOUT 0x0404 + #define NIN_BALLOONUSERCLICK 0x0405 #endif -// initialized on demand -UINT gs_msgTaskbar = 0; -UINT gs_msgRestartTaskbar = 0; - -#if WXWIN_COMPATIBILITY_2_4 -BEGIN_EVENT_TABLE(wxTaskBarIcon, wxTaskBarIconBase) - EVT_TASKBAR_MOVE (wxTaskBarIcon::_OnMouseMove) - EVT_TASKBAR_LEFT_DOWN (wxTaskBarIcon::_OnLButtonDown) - EVT_TASKBAR_LEFT_UP (wxTaskBarIcon::_OnLButtonUp) - EVT_TASKBAR_RIGHT_DOWN (wxTaskBarIcon::_OnRButtonDown) - EVT_TASKBAR_RIGHT_UP (wxTaskBarIcon::_OnRButtonUp) - EVT_TASKBAR_LEFT_DCLICK (wxTaskBarIcon::_OnLButtonDClick) - EVT_TASKBAR_RIGHT_DCLICK (wxTaskBarIcon::_OnRButtonDClick) -END_EVENT_TABLE() +#ifndef NIM_SETVERSION + #define NIM_SETVERSION 0x00000004 +#endif + +#ifndef NIF_INFO + #define NIF_INFO 0x00000010 #endif +// initialized on demand +static UINT gs_msgTaskbar = 0; +static UINT gs_msgRestartTaskbar = 0; + + IMPLEMENT_DYNAMIC_CLASS(wxTaskBarIcon, wxEvtHandler) // ============================================================================ // implementation // ============================================================================ +// wrapper around Shell_NotifyIcon(): this function is not present in Win95 +// shell32.dll so load it dynamically to allow programs using wxTaskBarIcon to +// start under this OS +static BOOL wxShellNotifyIcon(DWORD dwMessage, NOTIFYICONDATA *pData) +{ +#if wxUSE_DYNLIB_CLASS + typedef BOOL (WINAPI *Shell_NotifyIcon_t)(DWORD, NOTIFYICONDATA *); + + static Shell_NotifyIcon_t s_pfnShell_NotifyIcon = NULL; + static bool s_initialized = false; + if ( !s_initialized ) + { + s_initialized = true; + + wxLogNull noLog; + wxDynamicLibrary dllShell("shell32.dll"); + if ( dllShell.IsLoaded() ) + { + wxDL_INIT_FUNC_AW(s_pfn, Shell_NotifyIcon, dllShell); + } + + // NB: it's ok to destroy dllShell here, we link to shell32.dll + // implicitly so it won't be unloaded + } + + return s_pfnShell_NotifyIcon ? (*s_pfnShell_NotifyIcon)(dwMessage, pData) + : FALSE; +#else // !wxUSE_DYNLIB_CLASS + return Shell_NotifyIcon(dwMessage, pData); +#endif // wxUSE_DYNLIB_CLASS/!wxUSE_DYNLIB_CLASS +} + // ---------------------------------------------------------------------------- // wxTaskBarIconWindow: helper window // ---------------------------------------------------------------------------- @@ -129,11 +157,17 @@ wxTaskBarIcon::wxTaskBarIcon() wxTaskBarIcon::~wxTaskBarIcon() { - if (m_iconAdded) + if ( m_iconAdded ) RemoveIcon(); - if (m_win) - m_win->Destroy(); + if ( m_win ) + { + // we must use delete and not Destroy() here because the latter will + // only schedule the window to be deleted during the next idle event + // processing but we may not get any idle events if there are no other + // windows left in the program + delete m_win; + } } // Operations @@ -150,7 +184,7 @@ bool wxTaskBarIcon::SetIcon(const wxIcon& icon, const wxString& tooltip) m_icon = icon; m_strTooltip = tooltip; - NotifyIconData notifyData((HWND)m_win->GetHWND()); + NotifyIconData notifyData(GetHwndOf(m_win)); if (icon.Ok()) { @@ -158,15 +192,16 @@ bool wxTaskBarIcon::SetIcon(const wxIcon& icon, const wxString& tooltip) notifyData.hIcon = GetHiconOf(icon); } + // 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, tooltip.c_str(), WXSIZEOF(notifyData.szTip)); - wxStrncpy(notifyData.szTip, tooltip.c_str(), WXSIZEOF(notifyData.szTip)); + wxStrncpy(notifyData.szTip, tooltip.wx_str(), WXSIZEOF(notifyData.szTip)); } - bool ok = Shell_NotifyIcon(m_iconAdded ? NIM_MODIFY - : NIM_ADD, ¬ifyData) != 0; + bool ok = wxShellNotifyIcon(m_iconAdded ? NIM_MODIFY + : NIM_ADD, ¬ifyData) != 0; if ( !m_iconAdded && ok ) m_iconAdded = true; @@ -174,6 +209,48 @@ bool wxTaskBarIcon::SetIcon(const wxIcon& icon, const wxString& tooltip) return ok; } +#if wxUSE_TASKBARICON_BALLOONS + +bool +wxTaskBarIcon::ShowBalloon(const wxString& title, + const wxString& text, + unsigned msec, + int flags) +{ + wxCHECK_MSG( m_iconAdded, false, + _T("can't be used before the icon is created") ); + + const HWND hwnd = GetHwndOf(m_win); + + // we need to enable version 5.0 behaviour to receive notifications about + // the balloon disappearance + NotifyIconData notifyData(hwnd); + notifyData.uFlags = 0; + notifyData.uVersion = 3 /* NOTIFYICON_VERSION for Windows XP */; + + wxShellNotifyIcon(NIM_SETVERSION, ¬ifyData); + + + // do show the balloon now + notifyData = NotifyIconData(hwnd); + notifyData.uFlags |= NIF_INFO; + notifyData.uTimeout = msec; + wxStrncpy(notifyData.szInfo, text.wx_str(), WXSIZEOF(notifyData.szInfo)); + wxStrncpy(notifyData.szInfoTitle, title.wx_str(), + WXSIZEOF(notifyData.szInfoTitle)); + + if ( flags & wxICON_INFORMATION ) + notifyData.dwInfoFlags |= NIIF_INFO; + else if ( flags & wxICON_WARNING ) + notifyData.dwInfoFlags |= NIIF_WARNING; + else if ( flags & wxICON_ERROR ) + notifyData.dwInfoFlags |= NIIF_ERROR; + + return wxShellNotifyIcon(NIM_MODIFY, ¬ifyData) != 0; +} + +#endif // wxUSE_TASKBARICON_BALLOONS + bool wxTaskBarIcon::RemoveIcon() { if (!m_iconAdded) @@ -181,11 +258,12 @@ bool wxTaskBarIcon::RemoveIcon() m_iconAdded = false; - NotifyIconData notifyData((HWND)m_win->GetHWND()); + NotifyIconData notifyData(GetHwndOf(m_win)); - return Shell_NotifyIcon(NIM_DELETE, ¬ifyData) != 0; + return wxShellNotifyIcon(NIM_DELETE, ¬ifyData) != 0; } +#if wxUSE_MENUS bool wxTaskBarIcon::PopupMenu(wxMenu *menu) { wxASSERT_MSG( m_win != NULL, _T("taskbar icon not initialized") ); @@ -206,13 +284,14 @@ bool wxTaskBarIcon::PopupMenu(wxMenu *menu) menu->UpdateUI(); - // Work around a WIN32 bug - ::SetForegroundWindow((HWND)m_win->GetHWND()); + // 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); - // Work around a WIN32 bug - ::PostMessage((HWND)m_win->GetHWND(), WM_NULL, 0, 0L); + ::PostMessage(GetHwndOf(m_win), WM_NULL, 0, 0L); m_win->PopEventHandler(false); @@ -220,32 +299,7 @@ bool wxTaskBarIcon::PopupMenu(wxMenu *menu) return rval; } - -#if WXWIN_COMPATIBILITY_2_4 -// Overridables -void wxTaskBarIcon::OnMouseMove(wxEvent& e) { e.Skip(); } -void wxTaskBarIcon::OnLButtonDown(wxEvent& e) { e.Skip(); } -void wxTaskBarIcon::OnLButtonUp(wxEvent& e) { e.Skip(); } -void wxTaskBarIcon::OnRButtonDown(wxEvent& e) { e.Skip(); } -void wxTaskBarIcon::OnRButtonUp(wxEvent& e) { e.Skip(); } -void wxTaskBarIcon::OnLButtonDClick(wxEvent& e) { e.Skip(); } -void wxTaskBarIcon::OnRButtonDClick(wxEvent& e) { e.Skip(); } - -void wxTaskBarIcon::_OnMouseMove(wxTaskBarIconEvent& e) - { OnMouseMove(e); } -void wxTaskBarIcon::_OnLButtonDown(wxTaskBarIconEvent& e) - { OnLButtonDown(e); } -void wxTaskBarIcon::_OnLButtonUp(wxTaskBarIconEvent& e) - { OnLButtonUp(e); } -void wxTaskBarIcon::_OnRButtonDown(wxTaskBarIconEvent& e) - { OnRButtonDown(e); } -void wxTaskBarIcon::_OnRButtonUp(wxTaskBarIconEvent& e) - { OnRButtonUp(e); } -void wxTaskBarIcon::_OnLButtonDClick(wxTaskBarIconEvent& e) - { OnLButtonDClick(e); } -void wxTaskBarIcon::_OnRButtonDClick(wxTaskBarIconEvent& e) - { OnRButtonDClick(e); } -#endif +#endif // wxUSE_MENUS void wxTaskBarIcon::RegisterWindowMessages() { @@ -271,18 +325,18 @@ long wxTaskBarIcon::WindowProc(unsigned int msg, unsigned int WXUNUSED(wParam), long lParam) { - wxEventType eventType = 0; - - if (msg == gs_msgRestartTaskbar) // does the icon need to be redrawn? + if ( msg == gs_msgRestartTaskbar ) // does the icon need to be redrawn? { m_iconAdded = false; SetIcon(m_icon, m_strTooltip); + return 0; } // this function should only be called for gs_msg(Restart)Taskbar messages - wxASSERT(msg == gs_msgTaskbar); + wxASSERT( msg == gs_msgTaskbar ); - switch (lParam) + wxEventType eventType = 0; + switch ( lParam ) { case WM_LBUTTONDOWN: eventType = wxEVT_TASKBAR_LEFT_DOWN; @@ -312,11 +366,16 @@ long wxTaskBarIcon::WindowProc(unsigned int msg, eventType = wxEVT_TASKBAR_MOVE; break; - default: + case NIN_BALLOONTIMEOUT: + eventType = wxEVT_TASKBAR_BALLOON_TIMEOUT; + break; + + case NIN_BALLOONUSERCLICK: + eventType = wxEVT_TASKBAR_BALLOON_CLICK; break; } - if (eventType) + if ( eventType ) { wxTaskBarIconEvent event(eventType, this); @@ -326,4 +385,5 @@ long wxTaskBarIcon::WindowProc(unsigned int msg, return 0; } -#endif // __WIN95__ +#endif // wxUSE_TASKBARICON +