Tizen Native API  7.0
View/Property

This page provides information about views with properties.

Overview

A view is a structure which describes properties of a record. A record can have basic properties of four types: integer, string, long integer. Each property of basic type has functions to operate on it:

Property Setter Getter
integer calendar_record_set_int() calendar_record_get_int()
long long integer calendar_record_set_lli() calendar_record_get_lli()
double calendar_record_set_double() calendar_record_get_double()
string calendar_record_set_str() calendar_record_get_str()
calendar_time_s calendar_record_set_caltime() calendar_record_get_caltime()

For long long integer functions, "lli" stands for long long int, usually used to hold UTC time. Below you can find tables with view properties. Properties of type 'record' are other records. For example, the _calendar_event view has a 'calendar_alarm' property of type 'record'. This means that records of type calendar_alarm (_calendar_alarm view) can be children of the event record. If a name record holds the identifier of a event record in its 'event_id' property, it is the child record of the corresponding event record. Records can have many children of a given type. Please refer to the main section of Calendar API for a more detailed explanation and examples.

Required Header

#include <calendar.h>

_calendar_book view

Type Property ID Read, Write Description
string _uri read only Identifier of this calendar book view
integer id read only DB record ID of the calendar book
string uid read, write Unique identifier
string name read, write Calendar book name
string description read, write Calendar book description
string color read, write Calendar book color for UX
string location read, write Location of the event
integer visibility read, write Visibility of the calendar book for UX
integer sync_event read, write Currently NOT Used
integer account_id read, write once Account for this calendar
integer store_type read, write Type of calendar contents(refer to the calendar_book_type_e)
string sync_data1 read, write Generic data for use by syncing
string sync_data2 read, write Generic data for use by syncing
string sync_data3 read, write Generic data for use by syncing
string sync_data4 read, write Generic data for use by syncing
integer mode read, write Calendar book mode (refer to the calendar_book_mode_e)

_calendar_event view

