]> git.saurik.com Git - wxWidgets.git/blobdiff - samples/layout/layout.cpp
wxMediaCtrl API changes for 2.5.x/2.6
[wxWidgets.git] / samples / layout / layout.cpp
index 07503748329fbc7815f12eb93c9271681c2e494a..ed27778a83234c76005aa4a1c84083c516424642 100644 (file)
@@ -5,10 +5,14 @@
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$
-// Copyright:   (c) Julian Smart and Markus Holzem
-// Licence:    wxWindows license
+// Copyright:   (c) Julian Smart
+// Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
+// ----------------------------------------------------------------------------
+// headers
+// ----------------------------------------------------------------------------
+
 // For compilers that support precompilation, includes "wx/wx.h".
 #include "wx/wxprec.h"
 
 #include "wx/wx.h"
 #endif
 
-#if !wxUSE_CONSTRAINTS
-#error You must set wxUSE_CONSTRAINTS to 1 in setup.h!
-#endif
-
-#include <ctype.h>
 #include "wx/sizer.h"
+#include "wx/gbsizer.h"
 #include "wx/statline.h"
+#include "wx/notebook.h"
 
 #include "layout.h"
 
-// Declare two frames
-MyFrame   *frame = (MyFrame *) NULL;
-wxMenuBar *menu_bar = (wxMenuBar *) NULL;
+// ----------------------------------------------------------------------------
+// MyApp
+// ----------------------------------------------------------------------------
 
 IMPLEMENT_APP(MyApp)
 
-MyApp::MyApp()
+bool MyApp::OnInit()
 {
+  // Create the main frame window
+  MyFrame *frame = new MyFrame;
+
+  frame->Show(true);
+
+  return true;
 }
 
