3c69a2ec86
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@44403 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
319 lines
10 KiB
Python
319 lines
10 KiB
Python
import wx
|
|
import wxaddons.sized_controls as sc
|
|
|
|
overview = """\
|
|
<html><body><h2>Sized Controls</h2>
|
|
SizedControls is an addon library that attempts to simplify the
|
|
creation of sizer-based layouts. It adds the following classes:
|
|
|
|
<h3>SizedPanel</h3>
|
|
|
|
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.
|
|
|
|
<h3>SizedFrame and SizedDialog</h3>
|
|
|
|
These classes automatically setup a SizedPanel which is appropriately
|
|
positioned and given appropriate borders in accordance with the
|
|
platform's HIGs.
|
|
|
|
<p>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:
|
|
|
|
<table bgcolor=\"#EFEFEF\"><tr><td><pre>
|
|
... 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 ...</pre>
|
|
</td></tr></table>
|
|
|
|
would now look like this:
|
|
|
|
<table bgcolor=\"#EFEFEF\"><tr><td><pre>
|
|
... 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 ...</pre>
|
|
</td></tr></table>
|
|
|
|
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.
|
|
|
|
<h3>wx.Window.SetSizerProps Quick Reference</h3>
|
|
|
|
<p><pre>wx.Window.SetSizerProps(<props>)</pre>
|
|
|
|
<p>
|
|
<table bgcolor=\"#EFEFEF\">
|
|
<tr>
|
|
<td valign="middle" width="90"><b>Parameter</b></td> <td valign="middle"><b>Values</b></td> <td valign="middle"><b>Summary</b></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><i>expand</i></td> <td>True/False</td>
|
|
<td>Whether or not the control should grow to fill free space if
|
|
free space is available.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><i>proportion</i></td> <td>Number (typically 0-10)</td>
|
|
<td>How much of the free space the control should take up. Note that this value is
|
|
<i>relative</i> to other controls, so a proportion of 2 means take up
|
|
'twice as much' space as controls with a proportion of 1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><i>halign</i> <td>"left", "center", "centre", "right"</td>
|
|
<td>Determines horizontal alignment of control.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><i>valign</i> <td>"top", "center", "centre", "bottom"</td>
|
|
<td>Determines vertical alignment of control.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><i>border</i> <td>Tuple: ([<i>dirs</i>], integer)</td>
|
|
<td>Specifies amount of border padding to apply to specified directions. </br>
|
|
Example: (["left", "right"], 6) would add six pixels to left and right borders. </br>
|
|
Note that, unfortunately,
|
|
it is not currently possible to assign different border sizes to each direction.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><i>minsize</i> <td>One of the following string values: "fixed", "adjust"</td>
|
|
<td>Determines whether or not the minsize can be updated when the control's best size changes.</td>
|
|
</tr>
|
|
|
|
</table>
|
|
"""
|
|
|
|
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:])
|
|
|