Type Property ID Read, Write Description
string _uri read only Identifier of this event view
integer id read only DB record ID of the event
integer calendar_book_id read, write ID of the calendar book to which the event belongs
string summary read, write The short description of the event
string description read, write The description of the event
string location read, write The location of the event
string categories read, write The category of the event. For example APPOINTMENT, BIRTHDAY
string exdate read, write The exception list of the event. If this event has a recurrence rule, the instance of the exdate is removed. Format is "YYYYMMDD"(allday event) or "YYYYMMDDTHHMMSS". Multiple exceptions can be included with a comma
integer event_status read, write Refer to the calendar_event_status_e
integer priority read, write Refer to the calendar_event_priority_e
integer timezone read, write The timezone_id of the event if it exists. Refer to the _calendar_timezone view
integer person_id read, write The person_id of the event if the event is a birthday. Refer to the contacts-service
integer busy_status read, write Refer to the calendar_event_busy_status_e
integer sensitivity read, write Refer to the calendar_sensitivity_e
string uid read, write The unique ID of the event
string organizer_name read, write The name of organizer of the event
string organizer_email read, write The email address of the organizer of the event
integer meeting_status read, write Refer to the calendar_meeting_status_e
integer original_event_id read, write The ID of the original event if the event is an exception.
double latitude read, write The latitude of the location of the event
double longitude read, write The longitude of the location of the event
integer email_id read, write ID of the email_id. Refer to the email-service.
long long int created_time read, write The time when the event is created
long long int last_modified_time read only The time when the event is updated
integer is_deleted read only
integer freq read, write The frequent type of event recurrence. Refer to the calendar_recurrence_frequency_e
integer range_type read, write Refer to the calendar_range_type_e
calendar time until_time read, write The end time of the event recurrence. If the range_type is CALENDAR_RANGE_UNTIL
integer count read, write The count of the event recurrence. If the range_type is CALENDAR_RANGE_COUNT
integer interval read, write The interval of the event recurrence
string bysecond read, write The second list of the event recurrence. The value can be from 0 to 59. The list is seperated by commas
string byminute read, write The minute list of the event recurrence. The value can be from 0 to 59. The list is seperated by commas
string byhour read, write The hour list of the event recurrence. The value can be from 0 to 23. The list is seperated by commas
string byday read, write The day list of the event recurrence. The value can be SU, MO, TU, WE, TH, FR, SA. The list is seperated by commas
string bymonthday read, write The month day list of the event recurrence. The value can be from 1 to 31 and from -31 to -1. The list is seperated by commas
string byyearday read, write The year day list of the event recurrence. The value can be from 1 to 366 and from -366 to -1. The list is seperated by commas
string byweekno read, write The week number list of the event recurrence. The value can be from 1 to 53 and from -53 to -1. The list is seperated by commas
string bymonth read, write The month list of the event recurrence. The value can be from 1 to 12. The list is seperated by commas
string bysetpos read, write The position list of the event recurrence. The value can be from 1 to 366 and from -366 to -1. The list is seperated by commas
integer wkst read, write The start day of the week. Refer to the calendar_days_of_week_e
string recurrence_id read, write RECURRENCE-ID of RFC #2445
string rdate read, write RDATE of RFC #2445
integer has_attendee read only Whether or not the event has an attendee list
integer has_alarm read only Whether or not the event has an alarm list
integer calendar_system_type read, write Refer to the calendar_system_type_e
string sync_data1 read, write The sync data of the event. If developer need to save some information related to the event, they can use this property
string sync_data2 read, write The sync data of the event. If developer need to save some information related to the event, they can use this property
string sync_data3 read, write The sync data of the event. If developer need to save some information related to the event, they can use this property
string sync_data4 read, write The sync data of the event. If developer need to save some information related to the event, they can use this property
calendar time start_time read, write The start time of the event
string start_tzid read, write The timezone of the start_time
calendar time end_time read, write The end time of the event
string end_tzid read, write The timezone of the end_time
child list calendar_alarm read, write The alarm list of the event. Refer to the _calendar_alarm view
child list calendar_attendee read, write The attendee list of the event. Refer to the _calendar_attendee view
child list exception read, write The exception mod event list of the event
child list extended read, write The extended property list of the event. Refer to the _calendar_extended_property view (read only)
integer is_allday read only The event is an allday event or not
integer link_count read only The event is a linked event (Since 4.0)
integer link_base_id read only The event is a base linked event (Since 4.0)

_calendar_todo view

