Net::ICal::Alarm -- represents an alarm (a VALARM object).
use Net::ICal; # simple syntax $a = new Net::ICal::Alarm(action => 'DISPLAY', trigger => "20000101T073000", description => "Wake Up!"); # elaborate $a = new Net::ICal::Alarm (action => 'EMAIL', trigger => new Net::ICal::Trigger ( type => 'DURATION', content => new Net::ICal::Duration ("-PT5M"), related => 'END ), attendee => [new Net::ICal::Attendee('mailto:email@example.com')], summary => "mail subject", description => "mail contents");
This class handles reminders for Net::ICal Events and Todos. You can get a reminder in several different ways (a sound played, a message displayed on your screen, an email or a script/application run for you) at a certain time, either relative to the Event or Todo the Alarm is part of, or at a fixed date/time.
Create a new Alarm. The minimum options are an action, a trigger and either an attach or a description.
What the Alarm does when fired. The default type is EMAIL.
If the Alarm has an EMAIL "action", the text of the summary string will be the Subject header of the email.
If the Alarm has an AUDIO "action", this contains the sound to be played, either as an URL or inline. If the Alarm has an EMAIL "action", this will be attached to the email. If the Alarm has a PROCEDURE "action", it contains the application to be executed.
The number of times the Alarm must be repeated. If you specify this, you must also specify "duration".
More documentation pointers can be found in Net::ICal.