counter (NotesCalendarEntry - JavaScript™)

Counters a meeting entry or entries.

Defined in

NotesCalendarEntry

Syntax

cancel(comments:string, start:NotesDateTime, end:NotesDateTime) : void

cancel(comments:string, start:NotesDateTime, end:NotesDateTime, keepplaceholder:boolean) : void

cancel(comments:string, start:NotesDateTime, end:NotesDateTime, scope:int, recurid:string) : voidcancel(comments:string, start:NotesDateTime, end:NotesDateTime, keepplaceholder:boolean, scope:int, recurid:string) : void

Parameter Description
comments Comments regarding a meeting change.
start The start time of the counter proposal.
end The end time of the counter proposal. An exception occurs if the end time is not greater than the start time.
keepplaceholder Keeps a placeholder for the meeting.
scope The scope of a recurring operation:
  • CS_RANGE_REPEAT_ALL (1)
  • CS_RANGE_REPEAT_CURRENT (0)
  • CS_RANGE_REPEAT_FUTURE (3), inclusive
  • CS_RANGE_REPEAT_PREV (2), inclusive
recurid The recurrence identifier (RECURRENCE-ID item) for a recurring calendar event. The format of a recurrence identifier is a time in UTC format, for example, 20120913T160000Z.
Possible exception Value Text Description
NotesError.NOTES_ERR_INVALIDID 4757 Invalid ID The identifier for the NotesCalendarEntry object is not valid.
NotesError.NOTES_ERR_RECURID_NOTFOUND 4808 Recurrence-ID not found The recurrence identifier for the NotesCalendarEntry object is not valid.
NotesError.NOTES_ERR_IDNOTFOUND 4814 Identifier not found The recurrence identifier for the NotesCalendarEntry object does not identify an entry in the calendar, or the scope and recurid are missing for a recurring entry.

Usage

This method deals with meeting entries, not notices.

Examples

This button event counters a meeting entry.
var dbdir:NotesDbDirectory = session.getDbDirectory("");
var maildb:NotesDatabase = dbdir.openMailDatabase();
var cal:NotesCalendar = session.getCalendar(maildb);
var dt1:NotesDateTime = session.createDateTime("Tomorrow 12");
var dt2:NotesDateTime = session.createDateTime("Tomorrow 13");
var unid:string = sessionScope.unid;
var cale:NotesCalendarEntry = cal.getEntryByUNID(unid);
cale.counter("New time?", dt1, dt2, true);
requestScope.status = "Calendar entry for UNID " + unid + " countered\n";

LotusScript® syntax

NotesCalendarEntry.Cancel(Byval comments As String, start As NotesDateTime, end As NotesDateTime, Optional scope as Integer, Optional Byval recurid As String)

Java™ syntax

void NotesCalendarEntry.cancel(String comments, DateTime start, DateTime end)
void NotesCalendarEntry.cancel(String comments, DateTime start, DateTime end, boolean keepplaceholder)
void NotesCalendarEntry.cancel(String comments, DateTime start, DateTime end, int scope, String recurid))
void NotesCalendarEntry.cancel(String comments, DateTime start, DateTime end, boolean keepplaceholder, int scope, String recurid)