Tizen Native API
4.0
|
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 | 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 |