[wxWidgets.git] / wxPython / docs / wxPackage.html

<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" />
<title>The wxPython wx Package</title>
<meta name="author" content="Patrick K. O'Brien" />
<meta name="author" content="Robin Dunn" />
<meta name="organization" content="Orbtech" />
<meta name="date" content="2004-03-26" />
<link rel="stylesheet" href="default.css" type="text/css" />
</head>
<body>
<div class="document" id="the-wxpython-wx-package">
<h1 class="title">The wxPython wx Package</h1>
<h2 class="subtitle" id="or-how-to-survive-the-new-wx-namespace-changes">Or, how to survive the new wx namespace changes.</h2>
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Author:</th>
<td>Patrick K. O'Brien</td></tr>
<tr><th class="docinfo-name">Author:</th>
<td>Robin Dunn</td></tr>
<tr><th class="docinfo-name">Contact:</th>
<td><a class="first last reference" href="mailto:pobrien&#64;orbtech.com">pobrien&#64;orbtech.com</a></td></tr>
<tr><th class="docinfo-name">Organization:</th>
<td><a class="first last reference" href="http://www.orbtech.com/">Orbtech</a></td></tr>
<tr><th class="docinfo-name">Date:</th>
<td>2004-03-26</td></tr>
<tr><th class="docinfo-name">Revision:</th>
<td>1.4</td></tr>
</tbody>
</table>
<div class="contents topic">
<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
<ul class="simple">
<li><a class="reference" href="#introduction" id="id2" name="id2">Introduction</a></li>
<li><a class="reference" href="#why-change-anything" id="id3" name="id3">Why change anything?</a></li>
<li><a class="reference" href="#what-does-the-new-wx-package-do" id="id4" name="id4">What does the new wx package do?</a></li>
<li><a class="reference" href="#will-any-of-this-effect-my-existing-code" id="id5" name="id5">Will any of this effect my existing code?</a></li>
<li><a class="reference" href="#what-about-all-the-other-modules-like-grid-html-and-stc" id="id6" name="id6">What about all the other modules, like grid, html, and stc?</a></li>
<li><a class="reference" href="#how-do-i-use-this-new-wx-package" id="id7" name="id7">How do I use this new wx package?</a></li>
<li><a class="reference" href="#what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package" id="id8" name="id8">What are the issues with converting old code to use the new wx package?</a></li>
<li><a class="reference" href="#where-can-i-find-example-programs-using-the-new-wx-syntax" id="id9" name="id9">Where can I find example programs using the new wx syntax?</a></li>
</ul>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id2" id="introduction" name="introduction">Introduction</a></h1>
<p>In the begining there was Python, and Python had modules, and Python
was good.  But after a time Guido looked on Python and saw that Python
needed organizational assistance, and so Guido took code from Python's
side and created Packages and then Python was very good.  About this
time wxPython was reborn, and wxPython used Packages, but being young
and trying to use a new technology wxPython did not know how to use
Packages effectivly.  wxPython was good, but dreamed of being much
better...</p>
<p>Now many years later, after tons of code reorganization and build
hacking wxPython has reached that goal.  In version 2.4.1 a prototype
of this new structure was introduced that dynamically built at import
time a new toplevel package named simply &quot;wx&quot; that contained all the
items from wxPython.wx but with the names edited to remove the wx
prefix.  Now in 2.5 the final phase of that switcheroo has been
completed and the <em>real</em> classes, functions and constants are now
located in the wx package, leaving some compatibility modules in
wxPython.wx.  This document should answer all the questions you might
have concerning the new wx package.  Please also take a look at the
<a class="reference" href="MigrationGuide.html">2.5 Migration Guide</a> to see notes about other big differences in
this release.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id3" id="why-change-anything" name="why-change-anything">Why change anything?</a></h1>
<p>This change is being made for a couple of reasons.  The first reason
is to discourage the use of <tt class="docutils literal"><span class="pre">import</span> <span class="pre">*</span></tt>, which is a dangerous
technique that can create name conflicts and bloated namespaces.</p>
<p>The second reason is to remove what some perceive to be a &quot;wart.&quot;  For
example, the following code is rather ugly in that the &quot;wx&quot; prefix on
the wxFrame class name is no longer useful when you're using the wx
module prefix:</p>
<pre class="literal-block">
from wxPython import wx

