Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

change doc tweaks

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@37563 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Robin Dunn
2006-02-13 19:17:28 +00:00
parent 1f168cbd49
commit 14b37d975b
1 changed files with 14 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
wxPython/docs/CHANGES.txt
View File

@@ -37,8 +37,8 @@ empty stubs in wxPython.
Solved a problem that has been around for a very long time in how C++ Solved a problem that has been around for a very long time in how C++
methods are virtualized for overriding in derived Python classes. methods are virtualized for overriding in derived Python classes.
Previously we couldn't do it for methods that needed to exist in the Previously we couldn't do it for methods that needed to also exist in
base class wrappers such that they could be called normally. (The the base class wrappers such that they could be called normally. (The
reasons are long and complex, but suffice it to say that it was due to reasons are long and complex, but suffice it to say that it was due to
mixing C++'s dynamic dispatch, and Python's runtime lookup of the mixing C++'s dynamic dispatch, and Python's runtime lookup of the
method attributes resulting in endless recursion of function calls.) method attributes resulting in endless recursion of function calls.)
@@ -48,21 +48,28 @@ example wx.Printout.base_OnBeginDocument. Now that the problem has
finally been solved I have replaced all the base_Whatever() methods finally been solved I have replaced all the base_Whatever() methods
with the real Whatever() method as well as a simple wrapper named with the real Whatever() method as well as a simple wrapper named
base_Whatever that is marked as deprecated. So now instead of writing base_Whatever that is marked as deprecated. So now instead of writing
your overridden methods like this: your overridden methods like this::
def OnBeginDocument(self, start, end): def OnBeginDocument(self, start, end):
# do something here # do something here
return self.base_OnBeginDocument(start, end) return self.base_OnBeginDocument(start, end)
You can do it the *right way* like this: You can now call the base class method the normal way, like this::
def OnBeginDocument(self, start, end):
# do something here
return Printout.OnBeginDocument(self, start, end)
Or like this with super()::
def OnBeginDocument(self, start, end): def OnBeginDocument(self, start, end):
# do something here # do something here
return super(MyPrintout, self).OnBeginDocument(start, end) return super(MyPrintout, self).OnBeginDocument(start, end)
Note that the old way still works, but you will get a
DeprecationWarning from calling base_OnBeginDocument. The classes Note that the old way with the "base_" function still works, but you
affected by this are: will get a DeprecationWarning from calling base_OnBeginDocument. The
classes affected by this are:
* wx.DropSource * wx.DropSource
* wx.DropTarget * wx.DropTarget