]> git.saurik.com Git - wxWidgets.git/blobdiff - samples/notebook/notebook.cpp
Reorganize and improve wxSizer::SetItemMinSize() documentation.
[wxWidgets.git] / samples / notebook / notebook.cpp
index a7fdeea343fb55efb3cc720ec411ad38dc9026f2..31d206789847bac7207851e53ec2ad7f57165c9b 100644 (file)
 
 #include "wx/imaglist.h"
 #include "wx/artprov.h"
+#include "wx/cshelp.h"
+#include "wx/utils.h"
 #include "notebook.h"
 
+#if !defined(__WXMSW__) && !defined(__WXPM__)
+    #include "../sample.xpm"
+#endif
+
+//-----------------------------------------------------------------------------
+// MyApp
+//-----------------------------------------------------------------------------
+
 IMPLEMENT_APP(MyApp)
 
 bool MyApp::OnInit()
 {
+    if ( !wxApp::OnInit() )
+        return false;
+
+#if wxUSE_HELP
+    wxHelpProvider::Set( new wxSimpleHelpProvider );
+#endif
+
     // Create the main window
-    MyFrame *frame = new MyFrame( wxT("Notebook sample") );
+    MyFrame *frame = new MyFrame();
+    SetTopWindow(frame);
 
     // Problem with generic wxNotebook implementation whereby it doesn't size
     // properly unless you set the size again
@@ -44,12 +62,21 @@ bool MyApp::OnInit()
     return true;
 }
 
+
+//-----------------------------------------------------------------------------
+// Creation functions
+//-----------------------------------------------------------------------------
+
 wxPanel *CreateUserCreatedPage(wxBookCtrlBase *parent)
 {
     wxPanel *panel = new wxPanel(parent);
 
+#if wxUSE_HELP
+    panel->SetHelpText( wxT( "Panel with a Button" ) );
+#endif
+
     (void) new wxButton( panel, wxID_ANY, wxT("Button"),
-        wxPoint(10, 10), wxDefaultSize );
+                         wxPoint(10, 10), wxDefaultSize );
 
     return panel;
 }
