=head1 NAME Win32::GUI - Perl Win32 Graphical User Interface Extension =head1 SYNOPSIS use Win32::GUI(); =head1 Table of Contents 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 (L<http://msdn.microsoft.com/>). =head2 User Guide =over =item * L<README|Win32::GUI::UserGuide::Readme> What Win32::GUI is, and how to get it installed. =item * L<Release Notes|Win32::GUI::ReleaseNotes> Release notes. Essential reading for old hands who want to know what has changed between versions. =item * L<Introduction|Win32::GUI::UserGuide::Introduction> A short welcome. =item * L<General Concepts|Win32::GUI::UserGuide::Concepts> An introduction to the basic Windows GUI concepts and how they relate to Win32::GUI =item * L<Tutorial|Win32::GUI::Tutorial> A Tutorial. Essential reading for beginners: Creating your first Win32::GUI window and all the basics that you will need. =item * L<Frequently Asked Questions|Win32::GUI::UserGuide::FAQ> A (currently somewhat out of date) set of Frequently asked questions and answers. =back =head2 Reference =over =item * L<Packages|Win32::GUI::Reference::Packages> Per package documentation for Win32::GUI. =item * L<Common Events|Win32::GUI::Reference::Events> All the events that are common to every window. =item * L<Common Methods|Win32::GUI::Reference::Methods> All the methods in the Win32::GUI package (and inherited by the other packages). =item * L<Options|Win32::GUI::Reference::Options> Options common to most package constructors. =back =head1 Sample Code There is a set of sample applications installed with Win32::GUI, that should be found in the F<.../Win32/GUI/demos/> directory under your library installtion root (by default for ActiveState perl this is at F<C:/Perl/site/lib/Win32/GUI/demos>). There is a viewer/launcher application installed as well. Type C<win32-gui-demos> at a command prompt. =head1 EXPORTS 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 L<Win32::GUI::Constants|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: =over =item C<use Win32::GUI;> Will continue to export the same list of constants as earlier versions, but will generate a warning (under the C<use warnings;> pragma or with the C<-w> command line option to perl). In the future (v1.07 and later) this syntax will stop exporting anything. v1.07 will generate a warning that nothing is being exported. v1.08 will silently export nothing. =item C<use Win32::GUI qw( ... );> Will exported the requested list of constants. The full syntax allowed by L<Win32::GUI::Constants|Win32::GUI::Constants> may be used. =back Please see the L<v1.04 Release Notes|Win32::GUI::ReleaseNotes::RN_1_04> for further information on backwards compatability and making old scripts work. =for comment $Id: pod_postamble.tpl,v 1.2 2005/08/03 21:45:59 robertemay Exp $ =head1 VERSION Documentation for Win32::GUI v1.14 created 01 Jun 2017 This document is autogenerated by the build process. Edits made here will be lost. Edit F<docs/GUI.pod> instead. =head1 SUPPORT Homepage: L<http://perl-win32-gui.sourceforge.net/>. For further support join the users mailing list from the website at L<http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users>. There is a searchable list archive at L<http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/>. =head1 COPYRIGHT and LICENCE Copyright (c) 1997..2017 Aldo Calpini. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.