-bool MyApp::OnInit(void)
-{
-  // Create the main frame window
-  frame = new MyFrame((MyFrame *) NULL, (char *) "wxWindows Layout Demo", 0, 0, 550, 500);
+// ----------------------------------------------------------------------------
+// MyFrame
+// ----------------------------------------------------------------------------
 
-  frame->SetAutoLayout(TRUE);
+BEGIN_EVENT_TABLE(MyFrame, wxFrame)
+  EVT_MENU(LAYOUT_ABOUT, MyFrame::OnAbout)
+  EVT_MENU(LAYOUT_QUIT, MyFrame::OnQuit)
 
-  // Give it a status line
-  frame->CreateStatusBar(2);
+  EVT_MENU(LAYOUT_TEST_SIZER, MyFrame::TestFlexSizers)
+  EVT_MENU(LAYOUT_TEST_NB_SIZER, MyFrame::TestNotebookSizers)
+  EVT_MENU(LAYOUT_TEST_GB_SIZER, MyFrame::TestGridBagSizer)
+END_EVENT_TABLE()
 
+// Define my frame constructor
+MyFrame::MyFrame()
+       : wxFrame(NULL, wxID_ANY, _T("wxWidgets Layout Demo"),
+                 wxDefaultPosition, wxDefaultSize,
+                 wxDEFAULT_FRAME_STYLE | wxNO_FULL_REPAINT_ON_RESIZE)
+{
   // Make a menubar
   wxMenu *file_menu = new wxMenu;
 
-  file_menu->Append(LAYOUT_LOAD_FILE, "&Load file",      "Load a text file");
-  file_menu->Append(LAYOUT_TEST_NEW, "&Test new sizers",      "Test new sizer code");
+  file_menu->Append(LAYOUT_TEST_SIZER, _T("Test wx&FlexSizer"));
+  file_menu->Append(LAYOUT_TEST_NB_SIZER, _T("&Test notebook sizers"));
+  file_menu->Append(LAYOUT_TEST_GB_SIZER, _T("Test &gridbag sizer"));
 
   file_menu->AppendSeparator();
-  file_menu->Append(LAYOUT_QUIT, "E&xit",                "Quit program");
+  file_menu->Append(LAYOUT_QUIT, _T("E&xit"), _T("Quit program"));
 
   wxMenu *help_menu = new wxMenu;
-  help_menu->Append(LAYOUT_ABOUT, "&About",              "About layout demo");
+  help_menu->Append(LAYOUT_ABOUT, _T("&About"), _T("About layout demo"));
 
-  menu_bar = new wxMenuBar;
+  wxMenuBar *menu_bar = new wxMenuBar;
 
-  menu_bar->Append(file_menu, "&File");
-  menu_bar->Append(help_menu, "&Help");
+  menu_bar->Append(file_menu, _T("&File"));
+  menu_bar->Append(help_menu, _T("&Help"));
 
   // Associate the menu bar with the frame
-  frame->SetMenuBar(menu_bar);
-
-  // Make a panel
-  frame->panel = new wxPanel(frame, 0, 0, 1000, 500, wxTAB_TRAVERSAL);
-  frame->panel->SetBackgroundColour(wxSystemSettings::GetSystemColour(wxSYS_COLOUR_3DFACE));
-//  frame->panel->SetAutoLayout(TRUE);
-
-  // Create some panel items
-  wxButton *btn1 = new wxButton(frame->panel, -1, "A button (1)") ;
-
-  wxLayoutConstraints *b1 = new wxLayoutConstraints;
-  b1->centreX.SameAs    (frame->panel, wxCentreX);
-  b1->top.SameAs        (frame->panel, wxTop, 5);
-  b1->width.PercentOf   (frame->panel, wxWidth, 80);
-  b1->height.PercentOf  (frame->panel, wxHeight, 10);
-  btn1->SetConstraints(b1);
-
-  wxListBox *list = new wxListBox(frame->panel, -1,
-                                  wxPoint(-1, -1), wxSize(200, 100));
-  list->Append("Apple");
-  list->Append("Pear");
-  list->Append("Orange");
-  list->Append("Banana");
-  list->Append("Fruit");
-
-  wxLayoutConstraints *b2 = new wxLayoutConstraints;
-  b2->top.Below         (btn1, 5);
-  b2->left.SameAs       (frame->panel, wxLeft, 5);
-  b2->width.PercentOf   (frame->panel, wxWidth, 40);
-  b2->bottom.SameAs     (frame->panel, wxBottom, 5);
-  list->SetConstraints(b2);
-
-  wxTextCtrl *mtext = new wxTextCtrl(frame->panel, -1, "Some text",
-                        wxPoint(-1, -1), wxSize(150, 100));
-
-  wxLayoutConstraints *b3 = new wxLayoutConstraints;
-  b3->top.Below         (btn1, 5);
-  b3->left.RightOf      (list, 5);
-  b3->right.SameAs      (frame->panel, wxRight, 5);
-  b3->bottom.SameAs     (frame->panel, wxBottom, 5);
-  mtext->SetConstraints(b3);
-
-  frame->canvas = new MyWindow(frame, 0, 0, 400, 400, wxRETAINED);
-
-  // Give it scrollbars: the virtual canvas is 20 * 50 = 1000 pixels in each direction
-//  canvas->SetScrollbars(20, 20, 50, 50, 4, 4);
-
-  // Make a text window
-  frame->text_window = new MyTextWindow(frame, 0, 250, 400, 250);
+  SetMenuBar(menu_bar);
 
-  // Set constraints for panel subwindow
-  wxLayoutConstraints *c1 = new wxLayoutConstraints;
+#if wxUSE_STATUSBAR
+  CreateStatusBar(2);
+  SetStatusText(_T("wxWidgets layout demo"));
+#endif // wxUSE_STATUSBAR
 
-  c1->left.SameAs       (frame, wxLeft);
-  c1->top.SameAs        (frame, wxTop);
-  c1->right.PercentOf   (frame, wxWidth, 50);
-  c1->height.PercentOf  (frame, wxHeight, 50);
-
-  frame->panel->SetConstraints(c1);
+  // we want to get a dialog that is stretchable because it
+  // has a text ctrl in the middle. at the bottom, we have
+  // two buttons which.
 
-  // Set constraints for canvas subwindow
-  wxLayoutConstraints *c2 = new wxLayoutConstraints;
+  wxBoxSizer *topsizer = new wxBoxSizer( wxVERTICAL );
 
-  c2->left.SameAs       (frame->panel, wxRight);
-  c2->top.SameAs        (frame, wxTop);
-  c2->right.SameAs      (frame, wxRight);
-  c2->height.PercentOf  (frame, wxHeight, 50);
+  // 1) top: create wxStaticText with minimum size equal to its default size
+  topsizer->Add(
+    new wxStaticText( this, wxID_ANY, _T("An explanation (wxALIGN_RIGHT).") ),
+    wxSizerFlags().Align(wxALIGN_RIGHT).Border(wxALL & ~wxBOTTOM, 5));
 
-  frame->canvas->SetConstraints(c2);
+  // 2) top: create wxTextCtrl with minimum size (100x60)
+  topsizer->Add(
+    new wxTextCtrl( this, wxID_ANY, _T("My text (wxEXPAND)."), wxDefaultPosition, wxSize(100,60), wxTE_MULTILINE),
+    wxSizerFlags(1).Expand().Border(wxALL, 5));
+
+  // 2.5) Gratuitous test of wxStaticBoxSizers
+  wxBoxSizer *statsizer = new wxStaticBoxSizer(
+    new wxStaticBox(this, wxID_ANY, _T("A wxStaticBoxSizer")), wxVERTICAL );
+  statsizer->Add(
+    new wxStaticText(this, wxID_ANY, _T("And some TEXT inside it")),
+    wxSizerFlags().Center().Border(wxALL, 30));
+  topsizer->Add(
+    statsizer,
+    wxSizerFlags(1).Expand().Border(wxALL, 10));
+
+    // 2.7) And a test of wxGridSizer
+    wxGridSizer *gridsizer = new wxGridSizer(2, 5, 5);
+    gridsizer->Add(new wxStaticText(this, wxID_ANY, _T("Label")),
+                   wxSizerFlags().Align(wxALIGN_RIGHT | wxALIGN_CENTER_VERTICAL));
+    gridsizer->Add(new wxTextCtrl(this, wxID_ANY, _T("Grid sizer demo")),
+                   wxSizerFlags(1).Align(wxGROW | wxALIGN_CENTER_VERTICAL));
+    gridsizer->Add(new wxStaticText(this, wxID_ANY, _T("Another label")),
+                   wxSizerFlags().Align(wxALIGN_RIGHT | wxALIGN_CENTER_VERTICAL));
+    gridsizer->Add(new wxTextCtrl(this, wxID_ANY, _T("More text")),
+                   wxSizerFlags(1).Align(wxGROW | wxALIGN_CENTER_VERTICAL));
+    gridsizer->Add(new wxStaticText(this, wxID_ANY, _T("Final label")),
+                   wxSizerFlags().Align(wxALIGN_RIGHT | wxALIGN_CENTER_VERTICAL));
+    gridsizer->Add(new wxTextCtrl(this, wxID_ANY, _T("And yet more text")),
+                   wxSizerFlags().Align(wxGROW | wxALIGN_CENTER_VERTICAL));
+    topsizer->Add(
+        gridsizer,
+        wxSizerFlags().Proportion(1).Expand().Border(wxALL, 10));
+
+
+#if wxUSE_STATLINE
+  // 3) middle: create wxStaticLine with minimum size (3x3)
+  topsizer->Add(
+     new wxStaticLine( this, wxID_ANY, wxDefaultPosition, wxSize(3,3), wxHORIZONTAL),
+     wxSizerFlags().Expand());
+#endif // wxUSE_STATLINE
 
-  // Set constraints for text subwindow
-  wxLayoutConstraints *c3 = new wxLayoutConstraints;
-  c3->left.SameAs       (frame, wxLeft);
-  c3->top.Below         (frame->panel);
-  c3->right.SameAs      (frame, wxRight);
-  c3->bottom.SameAs     (frame, wxBottom);
 
-  frame->text_window->SetConstraints(c3);
+  // 4) bottom: create two centred wxButtons
+  wxBoxSizer *button_box = new wxBoxSizer( wxHORIZONTAL );
+  button_box->Add(
+     new wxButton( this, wxID_ANY, _T("Two buttons in a box") ),
+     wxSizerFlags().Border(wxALL, 7));
+  button_box->Add(
+     new wxButton( this, wxID_ANY, _T("(wxCENTER)") ),
+     wxSizerFlags().Border(wxALL, 7));
 
-  frame->Show(TRUE);
+  topsizer->Add(button_box, wxSizerFlags().Center());
 
-  frame->SetStatusText("wxWindows layout demo");
+  // don't allow frame to get smaller than what the sizers tell it and also set
+  // the initial size as calculated by the sizers
+  topsizer->SetSizeHints( this );
 
-  SetTopWindow(frame);
-  return TRUE;
+  SetSizer( topsizer );
 }
 
-//-----------------------------------------------------------------
-//  MyFrame
-//-----------------------------------------------------------------
-
-// Define my frame constructor
-MyFrame::MyFrame(wxFrame *frame, char *title, int x, int y, int w, int h):
-  wxFrame(frame, -1, title, wxPoint(x, y), wxSize(w, h))
+void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) )
 {
-  panel = (wxPanel *) NULL;
-  text_window = (MyTextWindow *) NULL;
-  canvas = (MyWindow *) NULL;
+    Close(true);
 }
 