@@ -58,13 +85,19 @@ wxPanel *CreateRadioButtonsPage(wxBookCtrlBase *parent)
 {
     wxPanel *panel = new wxPanel(parent);
 
-    wxString animals[] = { wxT("Fox"), wxT("Hare"), wxT("Rabbit"),
+#if wxUSE_HELP
+    panel->SetHelpText( wxT( "Panel with some Radio Buttons" ) );
+#endif
+
+    wxString animals[] = 
+      { wxT("Fox"), wxT("Hare"), wxT("Rabbit"),
         wxT("Sabre-toothed tiger"), wxT("T Rex") };
 
     wxRadioBox *radiobox1 = new wxRadioBox(panel, wxID_ANY, wxT("Choose one"),
         wxDefaultPosition, wxDefaultSize, 5, animals, 2, wxRA_SPECIFY_ROWS);
 
-    wxString computers[] = { wxT("Amiga"), wxT("Commodore 64"), wxT("PET"),
+    wxString computers[] = 
+      { wxT("Amiga"), wxT("Commodore 64"), wxT("PET"),
         wxT("Another") };
 
     wxRadioBox *radiobox2 = new wxRadioBox(panel, wxID_ANY,
@@ -83,8 +116,13 @@ wxPanel *CreateVetoPage(wxBookCtrlBase *parent)
 {
     wxPanel *panel = new wxPanel(parent);
 
+#if wxUSE_HELP
+    panel->SetHelpText( wxT( "An empty panel" ) );
+#endif
+
     (void) new wxStaticText( panel, wxID_ANY,
-        wxT("This page intentionally left blank"), wxPoint(10, 10) );
+                             wxT("This page intentionally left blank"), 
+                             wxPoint(10, 10) );
 
     return panel;
 }
@@ -93,6 +131,10 @@ wxPanel *CreateBigButtonPage(wxBookCtrlBase *parent)
 {
     wxPanel *panel = new wxPanel(parent);
 
+#if wxUSE_HELP
+    panel->SetHelpText( wxT( "Panel with a maximized button" ) );
+#endif
+
     wxButton *buttonBig = new wxButton(panel, wxID_ANY, wxT("Maximized button"));
 
     wxBoxSizer *sizerPanel = new wxBoxSizer(wxVERTICAL);
@@ -102,14 +144,18 @@ wxPanel *CreateBigButtonPage(wxBookCtrlBase *parent)
     return panel;
 }
 
-
 wxPanel *CreateInsertPage(wxBookCtrlBase *parent)
 {
     wxPanel *panel = new wxPanel(parent);
 
+#if wxUSE_HELP
+    panel->SetHelpText( wxT( "Maroon panel" ) );
+#endif
+
     panel->SetBackgroundColour( wxColour( wxT("MAROON") ) );
     (void) new wxStaticText( panel, wxID_ANY,
-        wxT("This page has been inserted, not added."), wxPoint(10, 10) );
+                             wxT("This page has been inserted, not added."), 
+                             wxPoint(10, 10) );
 
     return panel;
 }
@@ -149,52 +195,113 @@ void CreateInitialPages(wxBookCtrlBase *parent)
 
 wxPanel *CreatePage(wxBookCtrlBase *parent, const wxString&pageName)
 {
-    if
-    (
-        pageName.Contains(INSERTED_PAGE_NAME)
-        || pageName.Contains(ADDED_PAGE_NAME)
-    )
-    {
+    if ( pageName.Contains(INSERTED_PAGE_NAME) ||
+            pageName.Contains(ADDED_PAGE_NAME) ||
+                pageName.Contains(ADDED_SUB_PAGE_NAME) ||
+                    pageName.Contains(ADDED_PAGE_NAME_BEFORE) )
         return CreateUserCreatedPage(parent);
-    }
 
-    if (pageName == I_WAS_INSERTED_PAGE_NAME)
-    {
+    if ( pageName == I_WAS_INSERTED_PAGE_NAME )
         return CreateInsertPage(parent);
-    }
 
-    if (pageName == VETO_PAGE_NAME)
-    {
+    if ( pageName == VETO_PAGE_NAME )
         return CreateVetoPage(parent);
-    }
 
-    if (pageName == RADIOBUTTONS_PAGE_NAME)
-    {
+    if ( pageName == RADIOBUTTONS_PAGE_NAME )
         return CreateRadioButtonsPage(parent);
-    }
-
 
-    if (pageName == MAXIMIZED_BUTTON_PAGE_NAME)
-    {
+    if ( pageName == MAXIMIZED_BUTTON_PAGE_NAME )
         return CreateBigButtonPage(parent);
-    }
 
-    wxFAIL;
+    wxFAIL_MSG( wxT("unknown page name") );
 
-    return (wxPanel *) NULL;
+    return NULL;
 }
 
-MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
-                 long style)
-    : wxFrame((wxWindow *) NULL, wxID_ANY, title, pos, size, style)
+
+//-----------------------------------------------------------------------------
+// MyFrame
+//-----------------------------------------------------------------------------
+
+BEGIN_EVENT_TABLE(MyFrame, wxFrame)
+    // File menu
+    EVT_MENU_RANGE(ID_BOOK_NOTEBOOK, ID_BOOK_MAX, MyFrame::OnType)
+    EVT_MENU_RANGE(ID_ORIENT_DEFAULT, ID_ORIENT_MAX, MyFrame::OnOrient)
+    EVT_MENU(ID_SHOW_IMAGES, MyFrame::OnShowImages)
+    EVT_MENU(ID_MULTI, MyFrame::OnMulti)
+    EVT_MENU(wxID_EXIT, MyFrame::OnExit)
+
+    // Operations menu
+    EVT_MENU(ID_ADD_PAGE, MyFrame::OnAddPage)
+    EVT_MENU(ID_ADD_PAGE_NO_SELECT, MyFrame::OnAddPageNoSelect)
+    EVT_MENU(ID_INSERT_PAGE, MyFrame::OnInsertPage)
+    EVT_MENU(ID_DELETE_CUR_PAGE, MyFrame::OnDeleteCurPage)
+    EVT_MENU(ID_DELETE_LAST_PAGE, MyFrame::OnDeleteLastPage)
+    EVT_MENU(ID_NEXT_PAGE, MyFrame::OnNextPage)
+    EVT_MENU(ID_GO_HOME, MyFrame::OnGoHome)
+
+#if wxUSE_HELP
+    EVT_MENU(ID_CONTEXT_HELP, MyFrame::OnContextHelp)
+#endif // wxUSE_HELP
+    EVT_MENU(ID_HITTEST, MyFrame::OnHitTest)
+
+    // Book controls
+#if wxUSE_NOTEBOOK
+    EVT_NOTEBOOK_PAGE_CHANGED(wxID_ANY, MyFrame::OnNotebook)
+    EVT_NOTEBOOK_PAGE_CHANGING(wxID_ANY, MyFrame::OnNotebook)
+#endif
+#if wxUSE_LISTBOOK
+    EVT_LISTBOOK_PAGE_CHANGED(wxID_ANY, MyFrame::OnListbook)
+    EVT_LISTBOOK_PAGE_CHANGING(wxID_ANY, MyFrame::OnListbook)
+#endif
+#if wxUSE_CHOICEBOOK
+    EVT_CHOICEBOOK_PAGE_CHANGED(wxID_ANY, MyFrame::OnChoicebook)
+    EVT_CHOICEBOOK_PAGE_CHANGING(wxID_ANY, MyFrame::OnChoicebook)
+#endif
+#if wxUSE_TREEBOOK
+    EVT_TREEBOOK_PAGE_CHANGED(wxID_ANY, MyFrame::OnTreebook)
+    EVT_TREEBOOK_PAGE_CHANGING(wxID_ANY, MyFrame::OnTreebook)
+
+    EVT_MENU(ID_ADD_SUB_PAGE, MyFrame::OnAddSubPage)
+    EVT_MENU(ID_ADD_PAGE_BEFORE, MyFrame::OnAddPageBefore)
+    EVT_UPDATE_UI_RANGE(ID_ADD_PAGE_BEFORE, ID_ADD_SUB_PAGE,
+                            MyFrame::OnUpdateTreeMenu)
+#endif
+#if wxUSE_TOOLBOOK
+    EVT_TOOLBOOK_PAGE_CHANGED(wxID_ANY, MyFrame::OnToolbook)
+    EVT_TOOLBOOK_PAGE_CHANGING(wxID_ANY, MyFrame::OnToolbook)
+#endif
+
+    // Update title in idle time
+    EVT_IDLE(MyFrame::OnIdle)
+END_EVENT_TABLE()
+
+MyFrame::MyFrame()
+    : wxFrame(NULL, wxID_ANY, wxString(wxT("wxWidgets book controls sample")))
 {
-    m_type = ID_BOOK_NOTEBOOK;
+#if wxUSE_HELP
+    SetExtraStyle(wxFRAME_EX_CONTEXTHELP);
+#endif // wxUSE_HELP
+
+#if wxUSE_NOTEBOOK
+    m_type = Type_Notebook;
+#elif wxUSE_CHOICEBOOK
+    m_type = Type_Choicebook;
+#elif wxUSE_LISTBOOK
+    m_type = Type_Listbook;
+#elif wxUSE_TREEBOOK
+    m_type = Type_Treebook;
+#elif
+    #error "Don't use Notebook sample without any book enabled in wxWidgets build!"
+#endif
+
     m_orient = ID_ORIENT_DEFAULT;
     m_chkShowImages = true;
     m_multi = false;
 
-    // menu of the sample
+    SetIcon(wxICON(sample));
 
+    // menu of the sample
     wxMenu *menuType = new wxMenu;
 #if wxUSE_NOTEBOOK
     menuType->AppendRadioItem(ID_BOOK_NOTEBOOK,   wxT("&Notebook\tCtrl-1"));
@@ -205,20 +312,42 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
 #if wxUSE_CHOICEBOOK
     menuType->AppendRadioItem(ID_BOOK_CHOICEBOOK, wxT("&Choicebook\tCtrl-3"));
 #endif
+#if wxUSE_TREEBOOK
+    menuType->AppendRadioItem(ID_BOOK_TREEBOOK,   wxT("&Treebook\tCtrl-4"));
+#endif
+#if wxUSE_TOOLBOOK
+    menuType->AppendRadioItem(ID_BOOK_TOOLBOOK,   wxT("T&oolbook\tCtrl-5"));
+#endif
+
+    menuType->Check(ID_BOOK_NOTEBOOK + m_type, true);
 
     wxMenu *menuOrient = new wxMenu;
-    menuOrient->AppendRadioItem(ID_ORIENT_DEFAULT, wxT("&Default\tCtrl-4"));
-    menuOrient->AppendRadioItem(ID_ORIENT_TOP,     wxT("&Top\tCtrl-5"));
-    menuOrient->AppendRadioItem(ID_ORIENT_BOTTOM,  wxT("&Bottom\tCtrl-6"));
-    menuOrient->AppendRadioItem(ID_ORIENT_LEFT,    wxT("&Left\tCtrl-7"));
-    menuOrient->AppendRadioItem(ID_ORIENT_RIGHT,   wxT("&Right\tCtrl-8"));
-
-    wxMenu *menuDo = new wxMenu;
-    menuDo->Append(ID_ADD_PAGE, wxT("&Add page\tAlt-A"));
-    menuDo->Append(ID_INSERT_PAGE, wxT("&Insert page\tAlt-I"));
-    menuDo->Append(ID_DELETE_CUR_PAGE, wxT("&Delete current page\tAlt-D"));
-    menuDo->Append(ID_DELETE_LAST_PAGE, wxT("D&elete last page\tAlt-L"));
-    menuDo->Append(ID_NEXT_PAGE, wxT("&Next page\tAlt-N"));
+    menuOrient->AppendRadioItem(ID_ORIENT_DEFAULT, wxT("&Default\tCtrl-5"));
+    menuOrient->AppendRadioItem(ID_ORIENT_TOP,     wxT("&Top\tCtrl-6"));
+    menuOrient->AppendRadioItem(ID_ORIENT_BOTTOM,  wxT("&Bottom\tCtrl-7"));
+    menuOrient->AppendRadioItem(ID_ORIENT_LEFT,    wxT("&Left\tCtrl-8"));
+    menuOrient->AppendRadioItem(ID_ORIENT_RIGHT,   wxT("&Right\tCtrl-9"));
+
+    wxMenu *menuPageOperations = new wxMenu;
+    menuPageOperations->Append(ID_ADD_PAGE, wxT("&Add page\tAlt-A"));
+    menuPageOperations->Append(ID_ADD_PAGE_NO_SELECT, wxT("&Add page (don't select)\tAlt-B"));
+    menuPageOperations->Append(ID_INSERT_PAGE, wxT("&Insert page\tAlt-I"));
+    menuPageOperations->Append(ID_DELETE_CUR_PAGE, wxT("&Delete current page\tAlt-D"));
+    menuPageOperations->Append(ID_DELETE_LAST_PAGE, wxT("D&elete last page\tAlt-L"));
+    menuPageOperations->Append(ID_NEXT_PAGE, wxT("&Next page\tAlt-N"));
+#if wxUSE_TREEBOOK
+    menuPageOperations->AppendSeparator();
+    menuPageOperations->Append(ID_ADD_PAGE_BEFORE, wxT("Insert page &before\tAlt-B"));
+    menuPageOperations->Append(ID_ADD_SUB_PAGE, wxT("Add s&ub page\tAlt-U"));
+#endif
+    menuPageOperations->AppendSeparator();
+    menuPageOperations->Append(ID_GO_HOME, wxT("Go to the first page\tCtrl-F"));
+
+    wxMenu *menuOperations = new wxMenu;
+#if wxUSE_HELP
+    menuOperations->Append(ID_CONTEXT_HELP, wxT("&Context help\tCtrl-F1"));
+#endif // wxUSE_HELP
+    menuOperations->Append(ID_HITTEST, wxT("&Hit test\tCtrl-H"));
 
     wxMenu *menuFile = new wxMenu;
     menuFile->Append(wxID_ANY, wxT("&Type"), menuType, wxT("Type of control"));
@@ -232,54 +361,33 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
 
     wxMenuBar *menuBar = new wxMenuBar;
     menuBar->Append(menuFile, wxT("&File"));
-    menuBar->Append(menuDo, wxT("&Operations"));
+    menuBar->Append(menuPageOperations, wxT("&Pages"));
+    menuBar->Append(menuOperations, wxT("&Operations"));
     SetMenuBar(menuBar);
 
     // books creation
-
-    m_panel      = (wxPanel *)      NULL;
-#if wxUSE_NOTEBOOK
-    m_notebook   = (wxNotebook *)   NULL;
-#endif
-#if wxUSE_CHOICEBOOK
-    m_choicebook = (wxChoicebook *) NULL;
-#endif
-#if wxUSE_LISTBOOK
-    m_listbook   = (wxListbook *)   NULL;
-#endif
+    m_panel    = NULL;
+    m_bookCtrl = NULL;
 
     // create a dummy image list with a few icons
-    wxSize imageSize(32, 32);
-
-    m_imageList
-        = new wxImageList( imageSize.GetWidth(), imageSize.GetHeight() );
-
-    m_imageList->Add
-        (
-            wxArtProvider::GetIcon(wxART_INFORMATION, wxART_OTHER, imageSize)
-        );
-
-    m_imageList->Add
-        (
-            wxArtProvider::GetIcon(wxART_QUESTION, wxART_OTHER, imageSize)
-        );
+    const wxSize imageSize(32, 32);
 
-    m_imageList->Add
-        (
-            wxArtProvider::GetIcon(wxART_WARNING, wxART_OTHER, imageSize)
-        );
+    m_imageList = new wxImageList(imageSize.GetWidth(), imageSize.GetHeight());
+    m_imageList->
+        Add(wxArtProvider::GetIcon(wxART_INFORMATION, wxART_OTHER, imageSize));
+    m_imageList->
+        Add(wxArtProvider::GetIcon(wxART_QUESTION, wxART_OTHER, imageSize));
+    m_imageList->
+        Add(wxArtProvider::GetIcon(wxART_WARNING, wxART_OTHER, imageSize));
+    m_imageList->
+        Add(wxArtProvider::GetIcon(wxART_ERROR, wxART_OTHER, imageSize));
 
-    m_imageList->Add
-        (
-            wxArtProvider::GetIcon(wxART_ERROR, wxART_OTHER, imageSize)
-        );
-
-    m_panel = new wxPanel(this, wxID_ANY, wxDefaultPosition, wxDefaultSize,
-        wxTAB_TRAVERSAL | wxCLIP_CHILDREN | wxNO_BORDER | wxNO_FULL_REPAINT_ON_RESIZE);
+    m_panel = new wxPanel(this);
 
 #if USE_LOG
     m_text = new wxTextCtrl(m_panel, wxID_ANY, wxEmptyString,
-        wxDefaultPosition, wxDefaultSize, wxTE_MULTILINE | wxTE_READONLY);
+                            wxDefaultPosition, wxDefaultSize,
+                            wxTE_MULTILINE | wxTE_READONLY);
 
     m_logTargetOld = wxLog::SetActiveTarget( new wxLogTextCtrl(m_text) );
 #endif // USE_LOG
@@ -291,11 +399,10 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
     m_sizerFrame->Add(m_text, 1, wxEXPAND);
 #endif // USE_LOG
 
-    RecreateBooks();
+    RecreateBook();
 
     m_panel->SetSizer(m_sizerFrame);
 
-    m_sizerFrame->Fit(this);
     m_sizerFrame->SetSizeHints(this);
 
     Centre(wxBOTH);
@@ -307,212 +414,271 @@ MyFrame::~MyFrame()
     delete wxLog::SetActiveTarget(m_logTargetOld);
 #endif // USE_LOG
 
-    if (m_imageList)
-    {
-        delete m_imageList;
-        m_imageList = (wxImageList *) NULL;
-    }
+    delete m_imageList;
 }
 
