Tizen Native API  6.0
Watchface complication

All watch applications can request data shared by other watchface complication provider applications using watchface complication.

Required Header

#include <watchface-complication.h>

Overview

It provides watchface complication data request and receive service.

Functions

int watchface_complication_get_current_provider_id (complication_h handle, char **cur_provider)
 Gets the id of provider in the complication.
int watchface_complication_get_current_type (complication_h handle, watchface_complication_type_e *cur_type)
 Gets the currently set type of the complication.
int watchface_complication_add_updated_cb (complication_h handle, watchface_complication_updated_cb cb, watchface_complication_error_cb error_cb, void *user_data)
 Adds the callback function to use for complication update.
int watchface_complication_remove_updated_cb (complication_h handle, watchface_complication_updated_cb cb)
 Removes the callback function.
int watchface_complication_send_update_request (complication_h handle)
 Sends request the provider to update the complication.
int watchface_complication_create (int complication_id, const char *default_provider_id, watchface_complication_type_e default_type, int supported_types, int supported_event_types, complication_h *created_handle)
 Creates a complication handle.
int watchface_complication_destroy (complication_h handle)
 Destroys a complication handle.
int watchface_complication_data_get_type (const bundle *data, watchface_complication_type_e *type)
 Gets data type of complication data.
int watchface_complication_data_get_short_text (const bundle *data, char **short_text)
 Gets short text from complication data.
int watchface_complication_data_get_long_text (const bundle *data, char **long_text)
 Gets long text from complication data.
int watchface_complication_data_get_title (const bundle *data, char **title)
 Gets title text from complication data.
int watchface_complication_data_get_timestamp (const bundle *data, long *timestamp) TIZEN_DEPRECATED_API
 Gets timestamp from complication data.
int watchface_complication_data_get_timeinfo (const bundle *data, complication_time_info_h *info)
 Gets timeinfo from complication data.
int watchface_complication_timeinfo_get_timezone (complication_time_info_h info, char **timezone)
 Gets timezone from timeinfo.
int watchface_complication_timeinfo_get_timezone_id (complication_time_info_h info, char **timezone_id)
 Gets timezone ID from timeinfo.
int watchface_complication_timeinfo_get_timezone_country (complication_time_info_h info, char **country)
 Gets timezone country from timeinfo.
int watchface_complication_timeinfo_get_timezone_city (complication_time_info_h info, char **city)
 Gets timezone city from timeinfo.
int watchface_complication_timeinfo_get_timestamp (complication_time_info_h info, time_t *timestamp)
 Gets timestamp from timeinfo.
int watchface_complication_timeinfo_destroy (complication_time_info_h info)
 Destroys time information handle.
int watchface_complication_data_get_image_path (const bundle *data, char **image_path)
 Gets image path from complication data.
int watchface_complication_data_get_ranged_value (const bundle *data, double *current_value, double *min_value, double *max_value)
 Gets ranged value from complication data.
int watchface_complication_data_get_icon_path (const bundle *data, char **icon_path)
 Gets icon path from complication data.
int watchface_complication_data_get_extra_data (const bundle *data, char **extra_data)
 Gets extra data from complication data.
int watchface_complication_data_get_screen_reader_text (const bundle *data, char **screen_reader_text)
 Gets screen reader text from complication data.
int watchface_complication_transfer_event (complication_h handle, watchface_complication_event_type_e event_type)
 Transfers touch event to the complication provider.
int watchface_complication_allowed_list_create (complication_allowed_list_h *handle)
 Creates allowed list.
int watchface_complication_allowed_list_destroy (complication_allowed_list_h handle)
 Destroys allowed list.
int watchface_complication_allowed_list_add (complication_allowed_list_h handle, const char *provider_id, int types)
 Adds provider info to the allowed list.
int watchface_complication_allowed_list_delete (complication_allowed_list_h handle, const char *provider_id)
 Deletes provider info from the allowed list.
int watchface_complication_allowed_list_get_nth (complication_allowed_list_h handle, int index, char **provider_id, int *types)
 Gets n-th item of the allowed list.
