Shane Landrum > Net-ICal-0.15 > Net::ICal::Alarm

Download:
Net-ICal-0.15.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  3
Open  1
View/Report Bugs
Source  

NAME ^

Net::ICal::Alarm -- represents an alarm (a VALARM object).

SYNOPSIS ^

  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:alice@wonderland.com')],
                             summary => "mail subject",
                             description => "mail contents");

DESCRIPTION ^

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.

CONSTRUCTOR ^

new (optionhash)

Create a new Alarm. The minimum options are an action, a trigger and either an attach or a description.

The action describes what type of Alarm this is going to be. See "action" below for possible actions. The trigger describes when the alarm will be triggered. See "trigger" below for an explanation.

METHODS ^

action

What the Alarm does when fired. The default type is EMAIL.

trigger

The time at which to fire off the reminder. This can either be relative to the Event/Todo (a Net::ICal::Duration or at a fixed date/time (a Net::ICal::Time).

summary

If the Alarm has an EMAIL "action", the text of the summary string will be the Subject header of the email.

description

If the Alarm has an EMAIL "action", the text of the description string will be the body of the email. If the Alarm has a PROCEDURE "action", this is the argument string to be passed to the program.

attach

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.

attendee

If the Alarm has an EMAIL "action", this contains one or more Net::ICal::Attendee objects that describe the email addresses of the people that need to receive this Alarm.

repeat

The number of times the Alarm must be repeated. If you specify this, you must also specify "duration".

duration

The time before the Alarm is repeated. This is a Net::ICal::Duration object. If you specify this, you must also specify "repeat".

SEE ALSO ^

More documentation pointers can be found in Net::ICal.

syntax highlighting: