phoenix_title wx.lib.agw.labelbook.LabelContainer

Base class for LabelBook.


class_hierarchy Class Hierarchy

Inheritance diagram for class LabelContainer:

method_summary Methods Summary

__init__

Default class constructor.

CanDoBottomStyle

Allows the parent to examine the children type. Some implementation

DrawBackgroundBitmap

Draws a bitmap as the background of the control.

DrawLabel

Draws a label using the specified dc.

DrawRegularHover

Draws a rounded rectangle around the current tab.

DrawWebHover

Draws a web style hover effect (cursor set to hand & text is underlined).

GetColour

Returns a colour for a parameter.

GetTabAreaWidth

Returns the width of the tab area.

InitializeColours

Initializes the colours map to be used for this control.

OnEraseBackground

Handles the wx.EVT_ERASE_BACKGROUND event for LabelContainer.

OnMouseLeaveWindow

Handles the wx.EVT_LEAVE_WINDOW event for LabelContainer.

OnMouseLeftDown

Handles the wx.EVT_LEFT_DOWN event for LabelContainer.

OnMouseLeftUp

Handles the wx.EVT_LEFT_UP event for LabelContainer.

OnMouseMove

Handles the wx.EVT_MOTION event for LabelContainer.

OnPaint

Handles the wx.EVT_PAINT event for LabelContainer.

OnSize

Handles the wx.EVT_SIZE event for LabelContainer.

Resize

Actually resizes the tab area.

SetBackgroundBitmap

Sets the background bitmap for the control.

SetColour

Sets a colour for a parameter.

SetTabAreaWidth

Sets the width of the tab area.


api Class API

class LabelContainer(ImageContainerBase)

Base class for LabelBook.


Methods

__init__(self, parent, id=wx.ID_ANY, pos=wx.DefaultPosition, size=wx.DefaultSize, style=0, agwStyle=0, name="LabelContainer")

Default class constructor.

Parameters
  • parent – parent window. Must not be None;

  • id – window identifier. A value of -1 indicates a default value;

  • pos – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;

  • 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 – the underlying Panel window style;

  • agwStyle

    the AGW-specific window style. This can be a combination of the following bits:

    Window Styles

    Hex Value

    Description

    INB_BOTTOM

    0x1

    Place labels below the page area. Available only for FlatImageBook.

    INB_LEFT

    0x2

    Place labels on the left side. Available only for FlatImageBook.

    INB_RIGHT

    0x4

    Place labels on the right side.

    INB_TOP

    0x8

    Place labels above the page area.

    INB_BORDER

    0x10

    Draws a border around LabelBook or FlatImageBook.

    INB_SHOW_ONLY_TEXT

    0x20

    Shows only text labels and no images. Available only for LabelBook.

    INB_SHOW_ONLY_IMAGES

    0x40

    Shows only tab images and no label texts. Available only for LabelBook.

    INB_FIT_BUTTON

    0x80

    Displays a pin button to show/hide the book control.

    INB_DRAW_SHADOW

    0x100

    Draw shadows below the book tabs. Available only for LabelBook.

    INB_USE_PIN_BUTTON

    0x200

    Displays a pin button to show/hide the book control.

    INB_GRADIENT_BACKGROUND

    0x400

    Draws a gradient shading on the tabs background. Available only for LabelBook.

    INB_WEB_HILITE

    0x800

    On mouse hovering, tabs behave like html hyperlinks. Available only for LabelBook.

    INB_NO_RESIZE

    0x1000

    Don’t allow resizing of the tab area.

    INB_FIT_LABELTEXT

    0x2000

    Will fit the tab area to the longest text (or text+image if you have images) in all the tabs.

    INB_BOLD_TAB_SELECTION

    0x4000

    Show the selected tab text using a bold font.

  • name – the window name.



CanDoBottomStyle(self)

Allows the parent to examine the children type. Some implementation (such as LabelBook), does not support top/bottom images, only left/right.



DrawBackgroundBitmap(self, dc)

Draws a bitmap as the background of the control.

Parameters

dc – an instance of wx.DC.



DrawLabel(self, dc, rect, text, bmp, imgInfo, orientationLeft, imgIdx, selected, hover)

Draws a label using the specified dc.

Parameters
  • dc – an instance of wx.DC;

  • rect – the text client rectangle;

  • text – the actual text string;

  • bmp – a bitmap to be drawn next to the text;

  • imgInfo – an instance of wx.ImageInfo;

  • orientationLeftTrue if the book has the INB_RIGHT or INB_LEFT style set;

  • imgIdx – the tab image index;

  • selectedTrue if the tab is selected, False otherwise;

  • hoverTrue if the tab is being hovered with the mouse, False otherwise.



DrawRegularHover(self, dc, rect)

Draws a rounded rectangle around the current tab.

Parameters
  • dc – an instance of wx.DC;

  • rect – the current tab client rectangle.



DrawWebHover(self, dc, caption, xCoord, yCoord, selected)

Draws a web style hover effect (cursor set to hand & text is underlined).

Parameters
  • dc – an instance of wx.DC;

  • caption – the tab caption text;

  • xCoord – the x position of the tab caption;

  • yCoord – the y position of the tab caption;

  • selectedTrue if the tab is selected, False otherwise.



GetColour(self, which)

Returns a colour for a parameter.

Parameters

which – the colour key.

See also

SetColour for a list of valid colour keys.



GetTabAreaWidth(self)

Returns the width of the tab area.



InitializeColours(self)

Initializes the colours map to be used for this control.



OnEraseBackground(self, event)

Handles the wx.EVT_ERASE_BACKGROUND event for LabelContainer.

Parameters

event – a EraseEvent event to be processed.



OnMouseLeaveWindow(self, event)

Handles the wx.EVT_LEAVE_WINDOW event for LabelContainer.

Parameters

event – a MouseEvent event to be processed.



OnMouseLeftDown(self, event)

Handles the wx.EVT_LEFT_DOWN event for LabelContainer.

Parameters

event – a MouseEvent event to be processed.



OnMouseLeftUp(self, event)

Handles the wx.EVT_LEFT_UP event for LabelContainer.

Parameters

event – a MouseEvent event to be processed.



OnMouseMove(self, event)

Handles the wx.EVT_MOTION event for LabelContainer.

Parameters

event – a MouseEvent event to be processed.



OnPaint(self, event)

Handles the wx.EVT_PAINT event for LabelContainer.

Parameters

event – a PaintEvent event to be processed.



OnSize(self, event)

Handles the wx.EVT_SIZE event for LabelContainer.

Parameters

event – a wx.SizeEvent event to be processed.



Resize(self, event)

Actually resizes the tab area.

Parameters

event – an instance of wx.SizeEvent.



SetBackgroundBitmap(self, bmp)

Sets the background bitmap for the control.

Parameters

bmp – a valid wx.Bitmap object.



SetColour(self, which, colour)

Sets a colour for a parameter.

Parameters
  • which – can be one of the following parameters:

    Colour Key

    Value

    Description

    INB_TAB_AREA_BACKGROUND_COLOUR

    100

    The tab area background colour

    INB_ACTIVE_TAB_COLOUR

    101

    The active tab background colour

    INB_TABS_BORDER_COLOUR

    102

    The tabs border colour

    INB_TEXT_COLOUR

    103

    The tab caption text colour

    INB_ACTIVE_TEXT_COLOUR

    104

    The active tab caption text colour

    INB_HILITE_TAB_COLOUR

    105

    The tab caption highlight text colour

  • colour – a valid wx.Colour object.



SetTabAreaWidth(self, width)

Sets the width of the tab area.

Parameters

width – the width of the tab area, in pixels.