2005-05-04 14:57:50 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: wx/taskbar.h
|
|
|
|
// Purpose: wxTaskBarIcon base header and class
|
|
|
|
// Author: Julian Smart
|
|
|
|
// Modified by:
|
|
|
|
// Created:
|
|
|
|
// Copyright: (c) Julian Smart
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Licence: wxWindows licence
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
1998-08-14 20:23:28 -04:00
|
|
|
#ifndef _WX_TASKBAR_H_BASE_
|
|
|
|
#define _WX_TASKBAR_H_BASE_
|
|
|
|
|
2003-06-19 18:14:06 -04:00
|
|
|
#include "wx/defs.h"
|
|
|
|
|
2007-07-18 21:02:28 -04:00
|
|
|
#if wxUSE_TASKBARICON
|
2003-06-19 18:14:06 -04:00
|
|
|
|
2003-04-04 17:33:47 -05:00
|
|
|
#include "wx/event.h"
|
|
|
|
|
2007-07-09 06:09:52 -04:00
|
|
|
class WXDLLIMPEXP_FWD_ADV wxTaskBarIconEvent;
|
2004-06-04 17:56:29 -04:00
|
|
|
|
2003-04-04 17:33:47 -05:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxTaskBarIconBase: define wxTaskBarIcon interface
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
2003-08-02 09:52:31 -04:00
|
|
|
class WXDLLIMPEXP_ADV wxTaskBarIconBase : public wxEvtHandler
|
2003-04-04 17:33:47 -05:00
|
|
|
{
|
2003-07-21 20:24:07 -04:00
|
|
|
public:
|
|
|
|
wxTaskBarIconBase() { }
|
2004-09-23 14:20:56 -04:00
|
|
|
|
2008-09-30 16:54:02 -04:00
|
|
|
#if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__)
|
|
|
|
static bool IsAvailable();
|
|
|
|
#else
|
|
|
|
static bool IsAvailable() { return true; };
|
|
|
|
#endif
|
|
|
|
|
2004-06-04 17:56:29 -04:00
|
|
|
// Operations:
|
|
|
|
virtual bool SetIcon(const wxIcon& icon,
|
|
|
|
const wxString& tooltip = wxEmptyString) = 0;
|
|
|
|
virtual bool RemoveIcon() = 0;
|
|
|
|
virtual bool PopupMenu(wxMenu *menu) = 0;
|
|
|
|
|
2007-08-14 18:43:39 -04:00
|
|
|
// delayed destruction (similarly to wxWindow::Destroy())
|
|
|
|
void Destroy();
|
|
|
|
|
2004-06-04 17:56:29 -04:00
|
|
|
protected:
|
|
|
|
// creates menu to be displayed when user clicks on the icon
|
|
|
|
virtual wxMenu *CreatePopupMenu() { return NULL; }
|
2004-09-23 14:20:56 -04:00
|
|
|
|
2003-07-21 20:24:07 -04:00
|
|
|
private:
|
2004-06-04 17:56:29 -04:00
|
|
|
// default events handling, calls CreatePopupMenu:
|
2004-06-05 10:19:35 -04:00
|
|
|
void OnRightButtonDown(wxTaskBarIconEvent& event);
|
2004-09-23 14:20:56 -04:00
|
|
|
|
2004-06-04 17:56:29 -04:00
|
|
|
DECLARE_EVENT_TABLE()
|
2009-02-08 06:45:59 -05:00
|
|
|
wxDECLARE_NO_COPY_CLASS(wxTaskBarIconBase);
|
2003-04-04 17:33:47 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// now include the actual class declaration
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
2004-12-20 07:44:22 -05:00
|
|
|
#if defined(__WXPALMOS__)
|
2004-10-19 09:40:30 -04:00
|
|
|
#include "wx/palmos/taskbar.h"
|
|
|
|
#elif defined(__WXMSW__)
|
2003-04-04 17:33:47 -05:00
|
|
|
#include "wx/msw/taskbar.h"
|
2009-02-09 22:43:30 -05:00
|
|
|
#elif defined(__WXGTK20__)
|
2009-02-08 17:21:24 -05:00
|
|
|
#include "wx/gtk/taskbar.h"
|
2003-04-05 17:27:47 -05:00
|
|
|
#elif defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__)
|
|
|
|
#include "wx/unix/taskbarx11.h"
|
2008-01-27 08:21:39 -05:00
|
|
|
#elif defined (__WXMAC__)
|
2008-06-11 15:17:41 -04:00
|
|
|
#include "wx/osx/taskbarosx.h"
|
2004-10-15 18:52:28 -04:00
|
|
|
#elif defined (__WXCOCOA__)
|
|
|
|
#include "wx/cocoa/taskbar.h"
|
1998-08-14 20:23:28 -04:00
|
|
|
#endif
|
|
|
|
|
2003-04-04 17:33:47 -05:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxTaskBarIcon events
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
2003-08-02 09:52:31 -04:00
|
|
|
class WXDLLIMPEXP_ADV wxTaskBarIconEvent : public wxEvent
|
2003-04-04 17:33:47 -05:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
wxTaskBarIconEvent(wxEventType evtType, wxTaskBarIcon *tbIcon)
|
2004-09-23 14:20:56 -04:00
|
|
|
: wxEvent(wxID_ANY, evtType)
|
2003-04-04 17:33:47 -05:00
|
|
|
{
|
|
|
|
SetEventObject(tbIcon);
|
|
|
|
}
|
|
|
|
|
|
|
|
virtual wxEvent *Clone() const { return new wxTaskBarIconEvent(*this); }
|
2003-07-21 20:24:07 -04:00
|
|
|
|
|
|
|
private:
|
2009-02-08 06:45:59 -05:00
|
|
|
wxDECLARE_NO_ASSIGN_CLASS(wxTaskBarIconEvent);
|
2003-04-04 17:33:47 -05:00
|
|
|
};
|
|
|
|
|
2004-06-05 10:19:35 -04:00
|
|
|
typedef void (wxEvtHandler::*wxTaskBarIconEventFunction)(wxTaskBarIconEvent&);
|
|
|
|
|
2009-02-07 13:59:25 -05:00
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_MOVE, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_LEFT_DOWN, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_LEFT_UP, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_RIGHT_DOWN, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_RIGHT_UP, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_LEFT_DCLICK, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_RIGHT_DCLICK, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_BALLOON_TIMEOUT, wxTaskBarIconEvent );
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_ADV, wxEVT_TASKBAR_BALLOON_CLICK, wxTaskBarIconEvent );
|
2003-04-04 17:33:47 -05:00
|
|
|
|
2005-02-14 18:53:48 -05:00
|
|
|
#define wxTaskBarIconEventHandler(func) \
|
2009-01-12 09:26:13 -05:00
|
|
|
wxEVENT_HANDLER_CAST(wxTaskBarIconEventFunction, func)
|
2005-02-14 18:53:48 -05:00
|
|
|
|
|
|
|
#define wx__DECLARE_TASKBAREVT(evt, fn) \
|
|
|
|
wx__DECLARE_EVT0(wxEVT_TASKBAR_ ## evt, wxTaskBarIconEventHandler(fn))
|
|
|
|
|
|
|
|
#define EVT_TASKBAR_MOVE(fn) wx__DECLARE_TASKBAREVT(MOVE, fn)
|
|
|
|
#define EVT_TASKBAR_LEFT_DOWN(fn) wx__DECLARE_TASKBAREVT(LEFT_DOWN, fn)
|
|
|
|
#define EVT_TASKBAR_LEFT_UP(fn) wx__DECLARE_TASKBAREVT(LEFT_UP, fn)
|
|
|
|
#define EVT_TASKBAR_RIGHT_DOWN(fn) wx__DECLARE_TASKBAREVT(RIGHT_DOWN, fn)
|
|
|
|
#define EVT_TASKBAR_RIGHT_UP(fn) wx__DECLARE_TASKBAREVT(RIGHT_UP, fn)
|
|
|
|
#define EVT_TASKBAR_LEFT_DCLICK(fn) wx__DECLARE_TASKBAREVT(LEFT_DCLICK, fn)
|
|
|
|
#define EVT_TASKBAR_RIGHT_DCLICK(fn) wx__DECLARE_TASKBAREVT(RIGHT_DCLICK, fn)
|
2003-04-04 17:33:47 -05:00
|
|
|
|
2007-01-07 14:44:14 -05:00
|
|
|
// taskbar menu is shown on right button press under all platforms except MSW
|
|
|
|
// where it's shown on right button release, using this event type and macro
|
|
|
|
// allows to write code which works correctly on all platforms
|
|
|
|
#ifdef __WXMSW__
|
|
|
|
#define wxEVT_TASKBAR_CLICK wxEVT_TASKBAR_RIGHT_UP
|
|
|
|
#else
|
|
|
|
#define wxEVT_TASKBAR_CLICK wxEVT_TASKBAR_RIGHT_DOWN
|
2003-04-06 22:21:10 -04:00
|
|
|
#endif
|
2007-01-07 14:44:14 -05:00
|
|
|
#define EVT_TASKBAR_CLICK(fn) wx__DECLARE_TASKBAREVT(CLICK, fn)
|
2003-06-19 18:14:06 -04:00
|
|
|
|
2007-12-01 17:48:06 -05:00
|
|
|
// these events are currently generated only under wxMSW and only after (MSW-
|
|
|
|
// specific) ShowBalloon() had been called, don't use them in portable code
|
|
|
|
#define EVT_TASKBAR_BALLOON_TIMEOUT(fn) \
|
|
|
|
wx__DECLARE_TASKBAREVT(BALLOON_TIMEOUT, fn)
|
|
|
|
#define EVT_TASKBAR_BALLOON_CLICK(fn) \
|
|
|
|
wx__DECLARE_TASKBAREVT(BALLOON_CLICK, fn)
|
|
|
|
|
2007-07-18 21:02:28 -04:00
|
|
|
#endif // wxUSE_TASKBARICON
|
2007-01-07 14:44:14 -05:00
|
|
|
|
|
|
|
#endif // _WX_TASKBAR_H_BASE_
|