40c4c5a3b5
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@15688 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
729 lines
22 KiB
Python
729 lines
22 KiB
Python
#!/bin/env python
|
|
#----------------------------------------------------------------------------
|
|
# Name: Main.py
|
|
# Purpose: Testing lots of stuff, controls, window types, etc.
|
|
#
|
|
# Author: Robin Dunn
|
|
#
|
|
# Created: A long time ago, in a galaxy far, far away...
|
|
# RCS-ID: $Id$
|
|
# Copyright: (c) 1999 by Total Control Software
|
|
# Licence: wxWindows license
|
|
#----------------------------------------------------------------------------
|
|
|
|
import sys, os, time, string
|
|
from wxPython.wx import *
|
|
from wxPython.html import wxHtmlWindow
|
|
|
|
##from wxPython.stc import *
|
|
|
|
import images
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
|
|
_treeList = [
|
|
# new stuff
|
|
('New since last release', [
|
|
'RowColSizer',
|
|
'Unicode',
|
|
'wxFileHistory',
|
|
'wxGenericDirCtrl',
|
|
'wxImageFromStream',
|
|
]),
|
|
|
|
# managed windows == things with a caption you can close
|
|
('Base Frames and Dialogs', [
|
|
'wxDialog',
|
|
'wxFrame',
|
|
'wxMDIWindows',
|
|
'wxMiniFrame',
|
|
]),
|
|
|
|
# the common dialogs
|
|
('Common Dialogs', [
|
|
'wxColourDialog',
|
|
'wxDirDialog',
|
|
'wxFileDialog',
|
|
'wxFindReplaceDialog',
|
|
'wxFontDialog',
|
|
'wxMessageDialog',
|
|
'wxPageSetupDialog',
|
|
'wxPrintDialog',
|
|
'wxProgressDialog',
|
|
'wxSingleChoiceDialog',
|
|
'wxTextEntryDialog',
|
|
]),
|
|
|
|
# dialogs form libraries
|
|
('More Dialogs', [
|
|
'ErrorDialogs',
|
|
'ImageBrowser',
|
|
'wxMultipleChoiceDialog',
|
|
'wxScrolledMessageDialog',
|
|
]),
|
|
|
|
# core controls
|
|
('Core Windows/Controls', [
|
|
'VirtualListCtrl',
|
|
'wxButton',
|
|
'wxCheckBox',
|
|
'wxCheckListBox',
|
|
'wxChoice',
|
|
'wxComboBox',
|
|
'wxGauge',
|
|
'wxGenericDirCtrl',
|
|
'wxGrid',
|
|
'wxListBox',
|
|
'wxListCtrl',
|
|
'wxNotebook',
|
|
'wxPopupWindow',
|
|
'wxRadioBox',
|
|
'wxSashWindow',
|
|
'wxSlider',
|
|
'wxScrolledWindow',
|
|
'wxSplitterWindow',
|
|
'wxSpinButton',
|
|
'wxSpinCtrl',
|
|
'wxStaticText',
|
|
'wxStaticBitmap',
|
|
'wxStatusBar',
|
|
'wxTextCtrl',
|
|
'wxToggleButton',
|
|
'wxToolBar',
|
|
'wxTreeCtrl',
|
|
'wxValidator',
|
|
]),
|
|
|
|
# controls coming from other librairies
|
|
('More Windows/Controls', [
|
|
'ColourSelect',
|
|
'ContextHelp',
|
|
'FancyText',
|
|
'FileBrowseButton',
|
|
'GenericButtons',
|
|
'PyCrust',
|
|
'PyCrustWithFilling',
|
|
'SplitTree',
|
|
'TablePrint',
|
|
'wxCalendar',
|
|
'wxCalendarCtrl',
|
|
'wxDynamicSashWindow',
|
|
'wxEditableListBox',
|
|
'wxEditor',
|
|
'wxFloatBar',
|
|
'wxHtmlWindow',
|
|
'wxLEDNumberCtrl',
|
|
'wxMimeTypesManager',
|
|
'wxMVCTree',
|
|
'wxStyledTextCtrl_1',
|
|
'wxStyledTextCtrl_2',
|
|
'wxRightTextCtrl',
|
|
]),
|
|
|
|
# How to lay out the controls in a frame/dialog
|
|
('Window Layout', [
|
|
'LayoutAnchors',
|
|
'Layoutf',
|
|
'RowColSizer',
|
|
'Sizers',
|
|
'wxLayoutConstraints',
|
|
'XML_Resource',
|
|
]),
|
|
|
|
# ditto
|
|
('Process and Events', [
|
|
'infoframe',
|
|
'OOR',
|
|
'PythonEvents',
|
|
'Threads',
|
|
'wxProcess',
|
|
'wxTimer',
|
|
]),
|
|
|
|
# Clipboard and DnD
|
|
('Clipboard and DnD', [
|
|
'CustomDragAndDrop',
|
|
'DragAndDrop',
|
|
'URLDragAndDrop',
|
|
]),
|
|
|
|
# Images
|
|
('Images', [
|
|
'wxDragImage',
|
|
'wxImage',
|
|
'wxImageFromStream',
|
|
'wxMask',
|
|
]),
|
|
|
|
# Other stuff
|
|
('Miscellaneous', [
|
|
'ColourDB',
|
|
'DialogUnits',
|
|
'DrawXXXList',
|
|
'FontEnumerator',
|
|
'PrintFramework',
|
|
'Unicode',
|
|
'wxFileHistory',
|
|
'wxJoystick',
|
|
'wxOGL',
|
|
'wxWave',
|
|
]),
|
|
|
|
# need libs not coming with the demo
|
|
('Objects using an external library', [
|
|
'ActiveXWrapper_Acrobat',
|
|
'ActiveXWrapper_IE',
|
|
'wxGLCanvas',
|
|
'wxPlotCanvas',
|
|
]),
|
|
|
|
# pyTree, hangman, ... in the samples dir
|
|
('Check out the samples dir too', [
|
|
]),
|
|
|
|
]
|
|
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
class MyLog(wxPyLog):
|
|
def __init__(self, textCtrl, logTime=0):
|
|
wxPyLog.__init__(self)
|
|
self.tc = textCtrl
|
|
self.logTime = logTime
|
|
|
|
def DoLogString(self, message, timeStamp):
|
|
if self.logTime:
|
|
message = time.strftime("%X", time.localtime(timeStamp)) + \
|
|
": " + message
|
|
self.tc.AppendText(message + '\n')
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
def opj(path):
|
|
"""Convert paths to the platform-specific separator"""
|
|
return apply(os.path.join, tuple(string.split(path, '/')))
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
class wxPythonDemo(wxFrame):
|
|
overviewText = "wxPython Overview"
|
|
|
|
def __init__(self, parent, id, title):
|
|
wxFrame.__init__(self, parent, -1, title, size = (800, 600),
|
|
style=wxDEFAULT_FRAME_STYLE|wxNO_FULL_REPAINT_ON_RESIZE)
|
|
|
|
self.cwd = os.getcwd()
|
|
self.curOverview = ""
|
|
|
|
icon = images.getMondrianIcon()
|
|
self.SetIcon(icon)
|
|
|
|
if wxPlatform == '__WXMSW__':
|
|
# setup a taskbar icon, and catch some events from it
|
|
self.tbicon = wxTaskBarIcon()
|
|
self.tbicon.SetIcon(icon, "wxPython Demo")
|
|
EVT_TASKBAR_LEFT_DCLICK(self.tbicon, self.OnTaskBarActivate)
|
|
EVT_TASKBAR_RIGHT_UP(self.tbicon, self.OnTaskBarMenu)
|
|
EVT_MENU(self.tbicon, self.TBMENU_RESTORE, self.OnTaskBarActivate)
|
|
EVT_MENU(self.tbicon, self.TBMENU_CLOSE, self.OnTaskBarClose)
|
|
|
|
|
|
self.otherWin = None
|
|
self.showTip = true
|
|
EVT_IDLE(self, self.OnIdle)
|
|
EVT_CLOSE(self, self.OnCloseWindow)
|
|
EVT_ICONIZE(self, self.OnIconfiy)
|
|
EVT_MAXIMIZE(self, self.OnMaximize)
|
|
|
|
self.Centre(wxBOTH)
|
|
self.CreateStatusBar(1, wxST_SIZEGRIP)
|
|
|
|
splitter = wxSplitterWindow(self, -1, style=wxNO_3D|wxSP_3D)
|
|
splitter2 = wxSplitterWindow(splitter, -1, style=wxNO_3D|wxSP_3D)
|
|
|
|
def EmptyHandler(evt): pass
|
|
EVT_ERASE_BACKGROUND(splitter, EmptyHandler)
|
|
EVT_ERASE_BACKGROUND(splitter2, EmptyHandler)
|
|
|
|
# Prevent TreeCtrl from displaying all items after destruction when true
|
|
self.dying = false
|
|
|
|
# Make a File menu
|
|
self.mainmenu = wxMenuBar()
|
|
menu = wxMenu()
|
|
exitID = wxNewId()
|
|
menu.Append(exitID, 'E&xit\tAlt-X', 'Get the heck outta here!')
|
|
EVT_MENU(self, exitID, self.OnFileExit)
|
|
self.mainmenu.Append(menu, '&File')
|
|
|
|
# Make a Demo menu
|
|
menu = wxMenu()
|
|
for item in _treeList:
|
|
submenu = wxMenu()
|
|
for childItem in item[1]:
|
|
mID = wxNewId()
|
|
submenu.Append(mID, childItem)
|
|
EVT_MENU(self, mID, self.OnDemoMenu)
|
|
menu.AppendMenu(wxNewId(), item[0], submenu)
|
|
self.mainmenu.Append(menu, '&Demo')
|
|
|
|
|
|
# Make a Help menu
|
|
helpID = wxNewId()
|
|
menu = wxMenu()
|
|
menu.Append(helpID, '&About\tCtrl-H', 'wxPython RULES!!!')
|
|
EVT_MENU(self, helpID, self.OnHelpAbout)
|
|
self.mainmenu.Append(menu, '&Help')
|
|
self.SetMenuBar(self.mainmenu)
|
|
|
|
# set the menu accellerator table...
|
|
aTable = wxAcceleratorTable([(wxACCEL_ALT, ord('X'), exitID),
|
|
(wxACCEL_CTRL, ord('H'), helpID)])
|
|
self.SetAcceleratorTable(aTable)
|
|
|
|
|
|
# Create a TreeCtrl
|
|
tID = wxNewId()
|
|
self.treeMap = {}
|
|
self.tree = wxTreeCtrl(splitter, tID,
|
|
style=wxTR_HAS_BUTTONS |
|
|
wxTR_EDIT_LABELS |
|
|
wxTR_HAS_VARIABLE_ROW_HEIGHT)
|
|
|
|
#self.tree.SetBackgroundColour(wxNamedColour("Pink"))
|
|
root = self.tree.AddRoot("wxPython Overview")
|
|
firstChild = None
|
|
for item in _treeList:
|
|
child = self.tree.AppendItem(root, item[0])
|
|
if not firstChild: firstChild = child
|
|
for childItem in item[1]:
|
|
theDemo = self.tree.AppendItem(child, childItem)
|
|
self.treeMap[childItem] = theDemo
|
|
|
|
self.tree.Expand(root)
|
|
self.tree.Expand(firstChild)
|
|
EVT_TREE_ITEM_EXPANDED (self.tree, tID, self.OnItemExpanded)
|
|
EVT_TREE_ITEM_COLLAPSED (self.tree, tID, self.OnItemCollapsed)
|
|
EVT_TREE_SEL_CHANGED (self.tree, tID, self.OnSelChanged)
|
|
EVT_LEFT_DOWN (self.tree, self.OnTreeLeftDown)
|
|
|
|
# Create a Notebook
|
|
self.nb = wxNotebook(splitter2, -1, style=wxCLIP_CHILDREN)
|
|
|
|
# Set up a wxHtmlWindow on the Overview Notebook page
|
|
# we put it in a panel first because there seems to be a
|
|
# refresh bug of some sort (wxGTK) when it is directly in
|
|
# the notebook...
|
|
if 0: # the old way
|
|
self.ovr = wxHtmlWindow(self.nb, -1, size=(400, 400))
|
|
self.nb.AddPage(self.ovr, self.overviewText)
|
|
|
|
else: # hopefully I can remove this hacky code soon, see bug #216861
|
|
panel = wxPanel(self.nb, -1, style=wxCLIP_CHILDREN)
|
|
self.ovr = wxHtmlWindow(panel, -1, size=(400, 400))
|
|
self.nb.AddPage(panel, self.overviewText)
|
|
|
|
def OnOvrSize(evt, ovr=self.ovr):
|
|
ovr.SetSize(evt.GetSize())
|
|
|
|
EVT_SIZE(panel, OnOvrSize)
|
|
EVT_ERASE_BACKGROUND(panel, EmptyHandler)
|
|
|
|
|
|
self.SetOverview(self.overviewText, overview)
|
|
|
|
|
|
# Set up a TextCtrl on the Demo Code Notebook page
|
|
self.txt = wxTextCtrl(self.nb, -1,
|
|
style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
|
|
self.nb.AddPage(self.txt, "Demo Code")
|
|
|
|
|
|
# Set up a log on the View Log Notebook page
|
|
self.log = wxTextCtrl(splitter2, -1,
|
|
style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
|
|
|
|
# Set the wxWindows log target to be this textctrl
|
|
#wxLog_SetActiveTarget(wxLogTextCtrl(self.log))
|
|
|
|
# But instead of the above we want to show how to use our own wxLog class
|
|
wxLog_SetActiveTarget(MyLog(self.log))
|
|
|
|
|
|
|
|
self.Show(true)
|
|
|
|
# add the windows to the splitter and split it.
|
|
splitter2.SplitHorizontally(self.nb, self.log)
|
|
splitter.SplitVertically(self.tree, splitter2)
|
|
|
|
splitter.SetSashPosition(180, true)
|
|
splitter.SetMinimumPaneSize(20)
|
|
splitter2.SetSashPosition(450, true)
|
|
splitter2.SetMinimumPaneSize(20)
|
|
|
|
|
|
|
|
# select initial items
|
|
self.nb.SetSelection(0)
|
|
self.tree.SelectItem(root)
|
|
|
|
if len(sys.argv) == 2:
|
|
try:
|
|
selectedDemo = self.treeMap[sys.argv[1]]
|
|
except:
|
|
selectedDemo = None
|
|
if selectedDemo:
|
|
self.tree.SelectItem(selectedDemo)
|
|
self.tree.EnsureVisible(selectedDemo)
|
|
|
|
|
|
wxLogMessage('window handle: %s' % self.GetHandle())
|
|
|
|
|
|
#---------------------------------------------
|
|
def WriteText(self, text):
|
|
if text[-1:] == '\n':
|
|
text = text[:-1]
|
|
wxLogMessage(text)
|
|
|
|
|
|
def write(self, txt):
|
|
self.WriteText(txt)
|
|
|
|
#---------------------------------------------
|
|
def OnItemExpanded(self, event):
|
|
item = event.GetItem()
|
|
wxLogMessage("OnItemExpanded: %s" % self.tree.GetItemText(item))
|
|
event.Skip()
|
|
|
|
#---------------------------------------------
|
|
def OnItemCollapsed(self, event):
|
|
item = event.GetItem()
|
|
wxLogMessage("OnItemCollapsed: %s" % self.tree.GetItemText(item))
|
|
event.Skip()
|
|
|
|
#---------------------------------------------
|
|
def OnTreeLeftDown(self, event):
|
|
pt = event.GetPosition();
|
|
item, flags = self.tree.HitTest(pt)
|
|
if item == self.tree.GetSelection():
|
|
self.SetOverview(self.tree.GetItemText(item)+" Overview", self.curOverview)
|
|
event.Skip()
|
|
|
|
#---------------------------------------------
|
|
def OnSelChanged(self, event):
|
|
if self.dying:
|
|
return
|
|
|
|
item = event.GetItem()
|
|
itemText = self.tree.GetItemText(item)
|
|
self.RunDemo(itemText)
|
|
|
|
|
|
#---------------------------------------------
|
|
def RunDemo(self, itemText):
|
|
os.chdir(self.cwd)
|
|
if self.nb.GetPageCount() == 3:
|
|
if self.nb.GetSelection() == 2:
|
|
self.nb.SetSelection(0)
|
|
self.nb.DeletePage(2)
|
|
|
|
if itemText == self.overviewText:
|
|
self.GetDemoFile('Main.py')
|
|
self.SetOverview(self.overviewText, overview)
|
|
self.nb.Refresh();
|
|
self.window = None
|
|
|
|
else:
|
|
if os.path.exists(itemText + '.py'):
|
|
wxBeginBusyCursor()
|
|
wxLogMessage("Running demo %s.py..." % itemText)
|
|
try:
|
|
self.GetDemoFile(itemText + '.py')
|
|
module = __import__(itemText, globals())
|
|
self.SetOverview(itemText + " Overview", module.overview)
|
|
finally:
|
|
wxEndBusyCursor()
|
|
self.tree.Refresh()
|
|
|
|
# in case runTest is modal, make sure things look right...
|
|
self.nb.Refresh();
|
|
wxSafeYield()
|
|
|
|
self.window = module.runTest(self, self.nb, self) ###
|
|
if self.window:
|
|
self.nb.AddPage(self.window, 'Demo')
|
|
self.nb.SetSelection(2)
|
|
self.nb.Refresh() # without this wxMac has troubles showing the just added page
|
|
|
|
else:
|
|
self.ovr.SetPage("")
|
|
self.txt.Clear()
|
|
self.window = None
|
|
|
|
|
|
|
|
#---------------------------------------------
|
|
# Get the Demo files
|
|
def GetDemoFile(self, filename):
|
|
self.txt.Clear()
|
|
try:
|
|
self.txt.SetValue(open(filename).read())
|
|
except IOError:
|
|
self.txt.WriteText("Cannot open %s file." % filename)
|
|
|
|
self.txt.SetInsertionPoint(0)
|
|
self.txt.ShowPosition(0)
|
|
|
|
#---------------------------------------------
|
|
def SetOverview(self, name, text):
|
|
self.curOverview = text
|
|
lead = text[:6]
|
|
if lead != '<html>' and lead != '<HTML>':
|
|
text = string.join(string.split(text, '\n'), '<br>')
|
|
self.ovr.SetPage(text)
|
|
self.nb.SetPageText(0, name)
|
|
|
|
#---------------------------------------------
|
|
# Menu methods
|
|
def OnFileExit(self, *event):
|
|
self.Close()
|
|
|
|
|
|
def OnHelpAbout(self, event):
|
|
from About import MyAboutBox
|
|
about = MyAboutBox(self)
|
|
about.ShowModal()
|
|
about.Destroy()
|
|
|
|
|
|
#---------------------------------------------
|
|
def OnCloseWindow(self, event):
|
|
self.dying = true
|
|
self.window = None
|
|
self.mainmenu = None
|
|
if hasattr(self, "tbicon"):
|
|
del self.tbicon
|
|
self.Destroy()
|
|
|
|
|
|
#---------------------------------------------
|
|
def OnIdle(self, event):
|
|
if self.otherWin:
|
|
self.otherWin.Raise()
|
|
self.window = self.otherWin
|
|
self.otherWin = None
|
|
|
|
if self.showTip:
|
|
self.ShowTip()
|
|
self.showTip = false
|
|
|
|
|
|
#---------------------------------------------
|
|
def ShowTip(self):
|
|
try:
|
|
showTipText = open(opj("data/showTips")).read()
|
|
showTip, index = eval(showTipText)
|
|
except IOError:
|
|
showTip, index = (1, 0)
|
|
if showTip:
|
|
tp = wxCreateFileTipProvider(opj("data/tips.txt"), index)
|
|
showTip = wxShowTip(self, tp)
|
|
index = tp.GetCurrentTip()
|
|
open(opj("data/showTips"), "w").write(str( (showTip, index) ))
|
|
|
|
|
|
#---------------------------------------------
|
|
def OnDemoMenu(self, event):
|
|
try:
|
|
selectedDemo = self.treeMap[self.mainmenu.GetLabel(event.GetId())]
|
|
except:
|
|
selectedDemo = None
|
|
if selectedDemo:
|
|
self.tree.SelectItem(selectedDemo)
|
|
self.tree.EnsureVisible(selectedDemo)
|
|
|
|
|
|
#---------------------------------------------
|
|
def OnTaskBarActivate(self, evt):
|
|
if self.IsIconized():
|
|
self.Iconize(false)
|
|
if not self.IsShown():
|
|
self.Show(true)
|
|
self.Raise()
|
|
|
|
#---------------------------------------------
|
|
|
|
TBMENU_RESTORE = 1000
|
|
TBMENU_CLOSE = 1001
|
|
|
|
def OnTaskBarMenu(self, evt):
|
|
menu = wxMenu()
|
|
menu.Append(self.TBMENU_RESTORE, "Restore wxPython Demo")
|
|
menu.Append(self.TBMENU_CLOSE, "Close")
|
|
self.tbicon.PopupMenu(menu)
|
|
menu.Destroy()
|
|
|
|
#---------------------------------------------
|
|
def OnTaskBarClose(self, evt):
|
|
self.Close()
|
|
|
|
# because of the way wxTaskBarIcon.PopupMenu is implemented we have to
|
|
# prod the main idle handler a bit to get the window to actually close
|
|
wxGetApp().ProcessIdle()
|
|
|
|
|
|
#---------------------------------------------
|
|
def OnIconfiy(self, evt):
|
|
wxLogMessage("OnIconfiy")
|
|
evt.Skip()
|
|
|
|
#---------------------------------------------
|
|
def OnMaximize(self, evt):
|
|
wxLogMessage("OnMaximize")
|
|
evt.Skip()
|
|
|
|
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
#---------------------------------------------------------------------------
|
|
|
|
class MySplashScreen(wxSplashScreen):
|
|
def __init__(self):
|
|
bmp = wxImage(opj("bitmaps/splash.gif")).ConvertToBitmap()
|
|
wxSplashScreen.__init__(self, bmp,
|
|
wxSPLASH_CENTRE_ON_SCREEN|wxSPLASH_TIMEOUT,
|
|
4000, None, -1,
|
|
style = wxSIMPLE_BORDER|wxFRAME_NO_TASKBAR|wxSTAY_ON_TOP)
|
|
EVT_CLOSE(self, self.OnClose)
|
|
|
|
def OnClose(self, evt):
|
|
frame = wxPythonDemo(None, -1, "wxPython: (A Demonstration)")
|
|
frame.Show(true)
|
|
evt.Skip() # Make sure the default handler runs too...
|
|
|
|
|
|
class MyApp(wxApp):
|
|
def OnInit(self):
|
|
"""
|
|
Create and show the splash screen. It will then create and show
|
|
the main frame when it is time to do so.
|
|
"""
|
|
wxInitAllImageHandlers()
|
|
splash = MySplashScreen()
|
|
splash.Show()
|
|
return true
|
|
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
def main():
|
|
try:
|
|
demoPath = os.path.dirname(__file__)
|
|
os.chdir(demoPath)
|
|
except:
|
|
pass
|
|
app = MyApp(wxPlatform == "__WXMAC__")
|
|
app.MainLoop()
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
overview = """<html><body>
|
|
<h2>Python</h2>
|
|
|
|
Python is an interpreted, interactive, object-oriented programming
|
|
language often compared to Tcl, Perl, Scheme, or Java.
|
|
|
|
<p> Python combines remarkable power with very clear syntax. It has
|
|
modules, classes, exceptions, very high level dynamic data types, and
|
|
dynamic typing. There are interfaces to many system calls and
|
|
libraries, and new built-in modules are easily written in C or
|
|
C++. Python is also usable as an extension language for applications
|
|
that need a programmable interface. <p>
|
|
|
|
<h2>wxWindows</h2>
|
|
|
|
wxWindows is a free C++ framework designed to make cross-platform
|
|
programming child's play. Well, almost. wxWindows 2 supports Windows
|
|
3.1/95/98/NT, Unix with GTK/Motif/Lesstif, with a Mac version
|
|
underway. Other ports are under consideration. <p>
|
|
|
|
wxWindows is a set of libraries that allows C++ applications to
|
|
compile and run on several different types of computers, with minimal
|
|
source code changes. There is one library per supported GUI (such as
|
|
Motif, or Windows). As well as providing a common API (Application
|
|
Programming Interface) for GUI functionality, it provides
|
|
functionality for accessing some commonly-used operating system
|
|
facilities, such as copying or deleting files. wxWindows is a
|
|
'framework' in the sense that it provides a lot of built-in
|
|
functionality, which the application can use or replace as required,
|
|
thus saving a great deal of coding effort. Basic data structures such
|
|
as strings, linked lists and hash tables are also supported.
|
|
|
|
<p>
|
|
<h2>wxPython</h2>
|
|
|
|
wxPython is a Python extension module that encapsulates the wxWindows
|
|
GUI classes. Currently it is only available for the Win32 and GTK
|
|
ports of wxWindows, but as soon as the other ports are brought up to
|
|
the same level as Win32 and GTK, it should be fairly trivial to
|
|
enable wxPython to be used with the new GUI.
|
|
|
|
<p>
|
|
|
|
The wxPython extension module attempts to mirror the class heiarchy
|
|
of wxWindows as closely as possible. This means that there is a
|
|
wxFrame class in wxPython that looks, smells, tastes and acts almost
|
|
the same as the wxFrame class in the C++ version. Unfortunately,
|
|
because of differences in the languages, wxPython doesn't match
|
|
wxWindows exactly, but the differences should be easy to absorb
|
|
because they are natural to Python. For example, some methods that
|
|
return multiple values via argument pointers in C++ will return a
|
|
tuple of values in Python.
|
|
|
|
<p>
|
|
|
|
There is still much to be done for wxPython, many classes still need
|
|
to be mirrored. Also, wxWindows is still somewhat of a moving target
|
|
so it is a bit of an effort just keeping wxPython up to date. On the
|
|
other hand, there are enough of the core classes completed that
|
|
useful applications can be written.
|
|
|
|
<p>
|
|
|
|
wxPython is close enough to the C++ version that the majority of
|
|
the wxPython documentation is actually just notes attached to the C++
|
|
documents that describe the places where wxPython is different. There
|
|
is also a series of sample programs included, and a series of
|
|
documentation pages that assist the programmer in getting started
|
|
with wxPython.
|
|
|
|
"""
|
|
|
|
|
|
#----------------------------------------------------------------------------
|
|
#----------------------------------------------------------------------------
|
|
|
|
if __name__ == '__main__':
|
|
main()
|
|
|
|
#----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|