User Tools

Site Tools


event_event_properties
property constant can read can write persi
stent
type defaultmin max usage
CS_Area_Kind text Object kind = “Event” (iCal) or “ExpandedEvent” (view)
CS_Event_AllDaybool
CS_Event_ClearStyle ignored
CS_Event_Descriptiontext
CS_Event_Durationint In seconds
CS_Event_EndDatedate or intUsing int variant of getter/setter, the value is assumed to be POSIX time, including the start/end time
CS_Event_EndDateAdjtextSimilar to the property above without “Adj”, but use timezone info:
If iCal/eventUID is used, default calendar timezone is used (CS_iCal_DefaultTimezone)
If area/eventKey is used, area’s timezone is used (CS_Area_Timezone)
CS_Event_EndTimeint
CS_Event_EndTimeAdjtextSimilar to the property above without “Adj”, but use timezone info
CS_Event_iCal int Owning Calendar
CS_Event_Icon text Comma separated icon IDs
CS_Event_Index int Index into the event/banner arrays when using CalendarSet compatibility API
CS_Event_InfoTexttext Not persistent in VEVENT, only in XML
This text can be displayed in day/week view, see CS_Area_ShowInfoText
CS_Event_IsRecurring bool
CS_Event_Locationtext
CS_Event_Locked int0020 = unlocked
1 = selectable
2 = fully locked
CS_Event_RecurrCountint 0 0 = not counted
CS_Event_Recurrence int Recurrence instance (sequentially numbered)
event in view only
CS_Event_RecurrEndint 0 Use POSIX datetime
CS_Event_RecurrFrequencyint 171 = secondly
2 = minutely
3 = hourly
4 = daily
5= weekly
6 = monthly
7 = yearly
First rule in the set only
CS_Event_RecurrIntervalint 1
CS_Event_RecurrKind int 0 = none
1 = simple
2 = advanced
3 = complex
Determined by the rules used
CS_Event_StartDatedate or intUsing int variant of getter/setter, the value is assumed to be POSIX time, including the start/end time
CS_Event_StartDateAdjtextSimilar to the property above without “Adj”, but use timezone info:
If iCal/eventUID is used, default calendar timezone is used (CS_iCal_DefaultTimezone)
If area/eventKey is used, area’s timezone is used (CS_Area_Timezone)
CS_Event_StartTimeint
CS_Event_StartTimeAdjtextSimilar to the property above without “Adj”, but use timezone info
CS_Event_Statusint0030 = none
1 = confirmed
2 = tentative
3 = cancelled
CS_Event_Summarytext
CS_Event_Title text Event in view only
CS_Event_ToolTip text
CS_Event_UID text Unique ID
See below for additional explanations
CS_Event_UseDuration bool Use duration, not end date/time
CS_Event_UUIDtext This is the real event ID stored in VEVENT
Usage is meant for iCal integration: UUID is the unique event identifier

The CS_Event_UID name can be misleading, it could be e.g. CS_Event_Key
It is actually the event key to internal map entry (key → displayed event in a view → event in a calendar)
CS_Event_UUID is the real UID of the event from “UID”. CS_Event_UID is constructed from the UID and RID, internally named MapKey and is used directly with iCalRef. “normal” event uses “u:” + CS_Event_UUID
“recurrence instance” uses “r:” + CS_Event_UUID + RID
When an instance is created in a view, “View:” + sequential_instance_number + “:” + CS_Event_UID (where the sequential_instance_number is zero when it is not a repeating event) is used to identify that event in the view.
CS_Event_UID (well, mostly the “View:” variant) is used for communication between 4D and CalendarSet.
When you click an event (CS_Area_ClickedEventID), you get this, not CS_Event_UUID.
Example: repeating event (created in Calendar.app)

BEGIN:VEVENT
TRANSP:OPAQUE
DTEND;TZID=Europe/Bratislava:20200613T100000
X-APPLE-TRAVEL-ADVISORY-BEHAVIOR:AUTOMATIC
UID:A7AA7EA3-532C-4F76-BDBC-CD0F706110C1
DTSTAMP:20200614T095222Z
SEQUENCE:0
SUMMARY:Repeating Event
LAST-MODIFIED:20200614T095314Z
DTSTART;TZID=Europe/Bratislava:20200613T090000
CREATED:20200614T095114Z
RRULE:FREQ=WEEKLY;INTERVAL=1;COUNT=5
END:VEVENT

Now you change one instance (move event from 20.6. to 21.6.) - the modified recurrence instance is added:

BEGIN:VEVENT
TRANSP:OPAQUE
DTEND;TZID=Europe/Bratislava:20200613T100000
X-APPLE-TRAVEL-ADVISORY-BEHAVIOR:AUTOMATIC
UID:A7AA7EA3-532C-4F76-BDBC-CD0F706110C1
DTSTAMP:20200614T095222Z
SEQUENCE:0
SUMMARY:Repeating Event
LAST-MODIFIED:20200614T095314Z
DTSTART;TZID=Europe/Bratislava:20200613T090000
CREATED:20200614T095114Z
RRULE:FREQ=WEEKLY;INTERVAL=1;COUNT=5
END:VEVENT
BEGIN:VEVENT
CREATED:20200614T095114Z
UID:A7AA7EA3-532C-4F76-BDBC-CD0F706110C1
DTEND;TZID=Europe/Bratislava:20200621T100000
TRANSP:OPAQUE
X-APPLE-TRAVEL-ADVISORY-BEHAVIOR:AUTOMATIC
SUMMARY:Repeating Event
LAST-MODIFIED:20200614T095259Z
DTSTAMP:20200614T095222Z
DTSTART;TZID=Europe/Bratislava:20200621T090000
SEQUENCE:0
RECURRENCE-ID;TZID=Europe/Bratislava:20200620T090000
END:VEVENT
CS_Event_VCAL text iCal event format w/o “BEGIN:VCALENDAR”
CS_Event_VEVT text iCal event format
CS_Event_WeekStartint 060 = Sunday, 1 = Monday, …, 6 = Saturday
CS_Event_XML text
event_event_properties.txt · Last modified: 2020/06/17 17:22 by cs_admin