[wxWidgets.git] / wxPython / demo / wxLayoutConstraints.py

# 11/19/2003 - Jeff Grimmett (grimmtooth@softhome.net)
#
# o Updated for wx namespace
# 

import  wx

#---------------------------------------------------------------------------

class TestLayoutConstraints(wx.Panel):
    def __init__(self, parent):
        wx.Panel.__init__(self, parent, -1)
        self.SetAutoLayout(True)
        self.Bind(wx.EVT_BUTTON, self.OnButton, id=100)

        self.SetBackgroundColour(wx.NamedColour("MEDIUM ORCHID"))

        self.panelA = wx.Window(self, -1, style=wx.SIMPLE_BORDER)
        self.panelA.SetBackgroundColour(wx.BLUE)

        txt = wx.StaticText(
                    self.panelA, -1,
                    "Resize the window and see\n"
                    "what happens...  Notice that\n"
                    "there is no OnSize handler.",
                    (5,5), (-1, 50)
                    )

        txt.SetBackgroundColour(wx.BLUE)
        txt.SetForegroundColour(wx.WHITE)

        lc = wx.LayoutConstraints()
        lc.top.SameAs(self, wx.Top, 10)
        lc.left.SameAs(self, wx.Left, 10)
        lc.bottom.SameAs(self, wx.Bottom, 10)
        lc.right.PercentOf(self, wx.Right, 50)
        self.panelA.SetConstraints(lc)

        self.panelB = wx.Window(self, -1, style=wx.SIMPLE_BORDER)
        self.panelB.SetBackgroundColour(wx.RED)
        lc = wx.LayoutConstraints()
        lc.top.SameAs(self, wx.Top, 10)
        lc.right.SameAs(self, wx.Right, 10)
        lc.bottom.PercentOf(self, wx.Bottom, 30)
        lc.left.RightOf(self.panelA, 10)
        self.panelB.SetConstraints(lc)

        self.panelC = wx.Window(self, -1, style=wx.SIMPLE_BORDER)
        self.panelC.SetBackgroundColour(wx.WHITE)
        lc = wx.LayoutConstraints()
        lc.top.Below(self.panelB, 10)
        lc.right.SameAs(self, wx.Right, 10)
        lc.bottom.SameAs(self, wx.Bottom, 10)
        lc.left.RightOf(self.panelA, 10)
        self.panelC.SetConstraints(lc)

        b = wx.Button(self.panelA, 100, ' Panel A ')
        lc = wx.LayoutConstraints()
        lc.centreX.SameAs   (self.panelA, wx.CentreX)
        lc.centreY.SameAs   (self.panelA, wx.CentreY)
        lc.height.AsIs      ()
        lc.width.PercentOf  (self.panelA, wx.Width, 50)
        b.SetConstraints(lc);

        b = wx.Button(self.panelB, 100, ' Panel B ')
        lc = wx.LayoutConstraints()
        lc.top.SameAs       (self.panelB, wx.Top, 2)
        lc.right.SameAs     (self.panelB, wx.Right, 4)
        lc.height.AsIs      ()
        lc.width.AsIs       ()
        b.SetConstraints(lc);

        self.panelD = wx.Window(self.panelC, -1, style=wx.SIMPLE_BORDER)
        self.panelD.SetBackgroundColour(wx.GREEN)
        wx.StaticText(
            self.panelD, -1, "Panel D", (4, 4)
            ).SetBackgroundColour(wx.GREEN)

        b = wx.Button(self.panelC, 100, ' Panel C ')
        lc = wx.LayoutConstraints()
        lc.top.Below        (self.panelD)
        lc.left.RightOf     (self.panelD)
        lc.height.AsIs      ()
        lc.width.AsIs       ()
        b.SetConstraints(lc);

        lc = wx.LayoutConstraints()
        lc.bottom.PercentOf (self.panelC, wx.Height, 50)
        lc.right.PercentOf  (self.panelC, wx.Width, 50)
        lc.height.SameAs    (b, wx.Height)
        lc.width.SameAs     (b, wx.Width)
        self.panelD.SetConstraints(lc);


    def OnButton(self, event):
        wx.Bell()


#---------------------------------------------------------------------------

def runTest(frame, nb, log):
    win = TestLayoutConstraints(nb)
    return win

