Revision control

Copy as Markdown

Other Tools

/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#include "nsISupports.idl"
interface calIItemBase;
interface calIAttendee;
/**
* Accesses scheduling specific information of calendar items.
* Implementation by providers is optional.
*/
[scriptable, uuid(9221e243-c97e-4c5f-9e00-5d7d3521bb44)]
interface calISchedulingSupport : nsISupports
{
/**
* Tests whether the passed item corresponds to an invitation, e.g.
* the CUA or server has placed it in the calendar.
*
* @param aItem Item to be tested.
* @return Whether the passed item corresponds to an invitation.
*/
boolean isInvitation(in calIItemBase aItem);
/**
* Gets the invited attendee if the passed item corresponds to
* an invitation. UI code will use that attendee to modify e.g. PARTSTAT.
* If isInvitation returns true, getInvitedAttendee must return
* an attendee. If isInvitation is false, getInvitedAttendee may return
* an attendee in case the organizer (and owner of the calendar) has
* invited himself.
*
* @param aItem Invitation item.
* @return Attendee object, or null.
*/
calIAttendee getInvitedAttendee(in calIItemBase aItem);
/**
* Checks whether the provider keeps track of sending out the proper
* iTIP/iMIP message for a particular item.
*
* @param aMethod a iTIP method
* @param aItem an item that has been modified/deleted etc.
* @return true, if the provider keeps track of sending out passed message
*/
boolean canNotify(in AUTF8String aMethod, in calIItemBase aItem);
};