Phoenix Logo

phoenix_title wx.lib.agw.aui.tabart.ChromeTabArt

A class to draw tabs using the Google Chrome browser style. It uses custom bitmap to render the tabs, so that the look and feel is as close as possible to the Chrome style.


class_hierarchy Class Hierarchy

Inheritance diagram for class ChromeTabArt:


method_summary Methods Summary

__init__ Default class constructor.
Clone Clones the art object.
DrawTab Draws a single tab.
GetTabSize Returns the tab size for the given caption, bitmap and button state.
SetAGWFlags Sets the tab art flags.
SetBitmaps Assigns the tab custom bitmaps
SetSizingInfo Sets the tab sizing information.

api Class API



class ChromeTabArt(AuiDefaultTabArt)

A class to draw tabs using the Google Chrome browser style. It uses custom bitmap to render the tabs, so that the look and feel is as close as possible to the Chrome style.


Methods



__init__(self)

Default class constructor.



Clone(self)

Clones the art object.



DrawTab(self, dc, wnd, page, in_rect, close_button_state, paint_control=False)

Draws a single tab.

Parameters:
  • dc – a wx.DC device context;
  • wnd – a wx.Window instance object;
  • page – the tab control page associated with the tab;
  • in_rect (wx.Rect) – rectangle the tab should be confined to;
  • close_button_state (integer) – the state of the close button on the tab;
  • paint_control (bool) – whether to draw the control inside a tab (if any) on a MemoryDC.


GetTabSize(self, dc, wnd, caption, bitmap, active, close_button_state, control=None)

Returns the tab size for the given caption, bitmap and button state.

Parameters:
  • dc – a wx.DC device context;
  • wnd – a wx.Window instance object;
  • caption (string) – the tab text caption;
  • bitmap (wx.Bitmap) – the bitmap displayed on the tab;
  • active (bool) – whether the tab is selected or not;
  • close_button_state (integer) – the state of the close button on the tab;
  • control (wx.Window) – a wx.Window instance inside a tab (or None).


SetAGWFlags(self, agwFlags)

Sets the tab art flags.

Parameters:agwFlags (integer) – a combination of the following values:

Flag name Description
AUI_NB_TOP With this style, tabs are drawn along the top of the notebook
AUI_NB_LEFT With this style, tabs are drawn along the left of the notebook. Not implemented yet.
AUI_NB_RIGHT With this style, tabs are drawn along the right of the notebook. Not implemented yet.
AUI_NB_BOTTOM With this style, tabs are drawn along the bottom of the notebook
AUI_NB_TAB_SPLIT Allows the tab control to be split by dragging a tab
AUI_NB_TAB_MOVE Allows a tab to be moved horizontally by dragging
AUI_NB_TAB_EXTERNAL_MOVE Allows a tab to be moved to another tab control
AUI_NB_TAB_FIXED_WIDTH With this style, all tabs have the same width
AUI_NB_SCROLL_BUTTONS With this style, left and right scroll buttons are displayed
AUI_NB_WINDOWLIST_BUTTON With this style, a drop-down list of windows is available
AUI_NB_CLOSE_BUTTON With this style, a close button is available on the tab bar
AUI_NB_CLOSE_ON_ACTIVE_TAB With this style, a close button is available on the active tab
AUI_NB_CLOSE_ON_ALL_TABS With this style, a close button is available on all tabs
AUI_NB_MIDDLE_CLICK_CLOSE Allows to close AuiNotebook tabs by mouse middle button click
AUI_NB_SUB_NOTEBOOK This style is used by AuiManager to create automatic AuiNotebooks
AUI_NB_HIDE_ON_SINGLE_TAB Hides the tab window if only one tab is present
AUI_NB_SMART_TABS Use Smart Tabbing, like Alt + Tab on Windows
AUI_NB_USE_IMAGES_DROPDOWN Uses images on dropdown window list menu instead of check items
AUI_NB_CLOSE_ON_TAB_LEFT Draws the tab close button on the left instead of on the right (a la Camino browser)
AUI_NB_TAB_FLOAT Allows 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_TAB Draws an image representation of a tab while dragging (on by default)
AUI_NB_ORDER_BY_ACCESS Tab navigation order by last access time for the tabs
AUI_NB_NO_TAB_FOCUS Don’t draw tab focus rectangle

Note

Overridden from AuiDefaultTabArt.



SetBitmaps(self, mirror)

Assigns the tab custom bitmaps

Parameters:mirror (bool) – whether to vertically mirror the bitmap or not.


SetSizingInfo(self, tab_ctrl_size, tab_count, minMaxTabWidth)

Sets the tab sizing information.

Parameters:
  • tab_ctrl_size (wx.Size) – the size of the tab control area;
  • tab_count (integer) – the number of tabs;
  • minMaxTabWidth (tuple) – a tuple containing the minimum and maximum tab widths to be used when the AUI_NB_TAB_FIXED_WIDTH style is active.