include/wx/msw/taskbar.h

   1 /////////////////////////////////////////////////////////////////////////
   2 // File:        wx/msw/taskbar.h
   3 // Purpose:     Defines wxTaskBarIcon class for manipulating icons on the
   4 //              Windows task bar.
   5 // Author:      Julian Smart
   6 // Modified by: Vaclav Slavik
   7 // Created:     24/3/98
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) Julian Smart
  10 // Licence:     wxWindows licence
  11 /////////////////////////////////////////////////////////////////////////
  12
  13 #ifndef _WX_TASKBAR_H_
  14 #define _WX_TASKBAR_H_
  15
  16 #include "wx/icon.h"
  17
  18 // private helper class:
  19 class WXDLLIMPEXP_FWD_ADV wxTaskBarIconWindow;
  20
  21 class WXDLLIMPEXP_ADV wxTaskBarIcon : public wxTaskBarIconBase
  22 {
  23 public:
  24     wxTaskBarIcon();
  25     virtual ~wxTaskBarIcon();
  26
  27     // Accessors
  28     bool IsOk() const { return true; }
  29     bool IsIconInstalled() const { return m_iconAdded; }
  30
  31     // Operations
  32     bool SetIcon(const wxIcon& icon, const wxString& tooltip = wxEmptyString);
  33     bool RemoveIcon(void);
  34     bool PopupMenu(wxMenu *menu);
  35
  36     // MSW-specific class methods
  37
  38     // show a balloon notification (the icon must have been already initialized
  39     // using SetIcon)
  40     //
  41     // title and text are limited to 63 and 255 characters respectively, msec
  42     // is the timeout, in milliseconds, before the balloon disappears (will be
  43     // clamped down to the allowed 10-30s range by Windows if it's outside it)
  44     // and flags can include wxICON_ERROR/INFO/WARNING to show a corresponding
  45     // icon
  46     //
  47     // return true if balloon was shown, false on error (incorrect parameters
  48     // or function unsupported by OS)
  49     bool ShowBalloon(const wxString& title,
  50                      const wxString& text,
  51                      unsigned msec = 0,
  52                      int flags = 0);
  53
  54 protected:
  55     friend class wxTaskBarIconWindow;
  56
  57     long WindowProc(unsigned int msg, unsigned int wParam, long lParam);
  58     void RegisterWindowMessages();
  59
  60
  61     wxTaskBarIconWindow *m_win;
  62     bool                 m_iconAdded;
  63     wxIcon               m_icon;
  64     wxString             m_strTooltip;
  65
  66     DECLARE_DYNAMIC_CLASS_NO_COPY(wxTaskBarIcon)
  67 };
  68
  69 #endif // _WX_TASKBAR_H_