Type Property ID Read, Write Description
string _uri read only Identifier of this todo view
integer id read only DB record ID of the todo
integer calendar_book_id read, write ID of the calendar book to which the todo belongs
string summary read, write The short description of the todo
string description read, write The description of the todo
string location read, write The location of the todo
string categories read, write The category of the todo. For example APPOINTMENT, BIRTHDAY
integer todo_status read, write Refer to the calendar_todo_status_e
integer priority read, write Refer to the calendar_todo_priority_e
integer sensitivity read, write Refer to the calendar_sensitivity_e
string uid read, write The unique ID of the todo
double latitude read, write The latitude of the location of the todo
double longitude read, write The longitude of the location of the todo
long long int created_time read, write The time when the todo is created
long long int last_modified_time read only The time when the todo is updated
long long int completed_time read, write The time when the todo is completed
integer progress read, write The progression of the todo. The value can be from 0 to 100
integer is_deleted read only
integer freq read, write The frequent type of todo recurrence. Refer to the calendar_recurrence_frequency_e
integer range_type read, write Refer to the calendar_range_type_e
calendar time until_time read, write The end time of the todo recurrence. If the range_type is CALENDAR_RANGE_UNTIL
integer count read, write The count of the todo recurrence. If the range_type is CALENDAR_RANGE_COUNT
integer interval read, write The interval of the todo recurrence
string bysecond read, write The second list of the todo recurrence. The value can be from 0 to 59. The list is seperated by commas
string byminute read, write The minute list of the todo recurrence. The value can be from 0 to 59. The list is seperated by commas
string byhour read, write The hour list of the todo recurrence. The value can be from 0 to 23. The list is seperated by commas
string byday read, write The day list of the todo recurrence. The value can be SU, MO, TU, WE, TH, FR, SA. The list is seperated by commas
string bymonthday read, write The month day list of the todo recurrence. The value can be from 1 to 31 and from -31 to -1. The list is seperated by commas
string byyearday read, write The year day list of the todo recurrence. The value can be from 1 to 366 and from -366 to -1. The list is seperated by commas
string byweekno read, write The week number list of the todo recurrence. The value can be from 1 to 53 and from -53 to -1. The list is seperated by commas
string bymonth read, write The month list of the todo recurrence. The value can be from 1 to 12. The list is seperated by commas
string bysetpos read, write The position list of the todo recurrence. The value can be from 1 to 366 and from -366 to -1. The list is seperated by commas
integer wkst read, write The start day of the week. Refer to the calendar_days_of_week_e
integer has_alarm read only Whether or not the todo has an alarm list
string sync_data1 read, write The sync data of the todo. If developers need to save some information related to the todo, they can use this property
string sync_data2 read, write The sync data of the todo. If developers need to save some information related to the todo, they can use this property
string sync_data3 read, write The sync data of the todo. If developers need to save some information related to the todo, they can use this property
string sync_data4 read, write The sync data of the todo. If developers need to save some information related to the todo, they can use this property
calendar time start_time read, write The start time of the todo
string start_tzid read, write The timezone of the start_time
calendar time due_time read, write The due time of the todo
string due_tzid read, write The timezone of the due_time
child list calendar_alarm read, write The alarm list of the todo. Refer to the _calendar_alarm view
string organizer_name read, write The name of the organizer of the event
string organizer_email read, write The email address of the organizer of the event
integer has_attendee read only Whether or not the todo has an attendee list
child list calendar_attendee read, write The attendee list of the todo. Refer to the _calendar_attendee view
child list extended read, write The extended property list of the todo. Refer to the _calendar_extended_property view (read only)
integer is_allday read only The todo is an allday event or not

_calendar_timezone view

Type Property ID Read, Write Description
string _uri read only Identifier of this timezone view
integer id read only DB record ID of the timezone
integer calendar_book_id read, write DB record ID of a related calendar book
integer tz_offset_from_gmt read, write UTC offset which is in use when the onset of this time zone observance begins. Valid values are -720(-12:00) to 840(+14:00)
string standard_name read, write Name of the Standard Time
integer standard_start_month read, write Starting month of the Standard Time. Month is 0-based. eg, 0 for January
integer standard_start_position_of_week read, write Starting day-of-week-in-month of the Standard Time. Day is 1-based
integer standard_start_day read, write Starting day-of-week of the Standard Time. Valid values are 1(SUNDAY) to 7(SATURDAY)
integer standard_start_hour read, write Starting hour of the Standard Time. Valid values are 0 to 23
integer standard_bias read, write The number of minutes added during the Standard Time
string day_light_name read, write Name of Daylight
integer day_light_start_month read, write Starting month of Daylight. Month is 0-based. eg, 0 for January
integer day_light_start_position_of_week read, write Starting day-of-week-in-month of Daylight. Day is 1-based
integer day_light_start_day read, write Starting day-of-week of Daylight. Valid values are 1(SUNDAY) to 7(SATURDAY)
integer day_light_start_hour read, write Starting hour of Daylight. Valid values are 0 to 23
integer day_light_bias read, write The number of minutes added during Daylight Time

_calendar_attendee view