class Frame(wx.wxFrame)
</pre>
<p>The new wx package allows you to write code like this, instead:</p>
<pre class="literal-block">
import wx

class Frame(wx.Frame)
</pre>
<p>The third reason is that the wxWindows project has considered doing
the same thing (implement a new wx namespace and drop the &quot;wx&quot; prefix)
and we want wxPython to lead the way.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id4" id="what-does-the-new-wx-package-do" name="what-does-the-new-wx-package-do">What does the new wx package do?</a></h1>
<p>As mentioned in the Introduction, wxPython 2.4.1 introduced a way of
getting to this new syntax as quickly as possible.  It would import
the old names (like &quot;wxFrame&quot;) from the old package and then create new
names in the wx package  without the wx prefix, (like &quot;Frame&quot;.)
Starting with wxPython 2.5 the renaming is moved up to the wxPython
build step, so the real classes and etc. are actually named with the
new name (like &quot;Frame&quot;) and are located in the new wx package.</p>
<p>For compatibility the old wxPython package still exists, but now it is
populated with modules that simply import the new names and then
&quot;reverse-renames&quot; them to the old names.  It probably sounds a bit
complicated, but it is mostly automated and so it  doesn't cause
problems in most cases.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id5" id="will-any-of-this-effect-my-existing-code" name="will-any-of-this-effect-my-existing-code">Will any of this effect my existing code?</a></h1>
<p>No.  Your existing code will continue to work and be supported for
some time.  It will be up to you to decide when to switch to the new
syntax.  But all new documentation and code examples will use the new
syntax.  So don't wait too long.  You wouldn't want anyone calling you
old-fashioned, would you?</p>
<p>When you import from wxPython.wx and use a class with the old name,
such as wxButton, you are actually using the wx.Button class.  I
expect that the vast majority of the existing code should work fine
using this scheme.  The only things that may cause problems is if your
old code is depending on some of the implemtation details, or if you
are using other things that have changed in the API.  See the
<a class="reference" href="MigrationGuide.html">Migration Guide</a> for more details.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id6" id="what-about-all-the-other-modules-like-grid-html-and-stc" name="what-about-all-the-other-modules-like-grid-html-and-stc">What about all the other modules, like grid, html, and stc?</a></h1>
<p>There's more to the old wxPython than just the wxPython.wx module.
And we've got those extra modules covered as well.  Each of those
modules (as well as the lib subpackage) has been moved to the new wx
package and reverse-renamers have been placed in the wxPython package
as needed.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id7" id="how-do-i-use-this-new-wx-package" name="how-do-i-use-this-new-wx-package">How do I use this new wx package?</a></h1>
<p>The wx package is automatically created when you install wxPython
version 2.4.1 or higher.  So all you have to do is:</p>
<pre class="literal-block">
import wx
</pre>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id8" id="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package" name="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package">What are the issues with converting old code to use the new wx package?</a></h1>
<p>Obviously, you need to change your import statements from:</p>
<pre class="literal-block">
from wxPython import wx
</pre>
<p>or:</p>
<pre class="literal-block">
from wxPython.wx import *
</pre>
<p>to:</p>
<pre class="literal-block">
import wx
</pre>
<p>Then you need to refer to wx attributes without a &quot;wx&quot; prefix, such
as:</p>
<pre class="literal-block">
class MyFrame(wx.Frame):
</pre>
<p>In most cases, existing code can be modified with a simple search and
replace.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id9" id="where-can-i-find-example-programs-using-the-new-wx-syntax" name="where-can-i-find-example-programs-using-the-new-wx-syntax">Where can I find example programs using the new wx syntax?</a></h1>
<p>The wxPython demo application and most of the sample apps have been
converted to use the new <tt class="docutils literal"><span class="pre">import</span> <span class="pre">wx</span></tt> style of programming with
wxPython, so there are lots of examples to look at and to play with.
Here is one of them, it is the <tt class="docutils literal"><span class="pre">simple</span></tt> sample.</p>
<pre class="literal-block">
#----------------------------------------------------------------------
# A very simple wxPython example.  Just a wx.Frame, wx.Panel,
# wx.StaticText, wx.Button, and a wx.BoxSizer, but it shows the basic
# structure of any wxPython application.
#----------------------------------------------------------------------

import wx


