src/common/pickerbase.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/common/pickerbase.cpp
   3 // Purpose:     wxPickerBase class implementation
   4 // Author:      Francesco Montorsi
   5 // Modified by:
   6 // Created:     15/04/2006
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Francesco Montorsi
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24     #pragma hdrstop
  25 #endif
  26
  27 #if wxUSE_COLOURPICKERCTRL || \
  28     wxUSE_DIRPICKERCTRL    || \
  29     wxUSE_FILEPICKERCTRL   || \
  30     wxUSE_FONTPICKERCTRL
  31
  32 #include "wx/pickerbase.h"
  33 #include "wx/tooltip.h"
  34
  35 #ifndef WX_PRECOMP
  36     #include "wx/textctrl.h"
  37 #endif
  38
  39
  40 // ============================================================================
  41 // implementation
  42 // ============================================================================
  43
  44 IMPLEMENT_ABSTRACT_CLASS(wxPickerBase, wxControl)
  45
  46 BEGIN_EVENT_TABLE(wxPickerBase, wxControl)
  47     EVT_SIZE(wxPickerBase::OnSize)
  48     WX_EVENT_TABLE_CONTROL_CONTAINER(wxPickerBase)
  49 END_EVENT_TABLE()
  50 WX_DELEGATE_TO_CONTROL_CONTAINER(wxPickerBase, wxControl)
  51
  52
  53 // ----------------------------------------------------------------------------
  54 // wxPickerBase
  55 // ----------------------------------------------------------------------------
  56
  57 bool wxPickerBase::CreateBase(wxWindow *parent,
  58                          wxWindowID id,
  59                          const wxString &text,
  60                          const wxPoint& pos,
  61                          const wxSize& size,
  62                          long style,
  63                          const wxValidator& validator,
  64                          const wxString& name)
  65 {
  66     // remove any border style from our style as wxPickerBase's window must be
  67     // invisible (user styles must be set on the textctrl or the platform-dependent picker)
  68     style &= ~wxBORDER_MASK;
  69
  70     if (!wxControl::Create(parent, id, pos, size, style | wxNO_BORDER | wxTAB_TRAVERSAL,
  71                            validator, name))
  72         return false;
  73
  74     SetMinSize( size );
  75
  76     m_sizer = new wxBoxSizer(wxHORIZONTAL);
  77
  78     if (HasFlag(wxPB_USE_TEXTCTRL))
  79     {
  80         // NOTE: the style of this class (wxPickerBase) and the style of the
  81         //       attached text control are different: GetTextCtrlStyle() extracts
  82         //       the styles related to the textctrl from the styles passed here
  83         m_text = new wxTextCtrl(this, wxID_ANY, wxEmptyString,
  84                                 wxDefaultPosition, wxDefaultSize,
  85                                 GetTextCtrlStyle(style));
  86         if (!m_text)
  87         {
  88             wxFAIL_MSG( wxT("wxPickerBase's textctrl creation failed") );
  89             return false;
  90         }
  91
  92         // set the maximum lenght allowed for this textctrl.
  93         // This is very important since any change to it will trigger an update in
  94         // the m_picker; for very long strings, this real-time synchronization could
  95         // become a CPU-blocker and thus should be avoided.
  96         // 32 characters will be more than enough for all common uses.
  97         m_text->SetMaxLength(32);
  98
  99         // set the initial contents of the textctrl
 100         m_text->SetValue(text);
 101
 102         m_text->Connect(m_text->GetId(), wxEVT_COMMAND_TEXT_UPDATED,
 103                 wxCommandEventHandler(wxPickerBase::OnTextCtrlUpdate),
 104                 NULL, this);
 105         m_text->Connect(m_text->GetId(), wxEVT_KILL_FOCUS,
 106                 wxFocusEventHandler(wxPickerBase::OnTextCtrlKillFocus),
 107                 NULL, this);
 108
 109         m_text->Connect(m_text->GetId(), wxEVT_DESTROY,
 110                 wxWindowDestroyEventHandler(wxPickerBase::OnTextCtrlDelete),
 111                 NULL, this);
 112
 113         // the text control's proportion values defaults to 2
 114         m_sizer->Add(m_text, 2, GetDefaultTextCtrlFlag(), 5);
 115     }
 116
 117     return true;
 118 }
 119
 120 void wxPickerBase::PostCreation()
 121 {
 122     // the picker's proportion value defaults to 1 when there's no text control
 123     // associated with it - in that case it defaults to 0
 124     m_sizer->Add(m_picker, HasTextCtrl() ? 0 : 1, GetDefaultPickerCtrlFlag(), 5);
 125
 126     // For aesthetic reasons, make sure the picker is at least as high as the
 127     // associated text control and is always at least square.
 128     const wxSize pickerBestSize(m_picker->GetBestSize());
 129     const wxSize textBestSize( HasTextCtrl() ? m_text->GetBestSize() : wxSize());
 130     wxSize pickerMinSize;
 131     pickerMinSize.y = wxMax(pickerBestSize.y, textBestSize.y);
 132     pickerMinSize.x = wxMax(pickerBestSize.x, pickerMinSize.y);
 133     if ( pickerMinSize != pickerBestSize )
 134         m_picker->SetMinSize(pickerMinSize);
 135
 136     SetSizer(m_sizer);
 137
 138     SetInitialSize( GetMinSize() );
 139 }
 140
 141 #if wxUSE_TOOLTIPS
 142
 143 void wxPickerBase::DoSetToolTip(wxToolTip *tip)
 144 {
 145     // don't set the tooltip on us but rather on our two child windows
 146     // as otherwise it would appear only when the cursor is placed on the
 147     // small area around the child windows which belong to wxPickerBase
 148     m_picker->SetToolTip(tip);
 149
 150     // do a copy as wxWindow will own the pointer we pass
 151     if ( m_text )
 152         m_text->SetToolTip(tip ? new wxToolTip(tip->GetTip()) : NULL);
 153 }
 154
 155 #endif // wxUSE_TOOLTIPS
 156
 157 // ----------------------------------------------------------------------------
 158 // wxPickerBase - event handlers
 159 // ----------------------------------------------------------------------------
 160
 161 void wxPickerBase::OnTextCtrlKillFocus(wxFocusEvent& event)
 162 {
 163     event.Skip();
 164
 165     // don't leave the textctrl empty
 166     if (m_text && m_text->GetValue().empty())
 167         UpdateTextCtrlFromPicker();
 168 }
 169
 170 void wxPickerBase::OnTextCtrlDelete(wxWindowDestroyEvent &)
 171 {
 172     // the textctrl has been deleted; our pointer is invalid!
 173     m_text = NULL;
 174 }
 175
 176 void wxPickerBase::OnTextCtrlUpdate(wxCommandEvent &)
 177 {
 178     // for each text-change, update the picker
 179     UpdatePickerFromTextCtrl();
 180 }
 181
 182 void wxPickerBase::OnSize(wxSizeEvent &event)
 183 {
 184     if (GetAutoLayout())
 185         Layout();
 186     event.Skip();
 187 }
 188
 189 #endif // Any picker in use