/**
* @brief Called when a designated view changes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] view_uri The view URI
* @param[in] user_data The user data passed from the callback registration function
* @see calendar_db_add_changed_cb()
/**
* @brief Inserts a record into the calendar database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] record The record handle
* @brief Gets a record from the calendar database.
* @details This function creates a new record handle from the calendar database by the given @a record_id. \n
* @a record will be created and filled with record information.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @remarks You must release @a record using calendar_record_destroy().
/**
* @brief Updates a record in the calendar database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] record The record handle
/**
* @brief Deletes a record from the calendar database with related child records.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] view_uri The view URI of a record
/**
* @brief Retrieves all records as a list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @remarks You must release @a record_list using calendar_list_destroy().
/**
* @brief Retrieves records using a query handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @remarks You must release @a record_list using calendar_list_destroy().
/**
* @brief Gets the record count of a specific view.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @param[in] view_uri The view URI to get records from
/**
* @brief Gets the record count with a query handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @param[in] query The query handle used for filtering the results
/**
* @brief Inserts multiple records into the calendar database as a batch operation.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] record_list The record list handle
/**
* @brief Updates multiple records into the calendar database as a batch operation.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] record_list The record list handle
/**
* @brief Deletes multiple records with related child records from the calendar database as a batch operation.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] view_uri The view URI of the records to delete
/**
* @brief Gets the current calendar database version.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @param[out] calendar_db_version The calendar database version
/**
* @brief Registers a callback function to be invoked when a record changes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @remarks If successive change notification produced on the view_uri are identical,
/**
* @brief Unregisters a callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @param[in] view_uri The view URI of the record to subscribe for change notifications
/**
* @brief Retrieves records with the given calendar database version.
* @details This function finds all the changed records since the given @a calendar_db_version.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @remarks You must release @a change_record_list using calendar_list_destroy().
/**
* @brief Inserts a vcalendar stream into the calendar database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] vcalendar_stream The vcalendar stream
/**
* @brief Replaces a vcalendar stream in the calendar database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] vcalendar_stream The vcalendar stream
/**
* @brief Replaces a record in the calendar database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] record The record handle
/**
* @brief Replaces multiple records in the calendar database as a batch operation.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] record_list The record list handle
/**
* @brief Gets the last successful change version of the database on the current connection.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @param[out] last_change_version The calendar database version on the current connection
* @brief Retrieves changed exception records since the given calendar database version.
* Exceptions are the modified or deleted instances in a recurring event.
* @details This function finds all the changed records since the given @a calendar_db_version.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @remarks You must release @a change_record_list using calendar_list_destroy().
/**
* @brief Cleans the data after sync.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.write
* @param[in] calendar_book_id The calendar book ID
/**
* @brief Enumeration for calendar errors.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
/**
* @brief Creates a filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a filter using calendar_filter_destroy().
* @param[in] view_uri The view URI of a filter
* @param[out] filter The filter handle
/**
* @brief Destroys a filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Adds a condition for the string type property.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @param[in] property_id The property ID to add a condition
* @param[in] match The match flag
/**
* @brief Adds a condition for the integer type property.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @param[in] property_id The property ID to add a condition
* @param[in] match The match flag
/**
* @brief Adds a condition for the double type property.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @param[in] property_id The property ID to add a condition
* @param[in] match The match flag
/**
* @brief Adds a condition for the long long int type property.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @param[in] property_id The property ID to add a condition
* @param[in] match The match flag
/**
* @brief Adds a condition for the calendar_time_s type property.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @param[in] property_id The property ID to add a condition
* @param[in] match The match flag
/**
* @brief Adds a child filter to a parent filter.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] parent_filter The parent filter handle
* @param[in] child_filter The child filter handle
* @return @c 0 on success,
/**
* @brief Adds an operator between conditions.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] filter The filter handle
* @param[in] operator_type The operator type
* @return @c 0 on success,
/**
* @brief Creates a calendar list handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a calendar_list using calendar_list_destroy().
* @param[out] out_list The calendar list handle
* @return @c 0 on success,
/**
* @brief Destroys a calendar list handle and releases all its resources.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @param[in] delete_record If @c true, child records are destroyed automatically,
* otherwise @c false
/**
* @brief Retrieves the number of calendar entities in a calendar list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @param[out] count The count of the calendar entity
* @return @c 0 on success,
/**
* @brief Adds a record to the calendar list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @param[in] record The record handle
* @return @c 0 on success,
* @brief Removes a record from the calendar list.
* @details If the record is the current record, then the current record is changed to the next record.\n
* If the record is the last record then the current record will be @c NULL.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @param[in] record The record handle
* @return @c 0 on success,
/**
* @brief Retrieves a record from the calendar list.
* @details The default current record is the first record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You MUST NOT destroy the @a record handle.
* It is destroyed automatically when the @a list is destroyed.
* @param[in] list The calendar list handle
/**
* @brief Moves a calendar list to the previous position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Moves a calendar list to the next position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Moves a calendar list to the first position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Moves a calendar list to the last position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] list The calendar list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Creates a query handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a query using calendar_query_destroy().
* @param[in] view_uri The view URI of a query
* @param[out] query The filter handle
/**
* @brief Destroys a query handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] query The query handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Adds property IDs for projection.
* @details Property IDs can be of one of the properties of view_uri which is used in calendar_query_create().
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] query The query handle
* @param[in] property_id_array The property ID array
* @param[in] count The number of property IDs
/**
* @brief Sets the "distinct" option for projection.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] query The query handle
* @param[in] set If @c true it is set,
* otherwise if @c false it is unset
/**
* @brief Sets the filter for a query.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] query The query handle
* @param[in] filter The filter handle
* @return @c 0 on success,
/**
* @brief Sets the sort mode for a query.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] query The query handle
* @param[in] property_id The property ID to sort
* @param[in] is_ascending If @c true it sorts in the ascending order,
/**
* @brief Creates a record handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a record using calendar_record_destroy().
* @param[in] view_uri The view URI
* @param[out] out_record The record handle
/**
* @brief Destroys a record handle and releases all its resources.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] delete_child If @c true, child records are destroyed automatically,
* otherwise @c false
/**
* @brief Makes a clone of a record handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a cloned_record using calendar_record_destroy().
* @param[in] record The record handle
* @param[out] out_record The cloned record handle
/**
* @brief Gets a URI string from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[out] uri The URI of the record
* @return @c 0 on success,
/**
* @brief Gets a string from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a value using free().
* @param[in] record The record handle
* @param[in] property_id The property ID
/**
* @brief Gets a string pointer from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You MUST NOT release @a value.
* @param[in] record The record handle
* @param[in] property_id The property ID
/**
* @brief Gets an integer value from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[out] out_value The result value
/**
* @brief Gets a double value from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[out] out_value The result value
/**
* @brief Gets a long long integer value from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[out] out_value The result value
/**
* @brief Gets a calendar_caltime_s value from a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[out] out_value The result value
/**
* @brief Sets a string to a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[in] value The value to be set
/**
* @brief Sets an integer value to a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[in] value The value to be set
/**
* @brief Sets a double value to a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[in] value The value to be set
/**
* @brief Sets a long long integer value to a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[in] value The value to be set
/**
* @brief Sets a calendar_time_s value to a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle
* @param[in] property_id The property ID
* @param[in] value The value to be set
/**
* @brief Adds a child record to the parent record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The parent record handle
* @param[in] property_id The property ID
* @param[in] child_record The handle of the child record to be added to the parent record
/**
* @brief Removes a child record from the parent record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The parent record handle
* @param[in] property_id The property ID
* @param[in] child_record The handle of the child record to be removed from the parent record
/**
* @brief Gets the number of child records in a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The parent record handle
* @param[in] property_id The property ID
* @param[out] count The child record count
/**
* @brief Gets a child record handle pointer from the parent record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You MUST NOT release @a child_record. \n
* It is released when the parent record handle is destroyed.
* @param[in] record The record handle
/**
* @brief Makes a clone of a given record's child record list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a out_list using calendar_list_destroy().
* @param[in] record The record handle
* @param[in] property_id The property ID
/**
* @brief Called when an alarm is alerted.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] param Value string like id=value&time=value&tick=value&unit=value&type=value
* @param[in] user_data The user data passed from the callback registration function
* @see calendar_reminder_add_cb()
/**
* @brief Adds a callback to get a notification when an alarm gives an alert.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/calendar.read
* @param[in] callback The callback to be added
/**
* @brief Removes a callback to get a notification when an alarm gives an alert.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] callback The callback to be removed
* @param[in] user_data The user data
* @return @c 0 on success,
/**
* @brief Connects to the calendar service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks Opening the connection is necessary to access the calendar database and perform operations such as fetching, inserting, or updating records.\n
* The execution of calendar_connect() and calendar_disconnect() could slow down your application, so you are recommended not to call them frequently.
* @return @c 0 on success,
/**
* @brief Disconnects from the calendar service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks If there is no open connection, this function returns #CALENDAR_ERROR_DB_FAILED.
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Connects to the calendar service on a thread.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks Opening a connection is necessary to access the calendar database and perform operations such as fetching, inserting, or updating records.\n
* On a thread environment with calendar_connect(), request in one thread could fail, while another request connection is working in the other thread.
* To prevent request failure, calendar_connect_on_thread() is recommended.
/**
* @brief Disconnects from the calendar service on a thread.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks If there is no open connection, this function returns #CALENDAR_ERROR_DB_FAILED.
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Connects to the calendar service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @remarks Opening a connection is necessary to access the calendar database and perform operations such as fetching, inserting, or updating records.\n
* Before the calendar-service daemon is ready, if you call calendar_connect(), it could fail.
* It is recommended to call this API with #CALENDAR_CONNECT_FLAG_RETRY flags in such a situation.
/**
* @brief Handle for calendar record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
_CALENDAR_HANDLE(calendar_record_h)
/**
* @brief Handle for calendar filter.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
_CALENDAR_HANDLE(calendar_filter_h)
/**
* @brief Handle for calendar list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
_CALENDAR_HANDLE(calendar_list_h)
/**
* @brief Handle for calendar query.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
_CALENDAR_HANDLE(calendar_query_h)
/**
* @brief The calendar handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
_CALENDAR_HANDLE(calendar_h)
/**
* @brief Definition for a calendar connect flag.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_CONNECT_FLAG_NONE 0x00000000
/**
* @brief Definition for a calendar connect flag.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_CONNECT_FLAG_RETRY 0x00000001
/**
* @brief Definition for a default event calendar book database ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define DEFAULT_EVENT_CALENDAR_BOOK_ID 1
/**
* @brief Definition for a default to-do calendar book database ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define DEFAULT_TODO_CALENDAR_BOOK_ID 2
/**
* @brief Definition for a default birthday calendar book database ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define DEFAULT_BIRTHDAY_CALENDAR_BOOK_ID 3
/**
* @brief Definition for no due date of a to-do.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_TODO_NO_DUE_DATE INT64_MAX
/**
* @brief Definition for no start date of a to-do.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_TODO_NO_START_DATE (-INT64_MAX)
/**
* @brief Definition for no until of a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_RECORD_NO_UNTIL INT64_MAX
/**
* @brief Definition for no coordinate(latitude/longitude) of a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_RECORD_NO_COORDINATE 1000.0
/**
* @brief Definition for all calendar books.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
#define CALENDAR_BOOK_FILTER_ALL -1
/**
* @brief Enumeration for the filter match type of a string.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_MATCH_EXACTLY, /**< Full string, case-sensitive */
/**
* @brief Enumeration for the filter match type of an integer.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_MATCH_EQUAL, /**< '=' */
/**
* @brief Enumeration for a filter operator.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_FILTER_OPERATOR_AND, /**< AND */
/**
* @brief Enumeration for the calendar book type.
* @details "OR"ing is supported.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_BOOK_TYPE_NONE = 0, /**< Default calendar book type */
/**
* @brief Enumeration for the calendar sensitivity type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_SENSITIVITY_PUBLIC = 0, /**< Public Sensitivity */
/**
* @brief Enumeration for the attendee status.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_ATTENDEE_STATUS_PENDING = 0, /**< Pending status */
/**
* @brief Enumeration for the attendee role.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_ATTENDEE_ROLE_REQ_PARTICIPANT = 0, /**< Participation is required */
/**
* @brief Enumeration for the attendee cutype.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_ATTENDEE_CUTYPE_INDIVIDUAL = 0, /**< Individual cutype */
/**
* @brief Enumeration for the alarm time unit type of an event, such as minutes, hours, days, and so on.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_ALARM_NONE = -1, /**< No reminder set */
/**
* @brief Enumeration for the alarm action.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_ALARM_ACTION_AUDIO = 0, /**< Audio action */
/**
* @brief Enumeration for the frequency of an event's recurrence.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_RECURRENCE_NONE, /**< No recurrence event */
/**
* @brief Enumeration for the event status.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_EVENT_STATUS_NONE = 0x01, /**< No status */
/**
* @brief Enumeration for the busy status of an event.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_EVENT_BUSY_STATUS_FREE = 0, /**< The free status */
/**
* @brief Enumeration for the calendar event item's priority.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_EVENT_PRIORITY_NONE = 0x01, /**< No priority */
/**
* @brief Enumeration for the calendar to-do item's priority.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_TODO_PRIORITY_NONE = 0x01, /**< No priority */
/**
* @brief Enumeration for the status of a to-do.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_TODO_STATUS_NONE = 0x0100, /**< No status */
/**
* @brief Enumeration for the time type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_TIME_UTIME = 0, /**< Unix time */
/**
* @brief Enumeration for the range type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_RANGE_UNTIL, /**< Range until */
/**
* @brief Enumeration for the system type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_SYSTEM_NONE, /**< Locale's default calendar */
/**
* @brief Enumeration for the meeting status.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_MEETING_STATUS_NOTMEETING = 0, /**< No meeting */
/**
* @brief Enumeration for weekdays.
* @details Same value as UCalendarDaysOfWeek in ICU.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_SUNDAY = 1, /**< Sunday */
/**
* @brief Enumeration for the modified status of a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_RECORD_MODIFIED_STATUS_INSERTED = 0, /**< The record is inserted */
/**
* @brief The structure of time.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef struct {
calendar_time_type_e type; /**< type */
/**
* @brief Enumeration for the type of a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_RECORD_TYPE_NONE = 0, /**< No record type */
/**
* @brief Enumeration for the book mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_BOOK_MODE_NONE = 0, /**< All modules can read and write records of this calendar_book */
/**
* @brief Enumeration for the sync event type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CALENDAR_BOOK_SYNC_EVENT_FOR_ME = 0, /**< This book would not be synced to others except me */
/**
* @brief Retrieves a vcalendar stream from a calendar list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] calendar_list The calendar list handle
* @param[out] vcalendar_stream The vcalendar stream
* @return @c 0 on success,
/**
* @brief Retrieves all calendars from a vcalendar stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] vcalendar_stream The vcalendar stream
* @param[out] calendar_list The calendar list handle
* @return @c 0 on success,
/**
* @brief Called to get a record handle of
* \ref CAPI_SOCIAL_CALENDAR_SVC_VIEW_MODULE_calendar_event or \ref CAPI_SOCIAL_CALENDAR_SVC_VIEW_MODULE_calendar_todo.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] record The record handle (\ref CAPI_SOCIAL_CALENDAR_SVC_VIEW_MODULE_calendar_event or \ref CAPI_SOCIAL_CALENDAR_SVC_VIEW_MODULE_calendar_todo)
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop,
/**
* @brief Retrieves all events or to-dos
* (\ref CAPI_SOCIAL_CALENDAR_SVC_VIEW_MODULE_calendar_event or \ref CAPI_SOCIAL_CALENDAR_SVC_VIEW_MODULE_calendar_todo) from a vCalendar file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @elseif TV 4.0 @endif
+ * @since_tizen 2.3
* @param[in] vcalendar_file_path The file path of the vCalendar stream file
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function