class MyFrame(wx.Frame):
    &quot;&quot;&quot;
    This is MyFrame.  It just shows a few controls on a wxPanel,
    and has a simple menu.
    &quot;&quot;&quot;
    def __init__(self, parent, title):
        wx.Frame.__init__(self, parent, -1, title,
                          pos=(150, 150), size=(350, 200))

        # Create the menubar
        menuBar = wx.MenuBar()

        # and a menu 
        menu = wx.Menu()

        # add an item to the menu, using \tKeyName automatically
        # creates an accelerator, the third param is some help text
        # that will show up in the statusbar
        menu.Append(wx.ID_EXIT, &quot;E&amp;xit\tAlt-X&quot;, &quot;Exit this simple sample&quot;)

        # bind the menu event to an event handler
        self.Bind(wx.EVT_MENU, self.OnTimeToClose, id=wx.ID_EXIT)

        # and put the menu on the menubar
        menuBar.Append(menu, &quot;&amp;File&quot;)
        self.SetMenuBar(menuBar)

        self.CreateStatusBar()
        

        # Now create the Panel to put the other controls on.
        panel = wx.Panel(self)

        # and a few controls
        text = wx.StaticText(panel, -1, &quot;Hello World!&quot;)
        text.SetFont(wx.Font(14, wx.SWISS, wx.NORMAL, wx.BOLD))
        text.SetSize(text.GetBestSize())
        btn = wx.Button(panel, -1, &quot;Close&quot;)
        funbtn = wx.Button(panel, -1, &quot;Just for fun...&quot;)

        # bind the button events to handlers
        self.Bind(wx.EVT_BUTTON, self.OnTimeToClose, btn)
        self.Bind(wx.EVT_BUTTON, self.OnFunButton, funbtn)

        # Use a sizer to layout the controls, stacked vertically and with
        # a 10 pixel border around each
        sizer = wx.BoxSizer(wx.VERTICAL)
        sizer.Add(text, 0, wx.ALL, 10)
        sizer.Add(btn, 0, wx.ALL, 10)
        sizer.Add(funbtn, 0, wx.ALL, 10)
        panel.SetSizer(sizer)
        panel.Layout()


    def OnTimeToClose(self, evt):
        &quot;&quot;&quot;Event handler for the button click.&quot;&quot;&quot;
        print &quot;See ya later!&quot;
        self.Close()

    def OnFunButton(self, evt):
        &quot;&quot;&quot;Event handler for the button click.&quot;&quot;&quot;
        print &quot;Having fun yet?&quot;


class MyApp(wx.App):
    def OnInit(self):
        frame = MyFrame(None, &quot;Simple wxPython App&quot;)
        self.SetTopWindow(frame)

        print &quot;Print statements go to this stdout window by default.&quot;

        frame.Show(True)
        return True
        
app = MyApp(redirect=True)
app.MainLoop()


</pre>
</div>
</div>
</body>
</html>
Commit	Line	Data
8eda5e35 RD	1	<?xml version="1.0" encoding="iso-8859-1" ?>
	2	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	3	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
	4	<head>
	5	<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
709d7afa	6	<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" />
8eda5e35 RD	7	<title>The wxPython wx Package</title>
	8	<meta name="author" content="Patrick K. O'Brien" />
	9	<meta name="author" content="Robin Dunn" />
	10	<meta name="organization" content="Orbtech" />
7fa23c09	11	<meta name="date" content="2004-03-26" />
c04bcba0	12	<link rel="stylesheet" href="default.css" type="text/css" />
8eda5e35 RD	13	</head>
	14	<body>
	15	<div class="document" id="the-wxpython-wx-package">
	16	<h1 class="title">The wxPython wx Package</h1>
	17	<h2 class="subtitle" id="or-how-to-survive-the-new-wx-namespace-changes">Or, how to survive the new wx namespace changes.</h2>
	18	<table class="docinfo" frame="void" rules="none">
	19	<col class="docinfo-name" />
	20	<col class="docinfo-content" />
	21	<tbody valign="top">
	22	<tr><th class="docinfo-name">Author:</th>
	23	<td>Patrick K. O'Brien</td></tr>
	24	<tr><th class="docinfo-name">Author:</th>
	25	<td>Robin Dunn</td></tr>
	26	<tr><th class="docinfo-name">Contact:</th>
	27	<td><a class="first last reference" href="mailto:pobrien@orbtech.com">pobrien@orbtech.com</a></td></tr>
	28	<tr><th class="docinfo-name">Organization:</th>
	29	<td><a class="first last reference" href="http://www.orbtech.com/">Orbtech</a></td></tr>
	30	<tr><th class="docinfo-name">Date:</th>