int watchface_complication_allowed_list_apply (complication_h handle, complication_allowed_list_h list_handle)
 Applies the allowed list to a complication.
int watchface_complication_allowed_list_clear (complication_h handle)
 Removes applied allowed list.

Typedefs

typedef void * complication_h
 The complication handle.
typedef void(* watchface_complication_updated_cb )(int complication_id, const char *provider_id, watchface_complication_type_e type, const bundle *data, void *user_data)
 Called when the complication is updated.
typedef void(* watchface_complication_error_cb )(int complication_id, const char *provider_id, watchface_complication_type_e type, watchface_complication_error_e error, void *user_data)
 Called when the complication provider error is occured.
typedef struct
complication_allowed_list_ * 
complication_allowed_list_h
 The complication allowed list handle.

Typedef Documentation

typedef struct complication_allowed_list_* complication_allowed_list_h

The complication allowed list handle.

Since :
5.0
typedef void* complication_h

The complication handle.

Since :
5.0
typedef void(* watchface_complication_error_cb)(int complication_id, const char *provider_id, watchface_complication_type_e type, watchface_complication_error_e error, void *user_data)

Called when the complication provider error is occured.

Following error codes can be delivered. WATCHFACE_COMPLICATION_ERROR_PROVIDER_NOT_AVAILABLE : Provider application is not available now for some reason. (eg. uninstall, disable)
WATCHFACE_COMPLICATION_ERROR_IO_ERROR : Provider application is not responding for update request.
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORY : Out of memory.

Since :
5.0
Parameters:
[in]complication_idA number that identifies the complication
[in]provider_idThe name of the provider. The provider_id can be used only in the callback. To use outside, make a copy.
[in]typeThe type shown in the complication
[in]errorThe error related with complication provider
[in]user_dataThe user data passed from the callback function
typedef void(* watchface_complication_updated_cb)(int complication_id, const char *provider_id, watchface_complication_type_e type, const bundle *data, void *user_data)

Called when the complication is updated.

Since :
5.0
Parameters:
[in]complication_idA number that identifies the complication
[in]provider_idThe name of the provider The provider_id can be used only in the callback. To use outside, make a copy.
[in]typeThe type shown in the complication
[in]dataThe data of the complication provided by the provider The data can be used only in the callback. To use outside, make a copy.
[in]user_dataThe user data passed from the callback function

Function Documentation

Adds the callback function to use for complication update.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/datasharing
Parameters:
[in]handleComplication handle
[in]cbThe callback function
[in]error_cbThe error callback function
[in]user_dataThe user data to pass to the callback function
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIEDPermission denied
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
Precondition:
Complication handle should be created by watchface_complication_create().
See also:
watchface_complication_updated_cb()
watchface_complication_error_cb()
Sample code:
#include <watchface-complication.h>
{
    int ret;
    int comp_id = 1;
    complication_h complication;

    ret = watchface_complication_create(comp_id, "org.tizen.sample",
        WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT, WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT,
        WATCHFACE_COMPLICATION_EVENT_TAP,
        &complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE || complication == NULL)
        return ret;

    ret = watchface_complication_add_updated_cb(complication,
            _watchface_complication_updated_cb,
            _watchface_complication_error_cb, NULL);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE)
        return ret;
}
int watchface_complication_allowed_list_add ( complication_allowed_list_h  handle,
const char *  provider_id,
int  types 
)

Adds provider info to the allowed list.

Using this function the complication can add provider id and types which will be shown on the editor app's candidate provider list.

Since :
5.0
Parameters:
[in]handleThe complication allowed list handle
[in]provider_idThe complication provider id
[in]typesThe complication types, values of watchface_complication_type_e combined with bitwise 'or'
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_EXIST_IDThe provider id is already exists in allowed list
See also:
watchface_complication_allowed_list_create()
watchface_complication_allowed_list_destroy()
watchface_complication_allowed_list_delete()
watchface_complication_allowed_list_get_nth()
watchface_complication_allowed_list_apply()
watchface_complication_allowed_list_clear()
Sample code:
#include <watchface-complication.h>