-BEGIN_EVENT_TABLE(MyFrame, wxFrame)
-  EVT_MENU(LAYOUT_LOAD_FILE, MyFrame::LoadFile)
-  EVT_MENU(LAYOUT_QUIT, MyFrame::Quit)
-  EVT_MENU(LAYOUT_TEST_NEW, MyFrame::TestNewSizers)
-  EVT_MENU(LAYOUT_ABOUT, MyFrame::About)
-  EVT_SIZE(MyFrame::OnSize)
-END_EVENT_TABLE()
+void MyFrame::TestFlexSizers(wxCommandEvent& WXUNUSED(event) )
+{
+    MyFlexSizerFrame *newFrame = new MyFlexSizerFrame(_T("Flex Sizer Test Frame"), 50, 50);
+    newFrame->Show(true);
+}
 
-void MyFrame::LoadFile(wxCommandEvent& WXUNUSED(event) )
+void MyFrame::TestNotebookSizers(wxCommandEvent& WXUNUSED(event) )
 {
-      wxString s = wxFileSelector( _T("Load text file"), (const wxChar *) NULL, 
-                                   (const wxChar *) NULL, (const wxChar *) NULL, _T("*.txt") );
-      if (s != "")
-      {
-#ifdef __WXMSW__
-        frame->text_window->LoadFile(s);
-#endif
-      }
+    MySizerDialog dialog( this, _T("Notebook Sizer Test Dialog") );
+
+    dialog.ShowModal();
 }
 
