[wxWidgets.git] / utils / wxPython / demo / Main.py

#!/bin/env python
#----------------------------------------------------------------------------
# Name:         Main.py
# Purpose:      Testing lots of stuff, controls, window types, etc.
#
# Author:       Robin Dunn & Gary Dumer
#
# Created:
# RCS-ID:       $Id$
# Copyright:    (c) 1999 by Total Control Software
# Licence:      wxWindows license
#----------------------------------------------------------------------------

import sys, os
from   wxPython.wx import *


#---------------------------------------------------------------------------


_treeList = [
    ('Managed Windows', ['wxFrame', 'wxDialog', 'wxMiniFrame']),

    ('Miscellaneous Windows', ['wxGrid', 'wxSashWindow',
                               'wxScrolledWindow', 'wxSplitterWindow',
                               'wxStatusBar', 'wxToolBar', 'wxNotebook']),

    ('Common Dialogs', ['wxColourDialog', 'wxDirDialog', 'wxFileDialog',
                        'wxSingleChoiceDialog', 'wxTextEntryDialog',
                        'wxFontDialog', 'wxPageSetupDialog', 'wxPrintDialog',
                        'wxMessageDialog']),

    ('Controls', ['wxButton', 'wxCheckBox', 'wxCheckListBox', 'wxChoice',
                  'wxComboBox', 'wxGauge', 'wxListBox', 'wxListCtrl', 'wxTextCtrl',
                  'wxTreeCtrl', 'wxSpinButton', 'wxStaticText', 'wxStaticBitmap',
                  'wxRadioBox', 'wxSlider']),

    ('Window Layout', ['wxLayoutConstraints']),

    ('Micellaneous', ['wxTimer', 'wxGLCanvas', 'DialogUnits', 'wxImage']),

    ('wxPython Library', ['Layoutf', 'wxScrolledMessageDialog',
                          'wxMultipleChoiceDialog', 'wxPlotCanvas']),

    ('Cool Contribs', ['pyTree', 'hangman', 'SlashDot']),

    ]

#---------------------------------------------------------------------------