{
  complication_allowed_list_h handle;
  int ret = watchface_complication_allowed_list_create(&handle);
  if (ret == WATCHFACE_COMPLICATION_ERROR_NONE)
      ret = watchface_complication_allowed_list_add(handle, provider_id, types);
}

Applies the allowed list to a complication.

After using this function, the editor will display providers included in the allowed list handle.

Since :
5.0
Parameters:
[in]handleThe complication handle
[in]list_handleThe allowed list handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_DBDatabase error
See also:
watchface_complication_allowed_list_create()
watchface_complication_allowed_list_destroy()
watchface_complication_allowed_list_add()
watchface_complication_allowed_list_delete()
watchface_complication_allowed_list_get_nth()
watchface_complication_allowed_list_clear()
Sample code:
#include <watchface-complication.h>

{
  complication_h handle;
  complication_allowed_list_h allowed_list;

  // create complication handle

  int ret = watchface_complication_allowed_list_create(&allowed_list);
  if (ret == WATCHFACE_COMPLICATION_ERROR_NONE) {
      ret = watchface_complication_allowed_list_add(allowed_list, provider_id, types);
      if (ret == WATCHFACE_COMPLICATION_ERROR_EXIST_ID) {
        watchface_complication_allowed_list_delete(allowed_list, provider_id);
        watchface_complication_allowed_list_add(allowed_list, provider_id, types);
      }
      watchface_complication_allowed_list_get_nth(allowed_list, 0, &n_provider_id, &n_types);
      watchface_complication_allowed_list_apply(handle, allowed_list);
  }
}

Removes applied allowed list.

Since :
5.0
Parameters:
[in]handleThe complication allowed list handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
See also:
watchface_complication_allowed_list_create()
watchface_complication_allowed_list_destroy()
watchface_complication_allowed_list_add()
watchface_complication_allowed_list_delete()
watchface_complication_allowed_list_get_nth()
watchface_complication_allowed_list_apply()
Sample code:
#include <watchface-complication.h>

{
  complication_h handle;
  complication_allowed_list_h allowed_list;

  // create complication handle

  int ret = watchface_complication_allowed_list_create(&allowed_list);
  if (ret == WATCHFACE_COMPLICATION_ERROR_NONE) {
      ret = watchface_complication_allowed_list_add(allowed_list, provider_id, types);
      if (ret == WATCHFACE_COMPLICATION_ERROR_EXIST_ID) {
        watchface_complication_allowed_list_delete(allowed_list, provider_id);
        watchface_complication_allowed_list_add(allowed_list, provider_id, types);
      }
      watchface_complication_allowed_list_get_nth(allowed_list, 0, &n_provider_id, &n_types);
      watchface_complication_allowed_list_apply(handle, allowed_list);
      watchface_complication_allowed_list_clear(handle);
  }
}

Creates allowed list.

The allowed list created by this function is provider list which will be shown on the editor app's candidate provider list.

Since :
5.0
Remarks:
Created allowed list should be applied with watchface_complication_allowed_list_apply(). Created allowed list should be destroyed after applied.
Parameters:
[in]handleThe complication allowed list handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
See also:
watchface_complication_allowed_list_destroy()
watchface_complication_allowed_list_add()
watchface_complication_allowed_list_delete()
watchface_complication_allowed_list_get_nth()
watchface_complication_allowed_list_apply()
watchface_complication_allowed_list_clear()
Sample code:
#include <watchface-complication.h>

{
  complication_allowed_list_h handle;
  int ret = watchface_complication_allowed_list_create(&handle);
}
int watchface_complication_allowed_list_delete ( complication_allowed_list_h  handle,
const char *  provider_id 
)

Deletes provider info from the allowed list.

Since :
5.0
Parameters:
[in]handleThe complication allowed list handle
[in]provider_idThe complication provider id
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
See also:
watchface_complication_allowed_list_create()
watchface_complication_allowed_list_destroy()
watchface_complication_allowed_list_add()
watchface_complication_allowed_list_get_nth()
watchface_complication_allowed_list_apply()
watchface_complication_allowed_list_clear()
Sample code:
#include <watchface-complication.h>

