Tizen(Headed) Native API  6.5
Autofill manager

The Autofill manager API provides the functions for getting the current autofill service or changing autofill service.

Required Header

#include <autofill_manager.h>

Overview

Autofill is a feature that allows you to fill out the data previously entered by the user such as email, account and address in a text input field. email, account and address in a text input field. Autofill manager is a module for managing the installed autofill services. Application developers can use this module to get the current autofill service and changing the autofill service. Autofill manager functions are responsible for sending data for supporting autofill to the autofill service and receiving the data previously entered by the user from the autofill service.

Functions

int autofill_manager_create (autofill_manager_h *amh)
 Creates a handle for autofill manager.
int autofill_manager_destroy (autofill_manager_h amh)
 Destroys autofill manager handle.
int autofill_manager_connect (autofill_manager_h amh, autofill_manager_connection_status_changed_cb callback, void *user_data)
 Connects to autofill manager daemon.
int autofill_manager_set_autofill_service (autofill_manager_h amh, const char *app_id)
 Sets autofill service.
int autofill_manager_get_autofill_service (autofill_manager_h amh, char **service_app_id)
 Gets autofill service app ID.
int autofill_manager_foreach_autofill_service (autofill_manager_h amh, autofill_manager_autofill_service_cb callback, void *user_data)
 Retrieves all autofill services.

Typedefs

typedef struct autofill_manager_s * autofill_manager_h
 The autofill manager handle.
typedef void(* autofill_manager_connection_status_changed_cb )(autofill_manager_h amh, autofill_manager_connection_status_e status, void *user_data)
 Called when the connection status is changed.
typedef bool(* autofill_manager_autofill_service_cb )(const char *app_id, void *user_data)
 Called for each autofill service information.

Typedef Documentation

typedef bool(* autofill_manager_autofill_service_cb)(const char *app_id, void *user_data)

Called for each autofill service information.

Since :
5.5
Remarks:
app_id should not be freed and can be used only in the callback.
Parameters:
[in]app_idThe autofill service app ID
[in]user_dataThe user data to be passed to the callback function
Returns:
true to continue with the next iteration of the loop, otherwise false to break out of the loop
Precondition:
autofill_manager_foreach_autofill_service() will invoke this callback.
See also:
autofill_manager_foreach_autofill_service()

Called when the connection status is changed.

Since :
5.5
Remarks:
amh should not be freed and can be used only in the callback.
Parameters:
[in]amhThe autofill manager handle
[in]statusThe connection status
[in]user_dataThe user data passed from the callback function
See also:
autofill_manager_connect()
typedef struct autofill_manager_s* autofill_manager_h

The autofill manager handle.

Since :
5.5

Enumeration Type Documentation

Enumeration of connection status.

Since :
5.5
Enumerator:
AUTOFILL_MANAGER_CONNECTION_STATUS_CONNECTED 

Connected

AUTOFILL_MANAGER_CONNECTION_STATUS_DISCONNECTED 

Disconnected

AUTOFILL_MANAGER_CONNECTION_STATUS_REJECTED 

Rejected


Function Documentation

Connects to autofill manager daemon.

Warning:
This is not for use by third-party applications.
Since :
5.5
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/autofillmanager
Parameters:
[in]amhThe autofill manager handle
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
AUTOFILL_ERROR_NONENo error
AUTOFILL_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
AUTOFILL_ERROR_INVALID_PARAMETERInvalid parameter
AUTOFILL_ERROR_OPERATION_FAILEDOperation failure

Creates a handle for autofill manager.

Warning:
This is not for use by third-party applications.
Since :
5.5
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/autofillmanager
Remarks:
If the function succeeds, amh handle must be released with autofill_manager_destroy().
Parameters:
[out]amhThe autofill manager handle
Returns:
0 on success, otherwise a negative error value
Return values:
AUTOFILL_ERROR_NONENo error
AUTOFILL_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
AUTOFILL_ERROR_INVALID_PARAMETERInvalid parameter
AUTOFILL_ERROR_OUT_OF_MEMORYOut of memory
See also:
autofill_manager_destroy()

Destroys autofill manager handle.

Warning:
This is not for use by third-party applications.
Since :
5.5
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/autofillmanager
Parameters:
[in]amhThe autofill manager handle
Returns:
0 on success, otherwise a negative error value
Return values:
AUTOFILL_ERROR_NONENo error
AUTOFILL_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
AUTOFILL_ERROR_INVALID_PARAMETERInvalid parameter
See also:
autofill_manager_create()

Retrieves all autofill services.

Warning:
This is not for use by third-party applications.
Since :
5.5
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/autofillmanager
Parameters:
[in]amhThe autofill manager handle
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
AUTOFILL_ERROR_NONENo error
AUTOFILL_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
AUTOFILL_ERROR_INVALID_PARAMETERInvalid parameter
AUTOFILL_ERROR_OPERATION_FAILEDOperation failure
int autofill_manager_get_autofill_service ( autofill_manager_h  amh,
char **  service_app_id 
)

Gets autofill service app ID.

Warning:
This is not for use by third-party applications.
Since :
5.5
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/autofillmanager
Remarks:
service_app_id must be released using free().
Parameters:
[in]amhThe autofill manager handle
[out]service_app_idThe autofill service app ID
Returns:
0 on success, otherwise a negative error value
Return values:
AUTOFILL_ERROR_NONENo error
AUTOFILL_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
AUTOFILL_ERROR_INVALID_PARAMETERInvalid parameter
See also:
autofill_manager_set_autofill_service()
int autofill_manager_set_autofill_service ( autofill_manager_h  amh,
const char *  app_id 
)

Sets autofill service.

Warning:
This is not for use by third-party applications.
Since :
5.5
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/autofillmanager
Parameters:
[in]amhThe autofill manager handle
[in]app_idThe autofill service app ID
Returns:
0 on success, otherwise a negative error value
Return values:
AUTOFILL_ERROR_NONENo error
AUTOFILL_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
AUTOFILL_ERROR_INVALID_PARAMETERInvalid parameter
See also:
autofill_manager_get_autofill_service()