7fa23c09	31	<td>2004-03-26</td></tr>
8eda5e35	32	<tr><th class="docinfo-name">Revision:</th>
7fa23c09	33	<td>1.4</td></tr>
8eda5e35 RD	34	</tbody>
8eda5e35 RD	35	</table>
974a50f1 RD	36	<div class="contents topic">
974a50f1 RD	37	<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
8eda5e35 RD	38	<ul class="simple">
	39	<li><a class="reference" href="#introduction" id="id2" name="id2">Introduction</a></li>
	40	<li><a class="reference" href="#why-change-anything" id="id3" name="id3">Why change anything?</a></li>
	41	<li><a class="reference" href="#what-does-the-new-wx-package-do" id="id4" name="id4">What does the new wx package do?</a></li>
	42	<li><a class="reference" href="#will-any-of-this-effect-my-existing-code" id="id5" name="id5">Will any of this effect my existing code?</a></li>
	43	<li><a class="reference" href="#what-about-all-the-other-modules-like-grid-html-and-stc" id="id6" name="id6">What about all the other modules, like grid, html, and stc?</a></li>
	44	<li><a class="reference" href="#how-do-i-use-this-new-wx-package" id="id7" name="id7">How do I use this new wx package?</a></li>
	45	<li><a class="reference" href="#what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package" id="id8" name="id8">What are the issues with converting old code to use the new wx package?</a></li>
	46	<li><a class="reference" href="#where-can-i-find-example-programs-using-the-new-wx-syntax" id="id9" name="id9">Where can I find example programs using the new wx syntax?</a></li>
	47	</ul>
	48	</div>
974a50f1 RD	49	<div class="section">
974a50f1 RD	50	<h1><a class="toc-backref" href="#id2" id="introduction" name="introduction">Introduction</a></h1>
8eda5e35 RD	51	<p>In the begining there was Python, and Python had modules, and Python
	52	was good. But after a time Guido looked on Python and saw that Python
	53	needed organizational assistance, and so Guido took code from Python's
	54	side and created Packages and then Python was very good. About this
	55	time wxPython was reborn, and wxPython used Packages, but being young
	56	and trying to use a new technology wxPython did not know how to use
	57	Packages effectivly. wxPython was good, but dreamed of being much
	58	better...</p>
	59	<p>Now many years later, after tons of code reorganization and build
	60	hacking wxPython has reached that goal. In version 2.4.1 a prototype
	61	of this new structure was introduced that dynamically built at import
	62	time a new toplevel package named simply "wx" that contained all the
	63	items from wxPython.wx but with the names edited to remove the wx
	64	prefix. Now in 2.5 the final phase of that switcheroo has been
	65	completed and the <em>real</em> classes, functions and constants are now
	66	located in the wx package, leaving some compatibility modules in
	67	wxPython.wx. This document should answer all the questions you might
	68	have concerning the new wx package. Please also take a look at the
	69	<a class="reference" href="MigrationGuide.html">2.5 Migration Guide</a> to see notes about other big differences in
	70	this release.</p>
	71	</div>
974a50f1 RD	72	<div class="section">
974a50f1 RD	73	<h1><a class="toc-backref" href="#id3" id="why-change-anything" name="why-change-anything">Why change anything?</a></h1>
8eda5e35	74	<p>This change is being made for a couple of reasons. The first reason
c66cd08a	75	is to discourage the use of <tt class="docutils literal"><span class="pre">import</span> <span class="pre">*</span></tt>, which is a dangerous
8eda5e35 RD	76	technique that can create name conflicts and bloated namespaces.</p>
	77	<p>The second reason is to remove what some perceive to be a "wart." For
	78	example, the following code is rather ugly in that the "wx" prefix on
	79	the wxFrame class name is no longer useful when you're using the wx
	80	module prefix:</p>
	81	<pre class="literal-block">
	82	from wxPython import wx
	83
	84	class Frame(wx.wxFrame)
	85	</pre>
	86	<p>The new wx package allows you to write code like this, instead:</p>
	87	<pre class="literal-block">
	88	import wx
	89
	90	class Frame(wx.Frame)
	91	</pre>
	92	<p>The third reason is that the wxWindows project has considered doing
	93	the same thing (implement a new wx namespace and drop the "wx" prefix)
	94	and we want wxPython to lead the way.</p>
	95	</div>
