Phoenix Logo

phoenix_title wx.StaticBoxSizer

wx.StaticBoxSizer is a sizer derived from wx.BoxSizer but adds a static box around the sizer.

The static box may be either created independently or the sizer may create it itself as a convenience. In any case, the sizer owns the wx.StaticBox control and will delete it in the wx.StaticBoxSizer destructor.

Note that since wxWidgets 2.9.1 you are encouraged to create the windows which are added to wx.StaticBoxSizer as children of wx.StaticBox itself, see this class documentation for more details.

Example of use of this class:

def CreateControls(self):

    panel = wx.Panel(self)
    # Other controls here...

    sz = wx.StaticBoxSizer(wx.VERTICAL, panel, "Box")
    sz.Add(wx.StaticText(sz.GetStaticBox(), wx.ID_ANY,
                         "This window is a child of the staticbox"))

    # Other code...

class_hierarchy Class Hierarchy

Inheritance diagram for class StaticBoxSizer:


method_summary Methods Summary

__init__ This constructor uses an already existing static box.
CalcMin Implements the calculation of a box sizer’s minimal.
GetStaticBox Returns the static box associated with the sizer.
RecalcSizes Implements the calculation of a box sizer’s dimensions and then sets the size of its children (calling wx.Window.SetSize if the child is a window).

property_summary Properties Summary

StaticBox See GetStaticBox

api Class API



class wx.StaticBoxSizer(BoxSizer)

Possible constructors:

StaticBoxSizer(box, orient=HORIZONTAL)

StaticBoxSizer(orient, parent, label="")

StaticBoxSizer is a sizer derived from BoxSizer but adds a static box around the sizer.


Methods



__init__(self, *args, **kw)

overload Overloaded Implementations:



__init__ (self, box, orient=HORIZONTAL)

This constructor uses an already existing static box.

Parameters:
  • box (wx.StaticBox) – The static box to associate with the sizer (which will take its ownership).
  • orient (int) – Can be either VERTICAL or HORIZONTAL .



__init__ (self, orient, parent, label=””)

This constructor creates a new static box with the given label and parent window.

Parameters:
  • orient (int) –
  • parent (wx.Window) –
  • label (string) –





CalcMin(self)

Implements the calculation of a box sizer’s minimal.

It is used internally only and must not be called by the user. Documented for information.

Return type: wx.Size


GetStaticBox(self)

Returns the static box associated with the sizer.

Return type: wx.StaticBox


RecalcSizes(self)

Implements the calculation of a box sizer’s dimensions and then sets the size of its children (calling wx.Window.SetSize if the child is a window).

It is used internally only and must not be called by the user (call Layout if you want to resize). Documented for information.


Properties



StaticBox

See GetStaticBox