-void MyFrame::Quit(wxCommandEvent& WXUNUSED(event) )
+
+void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event) )
 {
-      this->Close(TRUE);
+    (void)wxMessageBox(_T("wxWidgets GUI library layout demo\n"),
+            _T("About Layout Demo"), wxOK|wxICON_INFORMATION);
 }
 
-void MyFrame::TestNewSizers(wxCommandEvent& WXUNUSED(event) )
+void MyFrame::TestGridBagSizer(wxCommandEvent& WXUNUSED(event) )
 {
-  NewSizerFrame *newFrame = new NewSizerFrame((MyFrame *) NULL, "Sizer Test Frame", 50, 50 );
-  newFrame->Show(TRUE);
+    MyGridBagSizerFrame *newFrame = new
+        MyGridBagSizerFrame(_T("wxGridBagSizer Test Frame"), 50, 50);
+    newFrame->Show(true);
 }
 
-void MyFrame::About(wxCommandEvent& WXUNUSED(event) )
+
+// ----------------------------------------------------------------------------
+//  MyFlexSizerFrame
+// ----------------------------------------------------------------------------
+
+void MyFlexSizerFrame::InitFlexSizer(wxFlexGridSizer *sizer)
 {
-      (void)wxMessageBox("wxWindows GUI library layout demo\n",
-            "About Layout Demo", wxOK|wxCENTRE);
+    for ( int i = 0; i < 3; i++ )
+    {
+        for ( int j = 0; j < 3; j++ )
+        {
+            sizer->Add(new wxStaticText
+                           (
+                            this,
+                            wxID_ANY,
+                            wxString::Format(_T("(%d, %d)"), i + 1, j + 1),
+                            wxDefaultPosition,
+                            wxDefaultSize,
+                            wxALIGN_CENTER
+                           ),
+                       0, wxEXPAND | wxALIGN_CENTER_VERTICAL | wxALL, 3);
+        }
+    }
 }
 