974a50f1 RD	96	<div class="section">
974a50f1 RD	97	<h1><a class="toc-backref" href="#id4" id="what-does-the-new-wx-package-do" name="what-does-the-new-wx-package-do">What does the new wx package do?</a></h1>
8eda5e35 RD	98	<p>As mentioned in the Introduction, wxPython 2.4.1 introduced a way of
	99	getting to this new syntax as quickly as possible. It would import
	100	the old names (like "wxFrame") from the old package and then create new
	101	names in the wx package without the wx prefix, (like "Frame".)
	102	Starting with wxPython 2.5 the renaming is moved up to the wxPython
	103	build step, so the real classes and etc. are actually named with the
	104	new name (like "Frame") and are located in the new wx package.</p>
	105	<p>For compatibility the old wxPython package still exists, but now it is
	106	populated with modules that simply import the new names and then
	107	"reverse-renames" them to the old names. It probably sounds a bit
	108	complicated, but it is mostly automated and so it doesn't cause
	109	problems in most cases.</p>
	110	</div>
974a50f1 RD	111	<div class="section">
974a50f1 RD	112	<h1><a class="toc-backref" href="#id5" id="will-any-of-this-effect-my-existing-code" name="will-any-of-this-effect-my-existing-code">Will any of this effect my existing code?</a></h1>
8eda5e35 RD	113	<p>No. Your existing code will continue to work and be supported for
	114	some time. It will be up to you to decide when to switch to the new
	115	syntax. But all new documentation and code examples will use the new
	116	syntax. So don't wait too long. You wouldn't want anyone calling you
	117	old-fashioned, would you?</p>
	118	<p>When you import from wxPython.wx and use a class with the old name,
	119	such as wxButton, you are actually using the wx.Button class. I
	120	expect that the vast majority of the existing code should work fine
	121	using this scheme. The only things that may cause problems is if your
	122	old code is depending on some of the implemtation details, or if you
	123	are using other things that have changed in the API. See the
	124	<a class="reference" href="MigrationGuide.html">Migration Guide</a> for more details.</p>
	125	</div>
974a50f1 RD	126	<div class="section">
974a50f1 RD	127	<h1><a class="toc-backref" href="#id6" id="what-about-all-the-other-modules-like-grid-html-and-stc" name="what-about-all-the-other-modules-like-grid-html-and-stc">What about all the other modules, like grid, html, and stc?</a></h1>
8eda5e35 RD	128	<p>There's more to the old wxPython than just the wxPython.wx module.
	129	And we've got those extra modules covered as well. Each of those
	130	modules (as well as the lib subpackage) has been moved to the new wx
	131	package and reverse-renamers have been placed in the wxPython package
	132	as needed.</p>
	133	</div>
974a50f1 RD	134	<div class="section">
974a50f1 RD	135	<h1><a class="toc-backref" href="#id7" id="how-do-i-use-this-new-wx-package" name="how-do-i-use-this-new-wx-package">How do I use this new wx package?</a></h1>
8eda5e35 RD	136	<p>The wx package is automatically created when you install wxPython
	137	version 2.4.1 or higher. So all you have to do is:</p>
	138	<pre class="literal-block">
	139	import wx
	140	</pre>
	141	</div>
974a50f1 RD	142	<div class="section">
974a50f1 RD	143	<h1><a class="toc-backref" href="#id8" id="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package" name="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package">What are the issues with converting old code to use the new wx package?</a></h1>
8eda5e35 RD	144	<p>Obviously, you need to change your import statements from:</p>
	145	<pre class="literal-block">
	146	from wxPython import wx
	147	</pre>
	148	<p>or:</p>
	149	<pre class="literal-block">
	150	from wxPython.wx import *
	151	</pre>
	152	<p>to:</p>
	153	<pre class="literal-block">
	154	import wx
	155	</pre>
	156	<p>Then you need to refer to wx attributes without a "wx" prefix, such
	157	as:</p>
	158	<pre class="literal-block">
	159	class MyFrame(wx.Frame):
	160	</pre>
	161	<p>In most cases, existing code can be modified with a simple search and
	162	replace.</p>
	163	</div>
