Removed some old, outdated, unfinished, or unstarted docs and the
samples that go with them. These can be added back later if somebody wants to work on them again. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@26378 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Robin Dunn
@@ -212,7 +212,6 @@ _treeList = [
|
||||
'FileHistory',
|
||||
'FontEnumerator',
|
||||
'Joystick',
|
||||
'NewNamespace',
|
||||
'OGL',
|
||||
'PrintFramework',
|
||||
'ShapedWindow',
|
||||
|
||||
@@ -1,47 +0,0 @@
|
||||
|
||||
import wx # This module uses the new wx namespace
|
||||
from wx import html
|
||||
from Main import opj
|
||||
|
||||
#----------------------------------------------------------------------
|
||||
|
||||
class TestPanel(wx.Panel):
|
||||
def __init__(self, parent, log):
|
||||
self.log = log
|
||||
wx.Panel.__init__(self, parent, -1)
|
||||
|
||||
hwin = html.HtmlWindow(self, -1)
|
||||
hwin.LoadFile(opj('data/wxPackage.html'))
|
||||
|
||||
sizer = wx.BoxSizer(wx.VERTICAL)
|
||||
sizer.Add(hwin, 1, wx.EXPAND)
|
||||
|
||||
self.SetSizer(sizer)
|
||||
|
||||
|
||||
#----------------------------------------------------------------------
|
||||
|
||||
def runTest(frame, nb, log):
|
||||
win = TestPanel(nb, log)
|
||||
return win
|
||||
|
||||
#----------------------------------------------------------------------
|
||||
|
||||
|
||||
|
||||
overview = """<html><body>
|
||||
<h2><center>Using the New Namespace</center></h2>
|
||||
|
||||
This sample isn't really a demo, but rather a place to display the
|
||||
introductory doc for using the new namespace.
|
||||
|
||||
</body></html>
|
||||
"""
|
||||
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
import sys,os
|
||||
import run
|
||||
run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
|
||||
|
||||
@@ -1,290 +0,0 @@
|
||||
<?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.2.8: http://docutils.sourceforge.net/" />
|
||||
<title>The wxPython wx Package</title>
|
||||
<meta name="author" content="Patrick K. O'Brien" />
|
||||
<meta name="organization" content="Orbtech" />
|
||||
<meta name="date" content="2003-05-08" />
|
||||
<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">Contact:</th>
|
||||
<td><a class="first last reference" href="mailto:pobrien@orbtech.com">pobrien@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>2003-05-08</td></tr>
|
||||
<tr><th class="docinfo-name">Revision:</th>
|
||||
<td>1.1.2.4</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="contents topic" id="contents">
|
||||
<p class="topic-title"><a name="contents">Contents</a></p>
|
||||
<ul class="simple">
|
||||
<li><a class="reference" href="#introduction" id="id1" name="id1">Introduction</a></li>
|
||||
<li><a class="reference" href="#why-change-anything" id="id2" name="id2">Why change anything?</a></li>
|
||||
<li><a class="reference" href="#what-does-the-new-wx-package-do" id="id3" name="id3">What does the new wx package do?</a></li>
|
||||
<li><a class="reference" href="#will-any-of-this-effect-my-existing-code" id="id4" name="id4">Will any of this effect my existing code?</a></li>
|
||||
<li><a class="reference" href="#how-does-the-new-wx-package-work" id="id5" name="id5">How does the new wx package work?</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" id="introduction">
|
||||
<h1><a class="toc-backref" href="#id1" name="introduction">Introduction</a></h1>
|
||||
<p>Big things sometimes come in small packages. This is certainly true
|
||||
of the new wx package, which is being introduced in wxPython 2.4.1 as
|
||||
a way to allow the "wx" prefix to be dropped from the names of all
|
||||
wxPython classes, functions, and constants. This document should
|
||||
answer all the questions you might have concerning the new wx package.
|
||||
If not, feel free to contact the author. I hope you like the new wx
|
||||
package as much as I do.</p>
|
||||
</div>
|
||||
<div class="section" id="why-change-anything">
|
||||
<h1><a class="toc-backref" href="#id2" 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="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 "wart." For
|
||||
example, the following code is rather ugly in that the "wx" 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 intends to do the same
|
||||
thing (implement a new wx namespace and drop the "wx" prefix) and we
|
||||
want wxPython to lead the way.</p>
|
||||
</div>
|
||||
<div class="section" id="what-does-the-new-wx-package-do">
|
||||
<h1><a class="toc-backref" href="#id3" name="what-does-the-new-wx-package-do">What does the new wx package do?</a></h1>
|
||||
<p>As a way of getting to this new syntax as quickly as possible, the
|
||||
code in this new wx package was created. What it does is alter the
|
||||
existing wx namespace dynamically. By making the changes on-the-fly
|
||||
at runtime, we can try out the new syntax before any permanent changes
|
||||
are made to the underlying class library. The downside of making
|
||||
these changes at runtime is that there is a slight delay when you
|
||||
<tt class="literal"><span class="pre">import</span> <span class="pre">wx</span></tt>; the upside is that you can start using the new syntax
|
||||
now.</p>
|
||||
</div>
|
||||
<div class="section" id="will-any-of-this-effect-my-existing-code">
|
||||
<h1><a class="toc-backref" href="#id4" 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>
|
||||
</div>
|
||||
<div class="section" id="how-does-the-new-wx-package-work">
|
||||
<h1><a class="toc-backref" href="#id5" name="how-does-the-new-wx-package-work">How does the new wx package work?</a></h1>
|
||||
<p>It's pretty simple, and pretty clever. The wx directory contains an
|
||||
<tt class="literal"><span class="pre">__init__.py</span></tt> file, making it a Python package. (In contrast, the
|
||||
old wxPython.wx module is a module, not a package.) When you <tt class="literal"><span class="pre">import</span>
|
||||
<span class="pre">wx</span></tt> the code in the <tt class="literal"><span class="pre">__init__.py</span></tt> file is executed, and that's
|
||||
where all the magic takes place. Let's take a look at the code inside
|
||||
the <tt class="literal"><span class="pre">__init__.py</span></tt> file:</p>
|
||||
<pre class="literal-block">
|
||||
"""wx package
|
||||
|
||||
Provides a way to drop the wx prefix from wxPython objects."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
from wxPython import wx
|
||||
|
||||
import types
|
||||
|
||||
d_new = globals()
|
||||
d_old = wx.__dict__
|
||||
|
||||
for old, obj in d_old.items():
|
||||
if type(obj) is types.ModuleType or old.startswith('_'):
|
||||
# Skip modules and private names.
|
||||
continue
|
||||
new = old
|
||||
if old.startswith('EVT_'):
|
||||
# Leave name unmodified; add to the new wx namespace.
|
||||
d_new[new] = obj
|
||||
elif old.startswith('wxEVT_'):
|
||||
# Leave name unmodified; add to the new wx namespace.
|
||||
d_new[new] = obj
|
||||
else:
|
||||
if old.startswith('wx'):
|
||||
# Remove the 'wx' prefix.
|
||||
new = old[2:]
|
||||
# Add to the new wx package namespace.
|
||||
d_new[new] = obj
|
||||
|
||||
del d_new
|
||||
del d_old
|
||||
del new
|
||||
del obj
|
||||
del old
|
||||
del types
|
||||
|
||||
del wx
|
||||
|
||||
</pre>
|
||||
<p>Namespaces in Python are implemented as dictionaries. The dictionary
|
||||
used to create the wx package's namespace is accessible using the
|
||||
<tt class="literal"><span class="pre">globals()</span></tt> function. The dictionary used to create the old
|
||||
wxPython.wx module's namespace is <tt class="literal"><span class="pre">wx.__dict__</span></tt>. Once we have these
|
||||
two dictionaries, it's a simple matter of iterating through one,
|
||||
changing the names, adding the renamed object to the other dictionary,
|
||||
and cleaning up a few local variables and imported modules. Voila!</p>
|
||||
</div>
|
||||
<div class="section" id="what-about-all-the-other-modules-like-grid-html-and-stc">
|
||||
<h1><a class="toc-backref" href="#id6" 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 wxPython than just the wx namespace. And we've got
|
||||
those extra modules covered as well. For each of those modules (as
|
||||
well as the lib package) we've got matching modules in the new wx
|
||||
package. Let's take a look at a few of them.</p>
|
||||
<p>Here is <tt class="literal"><span class="pre">html.py</span></tt>:</p>
|
||||
<pre class="literal-block">
|
||||
"""Provides a way to drop the wx prefix from wxPython objects."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
from wx import prefix
|
||||
|
||||
from wxPython import html
|
||||
prefix.rename(d_new=globals(), d_old=html.__dict__)
|
||||
del html
|
||||
|
||||
del prefix
|
||||
del wx
|
||||
|
||||
</pre>
|
||||
<p>And here is <tt class="literal"><span class="pre">lib/dialogs.py</span></tt>:</p>
|
||||
<pre class="literal-block">
|
||||
"""Provides a way to drop the wx prefix from wxPython objects."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
from wx import prefix
|
||||
|
||||
from wxPython.lib import dialogs
|
||||
prefix.rename(d_new=globals(), d_old=dialogs.__dict__)
|
||||
del dialogs
|
||||
|
||||
del prefix
|
||||
del wx
|
||||
|
||||
</pre>
|
||||
<p>As you can see, they both rely on the <tt class="literal"><span class="pre">prefix.rename()</span></tt> function
|
||||
defined in <tt class="literal"><span class="pre">prefix.py</span></tt>:</p>
|
||||
<pre class="literal-block">
|
||||
"""Renaming utility.
|
||||
|
||||
Provides a way to drop the wx prefix from wxPython objects."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import types
|
||||
|
||||
def rename(d_new, d_old):
|
||||
for old, obj in d_old.items():
|
||||
if type(obj) is types.ModuleType or old.startswith('_'):
|
||||
# Skip modules and private names.
|
||||
continue
|
||||
## mod = d_old['__name__']
|
||||
## if hasattr(obj, '__module__') and not obj.__module__.startswith(mod):
|
||||
## # Skip objects imported from other modules, except those
|
||||
## # related to the current module, such as stc_.
|
||||
## continue
|
||||
new = old
|
||||
if old.startswith('EVT_') or old.startswith('wxEVT_'):
|
||||
# Leave these names unmodified.
|
||||
pass
|
||||
elif old.startswith('wx'):
|
||||
new = old[2:]
|
||||
if new:
|
||||
d_new[new] = d_old[old]
|
||||
|
||||
</pre>
|
||||
<p>Again, the technique is very similar to the one used by the wx
|
||||
package.</p>
|
||||
</div>
|
||||
<div class="section" id="how-do-i-use-this-new-wx-package">
|
||||
<h1><a class="toc-backref" href="#id7" 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" id="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package">
|
||||
<h1><a class="toc-backref" href="#id8" 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 "wx" 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>
|
||||
<p>One extra issue you might run into when converting existing code is
|
||||
that the wx.__version__ attribute is no longer available, since the
|
||||
new wx namespace doesn't include any private attributes from the old
|
||||
wxPython.wx namespace. The solution is to use the wx.VERSION_STRING
|
||||
attribute, which was introduced in wxPython 2.4.1.</p>
|
||||
</div>
|
||||
<div class="section" id="where-can-i-find-example-programs-using-the-new-wx-syntax">
|
||||
<h1><a class="toc-backref" href="#id9" 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>Example programs are included in the wxPython/samples/wx_examples
|
||||
directory, and are documented in the <a class="reference" href="wxPythonExamples.html">wxPythonExamples</a> documentation
|
||||
file. Also, all the code in the py package uses the new wx syntax.
|
||||
You can learn more about these in the <a class="reference" href="PyManual.html">PyManual</a>.</p>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="footer"/>
|
||||
<div class="footer">
|
||||
<a class="reference" href="wxPackage.txt">View document source</a>.
|
||||
Generated on: 2003-06-04 18:07 UTC.
|
||||
Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -53,9 +53,6 @@ wxPython/samples/pySketch
|
||||
wxPython/samples/pySketch/images
|
||||
wxPython/samples/simple
|
||||
wxPython/samples/StyleEditor
|
||||
wxPython/samples/wx_examples
|
||||
wxPython/samples/wx_examples/basic
|
||||
wxPython/samples/wx_examples/hello
|
||||
wxPython/samples/wxProject
|
||||
wxPython/scripts
|
||||
wxPython/src
|
||||
|
||||
@@ -221,10 +221,6 @@ Source: "samples\StyleEditor\*.txt"; DestDir: "{app}\wx\samples\StyleEdit
|
||||
Source: "samples\StyleEditor\*.py"; DestDir: "{app}\wx\samples\StyleEditor"; Components: samples
|
||||
Source: "samples\StyleEditor\*.cfg"; DestDir: "{app}\wx\samples\StyleEditor"; Components: samples
|
||||
|
||||
Source: "samples\wx_examples\basic\*.py"; DestDir: "{app}\wx\samples\wx_examples\basic"; Components: samples
|
||||
Source: "samples\wx_examples\hello\*.py"; DestDir: "{app}\wx\samples\wx_examples\hello"; Components: samples
|
||||
Source: "samples\wx_examples\hello\*.jpg"; DestDir: "{app}\wx\samples\wx_examples\hello"; Components: samples
|
||||
|
||||
Source: "samples\wxProject\*.txt"; DestDir: "{app}\wx\samples\wxProject"; Components: samples
|
||||
Source: "samples\wxProject\*.py"; DestDir: "{app}\wx\samples\wxProject"; Components: samples
|
||||
|
||||
@@ -256,12 +252,9 @@ Name: "{group}\Resource Editor"; Filename: "{code:GetPythonDir}\pythonw.ex
|
||||
Name: "{group}\Sample Apps"; Filename: "{app}\wx\samples"; Components: samples
|
||||
|
||||
Name: "{group}\wxWindows Reference"; Filename: "{app}\wx\docs\wx.chm"; Components: docs
|
||||
Name: "{group}\wxOGL Reference"; Filename: "{app}\wx\docs\ogl.chm"; Components: docs
|
||||
Name: "{group}\licence.txt"; Filename: "{app}\wx\docs\licence\licence.txt"; Components: core
|
||||
Name: "{group}\README.txt"; Filename: "{app}\wx\docs\README.txt"; Components: docs
|
||||
Name: "{group}\CHANGES.txt"; Filename: "{app}\wx\docs\CHANGES.txt"; Components: docs
|
||||
Name: "{group}\Migration Guide"; Filename: "{app}\wx\docs\MigrationGuide.html"; Components: docs
|
||||
Name: "{group}\Other wxPython Docs"; Filename: "{app}\wx\docs\wxPythonDocs.html"; Components: docs
|
||||
Name: "{group}\CHANGES"; Filename: "{app}\wx\docs\CHANGES.html"; Components: docs
|
||||
Name: "{group}\Other Docs"; Filename: "{app}\wx\docs"; Components: docs
|
||||
|
||||
|
||||
;;------------------------------------------------------------
|
||||
|
||||
@@ -1,77 +0,0 @@
|
||||
<?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.3.1: http://docutils.sourceforge.net/" />
|
||||
<title>wxPython Documentation</title>
|
||||
<meta name="author" content="Patrick K. O'Brien" />
|
||||
<meta name="organization" content="Orbtech" />
|
||||
<meta name="date" content="2003-07-02" />
|
||||
<link rel="stylesheet" href="default.css" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div class="document" id="wxpython-documentation">
|
||||
<h1 class="title">wxPython Documentation</h1>
|
||||
<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">Contact:</th>
|
||||
<td><a class="first last reference" href="mailto:pobrien@orbtech.com">pobrien@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>2003-07-02</td></tr>
|
||||
<tr><th class="docinfo-name">Revision:</th>
|
||||
<td>1.2</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="section" id="wxpython-manual">
|
||||
<h1><a name="wxpython-manual">wxPython Manual</a></h1>
|
||||
<p><a class="reference" href="wxPythonManual.html">The wxPython Manual</a> is a reference to the wxPython toolkit.</p>
|
||||
</div>
|
||||
<div class="section" id="wxpython-developer-reference">
|
||||
<h1><a name="wxpython-developer-reference">wxPython Developer Reference</a></h1>
|
||||
<p><a class="reference" href="http://www.orbtech.com/www/wx/epydoc/">The wxPython source code documentation</a> is for developers, and was
|
||||
created using the Epydoc tool.</p>
|
||||
</div>
|
||||
<div class="section" id="wxpython-tutorial">
|
||||
<h1><a name="wxpython-tutorial">wxPython Tutorial</a></h1>
|
||||
<p><a class="reference" href="wxPythonTutorial.html">The wxPython Tutorial</a> will help get you started with wxPython.</p>
|
||||
</div>
|
||||
<div class="section" id="wxpython-examples">
|
||||
<h1><a name="wxpython-examples">wxPython Examples</a></h1>
|
||||
<p><a class="reference" href="wxPythonExamples.html">The wxPython Examples</a> illustrates example programs using wxPython.</p>
|
||||
</div>
|
||||
<div class="section" id="wx-package">
|
||||
<h1><a name="wx-package">wx Package</a></h1>
|
||||
<p><a class="reference" href="wxPackage.html">The wxPython wx Package</a> explains the new prefix-less wx package.</p>
|
||||
</div>
|
||||
<div class="section" id="py-manual">
|
||||
<h1><a name="py-manual">Py Manual</a></h1>
|
||||
<p><a class="reference" href="PyManual.html">The Py Manual</a> documents the Py collection of programs and source
|
||||
code modules, including:</p>
|
||||
<ul class="simple">
|
||||
<li>PyAlaCarte</li>
|
||||
<li>PyAlaMode</li>
|
||||
<li>PyCrust</li>
|
||||
<li>PyFilling</li>
|
||||
<li>PyShell</li>
|
||||
<li>PyWrap</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="py-developer-reference">
|
||||
<h1><a name="py-developer-reference">Py Developer Reference</a></h1>
|
||||
<p><a class="reference" href="http://www.orbtech.com/www/wx/epydoc/public/wx.py-module.html">The Py source code documentation</a> is for developers, and was created
|
||||
using the Epydoc tool.</p>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="footer" />
|
||||
<div class="footer">
|
||||
Generated on: 2004-03-12 19:55 UTC.
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,77 +0,0 @@
|
||||
========================
|
||||
wxPython Documentation
|
||||
========================
|
||||
|
||||
:Author: Patrick K. O'Brien
|
||||
:Contact: pobrien@orbtech.com
|
||||
:Organization: Orbtech_
|
||||
:Date: $Date$
|
||||
:Revision: $Revision$
|
||||
|
||||
.. _Orbtech: http://www.orbtech.com/
|
||||
|
||||
|
||||
wxPython Manual
|
||||
===============
|
||||
|
||||
`The wxPython Manual`_ is a reference to the wxPython toolkit.
|
||||
|
||||
.. _The wxPython Manual: wxPythonManual.html
|
||||
|
||||
|
||||
wxPython Developer Reference
|
||||
============================
|
||||
|
||||
`The wxPython source code documentation`_ is for developers, and was
|
||||
created using the Epydoc tool.
|
||||
|
||||
.. _The wxPython source code documentation: http://www.orbtech.com/www/wx/epydoc/
|
||||
|
||||
|
||||
wxPython Tutorial
|
||||
=================
|
||||
|
||||
`The wxPython Tutorial`_ will help get you started with wxPython.
|
||||
|
||||
.. _The wxPython Tutorial: wxPythonTutorial.html
|
||||
|
||||
|
||||
wxPython Examples
|
||||
=================
|
||||
|
||||
`The wxPython Examples`_ illustrates example programs using wxPython.
|
||||
|
||||
.. _The wxPython Examples: wxPythonExamples.html
|
||||
|
||||
|
||||
wx Package
|
||||
==========
|
||||
|
||||
`The wxPython wx Package`_ explains the new prefix-less wx package.
|
||||
|
||||
.. _The wxPython wx Package: wxPackage.html
|
||||
|
||||
|
||||
Py Manual
|
||||
=========
|
||||
|
||||
`The Py Manual`_ documents the Py collection of programs and source
|
||||
code modules, including:
|
||||
|
||||
* PyAlaCarte
|
||||
* PyAlaMode
|
||||
* PyCrust
|
||||
* PyFilling
|
||||
* PyShell
|
||||
* PyWrap
|
||||
|
||||
.. _The Py Manual: PyManual.html
|
||||
|
||||
|
||||
Py Developer Reference
|
||||
======================
|
||||
|
||||
`The Py source code documentation`_ is for developers, and was created
|
||||
using the Epydoc tool.
|
||||
|
||||
.. _The Py source code documentation: http://www.orbtech.com/www/wx/epydoc/public/wx.py-module.html
|
||||
@@ -1,226 +0,0 @@
|
||||
<?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.3.1: http://docutils.sourceforge.net/" />
|
||||
<title>Example Programs Using wxPython</title>
|
||||
<meta name="author" content="Patrick K. O'Brien" />
|
||||
<meta name="organization" content="Orbtech" />
|
||||
<meta name="date" content="2003-07-02" />
|
||||
<link rel="stylesheet" href="default.css" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div class="document" id="example-programs-using-wxpython">
|
||||
<h1 class="title">Example Programs Using wxPython</h1>
|
||||
<h2 class="subtitle" id="a-survival-guide-for-the-post-wx-prefixed-world">A survival guide for the post-wx-prefixed world.</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">Contact:</th>
|
||||
<td><a class="first last reference" href="mailto:pobrien@orbtech.com">pobrien@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>2003-07-02</td></tr>
|
||||
<tr><th class="docinfo-name">Revision:</th>
|
||||
<td>1.2</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="contents topic" id="contents">
|
||||
<p class="topic-title"><a name="contents">Contents</a></p>
|
||||
<ul class="simple">
|
||||
<li><a class="reference" href="#introduction" id="id1" name="id1">Introduction</a></li>
|
||||
<li><a class="reference" href="#background-with-tongue-firmly-in-cheek" id="id2" name="id2">Background (with tongue firmly in cheek)</a></li>
|
||||
<li><a class="reference" href="#basic-program-example" id="id3" name="id3">Basic Program Example</a></li>
|
||||
<li><a class="reference" href="#hello-wxpython-example" id="id4" name="id4">Hello wxPython Example</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="introduction">
|
||||
<h1><a class="toc-backref" href="#id1" name="introduction">Introduction</a></h1>
|
||||
<p>This document illustrates example programs using wxPython. All the
|
||||
examples make use of the new wx package syntax introduced in wxPython
|
||||
2.4.1, which is a bit different than older examples you might come
|
||||
across.</p>
|
||||
</div>
|
||||
<div class="section" id="background-with-tongue-firmly-in-cheek">
|
||||
<h1><a class="toc-backref" href="#id2" name="background-with-tongue-firmly-in-cheek">Background (with tongue firmly in cheek)</a></h1>
|
||||
<p>If something hits you on the head, don't run around screaming that the
|
||||
sky is falling. Instead, take a close look and see if it wasn't a
|
||||
"wx" prefix that hit you. Apparently, they're dropping off wxPython
|
||||
class names like flies dropping dead in the scorching heat of a
|
||||
summer's day.</p>
|
||||
<p>Yes, the world is changing, and even our little wxPython world must
|
||||
change with it. Then again, I'm not fond of pesky summertime flies,
|
||||
and I'm not too upset that the "wx" prefixes are going to bite the
|
||||
dust. I think it's for the best. But, being the kind, considerate
|
||||
person that I am, I decided to write this guide to make the wx
|
||||
namespace transition easier for everyone, even Chicken Little.</p>
|
||||
<div class="note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>Say what?</p>
|
||||
<p>If you have no idea what I mean by the "wx namespace transition,"
|
||||
consider yourself lucky. You can simply use these examples to
|
||||
learn wxPython in its current state (beginning with wxPython
|
||||
version 2.4.1). All you need to know is that previous wxPython
|
||||
code used a slightly different syntax that some folks (including
|
||||
me) considered ugly. So we changed it. And that's when the sky
|
||||
starting falling...</p>
|
||||
<p>If you want more of the technical details, read the <a class="reference" href="wxPackage.html">wx package
|
||||
documentation</a>.</p>
|
||||
</div>
|
||||
<p>Rather than simply <strong>tell</strong> you that everything will be okay, I
|
||||
decided to <strong>show</strong> you that everything will be okay. To do that,
|
||||
I've created a bunch of example programs using the new wx package. I
|
||||
hope you like them.</p>
|
||||
</div>
|
||||
<div class="section" id="basic-program-example">
|
||||
<h1><a class="toc-backref" href="#id3" name="basic-program-example">Basic Program Example</a></h1>
|
||||
<p>It doesn't get much simpler than this. Every wxPython program needs
|
||||
an application and a frame. To encourage good coding habits, I've
|
||||
split them into separate modules. They don't do much, but they're a
|
||||
good starting point.</p>
|
||||
<p>I include a simple App class in the frame module because the PyWrap
|
||||
"wrapper" utility (<tt class="literal"><span class="pre">pywrap</span></tt>) only works with modules that contain an
|
||||
application class. So including a simple one in each of your frame
|
||||
modules allows you to use the PyWrap runtime wrapper and debug your
|
||||
frames independent of your full application.</p>
|
||||
<p>Here is the module (<tt class="literal"><span class="pre">frame.py</span></tt>) that defines the frame class:</p>
|
||||
<pre class="literal-block">
|
||||
#!/usr/bin/env python
|
||||
|
||||
"""Basic frame class, with App for testing."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
|
||||
class Frame(wx.Frame):
|
||||
"""Frame class."""
|
||||
|
||||
def __init__(self, parent=None, id=-1, title='Title',
|
||||
pos=wx.DefaultPosition, size=(400, 200)):
|
||||
"""Create a Frame instance."""
|
||||
wx.Frame.__init__(self, parent, id, title, pos, size)
|
||||
|
||||
class App(wx.App):
|
||||
"""Application class."""
|
||||
|
||||
def OnInit(self):
|
||||
self.frame = Frame()
|
||||
self.frame.Show()
|
||||
self.SetTopWindow(self.frame)
|
||||
return True
|
||||
|
||||
def main():
|
||||
app = App()
|
||||
app.MainLoop()
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
|
||||
</pre>
|
||||
<p>And here is the module (<tt class="literal"><span class="pre">app.py</span></tt>) that defines the application class
|
||||
and imports the frame from <tt class="literal"><span class="pre">frame.py</span></tt>:</p>
|
||||
<pre class="literal-block">
|
||||
#!/usr/bin/env python
|
||||
|
||||
"""Basic application class."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
|
||||
from frame import Frame
|
||||
|
||||
class App(wx.App):
|
||||
"""Application class."""
|
||||
|
||||
def OnInit(self):
|
||||
self.frame = Frame()
|
||||
self.frame.Show()
|
||||
self.SetTopWindow(self.frame)
|
||||
return True
|
||||
|
||||
def main():
|
||||
app = App()
|
||||
app.MainLoop()
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
|
||||
</pre>
|
||||
</div>
|
||||
<div class="section" id="hello-wxpython-example">
|
||||
<h1><a class="toc-backref" href="#id4" name="hello-wxpython-example">Hello wxPython Example</a></h1>
|
||||
<p>This program displays an image file (<tt class="literal"><span class="pre">wxPython.jpg</span></tt>) inside a frame
|
||||
sized to match the graphic.</p>
|
||||
<div class="figure">
|
||||
<p><img alt="screenshots/hello-win98.png" scale="100" src="screenshots/hello-win98.png" /></p>
|
||||
<p class="caption">Running <tt class="literal"><span class="pre">hello.py</span></tt> on Windows.</p>
|
||||
</div>
|
||||
<div class="figure">
|
||||
<p><img alt="screenshots/hello-linux.png" scale="100" src="screenshots/hello-linux.png" /></p>
|
||||
<p class="caption">Running <tt class="literal"><span class="pre">hello.py</span></tt> on Linux.</p>
|
||||
</div>
|
||||
<div class="figure">
|
||||
<p><img alt="screenshots/hello-mac.png" scale="100" src="screenshots/hello-mac.png" /></p>
|
||||
<p class="caption">Running <tt class="literal"><span class="pre">hello.py</span></tt> on Mac OS X.</p>
|
||||
</div>
|
||||
<p>Here is the source code for <tt class="literal"><span class="pre">hello.py</span></tt>:</p>
|
||||
<pre class="literal-block">
|
||||
#!/usr/bin/env python
|
||||
|
||||
"""Hello, wxPython! program."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
|
||||
class Frame(wx.Frame):
|
||||
"""Frame class that displays an image."""
|
||||
|
||||
def __init__(self, image, parent=None, id=-1,
|
||||
pos=wx.DefaultPosition, title='Hello, wxPython!'):
|
||||
"""Create a Frame instance and display image."""
|
||||
temp = image.ConvertToBitmap()
|
||||
size = temp.GetWidth(), temp.GetHeight()
|
||||
wx.Frame.__init__(self, parent, id, title, pos, size)
|
||||
self.bmp = wx.StaticBitmap(parent=self, id=-1, bitmap=temp)
|
||||
|
||||
class App(wx.App):
|
||||
"""Application class."""
|
||||
|
||||
def OnInit(self):
|
||||
wx.InitAllImageHandlers()
|
||||
image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG)
|
||||
self.frame = Frame(image)
|
||||
self.frame.Show()
|
||||
self.SetTopWindow(self.frame)
|
||||
return True
|
||||
|
||||
def main():
|
||||
app = App()
|
||||
app.MainLoop()
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
|
||||
</pre>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="footer" />
|
||||
<div class="footer">
|
||||
Generated on: 2004-03-12 19:55 UTC.
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,118 +0,0 @@
|
||||
=================================
|
||||
Example Programs Using wxPython
|
||||
=================================
|
||||
|
||||
--------------------------------------------------
|
||||
A survival guide for the post-wx-prefixed world.
|
||||
--------------------------------------------------
|
||||
|
||||
:Author: Patrick K. O'Brien
|
||||
:Contact: pobrien@orbtech.com
|
||||
:Organization: Orbtech_
|
||||
:Date: $Date$
|
||||
:Revision: $Revision$
|
||||
|
||||
.. _Orbtech: http://www.orbtech.com/
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Introduction
|
||||
============
|
||||
|
||||
This document illustrates example programs using wxPython. All the
|
||||
examples make use of the new wx package syntax introduced in wxPython
|
||||
2.4.1, which is a bit different than older examples you might come
|
||||
across.
|
||||
|
||||
|
||||
Background (with tongue firmly in cheek)
|
||||
========================================
|
||||
|
||||
If something hits you on the head, don't run around screaming that the
|
||||
sky is falling. Instead, take a close look and see if it wasn't a
|
||||
"wx" prefix that hit you. Apparently, they're dropping off wxPython
|
||||
class names like flies dropping dead in the scorching heat of a
|
||||
summer's day.
|
||||
|
||||
Yes, the world is changing, and even our little wxPython world must
|
||||
change with it. Then again, I'm not fond of pesky summertime flies,
|
||||
and I'm not too upset that the "wx" prefixes are going to bite the
|
||||
dust. I think it's for the best. But, being the kind, considerate
|
||||
person that I am, I decided to write this guide to make the wx
|
||||
namespace transition easier for everyone, even Chicken Little.
|
||||
|
||||
.. note:: Say what?
|
||||
|
||||
If you have no idea what I mean by the "wx namespace transition,"
|
||||
consider yourself lucky. You can simply use these examples to
|
||||
learn wxPython in its current state (beginning with wxPython
|
||||
version 2.4.1). All you need to know is that previous wxPython
|
||||
code used a slightly different syntax that some folks (including
|
||||
me) considered ugly. So we changed it. And that's when the sky
|
||||
starting falling...
|
||||
|
||||
If you want more of the technical details, read the `wx package
|
||||
documentation`_.
|
||||
|
||||
.. _wx package documentation: wxPackage.html
|
||||
|
||||
|
||||
Rather than simply **tell** you that everything will be okay, I
|
||||
decided to **show** you that everything will be okay. To do that,
|
||||
I've created a bunch of example programs using the new wx package. I
|
||||
hope you like them.
|
||||
|
||||
|
||||
Basic Program Example
|
||||
=====================
|
||||
|
||||
It doesn't get much simpler than this. Every wxPython program needs
|
||||
an application and a frame. To encourage good coding habits, I've
|
||||
split them into separate modules. They don't do much, but they're a
|
||||
good starting point.
|
||||
|
||||
I include a simple App class in the frame module because the PyWrap
|
||||
"wrapper" utility (``pywrap``) only works with modules that contain an
|
||||
application class. So including a simple one in each of your frame
|
||||
modules allows you to use the PyWrap runtime wrapper and debug your
|
||||
frames independent of your full application.
|
||||
|
||||
Here is the module (``frame.py``) that defines the frame class:
|
||||
|
||||
.. include:: ../samples/wx_examples/basic/frame.py
|
||||
:literal:
|
||||
|
||||
And here is the module (``app.py``) that defines the application class
|
||||
and imports the frame from ``frame.py``:
|
||||
|
||||
.. include:: ../samples/wx_examples/basic/app.py
|
||||
:literal:
|
||||
|
||||
|
||||
Hello wxPython Example
|
||||
======================
|
||||
|
||||
This program displays an image file (``wxPython.jpg``) inside a frame
|
||||
sized to match the graphic.
|
||||
|
||||
.. figure:: screenshots/hello-win98.png
|
||||
:scale: 100
|
||||
|
||||
Running ``hello.py`` on Windows.
|
||||
|
||||
.. figure:: screenshots/hello-linux.png
|
||||
:scale: 100
|
||||
|
||||
Running ``hello.py`` on Linux.
|
||||
|
||||
.. figure:: screenshots/hello-mac.png
|
||||
:scale: 100
|
||||
|
||||
Running ``hello.py`` on Mac OS X.
|
||||
|
||||
Here is the source code for ``hello.py``:
|
||||
|
||||
.. include:: ../samples/wx_examples/hello/hello.py
|
||||
:literal:
|
||||
|
||||
@@ -1,128 +0,0 @@
|
||||
<?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.3.1: http://docutils.sourceforge.net/" />
|
||||
<title>The wxPython Tutorial</title>
|
||||
<meta name="author" content="Patrick K. O'Brien" />
|
||||
<meta name="organization" content="Orbtech" />
|
||||
<meta name="date" content="2003-07-02" />
|
||||
<link rel="stylesheet" href="default.css" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div class="document" id="the-wxpython-tutorial">
|
||||
<h1 class="title">The wxPython Tutorial</h1>
|
||||
<h2 class="subtitle" id="how-to-get-up-and-running-with-wxpython">How to get up and running with wxPython</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">Contact:</th>
|
||||
<td><a class="first last reference" href="mailto:pobrien@orbtech.com">pobrien@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>2003-07-02</td></tr>
|
||||
<tr><th class="docinfo-name">Revision:</th>
|
||||
<td>1.2</td></tr>
|
||||
<tr class="field"><th class="docinfo-name">License:</th><td class="field-body">wxWindows Free Documentation Licence, Version 3</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="contents topic" id="contents">
|
||||
<p class="topic-title"><a name="contents">Contents</a></p>
|
||||
<ul class="simple">
|
||||
<li><a class="reference" href="#introduction" id="id1" name="id1">Introduction</a></li>
|
||||
<li><a class="reference" href="#what-is-wxpython" id="id2" name="id2">What is wxPython?</a></li>
|
||||
<li><a class="reference" href="#license" id="id3" name="id3">License</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="introduction">
|
||||
<h1><a class="toc-backref" href="#id1" name="introduction">Introduction</a></h1>
|
||||
<p>This is a tutorial for the wxPython GUI toolkit. It uses the new wx
|
||||
package syntax that was introduced in wxPython 2.4.1.</p>
|
||||
</div>
|
||||
<div class="section" id="what-is-wxpython">
|
||||
<h1><a class="toc-backref" href="#id2" name="what-is-wxpython">What is wxPython?</a></h1>
|
||||
<p>wxPython is a GUI toolkit for the Python programming language. It
|
||||
allows Python programmers to create programs with a graphical user
|
||||
interface for Windows, Linux, and Mac OS X.</p>
|
||||
</div>
|
||||
<div class="section" id="license">
|
||||
<h1><a class="toc-backref" href="#id3" name="license">License</a></h1>
|
||||
<p>This document adheres to the same license as the other documentation
|
||||
that comes with wxWindows:</p>
|
||||
<pre class="literal-block">
|
||||
wxWindows Free Documentation Licence, Version 3
|
||||
===============================================
|
||||
|
||||
Copyright (c) 1998 Julian Smart, Robert Roebling et al
|
||||
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this licence document, but changing it is not allowed.
|
||||
|
||||
WXWINDOWS FREE DOCUMENTATION LICENCE
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
1. Permission is granted to make and distribute verbatim copies of this
|
||||
manual or piece of documentation provided any copyright notice and this
|
||||
permission notice are preserved on all copies.
|
||||
|
||||
2. Permission is granted to process this file or document through a
|
||||
document processing system and, at your option and the option of any third
|
||||
party, print the results, provided a printed document carries a copying
|
||||
permission notice identical to this one.
|
||||
|
||||
3. Permission is granted to copy and distribute modified versions of this
|
||||
manual or piece of documentation under the conditions for verbatim
|
||||
copying, provided also that any sections describing licensing conditions
|
||||
for this manual, such as, in particular, the GNU General Public Licence,
|
||||
the GNU Library General Public Licence, and any wxWindows Licence are
|
||||
included exactly as in the original, and provided that the entire
|
||||
resulting derived work is distributed under the terms of a permission
|
||||
notice identical to this one.
|
||||
|
||||
4. Permission is granted to copy and distribute translations of this
|
||||
manual or piece of documentation into another language, under the above
|
||||
conditions for modified versions, except that sections related to
|
||||
licensing, including this paragraph, may also be included in translations
|
||||
approved by the copyright holders of the respective licence documents in
|
||||
addition to the original English.
|
||||
|
||||
WARRANTY DISCLAIMER
|
||||
|
||||
5. BECAUSE THIS MANUAL OR PIECE OF DOCUMENTATION IS LICENSED FREE OF CHARGE,
|
||||
THERE IS NO WARRANTY FOR IT, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
|
||||
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
|
||||
PARTIES PROVIDE THIS MANUAL OR PIECE OF DOCUMENTATION "AS IS" WITHOUT
|
||||
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
|
||||
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
|
||||
PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF
|
||||
THE MANUAL OR PIECE OF DOCUMENTATION IS WITH YOU. SHOULD THE MANUAL OR
|
||||
PIECE OF DOCUMENTATION PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
|
||||
NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
6. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
|
||||
ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||
REDISTRIBUTE THE MANUAL OR PIECE OF DOCUMENTATION AS PERMITTED ABOVE, BE
|
||||
LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
|
||||
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
|
||||
MANUAL OR PIECE OF DOCUMENTATION (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF A PROGRAM BASED ON THE MANUAL OR PIECE OF
|
||||
DOCUMENTATION TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR
|
||||
OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
||||
|
||||
|
||||
</pre>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="footer" />
|
||||
<div class="footer">
|
||||
Generated on: 2004-03-12 19:55 UTC.
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,43 +0,0 @@
|
||||
=======================
|
||||
The wxPython Tutorial
|
||||
=======================
|
||||
|
||||
-----------------------------------------
|
||||
How to get up and running with wxPython
|
||||
-----------------------------------------
|
||||
|
||||
:Author: Patrick K. O'Brien
|
||||
:Contact: pobrien@orbtech.com
|
||||
:Organization: Orbtech_
|
||||
:Date: $Date$
|
||||
:Revision: $Revision$
|
||||
:License: wxWindows Free Documentation Licence, Version 3
|
||||
|
||||
.. _Orbtech: http://www.orbtech.com/
|
||||
|
||||
.. contents::
|
||||
|
||||
|
||||
Introduction
|
||||
============
|
||||
|
||||
This is a tutorial for the wxPython GUI toolkit. It uses the new wx
|
||||
package syntax that was introduced in wxPython 2.4.1.
|
||||
|
||||
|
||||
What is wxPython?
|
||||
=================
|
||||
|
||||
wxPython is a GUI toolkit for the Python programming language. It
|
||||
allows Python programmers to create programs with a graphical user
|
||||
interface for Windows, Linux, and Mac OS X.
|
||||
|
||||
|
||||
License
|
||||
=======
|
||||
|
||||
This document adheres to the same license as the other documentation
|
||||
that comes with wxWindows:
|
||||
|
||||
.. include:: ../licence/licendoc.txt
|
||||
:literal:
|
||||
@@ -1 +0,0 @@
|
||||
# Python package.
|
||||
@@ -1,27 +0,0 @@
|
||||
#!/usr/bin/env python
|
||||
|
||||
"""Basic application class."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
|
||||
from frame import Frame
|
||||
|
||||
class App(wx.App):
|
||||
"""Application class."""
|
||||
|
||||
def OnInit(self):
|
||||
self.frame = Frame()
|
||||
self.frame.Show()
|
||||
self.SetTopWindow(self.frame)
|
||||
return True
|
||||
|
||||
def main():
|
||||
app = App()
|
||||
app.MainLoop()
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -1,33 +0,0 @@
|
||||
#!/usr/bin/env python
|
||||
|
||||
"""Basic frame class, with App for testing."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
|
||||
class Frame(wx.Frame):
|
||||
"""Frame class."""
|
||||
|
||||
def __init__(self, parent=None, id=-1, title='Title',
|
||||
pos=wx.DefaultPosition, size=(400, 200)):
|
||||
"""Create a Frame instance."""
|
||||
wx.Frame.__init__(self, parent, id, title, pos, size)
|
||||
|
||||
class App(wx.App):
|
||||
"""Application class."""
|
||||
|
||||
def OnInit(self):
|
||||
self.frame = Frame()
|
||||
self.frame.Show()
|
||||
self.SetTopWindow(self.frame)
|
||||
return True
|
||||
|
||||
def main():
|
||||
app = App()
|
||||
app.MainLoop()
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -1 +0,0 @@
|
||||
# Python package.
|
||||
@@ -1,38 +0,0 @@
|
||||
#!/usr/bin/env python
|
||||
|
||||
"""Hello, wxPython! program."""
|
||||
|
||||
__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"
|
||||
__cvsid__ = "$Id$"
|
||||
__revision__ = "$Revision$"[11:-2]
|
||||
|
||||
import wx
|
||||
|
||||
class Frame(wx.Frame):
|
||||
"""Frame class that displays an image."""
|
||||
|
||||
def __init__(self, image, parent=None, id=-1,
|
||||
pos=wx.DefaultPosition, title='Hello, wxPython!'):
|
||||
"""Create a Frame instance and display image."""
|
||||
temp = image.ConvertToBitmap()
|
||||
size = temp.GetWidth(), temp.GetHeight()
|
||||
wx.Frame.__init__(self, parent, id, title, pos, size)
|
||||
self.bmp = wx.StaticBitmap(parent=self, id=-1, bitmap=temp)
|
||||
|
||||
class App(wx.App):
|
||||
"""Application class."""
|
||||
|
||||
def OnInit(self):
|
||||
wx.InitAllImageHandlers()
|
||||
image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG)
|
||||
self.frame = Frame(image)
|
||||
self.frame.Show()
|
||||
self.SetTopWindow(self.frame)
|
||||
return True
|
||||
|
||||
def main():
|
||||
app = App()
|
||||
app.MainLoop()
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB |
Reference in New Issue
Block a user