IWL::Calendar - a calendar widget
IWL::Object -> IWL::Widget -> IWL::Table -> IWL::Calendar
The calendar widget provides a graphical calendar. It inherits from IWL::Table(3pm)
IWL::Calendar->new ([%ARGS])
Where %ARGS is an optional hash parameter with with key-values:
Specifies the lower year boundary of the calendar. The year must include the century, e.g. 2007
Specifies the lower month boundary of the calendar. Months range from 0 to 11
Specifies the upper year boundary of the calendar. The year must include the century, e.g. 2007
Specifies the upper month boundary of the calendar. Months range from 0 to 11
Sets the starting date of the calendar. Defaults to the current date. See IWL::Calendar::setDate(3pm)
True, if the week numbers should be shown. Defaults to true. See IWL::Calendar::showWeekNumbers(3pm)
True, if the heading should be shown. Defaults to true. See IWL::Calendar::showHeading(3pm)
True, if the time should be shown. Defaults to true. See IWL::Calendar::showTime(3pm)
True, if days from the adjacent months should be shown. Defaults to true
True, if the user should be prevented from switching months/years. Defaults to false
True, if the calendar week should start on monday. Defaults to true
True, if the weekends should differ visually from the week days. Defaults to true
True, if the displayed time should use astronomical notation (e.g. 15:00 instead of 3:00 pm). Defaults to true
An array of dates that should be marked as special. See IWL::Calendar::markDate(3pm)
Fires when the month has been changed. Receives a Date object as a parameter.
Fires when the year has been changed. Receives a Date object as a parameter.
Fires when the date has been changed. Receives a Date object and the current calendar date cell object as parameters.
Fires when the calendar has been loaded.
Fires when a date has been selected. Receives a Date object and the current calendar date cell object as parameters.
Fires when a date has been activated, via double clicking. Receives a Date object and the current calendar date cell object as parameters.
Sets the starting date of the calendar.
Parameters: DATE - the starting date, can be in the following formats:
In seconds, or in milliseconds
Returns the starting date of the calendar
Sets whether the week numbers should be shown.
Parameters: BOOL - true if the week numbers should be shown
Sets whether the heading should be shown.
Parameters: BOOL - true if the heading should be shown
Sets whether the time should be shown.
Parameters: BOOL - true if the time should be shown
Sets the given date as a marked date.
Parameters: DATE - a date to mark. Can be an array of dates. The date should have the following format:
{year => 2007, month => 5, date => 11}
where year and month are optional.
Removes the given date from the list of marked dates.
Parameters: DATE - a date to unmark. See IWL::Calendar::markDate(3pm) for more information.
Clears all marked dates.
Updates the given ELEMENT with data, formatted using FORMAT when SIGNAL has been emitted.
Parameters: SIGNAL - the signal to which to connect. ELEMENT - the element to update, it must have a valid id. FORMAT - the format, which will be used to format the date. See strftime(3)
Copyright (c) 2006-2007 Viktor Kojouharov. All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perldoc perlartistic.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
1 POD Error
The following errors were encountered while parsing the POD:
You forgot a '=back' before '=head1'
To install IWL, copy and paste the appropriate command in to your terminal.
cpanm
cpanm IWL
CPAN shell
perl -MCPAN -e shell install IWL
For more information on module installation, please visit the detailed CPAN module installation guide.