974a50f1 RD	164	<div class="section">
974a50f1 RD	165	<h1><a class="toc-backref" href="#id9" id="where-can-i-find-example-programs-using-the-new-wx-syntax" name="where-can-i-find-example-programs-using-the-new-wx-syntax">Where can I find example programs using the new wx syntax?</a></h1>
90805926	166	<p>The wxPython demo application and most of the sample apps have been
c66cd08a	167	converted to use the new <tt class="docutils literal"><span class="pre">import</span> <span class="pre">wx</span></tt> style of programming with
90805926	168	wxPython, so there are lots of examples to look at and to play with.
c66cd08a	169	Here is one of them, it is the <tt class="docutils literal"><span class="pre">simple</span></tt> sample.</p>
90805926 RD	170	<pre class="literal-block">
90805926 RD	171	#----------------------------------------------------------------------
60b517c1 RD	172	# A very simple wxPython example. Just a wx.Frame, wx.Panel,
60b517c1 RD	173	# wx.StaticText, wx.Button, and a wx.BoxSizer, but it shows the basic
90805926 RD	174	# structure of any wxPython application.
	175	#----------------------------------------------------------------------
	176
	177	import wx
	178
	179
	180	class MyFrame(wx.Frame):
	181	"""
	182	This is MyFrame. It just shows a few controls on a wxPanel,
	183	and has a simple menu.
	184	"""
	185	def __init__(self, parent, title):
	186	wx.Frame.__init__(self, parent, -1, title,
	187	pos=(150, 150), size=(350, 200))
	188
	189	# Create the menubar
	190	menuBar = wx.MenuBar()
	191
	192	# and a menu
	193	menu = wx.Menu()
	194
	195	# add an item to the menu, using \tKeyName automatically
	196	# creates an accelerator, the third param is some help text
	197	# that will show up in the statusbar
	198	menu.Append(wx.ID_EXIT, "E&xit\tAlt-X", "Exit this simple sample")
	199
	200	# bind the menu event to an event handler
	201	self.Bind(wx.EVT_MENU, self.OnTimeToClose, id=wx.ID_EXIT)
	202
	203	# and put the menu on the menubar
	204	menuBar.Append(menu, "&File")
	205	self.SetMenuBar(menuBar)
	206
	207	self.CreateStatusBar()
	208
	209
	210	# Now create the Panel to put the other controls on.
	211	panel = wx.Panel(self)
	212
	213	# and a few controls
	214	text = wx.StaticText(panel, -1, "Hello World!")
	215	text.SetFont(wx.Font(14, wx.SWISS, wx.NORMAL, wx.BOLD))
	216	text.SetSize(text.GetBestSize())
	217	btn = wx.Button(panel, -1, "Close")
	218	funbtn = wx.Button(panel, -1, "Just for fun...")
	219
	220	# bind the button events to handlers
	221	self.Bind(wx.EVT_BUTTON, self.OnTimeToClose, btn)
	222	self.Bind(wx.EVT_BUTTON, self.OnFunButton, funbtn)
	223
	224	# Use a sizer to layout the controls, stacked vertically and with
	225	# a 10 pixel border around each
	226	sizer = wx.BoxSizer(wx.VERTICAL)
	227	sizer.Add(text, 0, wx.ALL, 10)
	228	sizer.Add(btn, 0, wx.ALL, 10)
	229	sizer.Add(funbtn, 0, wx.ALL, 10)
	230	panel.SetSizer(sizer)
	231	panel.Layout()
	232
	233
	234	def OnTimeToClose(self, evt):
	235	"""Event handler for the button click."""
	236	print "See ya later!"
	237	self.Close()
238
239	def OnFunButton(self, evt):
240	"""Event handler for the button click."""
241	print "Having fun yet?"
242
243
244	class MyApp(wx.App):
245	def OnInit(self):
246	frame = MyFrame(None, "Simple wxPython App")
90805926	247	self.SetTopWindow(frame)
60b517c1 RD	248
	249	print "Print statements go to this stdout window by default."
	250
	251	frame.Show(True)
90805926 RD	252	return True
90805926 RD	253
60b517c1	254	app = MyApp(redirect=True)
90805926 RD	255	app.MainLoop()
	256
	257
	258	</pre>
8eda5e35 RD	259	</div>
8eda5e35 RD	260	</div>
8eda5e35 RD	261	</body>
8eda5e35 RD	262	</html>