================ |logo| Pythonwin ================ .. |logo| image:: pythonwin.gif :alt: Pythonwin logo .. admonition:: Existing document :file:`\\Pythonwin\\readme.html` .. toctree:: :maxdepth: 2 :hidden: Debugger GUI Environment embeddingwin32ui Documents and Views Pythonwin Architecture The Editor .. contents:: :depth: 1 :local: Introduction ============ There are a few known problems (and probably lots of unknown ones)! .. todo:: Do some abbr directives/roles for IDE, GUI, UI, MFC Wire up links to :file:`\\Pythonwin\\pywin\\Demos\\readme.txt` and :file:`\\Pythonwin\\pywin\\Demos\\*.py` What to do with :file:`\\Pythonwin\\pywin\\idle\\readme.txt` Add discussion of :file:`\\Pythonwin\\pywin\\default.cfg` and :file:`\\Pythonwin\\pywin\\idle.cfg` Add discussion of :file:`\\Pythonwin\\start_pythonwin.pyw` What to do with :file:`\\Pythonwin\\Scintilla\\` |Pythonwin| is a Windows-only IDE and GUI framework for Python. It has an integrated debugger and a rich Python editing environment. |Pythonwin| is implemented as a *wrapper* for the Microsoft Foundation Class library. With it, you can use MFC in an interactive, interpreted environment, or write full-blown stand-alone applications tightly coupled with the Windows environment. Over 30 MFC objects are exposed, including Common Controls, Property Pages/Sheets, Control/Toolbars, Threads, etc. |Pythonwin| could almost be considered a sample program for the MFC UI environment. This Python UI environment can be embedded in almost any other application - such as OLE clients/servers, Netscape plugins, as a Macro language, etc. .. todo:: Remove Netscape plugins. Recent changes can be found at the end of this document. Demos ===== There are many demos in the :file:`pywin\\demos` directory. To see a list of all the demos, run the program :program:`pywin\\demos\\guidemo.py` from inside |Pythonwin|. Documentation ============= .. todo:: What is the role/directive for win32ui? Almost all win32ui methods are document in the |Pythonwin| Help file. This is available from the Help Menu in the |Pythonwin| environment. Below is a list of external |Pythonwin|-specific documentation. .. todo:: Create pages and links for win32ui doc, doc/view arch, mfc arch * There is separate :doc:`documentation for the debugger `. * Check out :doc:`documentation on the Pythonwin GUI environment `. * For a brief description of how to embed :file:`win32ui.pyd` into your MFC application see the :doc:`embedding win32ui documentation `. * There is some general documentation on the :doc:`MFC Architecture ` and more specifically, :doc:`document and view architecture `. * A Reference Manual of all available MFC functions etc. is released as a Windows Help file with the main |Pythonwin| release. * Check out the demos and the source code to the |Pythonwin| environment. Known Problems ============== * Some of the configuration options (eg, "Docking Windows") do not take affect until you restart |Pythonwin|. * Under Windows 9x, any attempt to use |Pythonwin| features from an MS-DOS prompt seems to cause immediate death. This means that you can not use the |Pythonwin| debugger for programs running under Python.exe on Windows 9x. You should still be able to use the debugger normally from inside |Pythonwin| itself. * |Pythonwin| will occasionally crash upon exiting under Windows 9x. The crash is in "user.exe" (old 16 bit code) which makes debugging difficult. It does not happen on Windows NT, so I'm stumped on this one. If someone could even just narrow it down to exactly what code will cause the crash at exit I would really appreciate it. * Some of the menu items are always grey. This functionality is simply not yet implemented in |Pythonwin|. Recent Changes ============== Fixed a lot of the interactive window formatting problems. |Pythonwin| now always prints output as it receives it - this should stop |Pythonwin| from looking like it has completely hung when in fact it is just waiting for some code to finish. Support for |Scintilla|_'s indentation guides, that gives a nice indication of the block structure. .. todo:: Remove or replace the dead link to Neil Hodgson. New, improved color editor, using the |Scintilla|_ control by Neil Hodgson (see *http://hare.net.au/~neilh/ScintillaTide.html*). The debugger now requires use of this editor. Much better printing support from Roger Burnham. |Pythonwin| itself still can't print anything, but the framework can (meaning some kind soul could now add the support to |Pythonwin| :-) DDE support is complete. Reference help file is far more complete. Lots of new methods from Kleanthis Kleanthous. Better tool-tip and region support