src/gtk/collpane.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/gtk/collpane.cpp
   3 // Purpose:     wxCollapsiblePane
   4 // Author:      Francesco Montorsi
   5 // Modified By:
   6 // Created:     8/10/2006
   7 // Id:          $Id$
   8 // Copyright:   (c) Francesco Montorsi
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12
  13 // ----------------------------------------------------------------------------
  14 // headers
  15 // ----------------------------------------------------------------------------
  16
  17 // For compilers that support precompilation, includes "wx.h".
  18 #include "wx/wxprec.h"
  19
  20 #if wxUSE_COLLPANE && !defined(__WXUNIVERSAL__)
  21
  22 #include "wx/collpane.h"
  23 #include "wx/toplevel.h"
  24 #include "wx/sizer.h"
  25 #include "wx/panel.h"
  26
  27 #include "wx/gtk/private.h"
  28
  29 // the lines below duplicate the same definitions in collpaneg.cpp, if we have
  30 // another implementation of this class we should extract them to a common file
  31
  32 const wxChar wxCollapsiblePaneNameStr[] = wxT("collapsiblePane");
  33
  34 DEFINE_EVENT_TYPE(wxEVT_COMMAND_COLLPANE_CHANGED)
  35
  36 IMPLEMENT_DYNAMIC_CLASS(wxCollapsiblePaneEvent, wxCommandEvent)
  37
  38 // ============================================================================
  39 // implementation
  40 // ============================================================================
  41
  42 //-----------------------------------------------------------------------------
  43 // "notify::expanded" signal
  44 //-----------------------------------------------------------------------------
  45
  46 extern "C" {
  47
  48 static void
  49 gtk_collapsiblepane_expanded_callback(GObject * WXUNUSED(object),
  50                                       GParamSpec * WXUNUSED(param_spec),
  51                                       wxCollapsiblePane *p)
  52 {
  53     // NB: unlike for the "activate" signal, when this callback is called, if
  54     //     we try to query the "collapsed" status through p->IsCollapsed(), we
  55     //     get the right value. I.e. here p->IsCollapsed() will return false if
  56     //     this callback has been called at the end of a collapsed->expanded
  57     //     transition and viceversa. Inside the "activate" signal callback
  58     //     p->IsCollapsed() would return the wrong value!
  59
  60     wxSize sz;
  61     if ( p->IsExpanded() )
  62     {
  63         // NB: we cannot use the p->GetBestSize() or p->GetMinSize() functions
  64         //     here as they would return the size for the collapsed expander
  65         //     even if the collapsed->expanded transition has already been
  66         //     completed; we solve this problem doing:
  67
  68         sz = p->m_szCollapsed;
  69
  70         wxSize panesz = p->GetPane()->GetBestSize();
  71         sz.x = wxMax(sz.x, panesz.x);
  72         sz.y += gtk_expander_get_spacing(GTK_EXPANDER(p->m_widget)) + panesz.y;
  73     }
  74     else // collapsed
  75     {
  76         // same problem described above: using p->Get[Best|Min]Size() here we
  77         // would get the size of the control when it is expanded even if the
  78         // expanded->collapsed transition should be complete now...
  79         // So, we use the size cached at control-creation time...
  80         sz = p->m_szCollapsed;
  81     }
  82
  83     // VERY IMPORTANT:
  84     // just calling
  85     //          p->OnStateChange(sz);
  86     // here would work work BUT:
  87     //     1) in the expanded->collapsed transition it provokes a lot of flickering
  88     //     2) in the collapsed->expanded transition using the "Change status" wxButton
  89     //        in samples/collpane application some strange warnings would be generated
  90     //        by the "clearlooks" theme, if that's your theme.
  91     //
  92     // So we prefer to use some GTK+ native optimized calls, which prevent too many resize
  93     // calculations to happen. Note that the following code has been very carefully designed
  94     // and tested - be VERY careful when changing it!
  95
  96     // 1) need to update our size hints
  97     // NB: this function call won't actually do any long operation
  98     //     (redraw/relayouting/resizing) so that it's flicker-free
  99     p->SetMinSize(sz);
 100
 101     if (p->HasFlag(wxCP_NO_TLW_RESIZE))
 102     {
 103         // fire an event
 104         wxCollapsiblePaneEvent ev(p, p->GetId(), p->IsCollapsed());
 105         p->HandleWindowEvent(ev);
 106
 107         // the user asked to explicitely handle the resizing itself...
 108         return;
 109     }
 110
 111     wxTopLevelWindow *
 112         top = wxDynamicCast(wxGetTopLevelParent(p), wxTopLevelWindow);
 113     if ( top && top->GetSizer() )
 114     {
 115         // 2) recalculate minimal size of the top window
 116         sz = top->GetSizer()->CalcMin();
 117
 118         if (top->m_mainWidget)
 119         {
 120             // 3) MAGIC HACK: if you ever used GtkExpander in a GTK+ program
 121             //    you know that this magic call is required to make it possible
 122             //    to shrink the top level window in the expanded->collapsed
 123             //    transition.  This may be sometimes undesired but *is*
 124             //    necessary and if you look carefully, all GTK+ programs using
 125             //    GtkExpander perform this trick (e.g. the standard "open file"
 126             //    dialog of GTK+>=2.4 is not resizeable when the expander is
 127             //    collapsed!)
 128             gtk_window_set_resizable (GTK_WINDOW (top->m_widget), p->IsExpanded());
 129
 130             // 4) set size hints
 131             top->SetMinClientSize(sz);
 132
 133             // 5) set size
 134             top->SetClientSize(sz);
 135         }
 136     }
 137
 138     if ( p->m_bIgnoreNextChange )
 139     {
 140         // change generated programmatically - do not send an event!
 141         p->m_bIgnoreNextChange = false;
 142         return;
 143     }
 144
 145     // fire an event
 146     wxCollapsiblePaneEvent ev(p, p->GetId(), p->IsCollapsed());
 147     p->HandleWindowEvent(ev);
 148 }
 149 }
 150
 151 static void
 152 gtk_collapsiblepane_insert_callback(wxWindowGTK* parent, wxWindowGTK* child)
 153 {
 154     // this callback should be used only once to insert the "pane" into the
 155     // GtkExpander widget. wxGenericCollapsiblePane::DoAddChild() will check if
 156     // it has been called only once (and in any case we would get a warning
 157     // from the following call as GtkExpander is a GtkBin and can contain only
 158     // a single child!).
 159     gtk_container_add (GTK_CONTAINER (parent->m_widget), child->m_widget);
 160 }
 161
 162 //-----------------------------------------------------------------------------
 163 // wxCollapsiblePane
 164 //-----------------------------------------------------------------------------
 165
 166 IMPLEMENT_DYNAMIC_CLASS(wxCollapsiblePane, wxControl)
 167
 168 BEGIN_EVENT_TABLE(wxCollapsiblePane, wxCollapsiblePaneBase)
 169     EVT_SIZE(wxCollapsiblePane::OnSize)
 170 END_EVENT_TABLE()
 171
 172 bool wxCollapsiblePane::Create(wxWindow *parent,
 173                                wxWindowID id,
 174                                const wxString& label,
 175                                const wxPoint& pos,
 176                                const wxSize& size,
 177                                long style,
 178                                const wxValidator& val,
 179                                const wxString& name)
 180 {
 181     m_bIgnoreNextChange = false;
 182
 183     if ( !PreCreation( parent, pos, size ) ||
 184           !wxControl::CreateBase(parent, id, pos, size, style, val, name) )
 185     {
 186         wxFAIL_MSG( wxT("wxCollapsiblePane creation failed") );
 187         return false;
 188     }
 189
 190     m_widget =
 191         gtk_expander_new_with_mnemonic(wxGTK_CONV(GTKConvertMnemonics(label)));
 192
 193     // see the gtk_collapsiblepane_expanded_callback comments to understand why
 194     // we connect to the "notify::expanded" signal instead of the more common
 195     // "activate" one
 196     g_signal_connect(m_widget, "notify::expanded",
 197                      G_CALLBACK(gtk_collapsiblepane_expanded_callback), this);
 198
 199     // before creating m_pPane, we need to makesure our own insert callback
 200     // will be used
 201     m_insertCallback = gtk_collapsiblepane_insert_callback;
 202
 203     // this the real "pane"
 204     m_pPane = new wxPanel(this, wxID_ANY, wxDefaultPosition, wxDefaultSize,
 205                            wxTAB_TRAVERSAL|wxNO_BORDER);
 206
 207     gtk_widget_show(m_widget);
 208     m_parent->DoAddChild( this );
 209
 210     PostCreation(size);
 211
 212     // remember the size of this control when it's collapsed
 213     m_szCollapsed = GetBestSize();
 214
 215     return true;
 216 }
 217
 218 wxSize wxCollapsiblePane::DoGetBestSize() const
 219 {
 220     wxASSERT_MSG( m_widget, wxT("DoGetBestSize called before creation") );
 221
 222     GtkRequisition req;
 223     req.width = 2;
 224     req.height = 2;
 225     (* GTK_WIDGET_CLASS( GTK_OBJECT_GET_CLASS(m_widget) )->size_request )
 226             (m_widget, &req );
 227
 228     // notice that we do not cache our best size here as it changes
 229     // all times the user expands/hide our pane
 230     return wxSize(req.width, req.height);
 231 }
 232
 233 void wxCollapsiblePane::Collapse(bool collapse)
 234 {
 235     // optimization
 236     if (IsCollapsed() == collapse)
 237         return;
 238
 239     // do not send event in next signal handler call
 240     m_bIgnoreNextChange = true;
 241     gtk_expander_set_expanded(GTK_EXPANDER(m_widget), !collapse);
 242 }
 243
 244 bool wxCollapsiblePane::IsCollapsed() const
 245 {
 246     return !gtk_expander_get_expanded(GTK_EXPANDER(m_widget));
 247 }
 248
 249 void wxCollapsiblePane::SetLabel(const wxString &str)
 250 {
 251     gtk_expander_set_label(GTK_EXPANDER(m_widget), wxGTK_CONV(str));
 252
 253     // FIXME: we need to update our collapsed width in some way but using GetBestSize()
 254     // we may get the size of the control with the pane size summed up if we are expanded!
 255     //m_szCollapsed.x = GetBestSize().x;
 256 }
 257
 258 void wxCollapsiblePane::OnSize(wxSizeEvent &ev)
 259 {
 260 #if 0       // for debug only
 261     wxClientDC dc(this);
 262     dc.SetPen(*wxBLACK_PEN);
 263     dc.SetBrush(*wxTRANSPARENT_BRUSH);
 264     dc.DrawRectangle(wxPoint(0,0), GetSize());
 265     dc.SetPen(*wxRED_PEN);
 266     dc.DrawRectangle(wxPoint(0,0), GetBestSize());
 267 #endif
 268
 269     // here we need to resize the pane window otherwise, even if the GtkExpander container
 270     // is expanded or shrinked, the pane window won't be updated!
 271     m_pPane->SetSize(ev.GetSize().x, ev.GetSize().y - m_szCollapsed.y);
 272
 273     // we need to explicitely call m_pPane->Layout() or else it won't correctly relayout
 274     // (even if SetAutoLayout(true) has been called on it!)
 275     m_pPane->Layout();
 276 }
 277
 278 #endif // wxUSE_COLLPANE && !defined(__WXUNIVERSAL__)
 279