include/wx/fontpicker.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/fontpicker.h
   3 // Purpose:     wxFontPickerCtrl base header
   4 // Author:      Francesco Montorsi
   5 // Modified by:
   6 // Created:     14/4/2006
   7 // Copyright:   (c) Francesco Montorsi
   8 // RCS-ID:      $Id$
   9 // Licence:     wxWindows Licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_FONTPICKER_H_BASE_
  13 #define _WX_FONTPICKER_H_BASE_
  14
  15 #include "wx/defs.h"
  16
  17
  18 #if wxUSE_FONTPICKERCTRL
  19
  20 #include "wx/control.h"
  21 #include "wx/pickerbase.h"
  22
  23
  24 class WXDLLIMPEXP_CORE wxFontPickerEvent;
  25
  26 extern WXDLLEXPORT_DATA(const wxChar) wxFontPickerWidgetNameStr[];
  27 extern WXDLLEXPORT_DATA(const wxChar) wxFontPickerCtrlNameStr[];
  28
  29
  30 // ----------------------------------------------------------------------------
  31 // wxFontPickerWidgetBase: a generic abstract interface which must be
  32 //                         implemented by controls used by wxFontPickerCtrl
  33 // ----------------------------------------------------------------------------
  34
  35 class WXDLLIMPEXP_CORE wxFontPickerWidgetBase
  36 {
  37 public:
  38     wxFontPickerWidgetBase() { m_selectedFont = *wxNORMAL_FONT; }
  39     virtual ~wxFontPickerWidgetBase() {}
  40
  41     wxFont GetSelectedFont() const
  42         { return m_selectedFont; }
  43     virtual void SetSelectedFont(const wxFont &f)
  44         { m_selectedFont = f; UpdateFont(); }
  45
  46 protected:
  47
  48     virtual void UpdateFont() = 0;
  49
  50     // the current font (may be invalid if none)
  51     // NOTE: don't call this m_font as wxWindow::m_font already exists
  52     wxFont m_selectedFont;
  53 };
  54
  55 // Styles which must be supported by all controls implementing wxFontPickerWidgetBase
  56 // NB: these styles must be defined to carefully-chosen values to
  57 //     avoid conflicts with wxButton's styles
  58
  59
  60 // keeps the label of the button updated with the fontface name + font size
  61 // E.g. choosing "Times New Roman bold, italic with size 10" from the fontdialog,
  62 //      updates the wxFontButtonGeneric's label (overwriting any previous label)
  63 //      with the "Times New Roman, 10" text (only fontface + fontsize is displayed
  64 //      to avoid extralong labels).
  65 #define wxFNTP_FONTDESC_AS_LABEL      0x0008
  66
  67 // uses the currently selected font to draw the label of the button
  68 #define wxFNTP_USEFONT_FOR_LABEL      0x0010
  69
  70 #if defined(__WXGTK24__)        // since GTK > 2.4, there is GtkFontButton
  71     #include "wx/gtk/fontpicker.h"
  72     #define wxFontPickerWidget      wxFontButton
  73 #else
  74     #include "wx/generic/fontpickerg.h"
  75     #define wxFontPickerWidget      wxGenericFontButton
  76 #endif
  77
  78
  79 // ----------------------------------------------------------------------------
  80 // wxFontPickerCtrl specific flags
  81 // ----------------------------------------------------------------------------
  82
  83 #define wxFNTP_USE_TEXTCTRL       (wxPB_USE_TEXTCTRL)
  84 #define wxFNTP_DEFAULT_STYLE      (wxFNTP_FONTDESC_AS_LABEL|wxFNTP_USEFONT_FOR_LABEL)
  85
  86 // not a style but rather the default value of the maximum pointsize allowed
  87 #define wxFNTP_MAXPOINT_SIZE      100
  88
  89
  90 // ----------------------------------------------------------------------------
  91 // wxFontPickerCtrl: platform-independent class which embeds the
  92 // platform-dependent wxFontPickerWidget andm if wxFNTP_USE_TEXTCTRL style is
  93 // used, a textctrl next to it.
  94 // ----------------------------------------------------------------------------
  95
  96 class WXDLLIMPEXP_CORE wxFontPickerCtrl : public wxPickerBase
  97 {
  98 public:
  99     wxFontPickerCtrl()
 100         : m_bIgnoreNextTextCtrlUpdate(false),
 101         m_nMaxPointSize(wxFNTP_MAXPOINT_SIZE)
 102     {
 103     }
 104
 105     virtual ~wxFontPickerCtrl() {}
 106
 107
 108     wxFontPickerCtrl(wxWindow *parent,
 109                      wxWindowID id,
 110                      const wxFont& initial = *wxNORMAL_FONT,
 111                      const wxPoint& pos = wxDefaultPosition,
 112                      const wxSize& size = wxDefaultSize,
 113                      long style = wxFNTP_DEFAULT_STYLE,
 114                      const wxValidator& validator = wxDefaultValidator,
 115                      const wxString& name = wxFontPickerCtrlNameStr)
 116         : m_bIgnoreNextTextCtrlUpdate(false),
 117           m_nMaxPointSize(wxFNTP_MAXPOINT_SIZE)
 118     {
 119         Create(parent, id, initial, pos, size, style, validator, name);
 120     }
 121
 122     bool Create(wxWindow *parent,
 123                 wxWindowID id,
 124                 const wxFont& initial = *wxNORMAL_FONT,
 125                 const wxPoint& pos = wxDefaultPosition,
 126                 const wxSize& size = wxDefaultSize,
 127                 long style = wxFNTP_DEFAULT_STYLE,
 128                 const wxValidator& validator = wxDefaultValidator,
 129                 const wxString& name = wxFontPickerCtrlNameStr);
 130
 131
 132 public:         // public API
 133
 134     // get the font chosen
 135     wxFont GetSelectedFont() const
 136         { return ((wxFontPickerWidget *)m_picker)->GetSelectedFont(); }
 137
 138     // sets currently displayed font
 139     void SetSelectedFont(const wxFont& f);
 140
 141     // set/get the max pointsize
 142     void SetMaxPointSize(unsigned int max)
 143         { m_nMaxPointSize=max; }
 144     unsigned int GetMaxPointSize() const
 145         { return m_nMaxPointSize; }
 146
 147 public:        // internal functions
 148
 149     void UpdatePickerFromTextCtrl();
 150     void UpdateTextCtrlFromPicker();
 151
 152     // event handler for our picker
 153     void OnFontChange(wxFontPickerEvent &);
 154
 155     // used to convert wxString <-> wxFont
 156     virtual wxString Font2String(const wxFont &font);
 157     virtual wxFont String2Font(const wxString &font);
 158
 159     // extracts the style for our picker from wxFontPickerCtrl's style
 160     long GetPickerStyle(long style) const
 161         { return (style & (wxFNTP_FONTDESC_AS_LABEL|wxFNTP_USEFONT_FOR_LABEL)); }
 162
 163 protected:
 164
 165     // true if the next UpdateTextCtrl() call is to ignore
 166     bool m_bIgnoreNextTextCtrlUpdate;
 167
 168     // the maximum pointsize allowed to the user
 169     unsigned int m_nMaxPointSize;
 170
 171 private:
 172     DECLARE_DYNAMIC_CLASS(wxFontPickerCtrl)
 173 };
 174
 175
 176 // ----------------------------------------------------------------------------
 177 // wxFontPickerEvent: used by wxFontPickerCtrl only
 178 // ----------------------------------------------------------------------------
 179
 180 BEGIN_DECLARE_EVENT_TYPES()
 181     DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_CORE, wxEVT_COMMAND_FONTPICKER_CHANGED, 1102)
 182 END_DECLARE_EVENT_TYPES()
 183
 184 class WXDLLIMPEXP_CORE wxFontPickerEvent : public wxCommandEvent
 185 {
 186 public:
 187     wxFontPickerEvent() {}
 188     wxFontPickerEvent(wxObject *generator, int id, const wxFont &f)
 189         : wxCommandEvent(wxEVT_COMMAND_FONTPICKER_CHANGED, id),
 190           m_font(f)
 191     {
 192         SetEventObject(generator);
 193     }
 194
 195     wxFont GetFont() const { return m_font; }
 196     void SetFont(const wxFont &c) { m_font = c; }
 197
 198 private:
 199     wxFont m_font;
 200
 201     DECLARE_DYNAMIC_CLASS_NO_COPY(wxFontPickerEvent)
 202 };
 203
 204 // ----------------------------------------------------------------------------
 205 // event types and macros
 206 // ----------------------------------------------------------------------------
 207
 208 typedef void (wxEvtHandler::*wxFontPickerEventFunction)(wxFontPickerEvent&);
 209
 210 #define wxFontPickerEventHandler(func) \
 211     (wxObjectEventFunction)(wxEventFunction)wxStaticCastEvent(wxFontPickerEventFunction, &func)
 212
 213 #define EVT_FONTPICKER_CHANGED(id, fn) \
 214     wx__DECLARE_EVT1(wxEVT_COMMAND_FONTPICKER_CHANGED, id, wxFontPickerEventHandler(fn))
 215
 216 #ifdef _WX_DEFINE_DATE_EVENTS_
 217     DEFINE_EVENT_TYPE(wxEVT_COMMAND_FONTPICKER_CHANGED)
 218
 219     IMPLEMENT_DYNAMIC_CLASS(wxFontPickerEvent, wxCommandEvent)
 220 #endif
 221
 222
 223
 224 #endif // wxUSE_FONTPICKERCTRL
 225
 226 #endif
 227     // _WX_FONTPICKER_H_BASE_