{
  complication_allowed_list_h handle;
  int ret = watchface_complication_allowed_list_create(&handle);
  if (ret == WATCHFACE_COMPLICATION_ERROR_NONE) {
      ret = watchface_complication_allowed_list_add(handle, provider_id, types);
      if (ret == WATCHFACE_COMPLICATION_ERROR_EXIST_ID) {
        watchface_complication_allowed_list_delete(handle, provider_id);
        watchface_complication_allowed_list_add(handle, provider_id, types);
      }
  }
}
int watchface_complication_allowed_list_get_nth ( complication_allowed_list_h  handle,
int  index,
char **  provider_id,
int *  types 
)

Gets n-th item of the allowed list.

Since :
5.0
Remarks:
The provider_id should be freed using free().
Parameters:
[in]handleThe complication allowed list handle
[in]indexIndex
[out]provider_idThe complication provider id
[out]typesThe complication types, values of watchface_complication_type_e combined with bitwise 'or'
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
See also:
watchface_complication_allowed_list_create()
watchface_complication_allowed_list_destroy()
watchface_complication_allowed_list_add()
watchface_complication_allowed_list_delete()
watchface_complication_allowed_list_apply()
watchface_complication_allowed_list_clear()
Sample code:
#include <watchface-complication.h>

{
  complication_allowed_list_h handle;
  int ret = watchface_complication_allowed_list_create(&handle);
  if (ret == WATCHFACE_COMPLICATION_ERROR_NONE) {
      ret = watchface_complication_allowed_list_add(handle, provider_id, types);
      if (ret == WATCHFACE_COMPLICATION_ERROR_EXIST_ID) {
        watchface_complication_allowed_list_delete(handle, provider_id);
        watchface_complication_allowed_list_add(handle, provider_id, types);
      }
      watchface_complication_allowed_list_get_nth(handle, 0, &n_provider_id, &n_types);
  }
}
int watchface_complication_create ( int  complication_id,
const char *  default_provider_id,
watchface_complication_type_e  default_type,
int  supported_types,
int  supported_event_types,
complication_h created_handle 
)

Creates a complication handle.

The default provider and type are the items to set for initial display. If user selects the other provider and type, they are no longer used. You can specify supported_types by combining the types you want to show in the complication. You can specify supported_event_types by combining the event types you want to handle for the complication.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/packagemanager.info
Remarks:
The created_handle should be released using watchface_complication_destroy(). Package manager privilege is needed to lookup provider application. The default_provider_id and the default_type are not always first setted value of the created_handle, it can be other value if user changed provider and type using watchface editor. Sum up, the created_handle will have default_provider_id and default_type as current value, if user never changed it before.
Parameters:
[in]complication_idA number that identifies the complication
[in]default_provider_idThe default provider id
[in]default_typeThe default type to display
[in]supported_typesThe type shown in the complication, values of watchface_complication_type_e combined with bitwise 'or'.
[in]supported_event_typesThe event type supported by complication, values of watchface_complication_event_type_e combined with bitwise 'or'. Complication can send supported event to the provider using watchface_complication_transfer_event().
[out]created_handleComplication handle on success
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIEDPermission denied
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
WATCHFACE_COMPLICATION_ERROR_EXIST_IDAlready exist complication_id
WATCHFACE_COMPLICATION_ERROR_NOT_EXISTProvider does not exist
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_DBDatabase error
WATCHFACE_COMPLICATION_ERROR_PROVIDER_NOT_AVAILABLEProvider application is not available now for some reason. (eg. uninstall, disable)
See also:
watchface_complication_type_e
watchface_complication_event_type_e
watchface_complication_transfer_event()
Sample code:
#include <watchface-complication.h>

complication_h complication;
void on_tap() {
    watchface_complication_transfer_event(complication,
            WATCHFACE_COMPLICATION_EVENT_TAP);
}

{
    int ret;
    int comp_id = 1;

    ret = watchface_complication_create(comp_id, "org.tizen.sample",
        WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT,
        WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT|WATCHFACE_COMPLICATION_TYPE_ICON,
        WATCHFACE_COMPLICATION_EVENT_TAP,
        &complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE || complication == NULL)
        return ret;
}
int watchface_complication_data_get_extra_data ( const bundle data,
char **  extra_data 
)