class wxPythonDemo(wxFrame):
    def __init__(self, parent, id, title):
        wxFrame.__init__(self, parent, -1, title,
                         wxDefaultPosition, wxSize(700, 550))
        if wxPlatform == '__WXMSW__':
            self.icon = wxIcon('bitmaps/mondrian.ico', wxBITMAP_TYPE_ICO)
            self.SetIcon(self.icon)

        self.otherWin = None
        EVT_IDLE(self, self.OnIdle)

        self.Centre(wxBOTH)
        self.CreateStatusBar(1, wxST_SIZEGRIP)
        splitter = wxSplitterWindow(self, -1)
        splitter2 = wxSplitterWindow(splitter, -1)

        # Prevent TreeCtrl from displaying all items after destruction
        self.dying = false

        # Make a File menu
        self.mainmenu = wxMenuBar()
        menu = wxMenu()
        mID = NewId()
        menu.Append(mID, 'E&xit', 'Get the heck outta here!')
        EVT_MENU(self, mID, self.OnFileExit)
        self.mainmenu.Append(menu, '&File')

        # Make a Help menu
        mID = NewId()
        menu = wxMenu()
        menu.Append(mID, '&About', 'wxPython RULES!!!')
        EVT_MENU(self, mID, self.OnHelpAbout)
        self.mainmenu.Append(menu, '&Help')
        self.SetMenuBar(self.mainmenu)

        # Create a TreeCtrl
        tID = NewId()
        self.tree = wxTreeCtrl(splitter, tID)
        root = self.tree.AddRoot("Overview")
        for item in _treeList:
            child = self.tree.AppendItem(root, item[0])
            for childItem in item[1]:
                self.tree.AppendItem(child, childItem)
        self.tree.Expand(root)
        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)


        # Create a Notebook
        self.nb = wxNotebook(splitter2, -1)

        # Set up a TextCtrl on the Overview Notebook page
        self.ovr = wxTextCtrl(self.nb, -1, '', wxDefaultPosition, wxDefaultSize,
                              wxTE_MULTILINE|wxTE_READONLY)
        self.nb.AddPage(self.ovr, "Overview")


        # Set up a TextCtrl on the Demo Code Notebook page
        self.txt = wxTextCtrl(self.nb, -1, '', wxDefaultPosition, wxDefaultSize,
                              wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
        self.nb.AddPage(self.txt, "Demo Code")


        # select initial items
        self.nb.SetSelection(0)
        self.tree.SelectItem(root)

        # Set up a log on the View Log Notebook page
        self.log = wxTextCtrl(splitter2, -1, '', wxDefaultPosition, wxDefaultSize,
                              wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
        (w, self.charHeight) = self.log.GetTextExtent('X')
        #self.WriteText('wxPython Demo Log:\n')


        # add the windows to the splitter and split it.
        splitter.SplitVertically(self.tree, splitter2)
        splitter.SetSashPosition(180, true)
        splitter.SetMinimumPaneSize(20)

        splitter2.SplitHorizontally(self.nb, self.log)
        splitter2.SetSashPosition(360, true)
        splitter2.SetMinimumPaneSize(20)

        # make our log window be stdout
        #sys.stdout = self

    #---------------------------------------------
    def WriteText(self, text):
        self.log.WriteText(text)
        w, h = self.log.GetClientSizeTuple()
        numLines = h/self.charHeight
        x, y = self.log.PositionToXY(self.log.GetLastPosition())
        self.log.ShowPosition(self.log.XYToPosition(x, y-numLines+1))

    def write(self, txt):
        self.WriteText(txt)

    #---------------------------------------------
    def OnItemExpanded(self, event):
        item = event.GetItem()
        self.log.WriteText("OnItemExpanded: %s\n" % self.tree.GetItemText(item))

    #---------------------------------------------
    def OnItemCollapsed(self, event):
        item = event.GetItem()
        self.log.WriteText("OnItemCollapsed: %s\n" % self.tree.GetItemText(item))

    #---------------------------------------------
    def OnSelChanged(self, event):
        if self.dying:
            return

        if self.nb.GetPageCount() == 3:
            if self.nb.GetSelection() == 2:
                self.nb.SetSelection(0)
            self.nb.DeletePage(2)

        item = event.GetItem()
        itemText = self.tree.GetItemText(item)

        if itemText == 'Overview':
            self.GetDemoFile('Main.py')
            self.SetOverview('Overview', overview)
            #self.nb.ResizeChildren();
            self.nb.Refresh();
            #wxYield()

        else:
            if os.path.exists(itemText + '.py'):
                self.GetDemoFile(itemText + '.py')
                module = __import__(itemText, globals())
                self.SetOverview(itemText, module.overview)

                # in case runTest is modal, make sure things look right...
                self.nb.Refresh();
                wxYield()

                window = module.runTest(self, self.nb, self)
                if window:
                    self.nb.AddPage(window, 'Demo')
                    self.nb.SetSelection(2)
                    self.nb.ResizeChildren();

            else:
                self.ovr.Clear()
                self.txt.Clear()


    #---------------------------------------------
    # Get the Demo files
    def GetDemoFile(self, filename):
        self.txt.Clear()
        if not self.txt.LoadFile(filename):
            self.txt.WriteText("Cannot open %s file." % filename)

        self.txt.SetInsertionPoint(0)
        self.txt.ShowPosition(0)

    #---------------------------------------------
    def SetOverview(self, name, text):
        self.ovr.Clear()
        self.ovr.WriteText(text)
        self.nb.SetPageText(0, name)
        self.ovr.SetInsertionPoint(0)
        self.ovr.ShowPosition(0)

    #---------------------------------------------
    # Menu methods
    def OnFileExit(self, event):
        self.Close()


    def OnHelpAbout(self, event):
        about = wxMessageDialog(self,
                                "wxPython is a Python extension module that\n"
                                "encapsulates the wxWindows GUI classes.\n\n"
                                "This demo shows off some of the capabilities\n"
                                "of wxPython.\n\n"
                                "          Developed by Robin Dunn",
                               "About wxPython", wxOK)
        about.ShowModal()
        about.Destroy()


    #---------------------------------------------
    def OnCloseWindow(self, event):
        self.dying = true
        self.Destroy()

    #---------------------------------------------
    def OnIdle(self, event):
        if self.otherWin:
            self.otherWin.Raise()
            self.otherWin = None


#---------------------------------------------------------------------------
#---------------------------------------------------------------------------

class MyApp(wxApp):
    def OnInit(self):
        wxImage_AddHandler(wxJPEGHandler())
        wxImage_AddHandler(wxPNGHandler())
        wxImage_AddHandler(wxGIFHandler())
        frame = wxPythonDemo(NULL, -1, "wxPython: (A Demonstration)")
        frame.Show(true)
        self.SetTopWindow(frame)
        return true

#---------------------------------------------------------------------------

def main():
    app = MyApp(0)
    app.MainLoop()


#---------------------------------------------------------------------------


overview = """\
Python
------------

Python is an interpreted, interactive, object-oriented programming language often compared to Tcl, Perl, Scheme, or Java.

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.

wxWindows
--------------------

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.

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.

wxPython
----------------

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.

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.

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.

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()

#----------------------------------------------------------------------------
Commit	Line	Data
cf694132 RD	1	#!/bin/env python
	2	#----------------------------------------------------------------------------
	3	# Name: Main.py
	4	# Purpose: Testing lots of stuff, controls, window types, etc.
	5	#
	6	# Author: Robin Dunn & Gary Dumer
	7	#
	8	# Created:
	9	# RCS-ID: $Id$
	10	# Copyright: (c) 1999 by Total Control Software
	11	# Licence: wxWindows license
	12	#----------------------------------------------------------------------------
	13
	14	import sys, os
	15	from wxPython.wx import *
	16
	17
	18	#---------------------------------------------------------------------------
	19
	20
	21	_treeList = [
	22	('Managed Windows', ['wxFrame', 'wxDialog', 'wxMiniFrame']),
	23
	24	('Miscellaneous Windows', ['wxGrid', 'wxSashWindow',
	25	'wxScrolledWindow', 'wxSplitterWindow',
	26	'wxStatusBar', 'wxToolBar', 'wxNotebook']),
	27
	28	('Common Dialogs', ['wxColourDialog', 'wxDirDialog', 'wxFileDialog',
	29	'wxSingleChoiceDialog', 'wxTextEntryDialog',
	30	'wxFontDialog', 'wxPageSetupDialog', 'wxPrintDialog',
	31	'wxMessageDialog']),
	32
	33	('Controls', ['wxButton', 'wxCheckBox', 'wxCheckListBox', 'wxChoice',
	34	'wxComboBox', 'wxGauge', 'wxListBox', 'wxListCtrl', 'wxTextCtrl',
	35	'wxTreeCtrl', 'wxSpinButton', 'wxStaticText', 'wxStaticBitmap',
	36	'wxRadioBox', 'wxSlider']),
	37
	38	('Window Layout', ['wxLayoutConstraints']),
	39
	40	('Micellaneous', ['wxTimer', 'wxGLCanvas', 'DialogUnits', 'wxImage']),
	41
	42	('wxPython Library', ['Layoutf', 'wxScrolledMessageDialog',
	43	'wxMultipleChoiceDialog', 'wxPlotCanvas']),
	44
	45	('Cool Contribs', ['pyTree', 'hangman', 'SlashDot']),
	46
	47	]
	48
	49	#---------------------------------------------------------------------------
	50
	51	class wxPythonDemo(wxFrame):
	52	def __init__(self, parent, id, title):
	53	wxFrame.__init__(self, parent, -1, title,
	54	wxDefaultPosition, wxSize(700, 550))
	55	if wxPlatform == '__WXMSW__':
	56	self.icon = wxIcon('bitmaps/mondrian.ico', wxBITMAP_TYPE_ICO)
	57	self.SetIcon(self.icon)
	58
	59	self.otherWin = None
	60	EVT_IDLE(self, self.OnIdle)
	61
	62	self.Centre(wxBOTH)
	63	self.CreateStatusBar(1, wxST_SIZEGRIP)
	64	splitter = wxSplitterWindow(self, -1)
65	splitter2 = wxSplitterWindow(splitter, -1)
66
67	# Prevent TreeCtrl from displaying all items after destruction
68	self.dying = false
69
70	# Make a File menu
71	self.mainmenu = wxMenuBar()
72	menu = wxMenu()
73	mID = NewId()
74	menu.Append(mID, 'E&xit', 'Get the heck outta here!')
75	EVT_MENU(self, mID, self.OnFileExit)
76	self.mainmenu.Append(menu, '&File')
77
78	# Make a Help menu
79	mID = NewId()
80	menu = wxMenu()
81	menu.Append(mID, '&About', 'wxPython RULES!!!')
82	EVT_MENU(self, mID, self.OnHelpAbout)
83	self.mainmenu.Append(menu, '&Help')
84	self.SetMenuBar(self.mainmenu)
85
86	# Create a TreeCtrl
87	tID = NewId()
88	self.tree = wxTreeCtrl(splitter, tID)
89	root = self.tree.AddRoot("Overview")
90	for item in _treeList:
91	child = self.tree.AppendItem(root, item[0])
92	for childItem in item[1]:
93	self.tree.AppendItem(child, childItem)
94	self.tree.Expand(root)
95	EVT_TREE_ITEM_EXPANDED (self.tree, tID, self.OnItemExpanded)
96	EVT_TREE_ITEM_COLLAPSED (self.tree, tID, self.OnItemCollapsed)
97	EVT_TREE_SEL_CHANGED (self.tree, tID, self.OnSelChanged)
98
99
100	# Create a Notebook
101	self.nb = wxNotebook(splitter2, -1)
102
103	# Set up a TextCtrl on the Overview Notebook page
104	self.ovr = wxTextCtrl(self.nb, -1, '', wxDefaultPosition, wxDefaultSize,
105	wxTE_MULTILINE\|wxTE_READONLY)
106	self.nb.AddPage(self.ovr, "Overview")
107
108
109	# Set up a TextCtrl on the Demo Code Notebook page
110	self.txt = wxTextCtrl(self.nb, -1, '', wxDefaultPosition, wxDefaultSize,
111	wxTE_MULTILINE\|wxTE_READONLY\|wxHSCROLL)
112	self.nb.AddPage(self.txt, "Demo Code")
113
114
115	# select initial items
116	self.nb.SetSelection(0)
117	self.tree.SelectItem(root)
118
119	# Set up a log on the View Log Notebook page
120	self.log = wxTextCtrl(splitter2, -1, '', wxDefaultPosition, wxDefaultSize,
121	wxTE_MULTILINE\|wxTE_READONLY\|wxHSCROLL)
122	(w, self.charHeight) = self.log.GetTextExtent('X')
53920141	123	#self.WriteText('wxPython Demo Log:\n')
cf694132 RD	124
	125
	126	# add the windows to the splitter and split it.
	127	splitter.SplitVertically(self.tree, splitter2)
	128	splitter.SetSashPosition(180, true)
	129	splitter.SetMinimumPaneSize(20)
	130
	131	splitter2.SplitHorizontally(self.nb, self.log)
	132	splitter2.SetSashPosition(360, true)
	133	splitter2.SetMinimumPaneSize(20)
	134
	135	# make our log window be stdout
c127177f	136	#sys.stdout = self
cf694132 RD	137
	138	#---------------------------------------------
	139	def WriteText(self, text):
	140	self.log.WriteText(text)
53920141 RD	141	w, h = self.log.GetClientSizeTuple()
	142	numLines = h/self.charHeight
	143	x, y = self.log.PositionToXY(self.log.GetLastPosition())
	144	self.log.ShowPosition(self.log.XYToPosition(x, y-numLines+1))
cf694132 RD	145
	146	def write(self, txt):
	147	self.WriteText(txt)
	148
	149	#---------------------------------------------
	150	def OnItemExpanded(self, event):
	151	item = event.GetItem()
	152	self.log.WriteText("OnItemExpanded: %s\n" % self.tree.GetItemText(item))
	153
	154	#---------------------------------------------
	155	def OnItemCollapsed(self, event):
	156	item = event.GetItem()
	157	self.log.WriteText("OnItemCollapsed: %s\n" % self.tree.GetItemText(item))
	158
	159	#---------------------------------------------
	160	def OnSelChanged(self, event):
	161	if self.dying:
	162	return
	163
	164	if self.nb.GetPageCount() == 3:
	165	if self.nb.GetSelection() == 2:
	166	self.nb.SetSelection(0)
	167	self.nb.DeletePage(2)
	168
	169	item = event.GetItem()
	170	itemText = self.tree.GetItemText(item)
	171
	172	if itemText == 'Overview':
	173	self.GetDemoFile('Main.py')
	174	self.SetOverview('Overview', overview)
	175	#self.nb.ResizeChildren();
	176	self.nb.Refresh();
	177	#wxYield()
	178
	179	else:
	180	if os.path.exists(itemText + '.py'):
	181	self.GetDemoFile(itemText + '.py')
	182	module = __import__(itemText, globals())
	183	self.SetOverview(itemText, module.overview)
	184
	185	# in case runTest is modal, make sure things look right...
	186	self.nb.Refresh();
	187	wxYield()
	188
	189	window = module.runTest(self, self.nb, self)
	190	if window:
	191	self.nb.AddPage(window, 'Demo')
	192	self.nb.SetSelection(2)
	193	self.nb.ResizeChildren();
	194
	195	else:
	196	self.ovr.Clear()
	197	self.txt.Clear()
	198
	199
	200	#---------------------------------------------
	201	# Get the Demo files
	202	def GetDemoFile(self, filename):
	203	self.txt.Clear()
	204	if not self.txt.LoadFile(filename):
	205	self.txt.WriteText("Cannot open %s file." % filename)
	206
	207	self.txt.SetInsertionPoint(0)
	208	self.txt.ShowPosition(0)
209
210	#---------------------------------------------
211	def SetOverview(self, name, text):
212	self.ovr.Clear()
213	self.ovr.WriteText(text)
214	self.nb.SetPageText(0, name)
215	self.ovr.SetInsertionPoint(0)
216	self.ovr.ShowPosition(0)
217
218	#---------------------------------------------
219	# Menu methods
220	def OnFileExit(self, event):
221	self.Close()
222
223
224	def OnHelpAbout(self, event):
225	about = wxMessageDialog(self,
226	"wxPython is a Python extension module that\n"
227	"encapsulates the wxWindows GUI classes.\n\n"
228	"This demo shows off some of the capabilities\n"
229	"of wxPython.\n\n"
230	" Developed by Robin Dunn",
231	"About wxPython", wxOK)
232	about.ShowModal()
233	about.Destroy()
234
235
236	#---------------------------------------------
237	def OnCloseWindow(self, event):
238	self.dying = true
239	self.Destroy()
240
241	#---------------------------------------------
242	def OnIdle(self, event):
243	if self.otherWin:
244	self.otherWin.Raise()
245	self.otherWin = None
246
247
248	#---------------------------------------------------------------------------
249	#---------------------------------------------------------------------------
250
251	class MyApp(wxApp):
252	def OnInit(self):
253	wxImage_AddHandler(wxJPEGHandler())
254	wxImage_AddHandler(wxPNGHandler())
255	wxImage_AddHandler(wxGIFHandler())
256	frame = wxPythonDemo(NULL, -1, "wxPython: (A Demonstration)")
257	frame.Show(true)
258	self.SetTopWindow(frame)
259	return true
260
261	#---------------------------------------------------------------------------
262
263	def main():
264	app = MyApp(0)
265	app.MainLoop()
266
267
268	#---------------------------------------------------------------------------
269
270
271
272	overview = """\
273	Python
274	------------
275
276	Python is an interpreted, interactive, object-oriented programming language often compared to Tcl, Perl, Scheme, or Java.
277
278	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.
279
280	wxWindows
281	--------------------
282
283	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.
284
285	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.
286
287	wxPython
288	----------------
289
290	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.
291
292	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.
293
294	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.
295
296	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.
297	"""
298
299
300
301
302
303
304
305	#----------------------------------------------------------------------------
306	#----------------------------------------------------------------------------
307
308	if __name__ == '__main__':
309	main()
310
311	#----------------------------------------------------------------------------
312
313
314
315
316
317
318