-int MyFrame::SelectFlag(int id, int nb, int lb, int chb)
-{
-    switch (id)
-    {
-        case ID_NOTEBOOK:   return nb;
-        case ID_LISTBOOK:   return lb;
-        case ID_CHOICEBOOK: return chb;
-    }
-    return 0;
-}
-
-#define RECREATE( wxBookType , idBook, oldBook , newBook )                         \
-{                                                                                  \
-    int flags;                                                                     \
-                                                                                   \
-    switch ( m_orient )                                                            \
-    {                                                                              \
-        case ID_ORIENT_TOP:                                                        \
-            flags = SelectFlag(idBook, wxNB_TOP, wxLB_TOP, wxCHB_TOP);             \
-            break;                                                                 \
-                                                                                   \
-        case ID_ORIENT_BOTTOM:                                                     \
-            flags = SelectFlag(idBook, wxNB_BOTTOM, wxLB_BOTTOM, wxCHB_BOTTOM);    \
-            break;                                                                 \
-                                                                                   \
-        case ID_ORIENT_LEFT:                                                       \
-            flags = SelectFlag(idBook, wxNB_LEFT, wxLB_LEFT, wxCHB_LEFT);          \
-            break;                                                                 \
-                                                                                   \
-        case ID_ORIENT_RIGHT:                                                      \
-            flags = SelectFlag(idBook, wxNB_RIGHT, wxLB_RIGHT, wxCHB_RIGHT);       \
-            break;                                                                 \
-                                                                                   \
-        default:                                                                   \
-            flags = SelectFlag(idBook, wxNB_DEFAULT, wxLB_DEFAULT, wxCHB_DEFAULT); \
-    }                                                                              \
-                                                                                   \
-    if ( m_multi && ( idBook == ID_NOTEBOOK ) )                                    \
-        flags |= wxNB_MULTILINE;                                                   \
-                                                                                   \
-    wxBookType *oldBook = newBook;                                                 \
-                                                                                   \
-    newBook = new wxBookType(m_panel, idBook,                                      \
-                             wxDefaultPosition, wxDefaultSize,                     \
-                             flags);                                               \
-                                                                                   \
-    if ( m_chkShowImages )                                                         \
-    {                                                                              \
-        newBook->SetImageList(m_imageList);                                        \
-    }                                                                              \
-                                                                                   \
-    if (oldBook)                                                                   \
-    {                                                                              \
-        int sel = oldBook->GetSelection();                                         \
-                                                                                   \
-        int count = oldBook->GetPageCount();                                       \
-        for (int n = 0; n < count; n++)                                            \
-        {                                                                          \
-            wxString str = oldBook->GetPageText(n);                                \
-                                                                                   \
-            wxWindow *page = CreatePage(newBook, str);                             \
-            newBook->AddPage(page, str, false, GetIconIndex(newBook) );            \
-        }                                                                          \
-                                                                                   \
-        m_sizerFrame->Detach(oldBook);                                             \
-                                                                                   \
-        delete oldBook;                                                            \
-                                                                                   \
-        if (sel != wxNOT_FOUND)                                                    \
-        {                                                                          \
-            newBook->SetSelection(sel);                                            \
-        }                                                                          \
-                                                                                   \
-    }                                                                              \
-    else                                                                           \
-    {                                                                              \
-        CreateInitialPages(newBook);                                               \
-    }                                                                              \
-                                                                                   \
-    m_sizerFrame->Insert(0, newBook, 5, wxEXPAND | wxALL, 4);                      \
-                                                                                   \
-    m_sizerFrame->Hide(newBook);                                                   \
-}
-
-void MyFrame::RecreateBooks()
-{
+// DISPATCH_ON_TYPE() macro is an ugly way to write the "same" code for
+// different wxBookCtrlBase-derived classes without duplicating code and
+// without using templates, it expands into "before <xxx> after" where "xxx"
+// part is control class-specific
 #if wxUSE_NOTEBOOK
-    RECREATE( wxNotebook   , ID_NOTEBOOK   , notebook   , m_notebook );
+    #define CASE_NOTEBOOK(x) case Type_Notebook: x; break;
+#else
+    #define CASE_NOTEBOOK(x)
 #endif
+
 #if wxUSE_LISTBOOK
-    RECREATE( wxListbook   , ID_LISTBOOK   , listbook   , m_listbook );
+    #define CASE_LISTBOOK(x) case Type_Listbook: x; break;
+#else
+    #define CASE_LISTBOOK(x)
 #endif
+
 #if wxUSE_CHOICEBOOK
-    RECREATE( wxChoicebook , ID_CHOICEBOOK , choicebook , m_choicebook );
+    #define CASE_CHOICEBOOK(x) case Type_Choicebook: x; break;
+#else
+    #define CASE_CHOICEBOOK(x)
 #endif
 
-    ShowCurrentBook();
-}
-
-wxBookCtrlBase *MyFrame::GetCurrentBook()
-{
-    switch (m_type)
-    {
-#if wxUSE_NOTEBOOK
-        case ID_BOOK_NOTEBOOK:   return m_notebook;
-#endif
-#if wxUSE_LISTBOOK
-        case ID_BOOK_LISTBOOK:   return m_listbook;
+#if wxUSE_TREEBOOK
+    #define CASE_TREEBOOK(x) case Type_Treebook: x; break;
+#else
+    #define CASE_TREEBOOK(x)
 #endif
-#if wxUSE_CHOICEBOOK
-        case ID_BOOK_CHOICEBOOK: return m_choicebook;
+
+#if wxUSE_TOOLBOOK
+    #define CASE_TOOLBOOK(x) case Type_Toolbook: x; break;
+#else
+    #define CASE_TOOLBOOK(x)
 #endif
+
+#define DISPATCH_ON_TYPE(before, nb, lb, cb, tb, toolb, after)                \
+    switch ( m_type )                                                         \
+    {                                                                         \
+        CASE_NOTEBOOK(before nb after)                                        \
+        CASE_LISTBOOK(before lb after)                                        \
+        CASE_CHOICEBOOK(before cb after)                                      \
+        CASE_TREEBOOK(before tb after)                                        \
+        CASE_TOOLBOOK(before toolb after)                                     \
+                                                                              \
+        default:                                                              \
+            wxFAIL_MSG( wxT("unknown book control type") );                    \
     }
-    return NULL;
+
+int MyFrame::TranslateBookFlag(int nb, int lb, int chb, int tbk, int toolbk) const
+{
+    int flag = 0;
+
+    DISPATCH_ON_TYPE(flag =, nb,  lb,  chb,  tbk, toolbk, + 0);
+
+    return flag;
 }
 
-void MyFrame::ShowCurrentBook()
+void MyFrame::RecreateBook()
 {
-    switch(m_type)
+    int flags;
+    switch ( m_orient )
     {
-#if wxUSE_NOTEBOOK
-        case ID_BOOK_NOTEBOOK:   if(m_notebook)   m_sizerFrame->Show(m_notebook);   break;
-#endif
-#if wxUSE_LISTBOOK
-        case ID_BOOK_LISTBOOK:   if(m_listbook)   m_sizerFrame->Show(m_listbook);   break;
-#endif
-#if wxUSE_CHOICEBOOK
-        case ID_BOOK_CHOICEBOOK: if(m_choicebook) m_sizerFrame->Show(m_choicebook); break;
-#endif
+        case ID_ORIENT_TOP:
+            flags = wxBK_TOP;
+            break;
+
+        case ID_ORIENT_BOTTOM:
+            flags = wxBK_BOTTOM;
+            break;
+
+        case ID_ORIENT_LEFT:
+            flags = wxBK_LEFT;
+            break;
+
+        case ID_ORIENT_RIGHT:
+            flags = wxBK_RIGHT;
+            break;
+
+        default:
+            flags = wxBK_DEFAULT;
     }
 
+    if ( m_multi && m_type == Type_Notebook )
+        flags |= wxNB_MULTILINE;
+
+    wxBookCtrlBase *oldBook = m_bookCtrl;
+
+    m_bookCtrl = NULL;
+
+    DISPATCH_ON_TYPE(m_bookCtrl = new,
+                         wxNotebook,
+                         wxListbook,
+                         wxChoicebook,
+                         wxTreebook,
+                         wxToolbook,
+                     (m_panel, wxID_ANY, wxDefaultPosition, wxDefaultSize, flags));
+
+    if ( !m_bookCtrl )
+        return;
+
+    m_bookCtrl->Hide();
+
+    if ( m_chkShowImages )
+    {
+        m_bookCtrl->SetImageList(m_imageList);
+    }
+
+    if ( oldBook )
+    {
+#if wxUSE_TREEBOOK
+        // we only need the old treebook if we're recreating another treebook
+        wxTreebook *tbkOld = m_type == Type_Treebook
+                                ? wxDynamicCast(oldBook, wxTreebook)
+                                : NULL;
+#endif // wxUSE_TREEBOOK
+
+        const int count = oldBook->GetPageCount();
+        for ( int n = 0; n < count; n++ )
+        {
+            const int image = GetIconIndex(m_bookCtrl);
+            const wxString str = oldBook->GetPageText(n);
+
+            wxWindow *page = CreatePage(m_bookCtrl, str);
+
+            // treebook complication: need to account for possible parent page
+#if wxUSE_TREEBOOK
+            if ( tbkOld )
+            {
+                const int parent = tbkOld->GetPageParent(n);
+                if ( parent != wxNOT_FOUND )
+                {
+                    wxStaticCast(m_bookCtrl, wxTreebook)->
+                        InsertSubPage(parent, page, str, false, image);
+
+                    // skip adding it again below
+                    continue;
+                }
+            }
+#endif // wxUSE_TREEBOOK
+
+            m_bookCtrl->AddPage(page, str, false, image);
+        }
+
+        const int sel = oldBook->GetSelection();
+        if ( sel != wxNOT_FOUND )
+            m_bookCtrl->SetSelection(sel);
+
+
+        m_sizerFrame->Detach(oldBook);
+        delete oldBook;
+    }
+    else // no old book
+    {
+        CreateInitialPages(m_bookCtrl);
+    }
+
+    m_sizerFrame->Insert(0, m_bookCtrl, wxSizerFlags(5).Expand().Border());
+
+    m_sizerFrame->Show(m_bookCtrl);
     m_sizerFrame->Layout();
 }
 
-BEGIN_EVENT_TABLE(MyFrame, wxFrame)
-    // File menu
-    EVT_MENU_RANGE(ID_BOOK_NOTEBOOK,ID_BOOK_MAX,MyFrame::OnType)
-    EVT_MENU_RANGE(ID_ORIENT_DEFAULT,ID_ORIENT_MAX,MyFrame::OnOrient)
-    EVT_MENU(ID_SHOW_IMAGES, MyFrame::OnShowImages)
-    EVT_MENU(ID_MULTI, MyFrame::OnMulti)
-    EVT_MENU(wxID_EXIT,MyFrame::OnExit)
+void MyFrame::AddFlagStrIfFlagPresent(wxString & flagStr, long flags, long flag, 
+                                      const wxChar * flagName) const
+{
+    if( (flags & flag) == flag )
+    {
+        if( !flagStr.empty() )
+            flagStr += wxT(" | ");
+        flagStr += flagName;
+    }
+}
 
-    // Operations menu
-    EVT_MENU(ID_ADD_PAGE, MyFrame::OnAddPage)
-    EVT_MENU(ID_INSERT_PAGE, MyFrame::OnInsertPage)
-    EVT_MENU(ID_DELETE_CUR_PAGE, MyFrame::OnDeleteCurPage)
-    EVT_MENU(ID_DELETE_LAST_PAGE, MyFrame::OnDeleteLastPage)
-    EVT_MENU(ID_NEXT_PAGE, MyFrame::OnNextPage)
+wxPanel *MyFrame::CreateNewPage() const
+{
+    wxPanel *panel = new wxPanel(m_bookCtrl, wxID_ANY );
 
-    // Book controls
-#if wxUSE_NOTEBOOK
-    EVT_NOTEBOOK_PAGE_CHANGED(ID_NOTEBOOK, MyFrame::OnNotebook)
-    EVT_NOTEBOOK_PAGE_CHANGING(ID_NOTEBOOK, MyFrame::OnNotebook)
-#endif
-#if wxUSE_LISTBOOK
-    EVT_LISTBOOK_PAGE_CHANGED(ID_LISTBOOK, MyFrame::OnListbook)
-    EVT_LISTBOOK_PAGE_CHANGING(ID_LISTBOOK, MyFrame::OnListbook)
-#endif
-#if wxUSE_CHOICEBOOK
-    EVT_CHOICEBOOK_PAGE_CHANGED(ID_CHOICEBOOK, MyFrame::OnChoicebook)
-    EVT_CHOICEBOOK_PAGE_CHANGING(ID_CHOICEBOOK, MyFrame::OnChoicebook)
+#if wxUSE_HELP
+    panel->SetHelpText( wxT( "Panel with \"First\" and \"Second\" buttons" ) );
 #endif
 
-    // Update title in idle time
-    EVT_IDLE(MyFrame::OnIdle)
-END_EVENT_TABLE()
+    (void) new wxButton(panel, wxID_ANY, wxT("First button"), wxPoint(10, 30));
+    (void) new wxButton(panel, wxID_ANY, wxT("Second button"), wxPoint(150, 30));
+
+    return panel;
+}
+
+
+//-----------------------------------------------------------------------------
+// MyFrame - event handlers
+//-----------------------------------------------------------------------------
+
+#if wxUSE_HELP
+
+void MyFrame::OnContextHelp(wxCommandEvent& WXUNUSED(event))
+{
+    // launches local event loop
+    wxContextHelp ch( this );
+}
+
+#endif // wxUSE_HELP
+
+void MyFrame::OnHitTest(wxCommandEvent& WXUNUSED(event))
+{
+    wxBookCtrlBase * book = GetCurrentBook();
+    const wxPoint pt = ::wxGetMousePosition();
+
+    long flags;
+    int pagePos = book->HitTest( book->ScreenToClient(pt), &flags );
+
+    wxString flagsStr;
+
+    AddFlagStrIfFlagPresent( flagsStr, flags, wxBK_HITTEST_NOWHERE, wxT("wxBK_HITTEST_NOWHERE") );
+    AddFlagStrIfFlagPresent( flagsStr, flags, wxBK_HITTEST_ONICON,  wxT("wxBK_HITTEST_ONICON") );
+    AddFlagStrIfFlagPresent( flagsStr, flags, wxBK_HITTEST_ONLABEL, wxT("wxBK_HITTEST_ONLABEL") );
+    AddFlagStrIfFlagPresent( flagsStr, flags, wxBK_HITTEST_ONPAGE,  wxT("wxBK_HITTEST_ONPAGE") );
+
+    wxLogMessage(wxT("HitTest at (%d,%d): %d: %s"),
+                 pt.x,
+                 pt.y,
+                 pagePos,
+                 flagsStr.c_str());
+}
 
 void MyFrame::OnType(wxCommandEvent& event)
 {
-    wxBookCtrlBase *currBook = GetCurrentBook();
+    m_type = static_cast<BookType>(event.GetId() - ID_BOOK_NOTEBOOK);
+
+    if ( m_bookCtrl )
+        m_sizerFrame->Hide(m_bookCtrl);
 
-    m_type = event.GetId();
+    RecreateBook();
+}
 
-    if (currBook)
-        m_sizerFrame->Hide(currBook);
+#if wxUSE_TREEBOOK
 
-    ShowCurrentBook();
+void MyFrame::OnUpdateTreeMenu(wxUpdateUIEvent& event)
+{
+    event.Enable(m_type == Type_Treebook);
 }
 
+#endif // wxUSE_TREEBOOK
+
 void MyFrame::OnOrient(wxCommandEvent& event)
 {
     m_orient = event.GetId();
-    RecreateBooks();
+    RecreateBook();
     m_sizerFrame->Layout();
 }
 
 void MyFrame::OnShowImages(wxCommandEvent& event)
 {
     m_chkShowImages = event.IsChecked();
-    RecreateBooks();
+    RecreateBook();
     m_sizerFrame->Layout();
 }
 
 void MyFrame::OnMulti(wxCommandEvent& event)
 {
     m_multi = event.IsChecked();
-    RecreateBooks();
+    RecreateBook();
     m_sizerFrame->Layout();
-    wxLogMessage(_T("Multiline setting works only in wxNotebook."));
+    wxLogMessage(wxT("Multiline setting works only in wxNotebook."));
 }
 
 void MyFrame::OnExit(wxCommandEvent& WXUNUSED(event))
@@ -522,22 +688,94 @@ void MyFrame::OnExit(wxCommandEvent& WXUNUSED(event))
 
 void MyFrame::OnAddPage(wxCommandEvent& WXUNUSED(event))
 {
-    static unsigned s_pageAdded = 0;
+    wxBookCtrlBase *currBook = GetCurrentBook();
 
+    if ( currBook )
+    {
+        static unsigned s_pageAdded = 0;
+        currBook->AddPage(CreateNewPage(),
+                          wxString::Format
+                          (
+                            ADDED_PAGE_NAME wxT("%u"),
+                            ++s_pageAdded
+                          ),
+                          true,
+                          GetIconIndex(currBook));
+    }
+}
+
+void MyFrame::OnAddPageNoSelect(wxCommandEvent& WXUNUSED(event))
+{
     wxBookCtrlBase *currBook = GetCurrentBook();
 
     if ( currBook )
     {
-        wxPanel *panel = new wxPanel( currBook, wxID_ANY );
-        (void) new wxButton( panel, wxID_ANY, wxT("First button"),
-            wxPoint(10, 10), wxDefaultSize );
-        (void) new wxButton( panel, wxID_ANY, wxT("Second button"),
-            wxPoint(50, 100), wxDefaultSize );
-
-        currBook->AddPage(panel, wxString::Format(ADDED_PAGE_NAME wxT("%u"),
-            ++s_pageAdded), true, GetIconIndex(currBook) );
+        static unsigned s_pageAdded = 0;
+        currBook->AddPage(CreateNewPage(),
+                          wxString::Format
+                          (
+                            ADDED_PAGE_NAME wxT("%u"),
+                            ++s_pageAdded
+                          ),
+                          false,
+                          GetIconIndex(currBook));
+    }
+}
+
+#if wxUSE_TREEBOOK
+void MyFrame::OnAddSubPage(wxCommandEvent& WXUNUSED(event))
+{
+    wxTreebook *currBook = wxDynamicCast(GetCurrentBook(), wxTreebook);
+    if ( currBook )
+    {
+        const int selPos = currBook->GetSelection();
+        if ( selPos == wxNOT_FOUND )
+        {
+            wxLogError(wxT("Select the parent page first!"));
+            return;
+        }
+
+        static unsigned s_subPageAdded = 0;
+        currBook->InsertSubPage
+                  (
+                    selPos,
+                    CreateNewPage(),
+                    wxString::Format
+                    (
+                     ADDED_SUB_PAGE_NAME wxT("%u"),
+                     ++s_subPageAdded
+                    ),
+                    true,
+                    GetIconIndex(currBook)
+                  );
+    }
+}
+
+void MyFrame::OnAddPageBefore(wxCommandEvent& WXUNUSED(event))
+{
+    wxBookCtrlBase *currBook = GetCurrentBook();
+    if ( currBook )
+    {
+        const int selPos = currBook->GetSelection();
+        if ( selPos == wxNOT_FOUND )
+        {
+            wxLogError(wxT("Select the parent page first!"));
+            return;
+        }
+
+        static unsigned s_subPageAdded = 0;
+        currBook->InsertPage(selPos,
+                             CreateNewPage(),
+                             wxString::Format
+                             (
+                                ADDED_PAGE_NAME_BEFORE wxT("%u"),
+                                ++s_subPageAdded
+                             ),
+                             true,
+                             GetIconIndex(currBook));
     }
 }
+#endif // wxUSE_TREEBOOK
 
 void MyFrame::OnInsertPage(wxCommandEvent& WXUNUSED(event))
 {
@@ -597,6 +835,18 @@ void MyFrame::OnNextPage(wxCommandEvent& WXUNUSED(event))
     }
 }
 
+void MyFrame::OnGoHome(wxCommandEvent& WXUNUSED(event))
+{
+    wxBookCtrlBase *currBook = GetCurrentBook();
+
+    if ( currBook )
+    {
+        // ChangeSelection shouldn't send any events, SetSelection() should
+        currBook->ChangeSelection(0);
+        //currBook->SetSelection(0);
+    }
+}
+
 void MyFrame::OnIdle( wxIdleEvent& WXUNUSED(event) )
 {
     static int s_nPages = wxNOT_FOUND;
@@ -627,59 +877,112 @@ void MyFrame::OnIdle( wxIdleEvent& WXUNUSED(event) )
     }
 }
 