Gets extra data from complication data.

Since :
5.0
Remarks:
The extra_data should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]extra_dataThe extra data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *value;
    watchface_complication_data_get_extra_data(data, &value);
}
int watchface_complication_data_get_icon_path ( const bundle data,
char **  icon_path 
)

Gets icon path from complication data.

Since :
5.0
Remarks:
The icon_path should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]icon_pathThe icon path data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *value;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_ICON)
        watchface_complication_data_get_icon_path(data, &value);
}
int watchface_complication_data_get_image_path ( const bundle data,
char **  image_path 
)

Gets image path from complication data.

Since :
5.0
Remarks:
The image_path should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]image_pathThe image path data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *value;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_IMAGE)
        watchface_complication_data_get_image_path(data, &value);
}
int watchface_complication_data_get_long_text ( const bundle data,
char **  long_text 
)

Gets long text from complication data.

Since :
5.0
Remarks:
The long_text should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]long_textThe long text data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *value;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_LONG_TEXT)
        watchface_complication_data_get_long_text(data, &value);
}
int watchface_complication_data_get_ranged_value ( const bundle data,
double *  current_value,
double *  min_value,
double *  max_value 
)

Gets ranged value from complication data.

Since :
5.0
Parameters:
[in]dataThe data received from complication provider app
[out]current_valueThe current value
[out]min_valueThe minimum value
[out]max_valueThe max value
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    double cur_val, min_val, max_val;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_RANGED_VALUE)
        watchface_complication_data_get_ranged_value(data, &cur_val, &min_val, &max_val);
}
int watchface_complication_data_get_screen_reader_text ( const bundle data,
char **  screen_reader_text 
)

Gets screen reader text from complication data.

Since :
5.0
Remarks:
The screen_reader_text should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]screen_reader_textThe screen reader text
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *screen_reader_text;
    watchface_complication_data_get_screen_reader_text(data, &screen_reader_text);
    ...
    free(screen_reader_text);
}
int watchface_complication_data_get_short_text ( const bundle data,
char **  short_text 
)

Gets short text from complication data.

Since :
5.0
Remarks:
The short_text should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]short_textThe short text data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *value;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT)
        watchface_complication_data_get_short_text(data, &value);
}

Gets timeinfo from complication data.

Since :
5.5
Remarks:
The info should be destroyed using watchface_complication_timeinfo_destroy().
Parameters:
[in]dataThe data received from complication provider app
[out]infoThe time information handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
complication_time_info_h
watchface_complication_timeinfo_get_timezone()
watchface_complication_timeinfo_get_timezone_id()
watchface_complication_timeinfo_get_timezone_country()
watchface_complication_timeinfo_get_timezone_city()
watchface_complication_timeinfo_destroy()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_destroy(info);
    }
}
int watchface_complication_data_get_timestamp ( const bundle data,
long *  timestamp 
)

Gets timestamp from complication data.

Deprecated:
Deprecated since 5.5. Use watchface_complication_data_get_timeinfo() instead.
Since :
5.0
Parameters:
[in]dataThe data received from complication provider app
[out]timestampThe timestamp
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    long value;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME)
        watchface_complication_data_get_timestamp(data, &value);
}
int watchface_complication_data_get_title ( const bundle data,
char **  title 
)

Gets title text from complication data.

Since :
5.0
Remarks:
The title should be freed using free().
Parameters:
[in]dataThe data received from complication provider app
[out]titleThe title text data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    char *value;

    watchface_complication_data_get_title(data, &value);
}

Gets data type of complication data.

Developer can get different set of data from data depends on data type. Data will be passed through watchface_complication_updated_cb callback and sent by complication provider app.

Since :
5.0
Parameters:
[in]dataThe data received from complication provider app
[out]typeThe data type
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
watchface_complication_type_e
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    watchface_complication_type_e type;
    watchface_complication_data_get_type(data, &type);
}

Destroys a complication handle.

