include/wx/msw/icon.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/msw/icon.h
   3 // Purpose:     wxIcon class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_ICON_H_
  13 #define _WX_ICON_H_
  14
  15 // ----------------------------------------------------------------------------
  16 // headers
  17 // ----------------------------------------------------------------------------
  18
  19 #include "wx/msw/gdiimage.h"
  20
  21 // ---------------------------------------------------------------------------
  22 // icon data
  23 // ---------------------------------------------------------------------------
  24
  25 // notice that although wxIconRefData inherits from wxBitmapRefData, it is not
  26 // a valid wxBitmapRefData
  27 class WXDLLEXPORT wxIconRefData : public wxGDIImageRefData
  28 {
  29 public:
  30     wxIconRefData() { }
  31     virtual ~wxIconRefData() { Free(); }
  32
  33     virtual void Free();
  34 };
  35
  36 // ---------------------------------------------------------------------------
  37 // Icon
  38 // ---------------------------------------------------------------------------
  39
  40 class WXDLLEXPORT wxIcon : public wxGDIImage
  41 {
  42 public:
  43     // ctors
  44         // default
  45     wxIcon() { }
  46
  47         // from raw data
  48     wxIcon(const char bits[], int width, int height);
  49
  50         // from XPM data
  51     wxIcon(const char **data) { CreateIconFromXpm(data); }
  52
  53     wxIcon(char **data) { CreateIconFromXpm((const char **)data); }
  54
  55         // from resource/file
  56     wxIcon(const wxString& name,
  57            long type = wxBITMAP_TYPE_ICO_RESOURCE,
  58            int desiredWidth = -1, int desiredHeight = -1);
  59
  60     wxIcon(const wxIconLocation& loc);
  61
  62     virtual ~wxIcon();
  63
  64     virtual bool LoadFile(const wxString& name,
  65                           long type = wxBITMAP_TYPE_ICO_RESOURCE,
  66                           int desiredWidth = -1, int desiredHeight = -1);
  67
  68     bool operator == (const wxIcon& icon) const
  69         { return m_refData == icon.m_refData; }
  70     bool operator != (const wxIcon& icon) const
  71         { return m_refData != icon.m_refData; }
  72
  73     // implementation only from now on
  74     wxIconRefData *GetIconData() const { return (wxIconRefData *)m_refData; }
  75
  76     void SetHICON(WXHICON icon) { SetHandle((WXHANDLE)icon); }
  77     WXHICON GetHICON() const { return (WXHICON)GetHandle(); }
  78
  79     // create from bitmap (which should have a mask unless it's monochrome):
  80     // there shouldn't be any implicit bitmap -> icon conversion (i.e. no
  81     // ctors, assignment operators...), but it's ok to have such function
  82     void CopyFromBitmap(const wxBitmap& bmp);
  83
  84 protected:
  85     virtual wxGDIImageRefData *CreateData() const
  86     {
  87         return new wxIconRefData;
  88     }
  89
  90     virtual wxObjectRefData *CloneRefData(const wxObjectRefData *data) const;
  91
  92     // create from XPM data
  93     void CreateIconFromXpm(const char **data);
  94
  95 private:
  96     DECLARE_DYNAMIC_CLASS(wxIcon)
  97 };
  98
  99 #endif
 100     // _WX_ICON_H_