import wx import wxaddons.sized_controls as sc overview = """\

Sized Controls

SizedControls is an addon library that attempts to simplify the creation of sizer-based layouts. It adds the following classes:

SizedPanel

This class automatically creates its own sizer (a vertical box sizer by default) and automatically adds its children to the sizer. You can change the SizedPanel's sizer type by calling panel.SetSizerType(\"type\", [args]), where valid types are \"horizontal\", \"vertical\", \"form\" (a 2-col flex grid sizer), and \"grid\". Args include \"cols\" and \"rows\" attributes for grids. This class also applies control borders that adhere to the native platform's Human Interface Guidelines (HIG) on Win, GTK and Mac.

SizedFrame and SizedDialog

These classes automatically setup a SizedPanel which is appropriately positioned and given appropriate borders in accordance with the platform's HIGs.

Since controls are added to the parent's sizer upon creation, you don't need to use sizer.Add or even create sizers yourself. You just use SetSizerType() to change the sizer you want to use, and control.SetSizerProps() to change the sizer properties of the control. So as a result, code that used to look like this:
... wx.Dialog init code... panel = wx.Panel(self, -1) b1 = wx.Button(panel, -1) b2 = wx.Button(panel, -1) t1 = wx.TextCtrl(panel, -1) b3 = wx.Button(panel, -1) sizer = wx.BoxSizer(wx.HORIZONTAL) sizer.Add(b1, 0, wx.ALL, 6) sizer.Add(b2, 0, wx.ALL, 6) sizer.Add(t1, 0, wx.EXPAND | wx.ALL, 6) sizer.Add(b3, 0, wx.ALL, 6) panel.SetSizer(sizer) dlgSizer = wx.BoxSizer() dlgSizer.Add(panel, 1, wx.EXPAND) self.SetSizer(dlgSizer) self.SetAutoLayout(True) ... rest of dialog ...

would now look like this:
... wx.Dialog init code... panel = self.GetContentsPane() panel.SetSizerType(\"horizontal\") b1 = wx.Button(panel, -1) b2 = wx.Button(panel, -1) t1 = wx.TextCtrl(panel, -1) t1.SetSizerProps(expand=True) b3 = wx.Button(panel, -1) ... rest of dialog ...

and the latter example will adhere to HIG spacing guidelines on all platforms, unlike the former example. Please check the demos for more complete and sophisticated examples of SizedControls in action.

wx.Window.SetSizerProps Quick Reference

wx.Window.SetSizerProps(<props>)

Parameter Values Summary

expand True/False Whether or not the control should grow to fill free space if free space is available.

proportion Number (typically 0-10) How much of the free space the control should take up. Note that this value is relative to other controls, so a proportion of 2 means take up 'twice as much' space as controls with a proportion of 1.

halign "left", "center", "centre", "right" Determines horizontal alignment of control.

valign "top", "center", "centre", "bottom" Determines vertical alignment of control.

border Tuple: ([dirs], integer) Specifies amount of border padding to apply to specified directions.
Example: (["left", "right"], 6) would add six pixels to left and right borders.
Note that, unfortunately, it is not currently possible to assign different border sizes to each direction.

minsize One of the following string values: "fixed", "adjust" Determines whether or not the minsize can be updated when the control's best size changes.

""" class FormDialog(sc.SizedDialog): def __init__(self, parent, id): sc.SizedDialog.__init__(self, None, -1, "SizedForm Dialog", style=wx.DEFAULT_DIALOG_STYLE | wx.RESIZE_BORDER) pane = self.GetContentsPane() pane.SetSizerType("form") # row 1 wx.StaticText(pane, -1, "Name") textCtrl = wx.TextCtrl(pane, -1, "Your name here") textCtrl.SetSizerProps(expand=True) # row 2 wx.StaticText(pane, -1, "Email") emailCtrl = wx.TextCtrl(pane, -1, "") emailCtrl.SetSizerProps(expand=True) # row 3 wx.StaticText(pane, -1, "Gender") wx.Choice(pane, -1, choices=["male", "female"]) # row 4 wx.StaticText(pane, -1, "State") wx.TextCtrl(pane, -1, size=(60, -1)) # two chars for state # row 5 wx.StaticText(pane, -1, "Title") # here's how to add a 'nested sizer' using sized_controls radioPane = sc.SizedPanel(pane, -1) radioPane.SetSizerType("horizontal") radioPane.SetSizerProps(expand=True) # make these children of the radioPane to have them use # the horizontal layout wx.RadioButton(radioPane, -1, "Mr.") wx.RadioButton(radioPane, -1, "Mrs.") wx.RadioButton(radioPane, -1, "Dr.") # end row 5 # add dialog buttons self.SetButtonSizer(self.CreateStdDialogButtonSizer(wx.OK | wx.CANCEL)) # a little trick to make sure that you can't resize the dialog to # less screen space than the controls need self.Fit() self.SetMinSize(self.GetSize()) class ErrorDialog(sc.SizedDialog): def __init__(self, parent, id): sc.SizedDialog.__init__(self, parent, id, "Error log viewer", style=wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER) # Always use self.GetContentsPane() - this ensures that your dialog # automatically adheres to HIG spacing requirements on all platforms. # pane here is a sc.SizedPanel with a vertical sizer layout. All children # should be added to this pane, NOT to self. pane = self.GetContentsPane() # first row self.listCtrl = wx.ListCtrl(pane, -1, size=(300, -1), style=wx.LC_REPORT) self.listCtrl.SetSizerProps(expand=True, proportion=1) self.ConfigureListCtrl() # second row self.lblDetails = wx.StaticText(pane, -1, "Error Details") # third row self.details = wx.TextCtrl(pane, -1, style=wx.TE_MULTILINE) self.details.SetSizerProps(expand=True, proportion=1) # final row # since we want to use a custom button layout, we won't use the # CreateStdDialogBtnSizer here, we'll just create our own panel with # a horizontal layout and add the buttons to that. btnpane = sc.SizedPanel(pane, -1) btnpane.SetSizerType("horizontal") btnpane.SetSizerProps(expand=True) self.saveBtn = wx.Button(btnpane, wx.ID_SAVE) spacer = sc.SizedPanel(btnpane, -1) spacer.SetSizerProps(expand=True, proportion=1) self.clearBtn = wx.Button(btnpane, -1, "Clear") self.Fit() self.SetMinSize(self.GetSize()) def ConfigureListCtrl(self): self.listCtrl.InsertColumn(0, "Time") self.listCtrl.InsertColumn(1, "Error Message") self.listCtrl.SetColumnWidth(0, 100) self.listCtrl.SetColumnWidth(1, 280) class GridFrame(sc.SizedFrame): def __init__(self, parent, id): sc.SizedFrame.__init__(self, parent, id, "Grid Layout Demo Frame") pane = self.GetContentsPane() pane.SetSizerType("grid", {"cols":3}) # 3-column grid layout # row 1 wx.TextCtrl(pane, -1).SetSizerProps(halign="left") wx.TextCtrl(pane, -1).SetSizerProps(halign="center") wx.TextCtrl(pane, -1).SetSizerProps(halign="right") # row 2 wx.TextCtrl(pane, -1).SetSizerProps(valign="center") wx.TextCtrl(pane, -1).SetSizerProps(expand=True, proportion=1) wx.TextCtrl(pane, -1).SetSizerProps(valign="center") # row 3 wx.TextCtrl(pane, -1).SetSizerProps(halign="left") wx.TextCtrl(pane, -1).SetSizerProps(halign="center") wx.TextCtrl(pane, -1).SetSizerProps(halign="right") self.CreateStatusBar() # should always do this when there's a resize border self.Fit() self.SetMinSize(self.GetSize()) #--------------------------------------------------------------------------- class TestPanel(wx.Panel): def __init__(self, parent, log): self.log = log self.parent = parent wx.Panel.__init__(self, parent, -1) b = wx.Button(self, -1, "Sized Controls Form Dialog", (50,50)) self.Bind(wx.EVT_BUTTON, self.OnFormButton, b) b2 = wx.Button(self, -1, "Sized Controls Error Dialog", (50,90)) self.Bind(wx.EVT_BUTTON, self.OnErrorButton, b2) b3 = wx.Button(self, -1, "Sized Controls Grid Layout Demo", (50,130)) self.Bind(wx.EVT_BUTTON, self.OnGridButton, b3) def OnFormButton(self, evt): print dlg = FormDialog(self, -1) dlg.CenterOnScreen() # this does not return until the dialog is closed. val = dlg.ShowModal() if val == wx.ID_OK: self.log.WriteText("You pressed OK\n") else: self.log.WriteText("You pressed Cancel\n") dlg.Destroy() def OnErrorButton(self, evt): dlg = ErrorDialog(self, -1) dlg.CenterOnScreen() # this does not return until the dialog is closed. val = dlg.ShowModal() if val == wx.ID_OK: self.log.WriteText("You pressed OK\n") else: self.log.WriteText("You pressed Cancel\n") dlg.Destroy() def OnGridButton(self, evt): dlg = GridFrame(self, -1) dlg.CenterOnScreen() dlg.Show() def runTest(frame, nb, log): win = TestPanel(nb, log) return win if __name__ == '__main__': import sys,os import run run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])

Parameter	Values	Summary
expand	True/False	Whether or not the control should grow to fill free space if free space is available.
proportion	Number (typically 0-10)	How much of the free space the control should take up. Note that this value is relative to other controls, so a proportion of 2 means take up 'twice as much' space as controls with a proportion of 1.
halign	"left", "center", "centre", "right"	Determines horizontal alignment of control.
valign	"top", "center", "centre", "bottom"	Determines vertical alignment of control.
border	Tuple: ([dirs], integer)	Specifies amount of border padding to apply to specified directions. Example: (["left", "right"], 6) would add six pixels to left and right borders. Note that, unfortunately, it is not currently possible to assign different border sizes to each direction.
minsize	One of the following string values: "fixed", "adjust"	Determines whether or not the minsize can be updated when the control's best size changes.