Since :
5.0
Parameters:
[in]handleComplication handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
Complication handle should be created by watchface_complication_create().
See also:
watchface_complication_create()
Sample code:
#include <watchface-complication.h>
{
    int ret;
    complication_h complication;

    // Create complication

    // Do something

    ret = watchface_complication_destroy(complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE)
        return;
}
int watchface_complication_get_current_provider_id ( complication_h  handle,
char **  cur_provider 
)

Gets the id of provider in the complication.

Since :
5.0
Remarks:
The cur_provider should be released using free().
Parameters:
[in]handleComplication handle
[out]cur_providerThe name of the provider supplying the data
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
Precondition:
Complication handle should be created by watchface_complication_create().
Sample code:
#include <watchface-complication.h>
{
    int ret;
    int comp_id = 1;
    complication_h complication;
    const char *cur_provider_id;

    ret = watchface_complication_create(comp_id, "org.tizen.sample",
        WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT, WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT,
        WATCHFACE_COMPLICATION_EVENT_TAP,
        &complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE || complication == NULL)
        return ret;

    ret = watchface_complication_get_current_provider_id(complication, &cur_provider_id);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE)
        return ret;
}

Gets the currently set type of the complication.

Since :
5.0
Parameters:
[in]handleComplication handle
[out]cur_typeThe type shown in the complication
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
Sample code:
#include <watchface-complication.h>
{
    int ret;
    int comp_id = 1;
    complication_h complication;
    watchface_complication_type_e cur_type;

    ret = watchface_complication_create(comp_id, "org.tizen.sample",
        WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT, WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT,
        WATCHFACE_COMPLICATION_EVENT_TAP,
        &complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE || complication == NULL)
        return ret;

    ret = watchface_complication_get_current_type(complication, &cur_type);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE)
        return ret;
}

Removes the callback function.

Since :
5.0
Parameters:
[in]handleComplication handle
[in]cbThe callback function
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
See also:
watchface_complication_updated_cb()
Sample code:
#include <watchface-complication.h>
{
    int ret;

    ret = watchface_complication_remove_updated_cb(complication,
            _watchface_complication_updated_cb);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE)
        return ret;
}

Sends request the provider to update the complication.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/appmanager.launch
Privilege:
http://tizen.org/privilege/datasharing
Remarks:
The watchface complication provider application can declare privileges for specific provider id in manifest xml file, in that case, the watchface application needs those privileges to use this function. If your app doesn't have those privileges, this function will return WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIED.
Parameters:
[in]handleComplication handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE if success, other value if failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccess
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIEDPermission denied
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_DBDatabase error
Sample code:
#include <watchface-complication.h>
{
    int ret;
    int comp_id = 1;
    complication_h complication;
    int supported_types;

    ret = watchface_complication_create(comp_id, "org.tizen.sample",
        WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT, WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT,
        WATCHFACE_COMPLICATION_EVENT_TAP,
        &complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE || complication == NULL)
        return ret;

    ret = watchface_complication_send_update_request(complication);
    if (ret != WATCHFACE_COMPLICATION_ERROR_NONE)
        return ret;
}

Destroys time information handle.

Since :
5.5
Parameters:
[in]infoThe time information handle
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
See also:
complication_time_info_h
watchface_complication_data_get_timeinfo()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_destroy(info);
    }
}

Gets timestamp from timeinfo.

Since :
5.5
Remarks:
The info should contain a timezone ID. If info doesn't contain a timezone ID, this function will return WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETER.
Parameters:
[in]infoThe time information handle
[out]timestampThe number of seconds since 00:00, Jan 1 1970 UTC, corresponding to POSIX time.
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
complication_time_info_h
watchface_complication_data_get_timeinfo()
watchface_complication_timeinfo_get_timezone_id()
watchface_complication_timeinfo_get_timezone()
watchface_complication_timeinfo_destroy()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;
    time_t timestamp;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_get_timestamp(info, &timestamp);
        watchface_complication_timeinfo_destroy(info);
    }
}

Gets timezone from timeinfo.