#---------------------------------------------------------------------------


overview = """\
<html><body>
Objects of this class can be associated with a window to define its
layout constraints, with respect to siblings or its parent.

<p>The class consists of the following eight constraints of class
wxIndividualLayoutConstraint, some or all of which should be accessed
directly to set the appropriate constraints.

<p><ul>
<li>left: represents the left hand edge of the window

<li>right: represents the right hand edge of the window

<li>top: represents the top edge of the window

<li>bottom: represents the bottom edge of the window

<li>width: represents the width of the window

<li>height: represents the height of the window

<li>centreX: represents the horizontal centre point of the window

<li>centreY: represents the vertical centre point of the window
</ul>
<p>Most constraints are initially set to have the relationship
wxUnconstrained, which means that their values should be calculated by
looking at known constraints. The exceptions are width and height,
which are set to wxAsIs to ensure that if the user does not specify a
constraint, the existing width and height will be used, to be
compatible with panel items which often have take a default size. If
the constraint is wxAsIs, the dimension will not be changed.

"""


if __name__ == '__main__':
    import sys,os
    import run
    run.main(['', os.path.basename(sys.argv[0])])
Commit	Line	Data
8fa876ca RD	1	# 11/19/2003 - Jeff Grimmett (grimmtooth@softhome.net)
	2	#
	3	# o Updated for wx namespace
	4	#
cf694132	5
8fa876ca	6	import wx
cf694132 RD	7
	8	#---------------------------------------------------------------------------
	9
8fa876ca	10	class TestLayoutConstraints(wx.Panel):
cf694132	11	def __init__(self, parent):
8fa876ca	12	wx.Panel.__init__(self, parent, -1)
1e4a197e	13	self.SetAutoLayout(True)
8fa876ca RD	14	self.Bind(wx.EVT_BUTTON, self.OnButton, id=100)
	15
	16	self.SetBackgroundColour(wx.NamedColour("MEDIUM ORCHID"))
	17
	18	self.panelA = wx.Window(self, -1, style=wx.SIMPLE_BORDER)
	19	self.panelA.SetBackgroundColour(wx.BLUE)
	20
	21	txt = wx.StaticText(
	22	self.panelA, -1,
	23	"Resize the window and see\n"
	24	"what happens... Notice that\n"
	25	"there is no OnSize handler.",
	26	(5,5), (-1, 50)
	27	)
	28
	29	txt.SetBackgroundColour(wx.BLUE)
	30	txt.SetForegroundColour(wx.WHITE)
	31
	32	lc = wx.LayoutConstraints()
	33	lc.top.SameAs(self, wx.Top, 10)
	34	lc.left.SameAs(self, wx.Left, 10)
	35	lc.bottom.SameAs(self, wx.Bottom, 10)
	36	lc.right.PercentOf(self, wx.Right, 50)
cf694132 RD	37	self.panelA.SetConstraints(lc)
cf694132 RD	38
8fa876ca RD	39	self.panelB = wx.Window(self, -1, style=wx.SIMPLE_BORDER)
	40	self.panelB.SetBackgroundColour(wx.RED)
	41	lc = wx.LayoutConstraints()
	42	lc.top.SameAs(self, wx.Top, 10)
	43	lc.right.SameAs(self, wx.Right, 10)
	44	lc.bottom.PercentOf(self, wx.Bottom, 30)
cf694132 RD	45	lc.left.RightOf(self.panelA, 10)
	46	self.panelB.SetConstraints(lc)
	47
8fa876ca RD	48	self.panelC = wx.Window(self, -1, style=wx.SIMPLE_BORDER)
	49	self.panelC.SetBackgroundColour(wx.WHITE)
	50	lc = wx.LayoutConstraints()
cf694132	51	lc.top.Below(self.panelB, 10)
8fa876ca RD	52	lc.right.SameAs(self, wx.Right, 10)
8fa876ca RD	53	lc.bottom.SameAs(self, wx.Bottom, 10)
cf694132 RD	54	lc.left.RightOf(self.panelA, 10)
	55	self.panelC.SetConstraints(lc)
	56
