wx.lib.agw.aui.tabmdi.AuiMDIClientWindow¶
AuiNotebook is a notebook control which implements many features common in applications with dockable panes. Specifically, AuiNotebook implements functionality which allows the user to rearrange tab order via drag-and-drop, split the tab window into many different splitter configurations, and toggle through different themes to customize the control’s look and feel.
An effort has been made to try to maintain an API as similar to that of Notebook.
The default theme that is used is AuiDefaultTabArt, which provides a modern, glossy
look and feel. The theme can be changed by calling AuiNotebook.SetArtProvider.
Class Hierarchy¶
Known Superclasses¶
wx.lib.agw.aui.auibook.AuiNotebook
Methods Summary¶
Default class constructor. |
|
Handles the |
|
Sets the page selection. Calling this method will generate a page change event. |
Class API¶
- class AuiMDIClientWindow(auibook.AuiNotebook)¶
AuiNotebook is a notebook control which implements many features common in applications with dockable panes. Specifically, AuiNotebook implements functionality which allows the user to rearrange tab order via drag-and-drop, split the tab window into many different splitter configurations, and toggle through different themes to customize the control’s look and feel.
An effort has been made to try to maintain an API as similar to that of
Notebook.The default theme that is used is
AuiDefaultTabArt, which provides a modern, glossy look and feel. The theme can be changed by callingAuiNotebook.SetArtProvider.
Methods¶
- __init__(self, parent, agwStyle=0)¶
Default class constructor.
- Parameters:
parent (wx.Window) – the
AuiNotebookparent;id (integer) – an identifier for the control: a value of -1 is taken to mean a default;
pos (wx.Point) – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;
size (wx.Size) – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform;
style (integer) – the underlying
Panelwindow style;agwStyle (integer) – the AGW-specific window style. This can be a combination of the following bits:
Flag name
Description
AUI_NB_TOPWith this style, tabs are drawn along the top of the notebook
AUI_NB_LEFTWith this style, tabs are drawn along the left of the notebook. Not implemented yet.
AUI_NB_RIGHTWith this style, tabs are drawn along the right of the notebook. Not implemented yet.
AUI_NB_BOTTOMWith this style, tabs are drawn along the bottom of the notebook
AUI_NB_TAB_SPLITAllows the tab control to be split by dragging a tab
AUI_NB_TAB_MOVEAllows a tab to be moved horizontally by dragging
AUI_NB_TAB_EXTERNAL_MOVEAllows a tab to be moved to another tab control
AUI_NB_TAB_FIXED_WIDTHWith this style, all tabs have the same width
AUI_NB_SCROLL_BUTTONSWith this style, left and right scroll buttons are displayed
AUI_NB_WINDOWLIST_BUTTONWith this style, a drop-down list of windows is available
AUI_NB_CLOSE_BUTTONWith this style, a close button is available on the tab bar
AUI_NB_CLOSE_ON_ACTIVE_TABWith this style, a close button is available on the active tab
AUI_NB_CLOSE_ON_ALL_TABSWith this style, a close button is available on all tabs
AUI_NB_MIDDLE_CLICK_CLOSEAllows to close
AuiNotebooktabs by mouse middle button clickAUI_NB_SUB_NOTEBOOKThis style is used by
AuiManagerto create automatic AuiNotebooksAUI_NB_HIDE_ON_SINGLE_TABHides the tab window if only one tab is present
AUI_NB_SMART_TABSUse Smart Tabbing, like
Alt+Tabon WindowsAUI_NB_USE_IMAGES_DROPDOWNUses images on dropdown window list menu instead of check items
AUI_NB_CLOSE_ON_TAB_LEFTDraws the tab close button on the left instead of on the right (a la Camino browser)
AUI_NB_TAB_FLOATAllows the floating of single tabs. Known limitation: when the notebook is more or less full screen, tabs cannot be dragged far enough outside of the notebook to become floating pages
AUI_NB_DRAW_DND_TABDraws an image representation of a tab while dragging (on by default)
AUI_NB_ORDER_BY_ACCESSTab navigation order by last access time for the tabs
AUI_NB_NO_TAB_FOCUSDon’t draw tab focus rectangle
Default value for agwStyle is:
AUI_NB_DEFAULT_STYLE=AUI_NB_TOP|AUI_NB_TAB_SPLIT|AUI_NB_TAB_MOVE|AUI_NB_SCROLL_BUTTONS|AUI_NB_CLOSE_ON_ACTIVE_TAB|AUI_NB_MIDDLE_CLICK_CLOSE|AUI_NB_DRAW_DND_TABname (string) – the window name.
- OnPageChanged(self, event)¶
- OnPageClose(self, event)¶
- OnSize(self, event)¶
Handles the
wx.EVT_SIZEevent forAuiNotebook.- Parameters:
event – a
wx.SizeEventevent to be processed.
- PageChanged(self, old_selection, new_selection)¶
- SetSelection(self, nPage)¶
Sets the page selection. Calling this method will generate a page change event.
- Parameters:
new_page (integer) – the index of the new selection;
force (bool) – whether to force the selection or not.