BookCtrl Overview

Introduction

A book control is a convenient way of displaying multiple pages of information, displayed one page at a time. wxPython has five variants of this control:

• wx.Choicebook: controlled by a wx.Choice
• wx.Listbook: controlled by a wx.ListCtrl
• wx.Notebook: uses a row of tabs
• wx.Treebook: controlled by a wx.TreeCtrl
• wx.Toolbook: controlled by a wx.ToolBar

Best Book

wx.BookCtrlBase is mapped to the class best suited for a given platform. Currently it provides wx.Choicebook for smartphones equipped with WinCE, and wx.Notebook for all other platforms. The mapping consists of:

wx.BookCtrl	wx.Choicebook or wx.Notebook
wxEVT_COMMAND_BOOKCTRL_PAGE_CHANGED	wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGED or wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED
wxEVT_COMMAND_BOOKCTRL_PAGE_CHANGING	wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGING or wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING
EVT_BOOKCTRL_PAGE_CHANGED	EVT_CHOICEBOOK_PAGE_CHANGED or EVT_NOTEBOOK_PAGE_CHANGED
EVT_BOOKCTRL_PAGE_CHANGING	EVT_CHOICEBOOK_PAGE_CHANGING or EVT_NOTEBOOK_PAGE_CHANGING

For orientation of the book controller, use following flags in style:

• wx.BK_TOP: controller above pages
• wx.BK_BOTTOM: controller below pages
• wx.BK_LEFT: controller on the left
• wx.BK_RIGHT: controller on the right
• wx.BK_DEFAULT: native controller placement