8fa876ca RD	57	b = wx.Button(self.panelA, 100, ' Panel A ')
	58	lc = wx.LayoutConstraints()
	59	lc.centreX.SameAs (self.panelA, wx.CentreX)
	60	lc.centreY.SameAs (self.panelA, wx.CentreY)
cf694132	61	lc.height.AsIs ()
8fa876ca	62	lc.width.PercentOf (self.panelA, wx.Width, 50)
cf694132 RD	63	b.SetConstraints(lc);
cf694132 RD	64
8fa876ca RD	65	b = wx.Button(self.panelB, 100, ' Panel B ')
	66	lc = wx.LayoutConstraints()
	67	lc.top.SameAs (self.panelB, wx.Top, 2)
	68	lc.right.SameAs (self.panelB, wx.Right, 4)
cf694132 RD	69	lc.height.AsIs ()
	70	lc.width.AsIs ()
	71	b.SetConstraints(lc);
	72
8fa876ca RD	73	self.panelD = wx.Window(self.panelC, -1, style=wx.SIMPLE_BORDER)
	74	self.panelD.SetBackgroundColour(wx.GREEN)
	75	wx.StaticText(
	76	self.panelD, -1, "Panel D", (4, 4)
	77	).SetBackgroundColour(wx.GREEN)
cf694132	78
8fa876ca RD	79	b = wx.Button(self.panelC, 100, ' Panel C ')
8fa876ca RD	80	lc = wx.LayoutConstraints()
cf694132 RD	81	lc.top.Below (self.panelD)
	82	lc.left.RightOf (self.panelD)
	83	lc.height.AsIs ()
	84	lc.width.AsIs ()
	85	b.SetConstraints(lc);
	86
8fa876ca RD	87	lc = wx.LayoutConstraints()
	88	lc.bottom.PercentOf (self.panelC, wx.Height, 50)
	89	lc.right.PercentOf (self.panelC, wx.Width, 50)
	90	lc.height.SameAs (b, wx.Height)
	91	lc.width.SameAs (b, wx.Width)
cf694132 RD	92	self.panelD.SetConstraints(lc);
	93
	94
	95	def OnButton(self, event):
8fa876ca	96	wx.Bell()
cf694132 RD	97
	98
	99	#---------------------------------------------------------------------------
	100
	101	def runTest(frame, nb, log):
	102	win = TestLayoutConstraints(nb)
	103	return win
	104
	105	#---------------------------------------------------------------------------
	106
	107
	108
8fa876ca RD	109	overview = """\
8fa876ca RD	110	<html><body>
1fded56b RD	111	Objects of this class can be associated with a window to define its
1fded56b RD	112	layout constraints, with respect to siblings or its parent.
cf694132	113
8fa876ca	114	<p>The class consists of the following eight constraints of class
1fded56b RD	115	wxIndividualLayoutConstraint, some or all of which should be accessed
1fded56b RD	116	directly to set the appropriate constraints.
cf694132	117
8fa876ca RD	118	<p><ul>
8fa876ca RD	119	<li>left: represents the left hand edge of the window
cf694132	120
8fa876ca	121	<li>right: represents the right hand edge of the window
cf694132	122
8fa876ca	123	<li>top: represents the top edge of the window
cf694132	124
8fa876ca	125	<li>bottom: represents the bottom edge of the window
cf694132	126
8fa876ca	127	<li>width: represents the width of the window
cf694132	128
8fa876ca	129	<li>height: represents the height of the window
cf694132	130
8fa876ca	131	<li>centreX: represents the horizontal centre point of the window
cf694132	132
8fa876ca RD	133	<li>centreY: represents the vertical centre point of the window
	134	</ul>
	135	<p>Most constraints are initially set to have the relationship
1fded56b RD	136	wxUnconstrained, which means that their values should be calculated by
	137	looking at known constraints. The exceptions are width and height,
	138	which are set to wxAsIs to ensure that if the user does not specify a
	139	constraint, the existing width and height will be used, to be
	140	compatible with panel items which often have take a default size. If
	141	the constraint is wxAsIs, the dimension will not be changed.
cf694132	142
cf694132	143	"""
1fded56b RD	144
	145
	146
	147
	148	if __name__ == '__main__':
	149	import sys,os
	150	import run
	151	run.main(['', os.path.basename(sys.argv[0])])
	152