Type Property ID Read, Write Description
string _uri read only Identifier of this calendar attendee view
integer event_id read only Event/TODO that the attendee belongs to
string number read, write The number of the attendee
integer cutype read, write The type of attendee (one of CALENDAR_ATTENDEE_CUTYPE_INDIVIDUAL, CALENDAR_ATTENDEE_CUTYPE_GROUP, CALENDAR_ATTENDEE_CUTYPE_RESOURCE, CALENDAR_ATTENDEE_CUTYPE_ROOM, CALENDAR_ATTENDEE_CUTYPE_UNKNOWN)
integer person_id read, write Person ID that the attendee belongs to
string uid read, write Unique identifier
string email read, write The email address of the attendee
integer role read, write Attendee role (one of CALENDAR_ATTENDEE_ROLE_REQ_PARTICIPANT, CALENDAR_ATTENDEE_ROLE_OPT_PARTICIPANT, CALENDAR_ATTENDEE_ROLE_NON_PARTICIPANT, CALENDAR_ATTENDEE_ROLE_CHAIR)
integer status read, write Attendee status (one of CALENDAR_ATTENDEE_STATUS_PENDING, CALENDAR_ATTENDEE_STATUS_ACCEPTED, CALENDAR_ATTENDEE_STATUS_DECLINED, CALENDAR_ATTENDEE_STATUS_TENTATIVE, CALENDAR_ATTENDEE_STATUS_DELEGATED, CALENDAR_ATTENDEE_STATUS_COMPLETED, CALENDAR_ATTENDEE_STATUS_IN_PROCESS)
integer rsvp read, write RSVP invitation reply (one of true, false)
string delegatee_uri read, write Delegatee (DELEGATED-TO)
string delegator_uri read, write Delegator (DELEGATED-FROM)
string name read, write Attendee name
string member read, write Group that the attendee belongs to

_calendar_alarm view

Type Property ID Read, Write Description
string _uri read only Identifier of this calendar alarm view
integer parent_id read only Event that the alarm belongs to
integer type read, write Currently NOT used
long long int time read, write The alarm time of the event(This represents the number of seconds elapsed since the Epoch, 1970-01-01 00:00:00 +0000(UTC)). This MUST be used with CALENDAR_ALARM_TIME_UNIT_SPECIFIC
integer tick read, write The number of unit before start time. This MUST be used with one of CALENDAR_ALARM_TIME_UNIT_MINUTE, CALENDAR_ALARM_TIME_UNIT_HOUR, CALENDAR_ALARM_TIME_UNIT_DAY, CALENDAR_ALARM_TIME_UNIT_WEEK.
integer tick_unit read, write Reminder tick time unit (one of CALENDAR_ALARM_NONE, CALENDAR_ALARM_TIME_UNIT_SPECIFIC, CALENDAR_ALARM_TIME_UNIT_MINUTE, CALENDAR_ALARM_TIME_UNIT_HOUR, CALENDAR_ALARM_TIME_UNIT_DAY, CALENDAR_ALARM_TIME_UNIT_WEEK)
string attach read, write Alarm tone path
string summary read, write Alarm summary
string description read, write Alarm description
integer action read, write Action of alarm (one of CALENDAR_ALARM_ACTION_AUDIO, CALENDAR_ALARM_ACTION_DISPLAY, CALENDAR_ALARM_ACTION_EMAIL)
calendar time alarm_time read, write The alarm time

_calendar_updated_info view (read only)

Type Property ID Description
string _uri Identifier of this updated_info view
integer id Modified event(or todo) record ID
integer calendar_book_id Calendar book ID of the modified event(or todo) record
integer modified_status Enumeration value of the modified status (calendar_record_modified_status_e)
integer version Version after change

_calendar_event_calendar_book view (read only)

Type Property ID
string _uri
integer event_id
integer calendar_book_id
string summary
string description
string location
string categories
string exdate
integer event_status
integer priority
integer timezone
integer person_id
integer busy_status
integer sensitivity
string uid
string organizer_name
string organizer_email
integer meeting_status
integer original_event_id
double latitude
double longitude
integer email_id
long long int created_time
long long int last_modified_time
integer freq
integer range_type
calendar time until_time
integer count
integer interval
string bysecond
string byminute
string byhour
string byday
string bymonthday
string byyearday
string byweekno
string bymonth
string bysetpos
integer wkst
string recurrence_id
string rdate
integer has_attendee
integer has_alarm
integer calendar_system_type
string sync_data1
string sync_data2
string sync_data3
string sync_data4
calendar time start_time
string start_tzid
calendar time end_time
string end_tzid
filter integer calendar_book_visibility
filter integer calendar_book_account_id

_calendar_todo_calendar_book view (read only)

