Wx::App::AnnualCal - the main module of the AnnualCal distribution
version 0.92
Main module for AnnualCal, a GUI application programmed in wxPerl, displaying an annual calendar for the year input by the user.
The entry point to a wxPerl program, analagous to 'main' in a C program.
The design of the GUI is moderately complex, utilizing BoxSizer, Grid, GridSizer, TxtCtrl, and Button widgets.
The name of each month is inserted into a TxtCtrl, and the days of each month are inserted into a 7x7 GridSizer, the first row of which is reserved for the weekday names. Each of these 12 pairs of widgets is then inserted into a vertical BoxSizer, the TxtCtrl added prior to the GridSizer, creating a set of 12 widgets containing all the data needed to display a year. The next step is to insert this collection into a single 3x4 Grid, in the correct order; a GridSizer is not used here because today's date is highlighted, when it is displayed.
A horizontal BoxSizer is used to contain the interactive Buttons for changing the year, and a TxtCtrl to display the current year.
Finally, a vertical BoxSizer is created which contains the Grid on top, and the horizontal BoxSizer on the bottom. The motivation for this design is that only the 'upper sizer' has to be replaced when the user changes the year; the 'bottom sizer' is essentially static, except for updating the TexCtrl to display the new year.
Elliot Winston <exw@cpan.org>
This software is copyright (c) 2014 by Elliot Winston.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Wx::App::AnnualCal, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Wx::App::AnnualCal
CPAN shell
perl -MCPAN -e shell install Wx::App::AnnualCal
For more information on module installation, please visit the detailed CPAN module installation guide.