Since :
5.5
Remarks:
The timezone should be freed using free().
Parameters:
[in]infoThe time information handle
[out]timezoneThe timezone
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
complication_time_info_h
watchface_complication_data_get_timeinfo()
watchface_complication_timeinfo_get_timezone_id()
watchface_complication_timeinfo_get_timezone_country()
watchface_complication_timeinfo_get_timezone_city()
watchface_complication_timeinfo_destroy()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;
    char *timezone;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_get_timezone(info, &timezone);
        watchface_complication_timeinfo_destroy(info);
    }
}

Gets timezone city from timeinfo.

Since :
5.5
Remarks:
The city should be freed using free().
Parameters:
[in]infoThe time information handle
[out]cityThe timezone city
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
complication_time_info_h
watchface_complication_timeinfo_get_timezone()
watchface_complication_data_get_timeinfo()
watchface_complication_timeinfo_get_timezone_id()
watchface_complication_timeinfo_get_timezone()
watchface_complication_timeinfo_destroy()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;
    char *city;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_get_timezone_city(info, &city);
        watchface_complication_timeinfo_destroy(info);
    }
}

Gets timezone country from timeinfo.

Since :
5.5
Remarks:
The country should be freed using free().
Parameters:
[in]infoThe time information handle
[out]countryThe timezone country
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
complication_time_info_h
watchface_complication_timeinfo_get_timezone()
watchface_complication_data_get_timeinfo()
watchface_complication_timeinfo_get_timezone_id()
watchface_complication_timeinfo_get_timezone_city()
watchface_complication_timeinfo_destroy()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;
    char *country;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_get_timezone_country(info, &country);
        watchface_complication_timeinfo_destroy(info);
    }
}

Gets timezone ID from timeinfo.

Since :
5.5
Remarks:
The timezone_id should be freed using free().
Parameters:
[in]infoThe time information handle
[out]timezone_idThe timezone ID
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_NO_DATANo data
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
See also:
complication_time_info_h
watchface_complication_timeinfo_get_timezone()
watchface_complication_data_get_timeinfo()
watchface_complication_timeinfo_get_timezone_country()
watchface_complication_timeinfo_get_timezone_city()
watchface_complication_timeinfo_destroy()
Sample code:
#include <watchface-complication.h>
void _on_complication_update(int complication_id,
        const char *provider_id,
        watchface_complication_type_e type,
        const bundle *data, void *user_data)
{
    complication_time_info_h info;
    watchface_complication_type_e type;
    char *timezone_id;

    watchface_complication_data_get_type(data, &type);
    if (type == WATCHFACE_COMPLICATION_TYPE_TIME) {
        watchface_complication_data_get_timeinfo(data, &info);
        watchface_complication_timeinfo_get_timezone_id(info, &timezone_id);
        watchface_complication_timeinfo_destroy(info);
    }
}

Transfers touch event to the complication provider.

This function launches the provider application with extra data, so that provider can tell it is launched by transferred touch event.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/appmanager.launch
Privilege:
http://tizen.org/privilege/datasharing
Remarks:
The watchface complication provider application can declare privileges for specific provider id in manifest xml file, in that case, the watchface application needs those privileges to use this function. If your app doesn't have those privileges, this function will return WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIED.
Parameters:
[in]handleThe complication handle
[in]event_typeThe event type that is transferred to complication provider
Returns:
WATCHFACE_COMPLICATION_ERROR_NONE on success, otherwise an error code (see watchface_complication_error_e) on failure
Return values:
WATCHFACE_COMPLICATION_ERROR_NONESuccessful
WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTEDNot supported
WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIEDPermission denied
WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETERInvalid parameter
WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORYOut of memory
WATCHFACE_COMPLICATION_ERROR_IO_ERRORI/O error
WATCHFACE_COMPLICATION_ERROR_DBDatabase error
See also:
watchface_complication_provider_event_get_type()
watchface_complication_provider_event_get_provider_id()
watchface_complication_provider_event_get_complication_type()
Sample code:
#include <watchface-complication.h>
void _on_complication_clicked(complication_h handle)
{
    watchface_complication_transfer_event(handle, WATCHFACE_COMPLICATION_EVENT_TAP);
}