'FileHistory',
'FontEnumerator',
'Joystick',
- 'NewNamespace',
'OGL',
'PrintFramework',
'ShapedWindow',
+++ /dev/null
-
-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:])
-
+++ /dev/null
-<?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>
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
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
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
;;------------------------------------------------------------
+++ /dev/null
-<?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>
+++ /dev/null
-========================
- 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
+++ /dev/null
-<?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>
+++ /dev/null
-=================================
- 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:
-
+++ /dev/null
-<?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>
+++ /dev/null
-=======================
- 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:
+++ /dev/null
-# Python package.
+++ /dev/null
-#!/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()
+++ /dev/null
-#!/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()
+++ /dev/null
-# Python package.
+++ /dev/null
-#!/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()
projects / wxWidgets.git / commitdiff
