include/wx/ownerdrw.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        ownerdrw.h
   3 // Purpose:     interface for owner-drawn GUI elements
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     11.11.97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef   _OWNERDRW_H
  13 #define   _OWNERDRW_H
  14
  15 #include "wx/defs.h"
  16
  17 #if wxUSE_OWNER_DRAWN
  18
  19 #include "wx/bitmap.h"
  20 #include "wx/colour.h"
  21 #include "wx/font.h"
  22
  23 // ----------------------------------------------------------------------------
  24 // wxOwnerDrawn - a mix-in base class, derive from it to implement owner-drawn
  25 //                behaviour
  26 //
  27 // wxOwnerDrawn supports drawing of an item with non standard font, color and
  28 // also supports 3 bitmaps: either a checked/unchecked bitmap for a checkable
  29 // element or one unchangeable bitmap otherwise.
  30 // ----------------------------------------------------------------------------
  31
  32 class WXDLLIMPEXP_CORE wxOwnerDrawn
  33 {
  34 public:
  35   // ctor & dtor
  36   wxOwnerDrawn(const wxString& str = wxEmptyString,
  37                bool bCheckable = false,
  38                bool bMenuItem = false); // FIXME kludge for colors
  39   virtual ~wxOwnerDrawn();
  40
  41   // fix appearance
  42   void SetFont(const wxFont& font)
  43       { m_font = font; m_bOwnerDrawn = true; }
  44
  45   wxFont& GetFont() const { return (wxFont &)m_font; }
  46
  47   void SetTextColour(const wxColour& colText)
  48       { m_colText = colText; m_bOwnerDrawn = true; }
  49
  50   wxColour& GetTextColour() const { return (wxColour&) m_colText; }
  51
  52   void SetBackgroundColour(const wxColour& colBack)
  53       { m_colBack = colBack; m_bOwnerDrawn = true; }
  54
  55   wxColour& GetBackgroundColour() const
  56       { return (wxColour&) m_colBack ; }
  57
  58   void SetBitmaps(const wxBitmap& bmpChecked,
  59                   const wxBitmap& bmpUnchecked = wxNullBitmap)
  60       { m_bmpChecked = bmpChecked;
  61         m_bmpUnchecked = bmpUnchecked;
  62         m_bOwnerDrawn = true; }
  63
  64   void SetBitmap(const wxBitmap& bmp, bool bChecked = true)
  65   {
  66       if ( bChecked )
  67           m_bmpChecked = bmp;
  68       else
  69           m_bmpUnchecked = bmp;
  70       m_bOwnerDrawn = true;
  71   }
  72
  73   void SetDisabledBitmap( const wxBitmap& bmpDisabled )
  74       { m_bmpDisabled = bmpDisabled;
  75         m_bOwnerDrawn = true; }
  76
  77   const wxBitmap& GetBitmap(bool bChecked = true) const
  78       { return (bChecked ? m_bmpChecked : m_bmpUnchecked); }
  79
  80   const wxBitmap& GetDisabledBitmap() const
  81       { return m_bmpDisabled; }
  82
  83   // the height of the menu checkmark (or bitmap) is determined by the font
  84   // for the current item, but the width should be always the same (for the
  85   // items to be aligned), so by default it's taken to be the same as for
  86   // the last item (and default width for the first one).
  87   //
  88   // NB: default is too small for bitmaps, but ok for checkmarks.
  89   void SetMarginWidth(int nWidth)
  90   {
  91       ms_nLastMarginWidth = m_nMarginWidth = (size_t) nWidth;
  92       if ( ((size_t) nWidth) != ms_nDefaultMarginWidth )
  93           m_bOwnerDrawn = true;
  94   }
  95
  96   int GetMarginWidth() const { return (int) m_nMarginWidth; }
  97   static int GetDefaultMarginWidth() { return (int) ms_nDefaultMarginWidth; }
  98
  99   // accessors
 100   void SetName(const wxString& strName)  { m_strName = strName; }
 101   const wxString& GetName() const { return m_strName;    }
 102   void SetCheckable(bool checkable) { m_bCheckable = checkable; }
 103   bool IsCheckable() const { return m_bCheckable; }
 104
 105   // this is for menu items only: accel string is drawn right aligned after the
 106   // menu item if not empty
 107   void SetAccelString(const wxString& strAccel) { m_strAccel = strAccel; }
 108
 109   // this function might seem strange, but if it returns false it means that
 110   // no non-standard attribute are set, so there is no need for this control
 111   // to be owner-drawn. Moreover, you can force owner-drawn to false if you
 112   // want to change, say, the color for the item but only if it is owner-drawn
 113   // (see wxMenuItem::wxMenuItem for example)
 114   bool IsOwnerDrawn() const { return m_bOwnerDrawn;   }
 115
 116   // switch on/off owner-drawing the item
 117   void SetOwnerDrawn(bool ownerDrawn = true) { m_bOwnerDrawn = ownerDrawn; }
 118   void ResetOwnerDrawn() { m_bOwnerDrawn = false;  }
 119
 120 public:
 121   // constants used in OnDrawItem
 122   // (they have the same values as corresponding Win32 constants)
 123   enum wxODAction
 124   {
 125     wxODDrawAll       = 0x0001,   // redraw entire control
 126     wxODSelectChanged = 0x0002,   // selection changed (see Status.Select)
 127     wxODFocusChanged  = 0x0004    // keyboard focus changed (see Status.Focus)
 128   };
 129
 130   enum wxODStatus
 131   {
 132     wxODSelected  = 0x0001,         // control is currently selected
 133     wxODGrayed    = 0x0002,         // item is to be grayed
 134     wxODDisabled  = 0x0004,         // item is to be drawn as disabled
 135     wxODChecked   = 0x0008,         // item is to be checked
 136     wxODHasFocus  = 0x0010,         // item has the keyboard focus
 137     wxODDefault   = 0x0020,         // item is the default item
 138     wxODHidePrefix= 0x0100          // hide keyboard cues (w2k and xp only)
 139   };
 140
 141   // virtual functions to implement drawing (return true if processed)
 142   virtual bool OnMeasureItem(size_t *pwidth, size_t *pheight);
 143   virtual bool OnDrawItem(wxDC& dc, const wxRect& rc, wxODAction act, wxODStatus stat);
 144
 145 protected:
 146   // return true if this is a menu item
 147   bool IsMenuItem() const;
 148
 149   // get the font to use, whether m_font is set or not
 150   wxFont GetFontToUse() const;
 151
 152
 153   wxString  m_strName,      // label for a manu item
 154             m_strAccel;     // the accel string ("Ctrl-F17") if any
 155
 156 private:
 157   static size_t ms_nDefaultMarginWidth; // menu check mark width
 158   static size_t ms_nLastMarginWidth;    // handy for aligning all items
 159
 160   bool      m_bCheckable,   // used only for menu or check listbox items
 161             m_bOwnerDrawn,  // true if something is non standard
 162             m_isMenuItem;   // true if this is a menu item
 163
 164   wxFont    m_font;         // font to use for drawing
 165   wxColour  m_colText,      // color ----"---"---"----
 166             m_colBack;      // background color
 167   wxBitmap  m_bmpChecked,   // bitmap to put near the item
 168             m_bmpUnchecked, // (checked is used also for 'uncheckable' items)
 169             m_bmpDisabled;
 170
 171   size_t    m_nHeight,      // font height
 172             m_nMarginWidth; // space occupied by bitmap to the left of the item
 173 };
 174
 175 #endif // wxUSE_OWNER_DRAWN
 176
 177 #endif
 178   // _OWNERDRW_H