calendar/base/public/calIRecurrenceItem.idl
author Mozilla Releng Treescript <release+treescript@mozilla.org>
Sun, 17 Oct 2021 08:37:26 +0000
changeset 44327 b6ecd7157436e9014492e7377e9674fbf2b72f70
parent 36959 5ba4422e867f7f2b922673b2b8bb58dac0a788e3
permissions -rw-r--r--
no bug - Bumping Thunderbird l10n changesets r=release a=l10n-bump DONTBUILD eu -> e7a488d9fc0b4a2215ea4be00df34b1cf91b3825 nn-NO -> a7f9a3d358757c792d20ecc2cfafc0a38d352897 pt-BR -> cfac0a9d49c9ad270e1e54e88906096958e894bc ru -> 03046775600fa8921df89e6b033582056fed8296

/* 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 calIDateTime;

interface calIIcalProperty;

[scriptable, uuid(918a243b-d887-41b0-8b4b-9cd56a9dd55f)]
interface calIRecurrenceItem : nsISupports
{
  // returns true if this thing is able to be modified;
  // if the item is not mutable, attempts to modify
  // any data will throw CAL_ERROR_ITEM_IS_IMMUTABLE
  readonly attribute boolean isMutable;

  // makes this item immutable
  void makeImmutable();

  // clone always returns a mutable event
  calIRecurrenceItem clone();

  // defaults to false; if true, this item is to be interpreted
  // as a negative rule (e.g. exceptions instead of rdates)
  attribute boolean isNegative;

  // returns whether this item has a finite number of dates
  // or not (e.g. a rule with no end date)
  readonly attribute boolean isFinite;

  /**
   * Search for the next occurrence after aTime and return its recurrence id.
   * aRecurrenceId must be the recurrence id of an occurrence to search after.
   *
   * @require               (aTime >= aRecurrenceId)
   * @param aRecurrenceId   The recurrence id to start searching at.
   * @param aTime           The earliest time to find the occurrence after.
   */
  calIDateTime getNextOccurrence(in calIDateTime aRecurrenceId,
                                 in calIDateTime aTime);

  // return array of calIDateTime of the start of all occurrences of
  // this event starting at aStartTime, between rangeStart and an
  // optional rangeEnd
  Array<calIDateTime> getOccurrences(in calIDateTime aStartTime,
                                     in calIDateTime aRangeStart,
                                     in calIDateTime aRangeEnd,
                                     in unsigned long aMaxCount);

  attribute calIIcalProperty icalProperty;
  attribute AUTF8String icalString;
};