Type Property ID
string _uri
integer todo_id
integer calendar_book_id
string summary
string description
string location
string categories
integer todo_status
integer priority
integer sensitivity
string uid
double latitude
double longitude
long long int created_time
long long int last_modified_time
long long int completed_time
integer progress
integer freq
integer range_type
calendar time until_time
integer count
integer interval
string bysecond
string byminute
string byhour
string byday
string bymonthday
string byyearday
string byweekno
string bymonth
string bysetpos
integer wkst
integer has_alarm
string sync_data1
string sync_data2
string sync_data3
string sync_data4
calendar time start_time
string start_tzid
calendar time due_time
string due_tzid
filter integer calendar_book_visibility
filter integer calendar_book_account_id

_calendar_event_calendar_book_attendee view (read only)

Type Property ID
string _uri
integer event_id
integer calendar_book_id
string summary
string description
string location
string categories
string exdate
integer event_status
integer priority
integer timezone
integer person_id
integer busy_status
integer sensitivity
string uid
string organizer_name
string organizer_email
integer meeting_status
integer original_event_id
double latitude
double longitude
integer email_id
long long int created_time
long long int last_modified_time
integer freq
integer range_type
calendar time until_time
integer count
integer interval
string bysecond
string byminute
string byhour
string byday
string bymonthday
string byyearday
string byweekno
string bymonth
string bysetpos
integer wkst
string recurrence_id
string rdate
integer has_attendee
integer has_alarm
integer calendar_system_type
string sync_data1
string sync_data2
string sync_data3
string sync_data4
calendar time start_time
string start_tzid
calendar time end_time
string end_tzid
filter integer calendar_book_visibility
filter integer calendar_book_account_id
filter string attendee_email
filter string attendee_name
filter string attendee_member

_calendar_instance_utime_calendar_book view

Type Property ID
string _uri
integer event_id
calendar time start_time
calendar time end_time
string summary
string location
integer calendar_book_id
string description
integer busy_status
integer event_status
integer priority
integer sensitivity
integer has_rrule
double latitude
double longitude
integer has_alarm
integer original_event_id
filter integer calendar_book_visibility
filter integer calendar_book_account_id
long long int last_modified_time
string sync_data1

_calendar_instance_localtime_calendar_book view

Type Property ID
string _uri
integer event_id
calendar time start_time
calendar time end_time
string summary
string location
integer calendar_book_id
string description
integer busy_status
integer event_status
integer priority
integer sensitivity
integer has_rrule
double latitude
double longitude
integer has_alarm
integer original_event_id
filter integer calendar_book_visibility
filter integer calendar_book_account_id
long long int last_modified_time
string sync_data1
int is_allday

_calendar_instance_utime_calendar_book_extended view

Type Property ID
string _uri
integer event_id
calendar time start_time
calendar time end_time
string summary
string location
integer calendar_book_id
string description
integer busy_status
integer event_status
integer priority
integer sensitivity
integer has_rrule
double latitude
double longitude
integer has_alarm
integer original_event_id
filter integer calendar_book_visibility
filter integer calendar_book_account_id
string organizer_name
string categories
integer has_attendee
string sync_data1
string sync_data2
string sync_data3
string sync_data4

_calendar_instance_localtime_calendar_book_extended view

Type Property ID
string _uri
integer event_id
calendar time start_time
calendar time end_time
string summary
string location
integer calendar_book_id
string description
integer busy_status
integer event_status
integer priority
integer sensitivity
integer has_rrule
double latitude
double longitude
integer has_alarm
integer original_event_id
filter integer calendar_book_visibility
filter integer calendar_book_account_id
string organizer_name
string categories
integer has_attendee
string sync_data1
string sync_data2
string sync_data3
string sync_data4

_calendar_extended_property view (read only)

Type Property ID Read, Write Description
string _uri read only Identifier of this extended_property view
integer id read only DB record ID of the extended_property
integer record_id read,write Related record ID
integer record_type read, write Enumeration value of the record type (calendar_record_type_e)
string key read, write The key of the property
string value read, write The value of the property