-#define BOOKEVENT(OnBook,wxBookEvent,bookStr,wxEVT_PAGE_CHANGED,wxEVT_PAGE_CHANGING,s_num) \
-void MyFrame::OnBook(wxBookEvent& event)                                                   \
-{                                                                                          \
-    wxString str = wxT("Unknown ");                                                        \
-    str << wxT(bookStr);                                                                   \
-    str << wxT(" event");                                                                  \
-                                                                                           \
-    wxEventType eventType = event.GetEventType();                                          \
-                                                                                           \
-    if (eventType == wxEVT_PAGE_CHANGED)                                                   \
-    {                                                                                      \
-        str = wxT("Changed");                                                              \
-    }                                                                                      \
-    else if (eventType == wxEVT_PAGE_CHANGING)                                             \
-    {                                                                                      \
-        int idx = event.GetOldSelection();                                                 \
-        wxBookCtrlBase *book = (wxBookCtrlBase *)event.GetEventObject();                   \
-        if ( idx != wxNOT_FOUND && book && book->GetPageText(idx) == VETO_PAGE_NAME )      \
-        {                                                                                  \
-            if                                                                             \
-            (                                                                              \
-                wxMessageBox(                                                              \
-                wxT("Are you sure you want to leave this page?\n")                         \
-                wxT("(This demonstrates veto-ing)"),                                       \
-                          wxT("Notebook sample"),                                          \
-                          wxICON_QUESTION | wxYES_NO, this) != wxYES )                     \
-            {                                                                              \
-                event.Veto();                                                              \
-            }                                                                              \
-                                                                                           \
-        }                                                                                  \
-                                                                                           \
-        str = wxT("Changing");                                                             \
-    }                                                                                      \
-                                                                                           \
-    static int s_num = 0;                                                                  \
-                                                                                           \
-    wxString logMsg;                                                                       \
-    logMsg.Printf(wxT("%s event #%d: %s (%d) Sel %d, OldSel %d"),                          \
-                  wxT(bookStr),s_num++, str.c_str(), eventType,                            \
-                  event.GetSelection(), event.GetOldSelection());                          \
-                                                                                           \
-    wxLogMessage(logMsg.c_str());                                                          \
-                                                                                           \
-    m_text->SetInsertionPointEnd();                                                        \
-}
-
+void MyFrame::OnBookCtrl(wxBookCtrlBaseEvent& event)
+{
+    static const struct EventInfo
+    {
+        wxEventType typeChanged,
+                    typeChanging;
+        const wxChar *name;
+    } events[] =
+    {
 #if wxUSE_NOTEBOOK
-BOOKEVENT(OnNotebook,wxNotebookEvent,"wxNotebook",wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED,wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING,s_numNotebookEvents)
-#endif
-#if wxUSE_CHOICEBOOK
-BOOKEVENT(OnChoicebook,wxChoicebookEvent,"wxChoicebook",wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGED,wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGING,s_numChoicebookEvents)
-#endif
+        {
+            wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED,
+            wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING,
+            wxT("wxNotebook")
+        },
+#endif // wxUSE_NOTEBOOK
 #if wxUSE_LISTBOOK
-BOOKEVENT(OnListbook,wxListbookEvent,"wxListbook",wxEVT_COMMAND_LISTBOOK_PAGE_CHANGED,wxEVT_COMMAND_LISTBOOK_PAGE_CHANGING,s_numListbookEvents)
+        {
+            wxEVT_COMMAND_LISTBOOK_PAGE_CHANGED,
+            wxEVT_COMMAND_LISTBOOK_PAGE_CHANGING,
+            wxT("wxListbook")
+        },
+#endif // wxUSE_LISTBOOK
+#if wxUSE_CHOICEBOOK
+        {
+            wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGED,
+            wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGING,
+            wxT("wxChoicebook")
+        },
+#endif // wxUSE_CHOICEBOOK
+#if wxUSE_TREEBOOK
+        {
+            wxEVT_COMMAND_TREEBOOK_PAGE_CHANGED,
+            wxEVT_COMMAND_TREEBOOK_PAGE_CHANGING,
+            wxT("wxTreebook")
+        },
+#endif // wxUSE_TREEBOOK
+#if wxUSE_TOOLBOOK
+        {
+            wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGED,
+            wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGING,
+            wxT("wxToolbook")
+        },
+#endif // wxUSE_TOOLBOOK
+    };
+
+
+    wxString nameEvent,
+             nameControl,
+             veto;
+    const wxEventType eventType = event.GetEventType();
+    for ( size_t n = 0; n < WXSIZEOF(events); n++ )
+    {
+        const EventInfo& ei = events[n];
+        if ( eventType == ei.typeChanged )
+        {
+            nameEvent = wxT("Changed");
+        }
+        else if ( eventType == ei.typeChanging )
+        {
+            const int idx = event.GetOldSelection();
+
+            // NB: can't use wxStaticCast here as wxBookCtrlBase is not in
+            //     wxRTTI
+            const wxBookCtrlBase * const
+                book = static_cast<wxBookCtrlBase *>(event.GetEventObject());
+            if ( idx != wxNOT_FOUND &&
+                    book && book->GetPageText(idx) == VETO_PAGE_NAME )
+            {
+                if ( wxMessageBox
+                     (
+                      wxT("Are you sure you want to leave this page?\n")
+                      wxT("(This demonstrates veto-ing)"),
+                      wxT("Notebook sample"),
+                      wxICON_QUESTION | wxYES_NO,
+                      this
+                     ) != wxYES )
+                {
+                    event.Veto();
+                    veto = wxT(" (vetoed)");
+                }
+            }
+
+            nameEvent = wxT("Changing");
+        }
+        else // skip end of the loop
+        {
+            continue;
+        }
+
+        nameControl = ei.name;
+        break;
+    }
+
+    static int s_num = 0;
+
+    wxLogMessage(wxT("Event #%d: %s: %s (%d) new sel %d, old %d%s"),
+                 ++s_num,
+                 nameControl.c_str(),
+                 nameEvent.c_str(),
+                 eventType,
+                 event.GetSelection(),
+                 event.GetOldSelection(),
+                 veto.c_str());
+
+#if USE_LOG
+    m_text->SetInsertionPointEnd();
 #endif
+}