fix to work on python <= 2.1
[python/dscho.git] / Mac / OSXResources / app / Resources / English.lproj / Documentation / gui.html
blob252c78c32fd8143a17c790afa18b5d7c5f483624
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
3 <html lang="en">
4 <head>
5 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
6 <title>Creating a User Interface with MacPython</title>
7 <meta name="generator" content="BBEdit 6.5.3">
8 <link rel="SHORTCUT ICON" href="pythonsmall.gif">
9 <META NAME="AppleIcon" CONTENT="pythonsmall.gif">
10 </head>
11 <body>
12 <h1>Creating a User Interface with MacPython</h1>
14 <p>There are a number of packages that allow creation of a user interface
15 for your Python code, each of which has its own merits:</p>
17 <ul>
18 <li> The Carbon package gives low-level access to the old Macintosh toolbox
19 calls for windows, events, dialogs and more. The <tt>FrameWork</tt> module
20 wraps these in a minimal framework. For documentation see the Macintosh
21 Library section of the <a href="doc/index.html">Python Language and runtime
22 documentation</a> and the Human Interface Toolbox section of
23 <a href="help:openbook=Carbon">Apple's Carbon Documentation</a>.
24 This solution is compatible with MacPython-OS9.</li>
25 <li> The <tt>W</tt> framework is built on top of this, and easier to use.
26 The MacPython IDE uses W. Some documentation is available on
27 <a href="http://www.nevada.edu/~cwebster/Python/index.html">Corran Webster's website</a>.
28 Compatible with MacPython-OS9.</li>
29 </ul>
31 <p>For new work, however, one of the following packages may be better suited.
32 They may be available out of the box in this distribution, otherwise you
33 can install them through the <a href="packman.html">Package Manager</a>:</p>
35 <ul>
36 <li> <a href="http://pyobjc.sourceforge.net/">PyObjC</a> allows complete access to Cocoa.
37 In technical terms it is a
38 bidirectional bridge between Python and Objectve-C, similar to Apple's Java
39 bridge. Probably the best choice for Mac OS X-only applications, but at the
40 time of this writing PyObjC is still in beta.</li>
42 <li> <a href="http://wxpython.sourceforge.net/">wxPython</a> gives Python programs
43 access to the wxWindows GUI toolkit. Many people consider this
44 the best open source cross-platform GUI solution available today.</li>
46 <li> Tkinter is the oldest cross-platform GUI toolkit for Python, bridging Python
47 to Tcl/Tk. If you install AquaTk it creates a native user interface on Mac OS X.
48 Documented in the Library section, Tkinter subsection of the
49 <a href="doc/index.html">Python Language and runtime documentation</a>. Tkinter
50 is not available for MacPython-OS9.</li>
51 </ul>
53 </body>
54 </html>