-// Size the subwindows when the frame is resized
-void MyFrame::OnSize(wxSizeEvent& WXUNUSED(event) )
+MyFlexSizerFrame::MyFlexSizerFrame(const wxChar *title, int x, int y )
+            : wxFrame(NULL, wxID_ANY, title, wxPoint(x, y) )
 {
-    Layout();
+    wxFlexGridSizer *sizerFlex;
+
+    // consttuct the first column
+    wxSizer *sizerCol1 = new wxBoxSizer(wxVERTICAL);
+    sizerCol1->Add(new wxStaticText(this, wxID_ANY, _T("Ungrowable:")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerCol1->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    sizerCol1->Add(new wxStaticText(this, wxID_ANY, _T("Growable middle column:")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableCol(1);
+    sizerCol1->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    sizerCol1->Add(new wxStaticText(this, wxID_ANY, _T("Growable middle row:")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableRow(1);
+    sizerCol1->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    sizerCol1->Add(new wxStaticText(this, wxID_ANY, _T("All growable columns:")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableCol(0, 1);
+    sizerFlex->AddGrowableCol(1, 2);
+    sizerFlex->AddGrowableCol(2, 3);
+    sizerCol1->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    // the second one
+    wxSizer *sizerCol2 = new wxBoxSizer(wxVERTICAL);
+    sizerCol2->Add(new wxStaticText(this, wxID_ANY, _T("Growable middle row and column:")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableCol(1);
+    sizerFlex->AddGrowableRow(1);
+    sizerCol2->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    sizerCol2->Add(new wxStaticText(this, wxID_ANY, _T("Same with horz flex direction")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableCol(1);
+    sizerFlex->AddGrowableRow(1);
+    sizerFlex->SetFlexibleDirection(wxHORIZONTAL);
+    sizerCol2->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    sizerCol2->Add(new wxStaticText(this, wxID_ANY, _T("Same with grow mode == \"none\"")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableCol(1);
+    sizerFlex->AddGrowableRow(1);
+    sizerFlex->SetFlexibleDirection(wxHORIZONTAL);
+    sizerFlex->SetNonFlexibleGrowMode(wxFLEX_GROWMODE_NONE);
+    sizerCol2->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    sizerCol2->Add(new wxStaticText(this, wxID_ANY, _T("Same with grow mode == \"all\"")), 0, wxCENTER | wxTOP, 20);
+    sizerFlex = new wxFlexGridSizer(3, 3);
+    InitFlexSizer(sizerFlex);
+    sizerFlex->AddGrowableCol(1);
+    sizerFlex->AddGrowableRow(1);
+    sizerFlex->SetFlexibleDirection(wxHORIZONTAL);
+    sizerFlex->SetNonFlexibleGrowMode(wxFLEX_GROWMODE_ALL);
+    sizerCol2->Add(sizerFlex, 1, wxALL | wxEXPAND, 10);
+
+    // add both columns to grid sizer
+    wxGridSizer *sizerTop = new wxGridSizer(2, 0, 20);
+    sizerTop->Add(sizerCol1, 1, wxEXPAND);
+    sizerTop->Add(sizerCol2, 1, wxEXPAND);
+
+    SetSizer(sizerTop);
+    sizerTop->SetSizeHints(this);
 }
 
-void MyFrame::Draw(wxDC& dc, bool WXUNUSED(draw_bitmaps) )
+// ----------------------------------------------------------------------------
+// MySizerDialog
+// ----------------------------------------------------------------------------
+
+MySizerDialog::MySizerDialog(wxWindow *parent, const wxChar *title)
+             : wxDialog(parent, wxID_ANY, wxString(title))
 {
-  dc.SetPen(* wxGREEN_PEN);
-  dc.DrawLine(0, 0, 200, 200);
-  dc.DrawLine(200, 0, 0, 200);
+    // Begin with first hierarchy: a notebook at the top and
+    // and OK button at the bottom.
+
+    wxBoxSizer *topsizer = new wxBoxSizer( wxVERTICAL );
+
+    wxNotebook *notebook = new wxNotebook( this, wxID_ANY );
+    topsizer->Add( notebook, 1, wxGROW );
+
+    wxButton *button = new wxButton( this, wxID_OK, _T("OK") );
+    topsizer->Add( button, 0, wxALIGN_RIGHT | wxALL, 10 );
+
+    // First page: one big text ctrl
+    wxTextCtrl *multi = new wxTextCtrl( notebook, wxID_ANY, _T("TextCtrl."), wxDefaultPosition, wxDefaultSize, wxTE_MULTILINE );
+    notebook->AddPage( multi, _T("Page One") );
 
-  dc.SetBrush(* wxCYAN_BRUSH);
-  dc.SetPen(* wxRED_PEN);
+    // Second page: a text ctrl and a button
+    wxPanel *panel = new wxPanel( notebook, wxID_ANY );
+    notebook->AddPage( panel, _T("Page Two") );
 
-  dc.DrawRectangle(100, 100, 100, 50);
-  dc.DrawRoundedRectangle(150, 150, 100, 50, 20);
+    wxSizer *panelsizer = new wxBoxSizer( wxVERTICAL );
 
-  dc.DrawEllipse(250, 250, 100, 50);
-  dc.DrawSpline(50, 200, 50, 100, 200, 10);
-  dc.DrawLine(50, 230, 200, 230);
+    wxTextCtrl *text = new wxTextCtrl( panel, wxID_ANY, _T("TextLine 1."), wxDefaultPosition, wxSize(250,-1) );
+    panelsizer->Add( text, 0, wxGROW|wxALL, 30 );
+    text = new wxTextCtrl( panel, wxID_ANY, _T("TextLine 2."), wxDefaultPosition, wxSize(250,-1) );
+    panelsizer->Add( text, 0, wxGROW|wxALL, 30 );
+    wxButton *button2 = new wxButton( panel, wxID_ANY, _T("Hallo") );
+    panelsizer->Add( button2, 0, wxALIGN_RIGHT | wxLEFT|wxRIGHT|wxBOTTOM, 30 );
 
-  dc.SetPen(* wxBLACK_PEN);
-  dc.DrawArc(50, 300, 100, 250, 100, 300 );
+    panel->SetAutoLayout( true );
+    panel->SetSizer( panelsizer );
+
+    // Tell dialog to use sizer
+    SetSizer( topsizer );
+    topsizer->SetSizeHints( this );
 }
 
-//-----------------------------------------------------------------
-//  MyWindow
-//-----------------------------------------------------------------
+// ----------------------------------------------------------------------------
+// MyGridBagSizerFrame
+// ----------------------------------------------------------------------------
+
+// some simple macros to help make the sample code below more clear
+#define TEXTCTRL(text)   new wxTextCtrl(p, wxID_ANY, _T(text))
+#define MLTEXTCTRL(text) new wxTextCtrl(p, wxID_ANY, _T(text), wxDefaultPosition, wxDefaultSize, wxTE_MULTILINE)
+#define POS(r, c)        wxGBPosition(r,c)
+#define SPAN(r, c)       wxGBSpan(r,c)
+
+wxChar* gbsDescription =_T("\
+The wxGridBagSizer is similar to the wxFlexGridSizer except the items are explicitly positioned\n\
+in a virtual cell of the layout grid, and column or row spanning is allowed.  For example, this\n\
+static text is positioned at (0,0) and it spans 7 columns.");
+
+
+// Some IDs
+enum {
+    GBS_HIDE_BTN = 1212,
+    GBS_SHOW_BTN,
+    GBS_MOVE_BTN1,
+    GBS_MOVE_BTN2,
 
-BEGIN_EVENT_TABLE(MyWindow, wxWindow)
-    EVT_PAINT(MyWindow::OnPaint)
+    GBS_MAX,
+};
+
+
+BEGIN_EVENT_TABLE(MyGridBagSizerFrame, wxFrame)
+    EVT_BUTTON( GBS_HIDE_BTN,  MyGridBagSizerFrame::OnHideBtn)
+    EVT_BUTTON( GBS_SHOW_BTN,  MyGridBagSizerFrame::OnShowBtn)
+    EVT_BUTTON( GBS_MOVE_BTN1, MyGridBagSizerFrame::OnMoveBtn)
+    EVT_BUTTON( GBS_MOVE_BTN2, MyGridBagSizerFrame::OnMoveBtn)
 END_EVENT_TABLE()
 
-// Define a constructor for my canvas
-MyWindow::MyWindow(wxFrame *frame, int x, int y, int w, int h, long style):
- wxWindow(frame, -1, wxPoint(x, y), wxSize(w, h), style)
-{
-}
 
-MyWindow::~MyWindow(void)
+MyGridBagSizerFrame::MyGridBagSizerFrame(const wxChar *title, int x, int y )
+    : wxFrame( NULL, wxID_ANY, title, wxPoint(x, y) )
 {
-}
+    wxPanel* p = new wxPanel(this, wxID_ANY);
+    m_panel = p;
+    m_gbs = new wxGridBagSizer();
 
-// Define the repainting behaviour
-void MyWindow::OnPaint(wxPaintEvent& WXUNUSED(event) )
-{
-  wxPaintDC dc(this);
-  frame->Draw(dc,TRUE);
-}
 
-//-----------------------------------------------------------------
-//  NewSizerFrame
-//-----------------------------------------------------------------
+    m_gbs->Add( new wxStaticText(p, wxID_ANY, gbsDescription),
+                POS(0,0), SPAN(1, 7),
+                wxALIGN_CENTER | wxALL, 5);
 
-NewSizerFrame::NewSizerFrame(wxFrame *frame, char *title, int x, int y ):
-  wxFrame(frame, -1, title, wxPoint(x, y) )
-{
-  // we want to get a dialog that is stretchable because it
-  // has a text ctrl in the middle. at the bottom, we have
-  // two buttons which.
+    m_gbs->Add( TEXTCTRL("pos(1,0)"),   POS(1,0) );
+    m_gbs->Add( TEXTCTRL("pos(1,1)"),   POS(1,1) );
+    m_gbs->Add( TEXTCTRL("pos(2,0)"),   POS(2,0) );
+    m_gbs->Add( TEXTCTRL("pos(2,1)"),   POS(2,1) );
+    m_gbs->Add( MLTEXTCTRL("pos(3,2), span(1,2)\nthis row and col are growable"),
+              POS(3,2), SPAN(1,2), wxEXPAND );
+    m_gbs->Add( MLTEXTCTRL("pos(4,3)\nspan(3,1)"),
+              POS(4,3), SPAN(3,1), wxEXPAND );
+    m_gbs->Add( TEXTCTRL("pos(5,4)"),   POS(5,4), wxDefaultSpan, wxEXPAND );
+    m_gbs->Add( TEXTCTRL("pos(6,5)"),   POS(6,5), wxDefaultSpan, wxEXPAND );
+    m_gbs->Add( TEXTCTRL("pos(7,6)"),   POS(7,6) );
 
-  wxBoxSizer *topsizer = new wxBoxSizer( wxVERTICAL );
-  
-  // 1) top: create wxStaticText with minimum size equal to its default size
-  topsizer->Add( 
-    new wxStaticText( this, -1, "An explanation (wxALIGN_RIGHT)." ),
-    0,                         // make vertically unstretchable
-    wxALIGN_RIGHT |            // right align text
-    wxTOP | wxLEFT | wxRIGHT,  // make border all around except wxBOTTOM
-    5 );                      // set border width to 5
+    //m_gbs->Add( TEXTCTRL("bad position"), POS(4,3) );  // Test for assert
+    //m_gbs->Add( TEXTCTRL("bad position"), POS(5,3) );  // Test for assert
 
-  // 2) top: create wxTextCtrl with minimum size (100x60)
-  topsizer->Add( 
-    new wxTextCtrl( this, -1, "My text (wxEXPAND).", wxDefaultPosition, wxSize(100,60), wxTE_MULTILINE),
-    1,            // make vertically stretchable
-    wxEXPAND |    // make horizontally stretchable
-    wxALL,        //   and make border all around
-    5 );         // set border width to 5
 
+    m_moveBtn1 = new wxButton(p, GBS_MOVE_BTN1, _T("Move this to (3,6)"));
+    m_moveBtn2 = new wxButton(p, GBS_MOVE_BTN2, _T("Move this to (3,6)"));
+    m_gbs->Add( m_moveBtn1, POS(10,2) );
+    m_gbs->Add( m_moveBtn2, POS(10,3) );
 
-  // 3) middle: create wxStaticLine with minimum size (3x3)
-  topsizer->Add( 
-     new wxStaticLine( this, -1, wxDefaultPosition, wxSize(3,3), wxHORIZONTAL), 
-     0,           // make vertically unstretchable
-     wxEXPAND |   // make horizontally stretchable
-     wxALL,       //   and make border all around
-     5 );         // set border width to 5
-     
-
-  // 4) bottom: create two centred wxButtons  
-  wxBoxSizer *button_box = new wxBoxSizer( wxHORIZONTAL );
-  button_box->Add(
-     new wxButton( this, -1, "Two buttons in a box" ), 
-     0,           // make horizontally unstretchable
-     wxALL,       // make border all around
-     7 );         // set border width to 7
-  button_box->Add(
-     new wxButton( this, -1, "(wxCENTER)" ), 
-     0,           // make horizontally unstretchable
-     wxALL,       // make border all around
-     7 );         // set border width to 7
-  
-  topsizer->Add( 
-     button_box,
-     0,          // make vertically unstretchable
-     wxCENTER ); // no border and centre horizontally
-
-  SetAutoLayout( TRUE );
-  
-  // set frame to minimum size
-  topsizer->Fit( this );  
-  
-  // don't allow frame to get smaller than what the sizers tell ye
-  topsizer->SetSizeHints( this );  
-  
-  SetSizer( topsizer );
+    m_hideBtn = new wxButton(p, GBS_HIDE_BTN, _T("Hide this item -->"));
+    m_gbs->Add(m_hideBtn, POS(12, 3));
+
+    m_hideTxt = new wxTextCtrl(p, wxID_ANY, _T("pos(12,4), size(150, -1)"),
+                                wxDefaultPosition, wxSize(150,-1));
+    m_gbs->Add( m_hideTxt, POS(12,4) );
+
+    m_showBtn = new wxButton(p, GBS_SHOW_BTN, _T("<-- Show it again"));
+    m_gbs->Add(m_showBtn, POS(12, 5));
+    m_showBtn->Disable();
+
+    m_gbs->Add(10,10, POS(14,0));
+
+    m_gbs->AddGrowableRow(3);
+    m_gbs->AddGrowableCol(2);
+
+    p->SetSizerAndFit(m_gbs);
+    SetClientSize(p->GetSize());
+}
+
+
+void MyGridBagSizerFrame::OnHideBtn(wxCommandEvent&)
+{
+    m_gbs->Hide(m_hideTxt);
+    m_hideBtn->Disable();
+    m_showBtn->Enable();
+    m_gbs->Layout();
 }
 
+void MyGridBagSizerFrame::OnShowBtn(wxCommandEvent&)
+{
+    m_gbs->Show(m_hideTxt);
+    m_hideBtn->Enable();
+    m_showBtn->Disable();
+    m_gbs->Layout();
+}
 
 
+void MyGridBagSizerFrame::OnMoveBtn(wxCommandEvent& event)
+{
+    wxButton* btn = (wxButton*)event.GetEventObject();
+    wxGBPosition curPos = m_gbs->GetItemPosition(btn);
+
+    // if it's already at the "other" spot then move it back
+    if (curPos == wxGBPosition(3,6))
+    {
+        m_gbs->SetItemPosition(btn, m_lastPos);
+        btn->SetLabel(_T("Move this to (3,6)"));
+    }
+    else
+    {
+        if ( m_gbs->CheckForIntersection(wxGBPosition(3,6), wxGBSpan(1,1)) )
+            wxMessageBox(
+_T("wxGridBagSizer will not allow items to be in the same cell as\n\
+another item, so this operation will fail.  You will also get an assert\n\
+when compiled in debug mode."), _T("Warning"), wxOK | wxICON_INFORMATION);
+
+        if ( m_gbs->SetItemPosition(btn, wxGBPosition(3,6)) )
+        {
+            m_lastPos = curPos;
+            btn->SetLabel(_T("Move it back"));
+        }
+    }
+    m_gbs->Layout();
+}