*/
#include <tizen.h>
-#include "autofill_enum.h"
#ifdef __cplusplus
extern "C" {
*/
/**
- * @brief Enumeration for autofill function error
+ * @brief Enumeration for autofill function error.
*
* @since_tizen 5.5
*/
AUTOFILL_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< out of memory */
} autofill_error_e;
+/**
+ * @brief Enumeration for autofill hint.
+ *
+ * @since_tizen 5.5
+ */
+typedef enum
+{
+ AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE, /**< Autofill hint for a credit card expiration date */
+ AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DAY, /**< Autofill hint for a credit card expiration day */
+ AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH, /**< Autofill hint for a credit card expiration month */
+ AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_YEAR, /**< Autofill hint for a credit card expiration year */
+ AUTOFILL_HINT_CREDIT_CARD_NUMBER, /**< Autofill hint for a credit card number */
+ AUTOFILL_HINT_EMAIL_ADDRESS, /**< Autofill hint for an email address */
+ AUTOFILL_HINT_NAME, /**< Autofill hint for a user's real name */
+ AUTOFILL_HINT_PHONE, /**< Autofill hint for a phone number */
+ AUTOFILL_HINT_POSTAL_ADDRESS, /**< Autofill hint for a postal address */
+ AUTOFILL_HINT_POSTAL_CODE, /**< Autofill hint for a postal code */
+ AUTOFILL_HINT_ID /**< Autofill hint for a user's ID */
+} autofill_hint_e;
+
+/**
+ * @brief The autofill item handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_item_s *autofill_item_h;
+
+/**
+ * @brief The autofill authentication information handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_auth_info_s *autofill_auth_info_h;
+
+/**
+ * @brief The autofill view information handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_view_info_s *autofill_view_info_h;
+
+/**
+ * @brief The autofill fill response handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_fill_response_s *autofill_fill_response_h;
+
+/**
+ * @brief The autofill fill response group handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_fill_response_group_s *autofill_fill_response_group_h;
+
+/**
+ * @brief The autofill fill response item handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_response_item_s *autofill_fill_response_item_h;
+
+/**
+ * @brief The autofill save item handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_save_item_s *autofill_save_item_h;
+
+/**
+ * @brief The autofill save view information handle.
+ * @since_tizen 5.5
+ */
typedef struct autofill_save_view_info_s *autofill_save_view_info_h;
/**
- * @brief Create autofill item
- *
+ * @brief Called for each autofill information in view info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a item should not be freed and can be used only in the callback.
+ * @param[in] item The autofill item handle
+ * @param[in] user_data The user data to be passed to the callback function
+ * @return @c true to continue with the next iteration of the loop,
+ * otherwise @c false to break out of the loop
+ * @pre autofill_view_info_foreach_items() will invoke this callback.
+ * @see autofill_view_info_foreach_items()
+ */
+typedef bool (*autofill_item_cb)(autofill_item_h item, void *user_data);
+
+/**
+ * @brief Called for each autofill information in save view info.
+ * @since_tizen 5.5
+ * @remarks @a item should not be freed and can be used only in the callback.
+ * @param[in] item The autofill item handle
+ * @param[in] user_data The user data to be passed to the callback function
+ * @return @c true to continue with the next iteration of the loop,
+ * otherwise @c false to break out of the loop
+ * @pre autofill_view_info_foreach_items() will invoke this callback.
+ * @see autofill_view_info_foreach_items()
+ */
+typedef bool (*autofill_save_item_cb)(autofill_save_item_h item, void *user_data);
+
+/**
+ * @brief Called for each autofill fill response group information in fill response.
+ * @since_tizen 5.5
+ * @remarks @a item should not be freed and can be used only in the callback.
+ * @param[in] item The autofill fill response group handle
+ * @param[in] user_data The user data to be passed to the callback function
+ * @return @c true to continue with the next iteration of the loop,
+ * otherwise @c false to break out of the loop
+ * @pre autofill_fill_response_foreach_groups() will invoke this callback.
+ * @see autofill_fill_response_foreach_groups()
+ */
+typedef bool (*autofill_fill_response_group_cb)(autofill_fill_response_group_h item, void *user_data);
+
+/**
+ * @brief Called for each autofill fill response information in fill response group.
+ * @since_tizen 5.5
+ * @remarks @a item should not be freed and can be used only in the callback.
+ * @param[in] item The autofill fill response item handle
+ * @param[in] user_data The user data to be passed to the callback function
+ * @return @c true to continue with the next iteration of the loop,
+ * otherwise @c false to break out of the loop
+ * @pre autofill_fill_response_group_foreach_items() will invoke this callback.
+ * @see autofill_view_info_foreach_items()
+ */
+typedef bool (*autofill_fill_response_item_cb)(autofill_fill_response_item_h item, void *user_data);
+
+/**
+ * @brief Creates autofill item.
+ * @since_tizen 5.5
+ * @remarks If the function succeeds, @a it handle must be released with autofill_item_destroy().
* @param[out] it The autofill item handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #AUTOFILL_ERROR_OUT_OF_MEMORY Out of memory
+ * @see autofill_item_destroy()
*/
int autofill_item_create(autofill_item_h *it);
/**
- * @brief Destroy autofill item
- *
+ * @brief Destroys autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_item_destroy(autofill_item_h it);
/**
- * @brief Clone autofill item
- *
+ * @brief Clones autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a clone handle must be released with autofill_item_destroy().
* @param[in] it The autofill item handle
* @param[out] clone The autofill item handle to be cloned
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_item_clone(autofill_item_h h, autofill_item_h *clone);
+int autofill_item_clone(autofill_item_h it, autofill_item_h *clone);
/**
- * @brief Set autofill hint (id (username), name, password, phone, credit card number, organization, so on)
- *
+ * @brief Sets autofill hint (id (username), name, password, phone, credit card number, organization, so on) in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[in] hint The autofill hint
* @return 0 on success, otherwise a negative error value
int autofill_item_set_autofill_hint(autofill_item_h it, autofill_hint_e hint);
/**
- * @brief Get autofill hint
- *
+ * @brief Gets autofill hint in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[out] hint The autofill hint
* @return 0 on success, otherwise a negative error value
int autofill_item_get_autofill_hint(autofill_item_h it, autofill_hint_e *hint);
/**
- * @brief Set autofill ID
- *
+ * @brief Sets autofill ID in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[in] id The autofill ID
* @return 0 on success, otherwise a negative error value
int autofill_item_set_id(autofill_item_h it, const char *id);
/**
- * @brief Set autofill ID
- *
+ * @brief Gets autofill ID in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a id must be released using free().
* @param[in] it The autofill item handle
* @param[out] id The autofill ID
* @return 0 on success, otherwise a negative error value
int autofill_item_get_id(autofill_item_h it, char **id);
/**
- * @brief Set autofill Label
- *
+ * @brief Sets autofill Label in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[in] label The autofill label
* @return 0 on success, otherwise a negative error value
int autofill_item_set_label(autofill_item_h it, const char *label);
/**
- * @brief Get autofill Label
- *
+ * @brief Gets autofill Label in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a label must be released using free().
* @param[in] it The autofill item handle
* @param[out] label The autofill label
* @return 0 on success, otherwise a negative error value
int autofill_item_get_label(autofill_item_h it, char **label);
/**
- * @brief Set sensitive data
- *
+ * @brief Sets sensitive data in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[in] sensitive The sensitive data or not
* @return 0 on success, otherwise a negative error value
int autofill_item_set_sensitive_data(autofill_item_h it, bool sensitive);
/**
- * @brief Get sensitive data
- *
+ * @brief Gets sensitive data in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[out] sensitive The sensitive data or not
* @return 0 on success, otherwise a negative error value
int autofill_item_get_sensitive_data(autofill_item_h it, bool *sensitive);
/**
- * @brief Set autofill value
- *
+ * @brief Sets autofill value in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill item handle
* @param[in] value The autofill value
* @return 0 on success, otherwise a negative error value
int autofill_item_set_value(autofill_item_h it, const char *value);
/**
- * @brief Get autofill value
- *
+ * @brief Gets autofill value in autofill item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a value must be released using free().
* @param[in] it The autofill item handle
* @param[out] value The autofill value
* @return 0 on success, otherwise a negative error value
*/
int autofill_item_get_value(autofill_item_h it, char **value);
-// auth info
-
/**
- * @brief Create autofill auth info
- *
+ * @brief Creates autofill authentication info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a ai handle must be released with autofill_auth_info_destroy().
* @param[out] ai The autofill authentication information handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_auth_info_create(autofill_auth_info_h *ai);
/**
- * @brief Destroy autofill view info
- *
+ * @brief Destroys autofill authentication info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_auth_info_destroy(autofill_auth_info_h ai);
/**
- * @brief Set app id
- *
+ * @brief Sets app id in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[in] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_set_app_id(autofill_auth_info_h ai, const char *app_id);
/**
- * @brief Get app id
- *
+ * @brief Gets app id in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a app_id must be released using free().
* @param[in] ai The autofill authentication information handle
* @param[out] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_get_app_id(autofill_auth_info_h ai, char **app_id);
/**
- * @brief Set view id
- *
+ * @brief Sets view id in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[in] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_set_view_id(autofill_auth_info_h ai, const char *view_id);
/**
- * @brief Get view id
- *
+ * @brief Gets view id in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a view_id must be released using free().
* @param[in] ai The autofill authentication information handle
* @param[in] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_get_view_id(autofill_auth_info_h ai, char **view_id);
/**
- * @brief Set exist autofill data
- *
+ * @brief Sets exist autofill data in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[in] exist_autofill_data The autofill data existence
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_set_exist_autofill_data(autofill_auth_info_h ai, bool exist_autofill_data);
/**
- * @brief Get exist autofill data
- *
+ * @brief Gets exist autofill data in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[out] exist_autofill_data The autofill data existence
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_get_exist_autofill_data(autofill_auth_info_h ai, bool *exist_autofill_data);
/**
- * @brief Set need authentication
- *
+ * @brief Sets need authentication in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[in] need_authentication The authentication need
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_set_need_authentication(autofill_auth_info_h ai, bool need_authentication);
/**
- * @brief Get need authentication
- *
+ * @brief Gets need authentication in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[out] need_authentication The authentication need
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_get_need_authentication(autofill_auth_info_h ai, bool *need_authentication);
/**
- * @brief Set service name
- *
+ * @brief Sets service name in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[in] service_name The autofill service name
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_set_service_name(autofill_auth_info_h ai, const char *service_name);
/**
- * @brief Get service name
- *
+ * @brief Gets service name in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a service_name must be released using free().
* @param[in] ai The autofill authentication information handle
* @param[out] service_name The autofill service name
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_get_service_name(autofill_auth_info_h ai, char **service_name);
/**
- * @brief Set service message
- *
+ * @brief Sets service message in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
- * @param[in] service_name The autofill service message
+ * @param[in] service_message The autofill service message
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
int autofill_auth_info_set_service_message(autofill_auth_info_h ai, const char *service_message);
/**
- * @brief Get service message
- *
+ * @brief Gets service message in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a service_message must be released using free().
* @param[in] ai The autofill authentication information handle
- * @param[out] service_name The autofill service message
+ * @param[out] service_message The autofill service message
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
int autofill_auth_info_get_service_message(autofill_auth_info_h ai, char **service_message);
/**
- * @brief Set service logo image path
- *
+ * @brief Sets service logo image path in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] ai The autofill authentication information handle
* @param[in] service_logo_image_path The autofill service logo image path
* @return 0 on success, otherwise a negative error value
int autofill_auth_info_set_service_logo_image_path(autofill_auth_info_h ai, const char *service_logo_image_path);
/**
- * @brief Get service logo image path
- *
+ * @brief Gets service logo image path in autofill authentication information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a service_logo_image_path must be released using free().
* @param[in] ai The autofill authentication information handle
* @param[out] service_logo_image_path The autofill service logo image path
* @return 0 on success, otherwise a negative error value
*/
int autofill_auth_info_get_service_logo_image_path(autofill_auth_info_h ai, char **service_logo_image_path);
-// view info
/**
- * @brief Create autofill view info
- *
+ * @brief Creates autofill view info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a vi handle must be released with autofill_view_info_destroy().
* @param[out] vi The autofill view info handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_view_info_create(autofill_view_info_h *vi);
/**
- * @brief Destroy autofill view info
- *
+ * @brief Destroys autofill view info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
- * @param[in] app_id The app ID
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
int autofill_view_info_destroy(autofill_view_info_h vi);
/**
- * @brief Set app id
- *
+ * @brief Sets app id in autofill view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_view_info_set_app_id(autofill_view_info_h vi, const char *app_id);
/**
- * @brief Get app id
- *
+ * @brief Gets app id in autofill view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a app_id must be released using free().
* @param[in] vi The autofill view info handle
* @param[out] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_view_info_get_app_id(const autofill_view_info_h vi, char **app_id);
/**
- * @brief Set view id
- *
+ * @brief Sets view id in autofill view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_view_info_set_view_id(autofill_view_info_h vi, const char *view_id);
/**
- * @brief Get view id
- *
+ * @brief Gets view id in autofill view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a view_id must be released using free().
* @param[in] vi The autofill view info handle
* @param[out] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_view_info_get_view_id(autofill_view_info_h vi, char **view_id);
/**
- * @brief Add autofill item
- *
+ * @brief Adds autofill item in autofill view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] it The autofill item handle
* @return 0 on success, otherwise a negative error value
int autofill_view_info_add_item(const autofill_view_info_h vi, autofill_item_h it);
/**
- * @brief Retrieve all items in view info
- *
+ * @brief Retrieves all items in view info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_view_info_foreach_items(autofill_view_info_h vi, bool (*callback)(autofill_item_h item, void *user_data), void *user_data);
+int autofill_view_info_foreach_items(autofill_view_info_h vi, autofill_item_cb callback, void *user_data);
-// save view info
/**
- * @brief Create autofill save view
- *
+ * @brief Creates autofill save view.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a vi handle must be released with autofill_save_view_info_destroy()
* @param[out] vi The autofill view info handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_save_view_info_create(autofill_save_view_info_h *vi);
/**
- * @brief Destroy autofill save view
- *
+ * @brief Destroys autofill save view.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_save_view_info_destroy(autofill_save_view_info_h vi);
/**
- * @brief Set app ID
- *
+ * @brief Sets app ID in autofill save view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_save_view_info_set_app_id(autofill_save_view_info_h vi, const char *app_id);
/**
- * @brief Get app ID
- *
+ * @brief Gets app ID in autofill save view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a app_id must be released using free().
* @param[in] vi The autofill view info handle
* @param[out] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_save_view_info_get_app_id(const autofill_save_view_info_h vi, char **app_id);
/**
- * @brief Set view ID
- *
+ * @brief Sets view ID in autofill save view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_save_view_info_set_view_id(autofill_save_view_info_h vi, const char *view_id);
/**
- * @brief Get view ID
- *
+ * @brief Gets view ID in autofill save view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a view_id must be released using free().
* @param[in] vi The autofill view info handle
- * @param[out] app_id The view ID
+ * @param[out] view_id The view ID
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
int autofill_save_view_info_get_view_id(autofill_save_view_info_h vi, char **view_id);
/**
- * @brief Add autofill save item
- *
+ * @brief Adds autofill save item in autofill save view information.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill save view info handle
* @param[in] it The autofill save item handle
* @return 0 on success, otherwise a negative error value
int autofill_save_view_info_add_item(const autofill_save_view_info_h vi, autofill_save_item_h it);
/**
- * @brief Retrieve all items in save view info
- *
+ * @brief Retrieves all items in save view info.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] vi The autofill view info handle
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_save_view_info_foreach_items(autofill_save_view_info_h vi, bool (*callback)(autofill_save_item_h item, void *user_data), void *user_data);
+int autofill_save_view_info_foreach_items(autofill_save_view_info_h vi, autofill_save_item_cb callback, void *user_data);
-// fill response
/**
- * @brief Create autofill fill response
- *
+ * @brief Creates autofill fill response.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a h handle must be released with autofill_fill_response_destroy().
* @param[out] h The autofill fill response handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_fill_response_create(autofill_fill_response_h *h);
/**
- * @brief Destroy autofill fill response
- *
+ * @brief Destroys autofill fill response.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_fill_response_destroy(autofill_fill_response_h h);
/**
- * @brief Set app ID
- *
+ * @brief Sets app ID.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response handle
* @param[in] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_set_app_id(autofill_fill_response_h h, const char *app_id);
/**
- * @brief Get app ID
- *
+ * @brief Gets app ID.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a app_id must be released using free().
* @param[in] h The autofill fill response handle
* @param[out] app_id The app ID
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_get_app_id(autofill_fill_response_h h, char **app_id);
/**
- * @brief Set view ID
- *
+ * @brief Sets view ID.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response handle
* @param[in] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_set_view_id(autofill_fill_response_h h, const char *view_id);
/**
- * @brief Get view ID
- *
+ * @brief Gets view ID.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a view_id must be released using free().
* @param[in] h The autofill fill response handle
* @param[out] view_id The view ID
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_get_view_id(autofill_fill_response_h h, char **view_id);
/**
- * @brief Add autofill fill response group
- *
+ * @brief Adds autofill fill response group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response handle
* @param[in] it The autofill fill response group handle
* @return 0 on success, otherwise a negative error value
*/
int autofill_fill_response_add_group(autofill_fill_response_h h, autofill_fill_response_group_h it);
+
/**
- * @brief Retrieve all groups of each fill response
- *
+ * @brief Retrieves all groups of each fill response.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response handle
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_fill_response_foreach_groups(autofill_fill_response_h h, bool (*callback)(autofill_fill_response_group_h item, void *user_data), void *user_data);
+int autofill_fill_response_foreach_groups(autofill_fill_response_h h, autofill_fill_response_group_cb callback, void *user_data);
/**
- * @brief Get the number of fill response group
- *
+ * @brief Gets the number of fill response group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response handle
* @param[out] count The number of group
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_get_group_count(autofill_fill_response_h h, int *count);
/**
- * @brief Create autofill fill response group
- *
+ * @brief Creates autofill fill response group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a h handle must be released with autofill_fill_response_group_destroy().
* @param[out] h The autofill fill response group handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_fill_response_group_create(autofill_fill_response_group_h *h);
/**
- * @brief Destroy autofill fill response group
- *
+ * @brief Destroys autofill fill response group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response group handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_fill_response_group_destroy(autofill_fill_response_group_h h);
/**
- * @brief Clone autofill fill response group
- *
+ * @brief Clones autofill fill response group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a clone handle must be released with autofill_fill_response_group_destroy().
* @param[in] h The autofill fill response group handle
* @param[in] clone The autofill fill response group handle to be cloned
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_group_clone(autofill_fill_response_group_h h, autofill_fill_response_group_h *clone);
/**
- * @brief Add autofill item
- *
+ * @brief Adds autofill item in autofill fil response group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response group handle
* @param[in] it The autofill fill response item handle
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_group_add_item(autofill_fill_response_group_h h, autofill_fill_response_item_h it);
/**
- * @brief Retrieve all fill response items of each group
- *
+ * @brief Retrieves all fill response items of each group.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] h The autofill fill response group handle
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_fill_response_group_foreach_items(autofill_fill_response_group_h h, bool (*callback)(autofill_fill_response_item_h item, void *user_data), void *user_data);
+int autofill_fill_response_group_foreach_items(autofill_fill_response_group_h h, autofill_fill_response_item_cb callback, void *user_data);
-// fill response item
/**
- * @brief Create autofill response item
- *
+ * @brief Creates autofill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a it handle must be released with autofill_fill_response_item_destroy().
* @param[out] it The autofill fill response item handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_fill_response_item_create(autofill_fill_response_item_h *it);
/**
- * @brief Destroy autofill fill response item
- *
+ * @brief Destroys autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill fill response item handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_fill_response_item_destroy(autofill_fill_response_item_h it);
/**
- * @brief Clone autofill fill response item
+ * @brief Clones autofill fill response item.
*
* @since_tizen 5.5
*
- * @privlevel public
- *
* @param[in] it The autofill fill response item handle
* @param[in] clone The autofill fill response item handle to be cloned
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_item_clone(autofill_fill_response_item_h it, autofill_fill_response_item_h *clone);
/**
- * @brief Set autofill ID
- *
+ * @brief Sets autofill ID in autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill fill response item handle
* @param[in] id The autofill fill response item ID
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_item_set_id(autofill_fill_response_item_h it, const char *id);
/**
- * @brief Get autofill ID
- *
+ * @brief Gets autofill ID in autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a id must be released using free().
* @param[in] it The autofill fill response item handle
* @param[out] id The autofill fill response item ID
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_item_get_id(autofill_fill_response_item_h it, char **id);
/**
- * @brief Set autofill value
- *
+ * @brief Sets autofill value in autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill fill response item handle
* @param[in] value The autofill fill response item value
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_item_set_value(autofill_fill_response_item_h it, const char *value);
/**
- * @brief Get autofill value
- *
+ * @brief Gets autofill value in autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a value must be released using free().
* @param[in] it The autofill fill response item handle
* @param[out] value The autofill fill response item value
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_item_get_value(autofill_fill_response_item_h it, char **value);
/**
- * @brief Set presentation text
- *
+ * @brief Sets presentation text in autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill fill response item handle
* @param[in] presentation_text The presentation text
* @return 0 on success, otherwise a negative error value
int autofill_fill_response_item_set_presentation_text(autofill_fill_response_item_h it, const char *presentation_text);
/**
- * @brief Get presentation text
- *
+ * @brief Gets presentation text in autofill fill response item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a presentation_text must be released using free().
* @param[in] it The autofill fill response item handle
* @param[out] presentation_text The presentation text
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_fill_response_item_get_presentation_text(autofill_fill_response_item_h it, char ** presentation_text);
+int autofill_fill_response_item_get_presentation_text(autofill_fill_response_item_h it, char **presentation_text);
-// save item
/**
- * @brief Create autofill save item
- *
+ * @brief Creates autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks If the function succeeds, @a it handle must be released with autofill_save_item_destroy().
* @param[out] it The autofill save item handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_save_item_create(autofill_save_item_h *it);
/**
- * @brief Destroy autofill save item
- *
+ * @brief Destroys autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
int autofill_save_item_destroy(autofill_save_item_h it);
/**
- * @brief Clone autofill item
- *
+ * @brief Clones autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[in] clone The autofill save item handle to be cloned
* @return 0 on success, otherwise a negative error value
* @retval #AUTOFILL_ERROR_NONE No error
* @retval #AUTOFILL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int autofill_save_item_clone(autofill_save_item_h h, autofill_save_item_h *clone);
+int autofill_save_item_clone(autofill_save_item_h it, autofill_save_item_h *clone);
/**
- * @brief Set autofill hint (id(username), name, password, phone, credit card number, organization, so on)
- *
+ * @brief Sets autofill hint (id(username), name, password, phone, credit card number, organization, so on) in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[in] hint The autofill hint
* @return 0 on success, otherwise a negative error value
int autofill_save_item_set_autofill_hint(autofill_save_item_h it, autofill_hint_e hint);
/**
- * @brief Get autofill hint
- *
+ * @brief Gets autofill hint in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[out] hint The autofill hint
* @return 0 on success, otherwise a negative error value
int autofill_save_item_get_autofill_hint(autofill_save_item_h it, autofill_hint_e *hint);
/**
- * @brief Set autofill ID
- *
+ * @brief Sets autofill ID in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[in] id The autofill ID
* @return 0 on success, otherwise a negative error value
int autofill_save_item_set_id(autofill_save_item_h it, const char *id);
/**
- * @brief Get autofill ID
- *
+ * @brief Gets autofill ID in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a id must be released using free().
* @param[in] it The autofill save item handle
* @param[out] id The autofill ID
* @return 0 on success, otherwise a negative error value
int autofill_save_item_get_id(autofill_save_item_h it, char **id);
/**
- * @brief Set autofill label
- *
+ * @brief Sets autofill label in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[out] label The autofill label
* @return 0 on success, otherwise a negative error value
int autofill_save_item_set_label(autofill_save_item_h it, const char *label);
/**
- * @brief Get autofill label
- *
+ * @brief Gets autofill label in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a label must be released using free().
* @param[in] it The autofill save item handle
* @param[out] label The autofill label
* @return 0 on success, otherwise a negative error value
int autofill_save_item_get_label(autofill_save_item_h it, char **label);
/**
- * @brief Set sensitive data
- *
+ * @brief Sets sensitive data in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[in] sensitive The sensitive data or not
* @return 0 on success, otherwise a negative error value
int autofill_save_item_set_sensitive_data(autofill_save_item_h it, bool sensitive);
/**
- * @brief Get sensitive data
- *
+ * @brief Gets sensitive data in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[out] sensitive The sensitive data or not
* @return 0 on success, otherwise a negative error value
int autofill_save_item_get_sensitive_data(autofill_save_item_h it, bool *sensitive);
/**
- * @brief Set autofill value
- *
+ * @brief Sets autofill value in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
* @param[in] it The autofill save item handle
* @param[in] value The autofill value
* @return 0 on success, otherwise a negative error value
int autofill_save_item_set_value(autofill_save_item_h it, const char *value);
/**
- * @brief Get autofill value
- *
+ * @brief Gets autofill value in autofill save item.
* @since_tizen 5.5
- *
- * @privlevel public
- *
+ * @remarks @a value must be released using free().
* @param[in] it The autofill save item handle
* @param[out] value The autofill value
* @return 0 on success, otherwise a negative error value