Win32::GUI - Perl Win32 Graphical User Interface Extension
Due to the volume of Win32::GUI documentation it is split into a number of different sections. The documentation is sparse in some areas, and incomplete in others. Patches are welcome. The documentation does not try to be a tutorial for Windows GUI programming, although the tutorial should give enough information for a beginner to get started. For advanced features knowledge of the Win32 API is assumed, and further information can be found from Microsoft's online resources (http://msdn.microsoft.com/).
What Win32::GUI is, and how to get it installed.
Release notes. Essential reading for old hands who want to know what has changed between versions.
A short welcome.
An introduction to the basic Windows GUI concepts and how they relate to Win32::GUI
A Tutorial. Essential reading for beginners: Creating your first Win32::GUI window and all the basics that you will need.
A (currently somewhat out of date) set of Frequently asked questions and answers.
Per package documentation for the core Win32::GUI packages.
All the events that are common to every window.
All the methods in the Win32::GUI package (and inherited by the other packages).
Options common to most package constructors.
Host AxticeX controls in Win32::GUI windows
Load bitmaps from within your script, rather than a seperate file.
Export any of over 1700 Win32 API constants for use with Win32::GUI functions and methods.
Support for creating bitmaps from other graphics file formats and more image manipulation. Can interact with the perl GD package if more complex image manipulation is required.
Accept files dragged from the Windows shell to your application.
Tabular data entry and display.
A simple layout manager.
An advanced source code editor control.
There is a set of sample applications installed with Win32::GUI, that should be found in the .../Win32/GUI/demos/ directory under your library installtion root (by default for ActiveState perl this is at C:/Perl/site/lib/Win32/GUI/demos). There is a viewer/launcher application installed as well. Type
win32-gui-demos at a command prompt.
Release of Win32::GUI up to and including v1.03 export a large list of constants into the callers namespace by default. This behaviour is changed in releases from v1.04 and onwards.
From v1.04 the support for constants is provided by Win32::GUI::Constants, and the prefered way of getting constants exported into your namespace should be:
use Win32::GUI(); # Empty export list to prevent default exports use Win32::GUI::Constants qw( ... ) # explicitly list wanted constants
although, for backwards compatibility the following are also supported:
Will continue to export the same list of constants as earlier versions, but will generate a warning (under the
use warnings; pragma or with the
-w command line option to perl). In the future (v1.05 and later) this syntax will stop exporting anything. v1.05 will generate a warning that nothing is being exported. v1.06 will silently export nothing.
use Win32::GUI qw( ... );
Will exported the requested list of constants. The full syntax allowed by Win32::GUI::Constants may be used.
Please see the v1.04 Release Notes for further information on backwards compatability and making old scripts work.