]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/docs/wxPackage.html
overwrite old wx DLLs even if the version numbers match
[wxWidgets.git] / wxPython / docs / wxPackage.html
index 82d666958c555435cde5f9ecf2ceff2a20a8181c..303e1b20fa4f39ab2b95617a368a95b500690fe2 100644 (file)
 <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" />
 <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.7: http://docutils.sourceforge.net/" />
+<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
 <title>The wxPython wx Package</title>
 <meta name="author" content="Patrick K. O'Brien" />
 <meta name="author" content="Robin Dunn" />
 <meta name="organization" content="Orbtech" />
 <meta name="date" content="2004-03-26" />
 <title>The wxPython wx Package</title>
 <meta name="author" content="Patrick K. O'Brien" />
 <meta name="author" content="Robin Dunn" />
 <meta name="organization" content="Orbtech" />
 <meta name="date" content="2004-03-26" />
-<link rel="stylesheet" href="default.css" type="text/css" />
+<style type="text/css">
+
+/*
+:Author: David Goodger
+:Contact: goodger@users.sourceforge.net
+:Date: $Date$
+:Revision: $Revision$
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+
+.hidden {
+  display: none }
+
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+
+blockquote.epigraph {
+  margin: 2em 5em ; }
+
+dl.docutils dd {
+  margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+
+div.abstract {
+  margin: 2em 5em }
+
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+
+div.sidebar {
+  margin-left: 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+
+div.system-messages {
+  margin: 5em }
+
+div.system-messages h1 {
+  color: red }
+
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+
+div.topic {
+  margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+
+h1.title {
+  text-align: center }
+
+h2.subtitle {
+  text-align: center }
+
+hr.docutils {
+  width: 75% }
+
+img.align-left {
+  clear: left }
+
+img.align-right {
+  clear: right }
+
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+
+ol.arabic {
+  list-style: decimal }
+
+ol.loweralpha {
+  list-style: lower-alpha }
+
+ol.upperalpha {
+  list-style: upper-alpha }
+
+ol.lowerroman {
+  list-style: lower-roman }
+
+ol.upperroman {
+  list-style: upper-roman }
+
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+
+p.caption {
+  font-style: italic }
+
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+
+p.label {
+  white-space: nowrap }
+
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+p.topic-title {
+  font-weight: bold }
+
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font-family: serif ;
+  font-size: 100% }
+
+pre.literal-block, pre.doctest-block {
+  margin-left: 2em ;
+  margin-right: 2em ;
+  background-color: #eeeeee }
+
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+span.interpreted {
+  font-family: sans-serif }
+
+span.option {
+  white-space: nowrap }
+
+span.pre {
+  white-space: pre }
+
+span.problematic {
+  color: red }
+
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+
+table.docinfo {
+  margin: 2em 4em }
+
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+
+tt.docutils {
+  background-color: #eeeeee }
+
+ul.auto-toc {
+  list-style-type: none }
+
+</style>
 </head>
 <body>
 <div class="document" id="the-wxpython-wx-package">
 </head>
 <body>
 <div class="document" id="the-wxpython-wx-package">
 <td>1.4</td></tr>
 </tbody>
 </table>
 <td>1.4</td></tr>
 </tbody>
 </table>
-<div class="contents topic" id="contents">
-<p class="topic-title first"><a name="contents">Contents</a></p>
+<div class="contents topic">
+<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
 <ul class="simple">
 <li><a class="reference" href="#introduction" id="id2" name="id2">Introduction</a></li>
 <li><a class="reference" href="#why-change-anything" id="id3" name="id3">Why change anything?</a></li>
 <ul class="simple">
 <li><a class="reference" href="#introduction" id="id2" name="id2">Introduction</a></li>
 <li><a class="reference" href="#why-change-anything" id="id3" name="id3">Why change anything?</a></li>
 <li><a class="reference" href="#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>
 <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="#id2" name="introduction">Introduction</a></h1>
+<div class="section">
+<h1><a class="toc-backref" href="#id2" id="introduction" name="introduction">Introduction</a></h1>
 <p>In the begining there was Python, and Python had modules, and Python
 was good.  But after a time Guido looked on Python and saw that Python
 needed organizational assistance, and so Guido took code from Python's
 <p>In the begining there was Python, and Python had modules, and Python
 was good.  But after a time Guido looked on Python and saw that Python
 needed organizational assistance, and so Guido took code from Python's
@@ -69,8 +351,8 @@ have concerning the new wx package.  Please also take a look at the
 <a class="reference" href="MigrationGuide.html">2.5 Migration Guide</a> to see notes about other big differences in
 this release.</p>
 </div>
 <a class="reference" href="MigrationGuide.html">2.5 Migration Guide</a> to see notes about other big differences in
 this release.</p>
 </div>
-<div class="section" id="why-change-anything">
-<h1><a class="toc-backref" href="#id3" name="why-change-anything">Why change anything?</a></h1>
+<div class="section">
+<h1><a class="toc-backref" href="#id3" id="why-change-anything" name="why-change-anything">Why change anything?</a></h1>
 <p>This change is being made for a couple of reasons.  The first reason
 is to discourage the use of <tt class="docutils literal"><span class="pre">import</span> <span class="pre">*</span></tt>, which is a dangerous
 technique that can create name conflicts and bloated namespaces.</p>
 <p>This change is being made for a couple of reasons.  The first reason
 is to discourage the use of <tt class="docutils literal"><span class="pre">import</span> <span class="pre">*</span></tt>, which is a dangerous
 technique that can create name conflicts and bloated namespaces.</p>
@@ -93,8 +375,8 @@ class Frame(wx.Frame)
 the same thing (implement a new wx namespace and drop the &quot;wx&quot; prefix)
 and we want wxPython to lead the way.</p>
 </div>
 the same thing (implement a new wx namespace and drop the &quot;wx&quot; prefix)
 and we want wxPython to lead the way.</p>
 </div>
-<div class="section" id="what-does-the-new-wx-package-do">
-<h1><a class="toc-backref" href="#id4" name="what-does-the-new-wx-package-do">What does the new wx package do?</a></h1>
+<div class="section">
+<h1><a class="toc-backref" href="#id4" id="what-does-the-new-wx-package-do" name="what-does-the-new-wx-package-do">What does the new wx package do?</a></h1>
 <p>As mentioned in the Introduction, wxPython 2.4.1 introduced a way of
 getting to this new syntax as quickly as possible.  It would import
 the old names (like &quot;wxFrame&quot;) from the old package and then create new
 <p>As mentioned in the Introduction, wxPython 2.4.1 introduced a way of
 getting to this new syntax as quickly as possible.  It would import
 the old names (like &quot;wxFrame&quot;) from the old package and then create new
@@ -108,8 +390,8 @@ populated with modules that simply import the new names and then
 complicated, but it is mostly automated and so it  doesn't cause
 problems in most cases.</p>
 </div>
 complicated, but it is mostly automated and so it  doesn't cause
 problems in most cases.</p>
 </div>
-<div class="section" id="will-any-of-this-effect-my-existing-code">
-<h1><a class="toc-backref" href="#id5" name="will-any-of-this-effect-my-existing-code">Will any of this effect my existing code?</a></h1>
+<div class="section">
+<h1><a class="toc-backref" href="#id5" id="will-any-of-this-effect-my-existing-code" name="will-any-of-this-effect-my-existing-code">Will any of this effect my existing code?</a></h1>
 <p>No.  Your existing code will continue to work and be supported for
 some time.  It will be up to you to decide when to switch to the new
 syntax.  But all new documentation and code examples will use the new
 <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
@@ -123,24 +405,24 @@ old code is depending on some of the implemtation details, or if you
 are using other things that have changed in the API.  See the
 <a class="reference" href="MigrationGuide.html">Migration Guide</a> for more details.</p>
 </div>
 are using other things that have changed in the API.  See the
 <a class="reference" href="MigrationGuide.html">Migration Guide</a> for more details.</p>
 </div>
-<div class="section" 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>
+<div class="section">
+<h1><a class="toc-backref" href="#id6" id="what-about-all-the-other-modules-like-grid-html-and-stc" name="what-about-all-the-other-modules-like-grid-html-and-stc">What about all the other modules, like grid, html, and stc?</a></h1>
 <p>There's more to the old wxPython than just the wxPython.wx module.
 And we've got those extra modules covered as well.  Each of those
 modules (as well as the lib subpackage) has been moved to the new wx
 package and reverse-renamers have been placed in the wxPython package
 as needed.</p>
 </div>
 <p>There's more to the old wxPython than just the wxPython.wx module.
 And we've got those extra modules covered as well.  Each of those
 modules (as well as the lib subpackage) has been moved to the new wx
 package and reverse-renamers have been placed in the wxPython package
 as needed.</p>
 </div>
-<div class="section" 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>
+<div class="section">
+<h1><a class="toc-backref" href="#id7" id="how-do-i-use-this-new-wx-package" name="how-do-i-use-this-new-wx-package">How do I use this new wx package?</a></h1>
 <p>The wx package is automatically created when you install wxPython
 version 2.4.1 or higher.  So all you have to do is:</p>
 <pre class="literal-block">
 import wx
 </pre>
 </div>
 <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>
+<div class="section">
+<h1><a class="toc-backref" href="#id8" id="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package" name="what-are-the-issues-with-converting-old-code-to-use-the-new-wx-package">What are the issues with converting old code to use the new wx package?</a></h1>
 <p>Obviously, you need to change your import statements from:</p>
 <pre class="literal-block">
 from wxPython import wx
 <p>Obviously, you need to change your import statements from:</p>
 <pre class="literal-block">
 from wxPython import wx
@@ -161,8 +443,8 @@ class MyFrame(wx.Frame):
 <p>In most cases, existing code can be modified with a simple search and
 replace.</p>
 </div>
 <p>In most cases, existing code can be modified with a simple search and
 replace.</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>
+<div class="section">
+<h1><a class="toc-backref" href="#id9" id="where-can-i-find-example-programs-using-the-new-wx-syntax" name="where-can-i-find-example-programs-using-the-new-wx-syntax">Where can I find example programs using the new wx syntax?</a></h1>
 <p>The wxPython demo application and most of the sample apps have been
 converted to use the new <tt class="docutils literal"><span class="pre">import</span> <span class="pre">wx</span></tt> style of programming with
 wxPython, so there are lots of examples to look at and to play with.
 <p>The wxPython demo application and most of the sample apps have been
 converted to use the new <tt class="docutils literal"><span class="pre">import</span> <span class="pre">wx</span></tt> style of programming with
 wxPython, so there are lots of examples to look at and to play with.