Functions
Ewk_Autofill_Profile *	ewk_autofill_profile_new (void)
	Creates a new profile.
void	ewk_autofill_profile_delete (Ewk_Autofill_Profile *profile)
	Deletes a given profile.
void	ewk_autofill_profile_data_set (Ewk_Autofill_Profile profile, Ewk_Autofill_Profile_Data_Type name, const char value)
	Sets the data in the profile created by ewk_autofill_profile_new.
unsigned	ewk_autofill_profile_id_get (Ewk_Autofill_Profile *profile)
	Gets the id attribute value from a given profile.
const char *	ewk_autofill_profile_data_get (Ewk_Autofill_Profile *profile, Ewk_Autofill_Profile_Data_Type name)
	Gets the attribute value from a given profile.
Ewk_Back_Forward_List_Item *	ewk_back_forward_list_current_item_get (const Ewk_Back_Forward_List *list)
	Returns the current item in the list.
Ewk_Back_Forward_List_Item *	ewk_back_forward_list_previous_item_get (const Ewk_Back_Forward_List *list)
	Returns the item that precedes the current item in the list.
Ewk_Back_Forward_List_Item *	ewk_back_forward_list_next_item_get (const Ewk_Back_Forward_List *list)
	Returns the item that follows the current item in the list.
Ewk_Back_Forward_List_Item *	ewk_back_forward_list_item_at_index_get (const Ewk_Back_Forward_List *list, int index)
	Returns the item at a given index relative to the current item.
unsigned	ewk_back_forward_list_count (Ewk_Back_Forward_List *list)
	Returns the length of the back-forward list including the current item.
Eina_List *	ewk_back_forward_list_n_back_items_copy (const Ewk_Back_Forward_List *list, int limit)
	Creates a list containing the items preceding the current item limited by limit.
Eina_List *	ewk_back_forward_list_n_forward_items_copy (const Ewk_Back_Forward_List *list, int limit)
	Creates the list containing the items following the current item limited by limit.
Ewk_Back_Forward_List_Item *	ewk_back_forward_list_item_ref (Ewk_Back_Forward_List_Item *item)
	Increases the reference count of the given object.
void	ewk_back_forward_list_item_unref (Ewk_Back_Forward_List_Item *item)
	Decreases the reference count of the given object, possibly freeing it.
const char *	ewk_back_forward_list_item_url_get (const Ewk_Back_Forward_List_Item *item)
	Returns the URL of the item.
const char *	ewk_back_forward_list_item_title_get (const Ewk_Back_Forward_List_Item *item)
	Returns the title of the item.
const char *	ewk_back_forward_list_item_original_url_get (const Ewk_Back_Forward_List_Item *item)
	Returns the original URL of the item.
Ewk_Cookie_Manager *	ewk_context_cookie_manager_get (const Ewk_Context *context)
	Gets the cookie manager instance for this context.
Eina_Bool	ewk_context_application_cache_delete_all (Ewk_Context *context)
	Requests for deleting all web application caches.
Eina_Bool	ewk_context_cache_model_set (Ewk_Context *context, Ewk_Cache_Model model)
	Requests to set the cache model.
Ewk_Cache_Model	ewk_context_cache_model_get (const Ewk_Context *context)
	Returns the cache model type.
Eina_Bool	ewk_context_form_autofill_profile_add (Ewk_Context context, Ewk_Autofill_Profile profile)
	Saves the created profile into permenant storage.
Ewk_Autofill_Profile *	ewk_context_form_autofill_profile_get (Ewk_Context *context, unsigned id)
	Gets the existing profile for given index.
Eina_List *	ewk_context_form_autofill_profile_get_all (Ewk_Context *context)
	Gets a list of all existing profiles.
Eina_Bool	ewk_context_form_autofill_profile_set (Ewk_Context context, unsigned id, Ewk_Autofill_Profile profile)
	Sets the given profile for the given id.
Eina_Bool	ewk_context_form_autofill_profile_remove (Ewk_Context *context, unsigned id)
	Removes Autofill Form profile completely.
void	ewk_context_form_candidate_data_delete_all (Ewk_Context *context)
	Deletes all candidate form data from DB.
void	ewk_context_form_password_data_delete_all (Ewk_Context *context)
	Deletes whole password data from DB.
void	ewk_context_resource_cache_clear (Ewk_Context *context)
	Clears HTTP caches in the local storage and all resources cached in memory such as images, CSS, JavaScript, XSL, and fonts for context.
Evas_Object *	ewk_context_icon_database_icon_object_add (Ewk_Context context, const char uri, Evas *canvas)
	Requests to get image representing the given URL.
void	ewk_context_preferred_languages_set (Eina_List *languages)
	Sets the list of preferred languages.
Eina_Bool	ewk_context_web_indexed_database_delete_all (Ewk_Context *context)
	Requests for deleting all web indexed databases.
Eina_Bool	ewk_context_web_storage_delete_all (Ewk_Context *context)
	Deletes all web storage.
unsigned	ewk_context_menu_item_count (Ewk_Context_Menu *menu)
	Counts the number of context menu items.
Ewk_Context_Menu_Item *	ewk_context_menu_nth_item_get (Ewk_Context_Menu *menu, unsigned int n)
	Returns the nth item in a context menu.
Eina_Bool	ewk_context_menu_item_remove (Ewk_Context_Menu menu, Ewk_Context_Menu_Item item)
	Removes the context menu item from the context menu object.
Eina_Bool	ewk_context_menu_item_append_as_action (Ewk_Context_Menu menu, Ewk_Context_Menu_Item_Tag tag, const char title, Eina_Bool enabled)
	Adds the context menu item to the context menu object.
Eina_Bool	ewk_context_menu_item_append (Ewk_Context_Menu menu, Ewk_Context_Menu_Item_Tag tag, const char title, const char *icon_file, Eina_Bool enabled)
	Adds the context menu item to the context menu object.
Ewk_Context_Menu_Item_Tag	ewk_context_menu_item_tag_get (Ewk_Context_Menu_Item *item)
	Returns the tag of the context menu item.
const char *	ewk_context_menu_item_link_url_get (Ewk_Context_Menu_Item *item)
	Returns the link URL string of the context menu item.
const char *	ewk_context_menu_item_image_url_get (Ewk_Context_Menu_Item *item)
	Returns the image URL string of the context menu item.
void	ewk_cookie_manager_accept_policy_set (Ewk_Cookie_Manager *manager, Ewk_Cookie_Accept_Policy policy)
	Sets policy as the cookie acceptance policy for manager.
void	ewk_cookie_manager_accept_policy_async_get (const Ewk_Cookie_Manager manager, Ewk_Cookie_Manager_Policy_Async_Get_Cb callback, void data)
	Gets the cookie acceptance policy of manager asynchronously.
void	ewk_cookie_manager_cookies_clear (Ewk_Cookie_Manager *manager)
	Deletes all the cookies of manager.
const char *	ewk_error_url_get (const Ewk_Error *error)
	Query failing URL for this error.
int	ewk_error_code_get (const Ewk_Error *error)
	Query the error code.
const char *	ewk_error_description_get (const Ewk_Error *error)
	Query description for this error.
Eina_Bool	ewk_error_cancellation_get (const Ewk_Error *error)
	Query if error should be treated as a cancellation.
const Ewk_Security_Origin *	ewk_geolocation_permission_request_origin_get (const Ewk_Geolocation_Permission_Request *request)
	Requests for getting origin of geolocation permission request.
int	ewk_init (void)
	Initializes WebKit's instance.
int	ewk_shutdown (void)
	Decreases a reference count of WebKit's instance, possibly destroying it.
const char *	ewk_policy_decision_cookie_get (Ewk_Policy_Decision *policy_decision)
	Returns a cookie from the Policy Decision object.
const char *	ewk_policy_decision_url_get (Ewk_Policy_Decision *policy_decision)
	Returns a URL from the Policy Decision object.
const char *	ewk_policy_decision_scheme_get (Ewk_Policy_Decision *policy_decision)
	Returns a scheme from the Policy Decision object.
const char *	ewk_policy_decision_host_get (Ewk_Policy_Decision *policy_decision)
	Returns a host from the Policy Decision object.
const char *	ewk_policy_decision_http_method_get (Ewk_Policy_Decision *policy_decision)
	Returns an HTTP method from the Policy Decision object.
const char *	ewk_policy_decision_response_mime_get (Ewk_Policy_Decision *policy_decision)
	Returns a MIME type for response data from the Policy Decision object.
const Eina_Hash *	ewk_policy_decision_response_headers_get (Ewk_Policy_Decision *policy_decision)
	Returns HTTP headers for response data from the Policy Decision object.
int	ewk_policy_decision_response_status_code_get (Ewk_Policy_Decision *policy_decision)
	Returns an HTTP status code from the Policy Decision object.
Ewk_Policy_Decision_Type	ewk_policy_decision_type_get (const Ewk_Policy_Decision *policy_decision)
	Returns a policy type from the Policy Decision object.
Eina_Bool	ewk_policy_decision_use (Ewk_Policy_Decision *policy_decision)
	Accepts the action which triggers this decision.
Eina_Bool	ewk_policy_decision_ignore (Ewk_Policy_Decision *policy_decision)
	Ignores the action which triggers this decision.
Ewk_Policy_Navigation_Type	ewk_policy_decision_navigation_type_get (Ewk_Policy_Decision *policy_decision)
	Returns a navigation type from the Policy Decision object.
const char *	ewk_security_origin_host_get (const Ewk_Security_Origin *origin)
	Requests for getting host of security origin.
const char *	ewk_security_origin_protocol_get (const Ewk_Security_Origin *origin)
	Requests for getting host of security origin.
Eina_Bool	ewk_settings_autofill_password_form_enabled_set (Ewk_Settings *settings, Eina_Bool enable)
	Requests enable/disable password form autofill.
Eina_Bool	ewk_settings_form_candidate_data_enabled_set (Ewk_Settings *settings, Eina_Bool enable)
	Requests enable/disable form candidate data for autofill.
Eina_Bool	ewk_settings_form_profile_data_enabled_set (Ewk_Settings *settings, Eina_Bool enable)
	Enables/disables form autofill profile feature.
Eina_Bool	ewk_settings_auto_fitting_set (Ewk_Settings *settings, Eina_Bool enable)
	Requests setting of auto fit.
Eina_Bool	ewk_settings_auto_fitting_get (const Ewk_Settings *settings)
	Returns the auto fit status.
Eina_Bool	ewk_settings_javascript_enabled_set (Ewk_Settings *settings, Eina_Bool enable)
	Enables/disables JavaScript executing.
Eina_Bool	ewk_settings_javascript_enabled_get (const Ewk_Settings *settings)
	Returns whether JavaScript can be executable.
Eina_Bool	ewk_settings_loads_images_automatically_set (Ewk_Settings *settings, Eina_Bool automatic)
	Enables/disables auto loading of images.
Eina_Bool	ewk_settings_loads_images_automatically_get (const Ewk_Settings *settings)
	Returns whether images can be loaded automatically.
Eina_Bool	ewk_settings_default_text_encoding_name_set (Ewk_Settings settings, const char encoding)
	Sets the default text encoding name.
const char *	ewk_settings_default_text_encoding_name_get (const Ewk_Settings *settings)
	Gets the default text encoding name.
Eina_Bool	ewk_settings_default_font_size_set (Ewk_Settings *settings, int size)
	Sets the default font size.
int	ewk_settings_default_font_size_get (const Ewk_Settings *settings)
	Returns the default font size.
Eina_Bool	ewk_settings_private_browsing_enabled_set (Ewk_Settings *settings, Eina_Bool enable)
	Requests to enable/disable private browsing.
Eina_Bool	ewk_settings_private_browsing_enabled_get (const Ewk_Settings *settings)
	Enables/disables private browsing.
Eina_Bool	ewk_settings_scripts_can_open_windows_set (Ewk_Settings *settings, Eina_Bool enable)
	Enables/disables if the scripts can open new windows.
Eina_Bool	ewk_settings_scripts_can_open_windows_get (const Ewk_Settings *settings)
	Returns whether the scripts can open new windows.
Eina_Bool	ewk_view_visibility_set (Evas_Object *o, Eina_Bool enable)
	Request to set the current page's visibility.
void	ewk_view_orientation_send (Evas_Object *o, int orientation)
	Sends the orientation of the device.
const char *	ewk_view_text_selection_text_get (Evas_Object *o)
	Returns the selection text.
Eina_Bool	ewk_view_text_selection_clear (Evas_Object *o)
	Clears the current selection.
Evas_Object *	ewk_view_add (Evas *e)
	Creates a new EFL WebKit view object.
Ewk_Context *	ewk_view_context_get (const Evas_Object *o)
	Gets the Ewk_Context of this view.
Eina_Bool	ewk_view_url_set (Evas_Object o, const char url)
	Asks the object to load the given URL.
const char *	ewk_view_url_get (const Evas_Object *o)
	Returns the current URL string of the view object.
Eina_Bool	ewk_view_reload (Evas_Object *o)
	Asks the main frame to reload the current document.
Eina_Bool	ewk_view_stop (Evas_Object *o)
	Asks the main frame to stop loading.
Ewk_Settings *	ewk_view_settings_get (const Evas_Object *o)
	Gets the Ewk_Settings of this view.
Eina_Bool	ewk_view_back (Evas_Object *o)
	Asks the main frame to navigate back in history.
Eina_Bool	ewk_view_forward (Evas_Object *o)
	Asks the main frame to navigate forward in history.
Eina_Bool	ewk_view_back_possible (Evas_Object *o)
	Checks whether it is possible to navigate backwards one item in history.
Eina_Bool	ewk_view_forward_possible (Evas_Object *o)
	Checks whether it is possible to navigate forwards one item in history.
Ewk_Back_Forward_List *	ewk_view_back_forward_list_get (const Evas_Object *o)
	Gets the back-forward list associated with this view.
void	ewk_view_back_forward_list_clear (const Evas_Object *o)
	Clears the back-forward list of a page.
const char *	ewk_view_title_get (const Evas_Object *o)
	Gets the current title of the main frame.
double	ewk_view_load_progress_get (const Evas_Object *o)
	Gets the current load progress of the page.
Eina_Bool	ewk_view_user_agent_set (Evas_Object o, const char user_agent)
	Requests to set the user agent string.
const char *	ewk_view_user_agent_get (const Evas_Object *o)
	Returns the user agent string.
Eina_Bool	ewk_view_contents_size_get (const Evas_Object o, Evas_Coord width, Evas_Coord *height)
	Gets the last known content's size.
Eina_Bool	ewk_view_script_execute (Evas_Object o, const char script, Ewk_View_Script_Execute_Cb callback, void *user_data)
	Requests the execution of the given script.
Eina_Bool	ewk_view_scale_set (Evas_Object *o, double scale_factor, int cx, int cy)
	Scales the current page, centered at the given point.
double	ewk_view_scale_get (const Evas_Object *o)
	Gets the current scale factor of the page.
Eina_Bool	ewk_view_fullscreen_exit (Evas_Object *o)
	Exits fullscreen when the back key is pressed.
void	ewk_view_suspend (Evas_Object *o)
	Suspends the operation associated with the view object.
void	ewk_view_resume (Evas_Object *o)
	Resumes the operation associated with the view object after calling ewk_view_suspend().
Eina_Bool	ewk_view_url_request_set (Evas_Object o, const char url, Ewk_Http_Method method, Eina_Hash headers, const char body)
	Requests loading of the given request data.
Eina_Bool	ewk_view_contents_set (Evas_Object o, const char contents, size_t contents_size, char mime_type, char encoding, char *base_uri)
	Requests loading the given contents by MIME type into the view object.
void	ewk_view_scroll_by (Evas_Object *o, int dx, int dy)
	Scrolls the webpage of view by dx and dy.
Eina_Bool	ewk_view_scroll_pos_get (Evas_Object o, int x, int *y)
	Gets the current scroll position of the given view.
Eina_Bool	ewk_view_scroll_set (Evas_Object *o, int x, int y)
	Sets an absolute scroll of the given view.
Eina_Bool	ewk_view_text_find (Evas_Object o, const char text, Ewk_Find_Options options, unsigned max_match_count)
	Searches and highlights the given string in the document.
Eina_Bool	ewk_view_html_string_load (Evas_Object o, const char html, const char base_url, const char unreachable_url)
	Loads the specified html string as the content of the view.
Typedefs
typedef struct Ewk_Context	Ewk_Context
	The structure type that creates a type name for Ewk_Context.
typedef struct Ewk_Settings	Ewk_Settings
	The structure type that creates a type name for Ewk_Settings.
typedef enum Ewk_Find_Options	Ewk_Find_Options
	Enumeration that creates a type name for the Ewk_Find_Options.
typedef struct _Ewk_Policy_Decision	Ewk_Policy_Decision
	The structure type that creates a type name for Ewk_Policy_Decision.
typedef struct Ewk_Error	Ewk_Error
	The structure type that creates a type name for Ewk_Error.
typedef struct Ewk_Back_Forward_List	Ewk_Back_Forward_List
	The structure type that creates a type name for Ewk_Back_Forward_List.
typedef struct Ewk_Back_Forward_List_Item	Ewk_Back_Forward_List_Item
	The structure type that creates a type name for Ewk_Back_Forward_List_Item.
typedef enum Ewk_Cache_Model	Ewk_Cache_Model
	Enumeration that creates a type name for the Ewk_Cache_Model.
typedef uint32_t	Ewk_Context_Menu_Item_Tag
	The structure type that creates a type name for _Ewk_Context_Menu_Item_Tag.
typedef struct _Ewk_Context_Menu	Ewk_Context_Menu
	The structure type that creates a type name for Ewk_Context_Menu.
typedef struct _Ewk_Context_Menu_Item	Ewk_Context_Menu_Item
	The structure type that creates a type name for Ewk_Context_Menu_Item.
typedef struct Ewk_Cookie_Manager	Ewk_Cookie_Manager
	The structure type that creates a type name for Ewk_Cookie_Manager.
typedef enum Ewk_Cookie_Accept_Policy	Ewk_Cookie_Accept_Policy
	Enumeration that creates a type name for the Ewk_Cookie_Accept_Policy.
typedef void(*	Ewk_Cookie_Manager_Policy_Async_Get_Cb )(Ewk_Cookie_Accept_Policy policy, void *event_info)
	Called for use with ewk_cookie_manager_accept_policy_async_get().
typedef enum _Ewk_Policy_Decision_Type	Ewk_Policy_Decision_Type
	Enumeration that creates a type name for the Ewk_Policy_Decision_Type.
typedef enum _Ewk_Policy_Navigation_Type	Ewk_Policy_Navigation_Type
	Enumeration that creates a type name for Ewk_Policy_Navigation_Type.
typedef void(*	Ewk_View_Script_Execute_Cb )(Evas_Object o, const char result_value, void *user_data)
	Callback for ewk_view_script_execute().
typedef enum Ewk_Http_Method	Ewk_Http_Method
	Enumeration that creates a type name for the Ewk_Http_Method.

The WebView API provides functions to display web pages and control web pages.

Required Header

#include <EWebKit.h>

Overview

The WebView API provides functions to display web pages and control web pages. It is based on the WebKit engine, which is one of the most popular layout engines to render web pages.

Smart object

It is WebKit main smart object. This object provides view related APIs of WebKit2 to EFL object.
The following signals (see evas_object_smart_callback_add()) are emitted:

Signals	Type	Description
close,window	void	Window is closed
contextmenu,customize	Ewk_Context_Menu*	Requested context menu items can be customized by app side
contextmenu,selected	Ewk_Context_Menu_Item*	A context menu item is selected
create,window	Evas_Object**	A new window is created
fullscreen,enterfullscreen	bool*	Reports to enter fullscreen
fullscreen,exitfullscreen	void	Reports to exit fullscreen
load,committed	void	Reports load committed
load,error	Ewk_Error*	Reports load error
load,finished	void	Reports load finished
load,progress	double*	Load progress has changed
load,started	void	Reports load started
policy,navigation,decide	Ewk_Policy_Decision*	A navigation policy decision should be taken
policy,newwindow,decide	Ewk_Policy_Decision*	A new window policy decision should be taken
policy,response,decide	Ewk_Policy_Decision*	A response policy decision should be taken
text,found	unsigned*	The requested text was found and it gives the number of matches
title,changed	const char*	Title of the main frame was changed
url,changed	const char*	Url of the main frame was changed

Typedef Documentation

typedef struct Ewk_Back_Forward_List Ewk_Back_Forward_List

The structure type that creates a type name for Ewk_Back_Forward_List.

Since :: 2.3

typedef struct Ewk_Back_Forward_List_Item Ewk_Back_Forward_List_Item

The structure type that creates a type name for Ewk_Back_Forward_List_Item.

Since :: 2.3

typedef enum Ewk_Cache_Model Ewk_Cache_Model

Enumeration that creates a type name for the Ewk_Cache_Model.

Since :: 2.3

typedef struct Ewk_Context Ewk_Context

The structure type that creates a type name for Ewk_Context.

Since :: 2.3

typedef struct _Ewk_Context_Menu Ewk_Context_Menu

The structure type that creates a type name for Ewk_Context_Menu.

Since :: 2.3

typedef struct _Ewk_Context_Menu_Item Ewk_Context_Menu_Item

The structure type that creates a type name for Ewk_Context_Menu_Item.

Since :: 2.3

typedef uint32_t Ewk_Context_Menu_Item_Tag

The structure type that creates a type name for _Ewk_Context_Menu_Item_Tag.

Since :: 2.3

typedef enum Ewk_Cookie_Accept_Policy Ewk_Cookie_Accept_Policy

Enumeration that creates a type name for the Ewk_Cookie_Accept_Policy.

Since :: 2.3

typedef struct Ewk_Cookie_Manager Ewk_Cookie_Manager

The structure type that creates a type name for Ewk_Cookie_Manager.

Since :: 2.3

typedef void(* Ewk_Cookie_Manager_Policy_Async_Get_Cb)(Ewk_Cookie_Accept_Policy policy, void *event_info)

Called for use with ewk_cookie_manager_accept_policy_async_get().

Since :: 2.3

Parameters:

[in]	policy	A Ewk_Cookie_Accept_Policy
[in]	event_info	The user data that will be passsed when ewk_cookie_manager_accept_policy_async_get() is called

typedef struct Ewk_Error Ewk_Error

The structure type that creates a type name for Ewk_Error.

Since :: 2.3

typedef enum Ewk_Find_Options Ewk_Find_Options

Enumeration that creates a type name for the Ewk_Find_Options.

Since :: 2.3

typedef struct _Ewk_Policy_Decision Ewk_Policy_Decision

The structure type that creates a type name for Ewk_Policy_Decision.

Since :: 2.3

typedef enum _Ewk_Policy_Decision_Type Ewk_Policy_Decision_Type

Enumeration that creates a type name for the Ewk_Policy_Decision_Type.

Since :: 2.3

typedef enum _Ewk_Policy_Navigation_Type Ewk_Policy_Navigation_Type

Enumeration that creates a type name for Ewk_Policy_Navigation_Type.

Since :: 2.3

typedef struct Ewk_Settings Ewk_Settings

The structure type that creates a type name for Ewk_Settings.

Since :: 2.3

typedef void(* Ewk_View_Script_Execute_Cb)(Evas_Object *o, const char *result_value, void *user_data)

Callback for ewk_view_script_execute().

Since :: 2.3

Parameters:

[in]	o	The view object
[in]	result_value	The value returned by the script
[in]	user_data	The user_data will be passsed when ewk_view_script_execute() is called

Enumeration Type Documentation

enum _Ewk_Context_Menu_Item_Tag

Enumeration that provides the tags of items in the context menu.
Enumeration values from 9001 to 9999 of _Ewk_Context_Menu_Item_Tag are reserved for product vendors.

Since :: 2.3

Enumerator:

EWK_CONTEXT_MENU_ITEM_TAG_OPEN_LINK_IN_NEW_WINDOW	Open link in new window
EWK_CONTEXT_MENU_ITEM_TAG_DOWNLOAD_LINK_TO_DISK	Download link to disk
EWK_CONTEXT_MENU_ITEM_TAG_COPY_LINK_TO_CLIPBOARD	Copy link to clipboard
EWK_CONTEXT_MENU_ITEM_TAG_OPEN_IMAGE_IN_NEW_WINDOW	Open image in new window
EWK_CONTEXT_MENU_ITEM_TAG_OPEN_IMAGE_IN_CURRENT_WINDOW	Open image in current window
EWK_CONTEXT_MENU_ITEM_TAG_DOWNLOAD_IMAGE_TO_DISK	Download image to disk
EWK_CONTEXT_MENU_ITEM_TAG_COPY_IMAGE_TO_CLIPBOARD	Copy image to clipboard
EWK_CONTEXT_MENU_ITEM_TAG_COPY	Copy
EWK_CONTEXT_MENU_ITEM_TAG_CUT	Cut
EWK_CONTEXT_MENU_ITEM_TAG_PASTE	Paste
EWK_CONTEXT_MENU_ITEM_TAG_SEARCH_WEB	Search web
EWK_CONTEXT_MENU_ITEM_TAG_OPEN_LINK	Open link
EWK_CONTEXT_MENU_ITEM_TAG_INSPECT_ELEMENT	Inspect element
EWK_CONTEXT_MENU_ITEM_TAG_SELECT_ALL	Select all
EWK_CONTEXT_MENU_ITEM_TAG_SELECT_WORD	Select word
EWK_CONTEXT_MENU_ITEM_TAG_TEXT_SELECTION_MODE	Text selection mode
EWK_CONTEXT_MENU_ITEM_TAG_CLIPBOARD	Clipboard
EWK_CONTEXT_MENU_ITEM_TAG_COPY_LINK_DATA	Copy link data
EWK_CONTEXT_MENU_ITEM_BASE_APPLICATION_TAG	If app want to add customized item, use enum value after EWK_CONTEXT_MENU_ITEM_BASE_APPLICATION_TAG

enum _Ewk_Policy_Decision_Type

Enumeration that provides an option to policy decision types.

Since :: 2.3

Enumerator:

EWK_POLICY_DECISION_USE	Use
EWK_POLICY_DECISION_DOWNLOAD	Download
EWK_POLICY_DECISION_IGNORE	Ignore

enum _Ewk_Policy_Navigation_Type

Enumeration that provides an option to policy navigation types.

Since :: 2.3

Enumerator:

EWK_POLICY_NAVIGATION_TYPE_LINK_CLICKED	Link clicked
EWK_POLICY_NAVIGATION_TYPE_FORM_SUBMITTED	Form submitted
EWK_POLICY_NAVIGATION_TYPE_BACK_FORWARD	Back forward
EWK_POLICY_NAVIGATION_TYPE_RELOAD	Reload
EWK_POLICY_NAVIGATION_TYPE_FORM_RESUBMITTED	Form resubmitted
EWK_POLICY_NAVIGATION_TYPE_OTHER	Other

enum Ewk_Cache_Model

Enumeration that contains option for the cache model.

Since :: 2.3

Enumerator:

EWK_CACHE_MODEL_DOCUMENT_VIEWER	Use the smallest cache capacity
EWK_CACHE_MODEL_DOCUMENT_BROWSER	Use bigger cache capacity than EWK_CACHE_MODEL_DOCUMENT_VIEWER
EWK_CACHE_MODEL_PRIMARY_WEBBROWSER	Use the biggest cache capacity

enum Ewk_Cookie_Accept_Policy

Enumeration that contains accept policies for the cookies.

Since :: 2.3

Enumerator:

EWK_COOKIE_ACCEPT_POLICY_ALWAYS	Accepts every cookie sent from any page
EWK_COOKIE_ACCEPT_POLICY_NEVER	Rejects all cookies
EWK_COOKIE_ACCEPT_POLICY_NO_THIRD_PARTY	Accepts only cookies set by the main document loaded

enum Ewk_Error_Code

Enumeration that provides an option to error codes.

Since :: 2.3

Enumerator:

EWK_ERROR_CODE_UNKNOWN	Unknown
EWK_ERROR_CODE_CANCELED	User canceled
EWK_ERROR_CODE_CANT_SUPPORT_MIMETYPE	Can't show page for this MIME Type
EWK_ERROR_CODE_FAILED_FILE_IO	Error regarding to file io
EWK_ERROR_CODE_CANT_CONNECT	Cannot connect to Network
EWK_ERROR_CODE_CANT_LOOKUP_HOST	Fail to look up host from DNS
EWK_ERROR_CODE_FAILED_TLS_HANDSHAKE	Fail to SSL/TLS handshake
EWK_ERROR_CODE_INVALID_CERTIFICATE	Received certificate is invalid
EWK_ERROR_CODE_REQUEST_TIMEOUT	Connection timeout
EWK_ERROR_CODE_TOO_MANY_REDIRECTS	Too many redirects
EWK_ERROR_CODE_TOO_MANY_REQUESTS	Too many requests during this load
EWK_ERROR_CODE_BAD_URL	Malformed url
EWK_ERROR_CODE_UNSUPPORTED_SCHEME	Unsupported scheme
EWK_ERROR_CODE_AUTHENTICATION	User authentication failed on server
EWK_ERROR_CODE_INTERNAL_SERVER	Web server has internal server error

enum Ewk_Find_Options

Enumeration that provides the option to find text.

Enum values used to specify search options.

It contains enum values used to specify search options.

Since :: 2.3

Enumerator:

EWK_FIND_OPTIONS_NONE	No search flags, this means a case sensitive, no wrap, forward only search
EWK_FIND_OPTIONS_CASE_INSENSITIVE	Case insensitive search
EWK_FIND_OPTIONS_AT_WORD_STARTS	Search text only at the beginning of the words
EWK_FIND_OPTIONS_TREAT_MEDIAL_CAPITAL_AS_WORD_START	Treat capital letters in the middle of words as word start
EWK_FIND_OPTIONS_BACKWARDS	Search backwards
EWK_FIND_OPTIONS_WRAP_AROUND	If not present the search stops at the end of the document
EWK_FIND_OPTIONS_SHOW_OVERLAY	Show overlay
EWK_FIND_OPTIONS_SHOW_FIND_INDICATOR	Show indicator
EWK_FIND_OPTIONS_SHOW_HIGHLIGHT	Show highlight

enum Ewk_Http_Method

Enumeration that provides HTTP method options.

Since :: 2.3

Enumerator:

EWK_HTTP_METHOD_GET	Get
EWK_HTTP_METHOD_HEAD	Head
EWK_HTTP_METHOD_POST	Post
EWK_HTTP_METHOD_PUT	Put
EWK_HTTP_METHOD_DELETE	Delete

Function Documentation

const char* ewk_autofill_profile_data_get	(	Ewk_Autofill_Profile *	profile,
		Ewk_Autofill_Profile_Data_Type	name
	)

Gets the attribute value from a given profile.

The profile obtained from ewk_context_form_autofill_profile_get will be used to get the data

Since :: 2.4

Parameters:

[in]	profile	name of profile
[in]	name	name of attribute

Returns:: Value of attribute (char*), NULL otherwise

See also:: ewk_autofill_profile_new; ewk_context_form_autofill_profile_get; ewk_context_form_autofill_profile_get_all

void ewk_autofill_profile_data_set	(	Ewk_Autofill_Profile *	profile,
		Ewk_Autofill_Profile_Data_Type	name,
		const char *	value
	)

Sets the data in the profile created by ewk_autofill_profile_new.

The data set by this function is set locally. To save it to database use ewk_context_form_autofill_profile_add

Since :: 2.4

Parameters:

[in]	profile	contains the profile data
[in]	name	type of attribute to be set
[in]	value	value of the attribute

See also:: ewk_autofill_profile_data_get; Ewk_Autofill_Profile_Data_Type; ewk_context_form_autofill_profile_add

void ewk_autofill_profile_delete ( Ewk_Autofill_Profile * profile )

Deletes a given profile.

The API will delete the a particular profile only from the memory. To remove the profile permenantly use ewk_context_form_autofill_profile_remove

Since :: 2.4

Parameters:

[in] profile name

See also:: ewk_autofill_profile_new; ewk_context_form_autofill_profile_get; ewk_context_form_autofill_profile_remove

unsigned ewk_autofill_profile_id_get ( Ewk_Autofill_Profile * profile )

Gets the id attribute value from a given profile.

The profile obtained from ewk_context_form_autofill_profile_get will be used to get the profileid

Parameters:

[in] profile name of profile

Since :: 2.4

Returns:: Value of attribute (unsigned), 0 otherwise

See also:: ewk_autofill_profile_new; ewk_context_form_autofill_profile_get; ewk_context_form_autofill_profile_get_all

Ewk_Autofill_Profile* ewk_autofill_profile_new ( void )

Creates a new profile.

The created profile must be deleted by ewk_autofill_profile_delete

Since :: 2.4

Returns:: Ewk_Autofill_Profile if new profile is successfully created, NULL otherwise

See also:: ewk_autofill_profile_data_set; ewk_autofill_profile_delete

unsigned ewk_back_forward_list_count ( Ewk_Back_Forward_List * list )

Returns the length of the back-forward list including the current item.

Since :: 2.3

Parameters:

[in] list The back-forward list instance

Returns:: The length of the back-forward list including the current item,
otherwise 0 in case of an error

Ewk_Back_Forward_List_Item* ewk_back_forward_list_current_item_get ( const Ewk_Back_Forward_List * list )

Returns the current item in the list.

Since :: 2.3

Parameters:

[in] list The back-forward list instance

Returns:: The current item in the list,
otherwise NULL in case of an error

Ewk_Back_Forward_List_Item* ewk_back_forward_list_item_at_index_get	(	const Ewk_Back_Forward_List *	list,
		int	index
	)

Returns the item at a given index relative to the current item.

Since :: 2.3

Parameters:

[in]	list	The back-forward list instance
[in]	index	The index of the item

Returns:: The item at a given index relative to the current item,
otherwise NULL in case of an error

const char* ewk_back_forward_list_item_original_url_get ( const Ewk_Back_Forward_List_Item * item )

Returns the original URL of the item.

Since :: 2.3

Parameters:

[in] item The back-forward list item instance

Returns:: The original URL of the item,
otherwise NULL in case of an error
This pointer is guaranteed to be eina_stringshare,
so whenever possible save yourself some CPU cycles and
use eina_stringshare_ref() instead of eina_stringshare_add() or strdup()

See also:: ewk_back_forward_list_item_url_get()

Ewk_Back_Forward_List_Item* ewk_back_forward_list_item_ref ( Ewk_Back_Forward_List_Item * item )

Increases the reference count of the given object.

Since :: 2.3

Parameters:

[in] item The back-forward list item instance to increase the reference count

Returns:: A pointer to the object on success,
otherwise NULL

const char* ewk_back_forward_list_item_title_get ( const Ewk_Back_Forward_List_Item * item )

Returns the title of the item.

Since :: 2.3

Parameters:

[in] item The back-forward list item instance

Returns:: The title of the item,
otherwise NULL in case of an error
This pointer is guaranteed to be eina_stringshare,
so whenever possible save yourself some CPU cycles and
use eina_stringshare_ref() instead of eina_stringshare_add() or strdup()

void ewk_back_forward_list_item_unref ( Ewk_Back_Forward_List_Item * item )

Decreases the reference count of the given object, possibly freeing it.

When the reference count reaches 0, the item is freed.

Since :: 2.3

Parameters:

[in] item The back-forward list item instance to decrease the reference count

const char* ewk_back_forward_list_item_url_get ( const Ewk_Back_Forward_List_Item * item )

Returns the URL of the item.

The returned URL may differ from the original URL (For example, if the page is redirected).

Since :: 2.3

Parameters:

[in] item The back-forward list item instance

Returns:: The URL of the item,
otherwise NULL in case of an error
This pointer is guaranteed to be eina_stringshare,
so whenever possible save yourself some CPU cycles and
use eina_stringshare_ref() instead of eina_stringshare_add() or strdup()

See also:: ewk_back_forward_list_item_original_url_get()

Eina_List* ewk_back_forward_list_n_back_items_copy	(	const Ewk_Back_Forward_List *	list,
		int	limit
	)

Creates a list containing the items preceding the current item limited by limit.

The Ewk_Back_Forward_List_Item elements are located in the result list starting with the oldest one.
If limit is equal to -1 all the items preceding the current item are returned.

Since :: 2.3

Parameters:

[in]	list	The back-forward list instance
[in]	limit	The number of items to retrieve

Returns:: Eina_List containing Ewk_Back_Forward_List_Item elements,
otherwise NULL in case of an error
The Eina_List and its items should be freed after use
Use ewk_back_forward_list_item_unref() to free the items

Eina_List* ewk_back_forward_list_n_forward_items_copy	(	const Ewk_Back_Forward_List *	list,
		int	limit
	)

Creates the list containing the items following the current item limited by limit.

The Ewk_Back_Forward_List_Item elements are located in the result list starting with the oldest one.
If limit is equal to -1 all the items preceding the current item are returned.

Since :: 2.3

Parameters:

[in]	list	The back-forward list instance
[in]	limit	The number of items to retrieve

Returns:: Eina_List containing Ewk_Back_Forward_List_Item elements,
otherwise NULL in case of an error,
The Eina_List and its items should be freed after use
Use ewk_back_forward_list_item_unref() to free the items

Ewk_Back_Forward_List_Item* ewk_back_forward_list_next_item_get ( const Ewk_Back_Forward_List * list )

Returns the item that follows the current item in the list.

Since :: 2.3

Parameters:

[in] list The back-forward list instance

Returns:: The item that follows the current item in the list,
otherwise NULL in case of an error

Ewk_Back_Forward_List_Item* ewk_back_forward_list_previous_item_get ( const Ewk_Back_Forward_List * list )

Returns the item that precedes the current item in the list.

Since :: 2.3

Parameters:

[in] list The back-forward list instance

Returns:: The item that precedes the current item in the list,
otherwise NULL in case of an error

Eina_Bool ewk_context_application_cache_delete_all ( Ewk_Context * context )

Requests for deleting all web application caches.

Since :: 2.4

Parameters:

[in] context Context object

Returns:: EINA_TRUE on success, otherwise EINA FALSE

Ewk_Cache_Model ewk_context_cache_model_get ( const Ewk_Context * context )

Returns the cache model type.

Since :: 2.3

Parameters:

[in] context The context object

Returns:: Ewk_Cache_Model

Eina_Bool ewk_context_cache_model_set	(	Ewk_Context *	context,
		Ewk_Cache_Model	model
	)

Requests to set the cache model.

Since :: 2.3

Parameters:

[in]	context	The context object
[in]	model	The cache model

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

Ewk_Cookie_Manager* ewk_context_cookie_manager_get ( const Ewk_Context * context )

Gets the cookie manager instance for this context.

Since :: 2.3

Parameters:

[in] context The context object to query

Returns:: The Ewk_Cookie_Manager object instance,
otherwise NULL in case of failure

Eina_Bool ewk_context_form_autofill_profile_add	(	Ewk_Context *	context,
		Ewk_Autofill_Profile *	profile
	)

Saves the created profile into permenant storage.

The profile used to save must be created by ewk_autofill_profile_new. Data can be added to the created profile by ewk_autofill_profile_data_set.

Since :: 2.4

Parameters:

[in]	context	Context object
[in]	profile	Ewk_Autofill_Profile

Returns:: EINA_TRUE if the profile data is saved successfully, otherwise EINA_FALSE

See also:: ewk_autofill_profile_new

Ewk_Autofill_Profile* ewk_context_form_autofill_profile_get	(	Ewk_Context *	context,
		unsigned	id
	)

Gets the existing profile for given index.

Since :: 2.4

Parameters:

[in]	context	Context object
[in]	id	Profile

Returns:: Ewk_Autofill_Profile if profile exists, otherwise NULL

See also:: ewk_autofill_profile_delete

Eina_List* ewk_context_form_autofill_profile_get_all ( Ewk_Context * context )

Gets a list of all existing profiles.

The obtained profile must be deleted by ewk_autofill_profile_delete.

Since :: 2.4

Parameters:

[in] context Context object

Returns:: Eina_List of Ewk_Autofill_Profile, otherwise NULL

See also:: ewk_autofill_profile_delete

Eina_Bool ewk_context_form_autofill_profile_remove	(	Ewk_Context *	context,
		unsigned	id
	)

Removes Autofill Form profile completely.

Since :: 2.4

Parameters:

[in]	context	Context object
[in]	id	Profile

Returns:: EINA_TRUE if the profile data is removed successfully, otherwise EINA_FALSE

See also:: ewk_context_form_autofill_profile_get_all

Eina_Bool ewk_context_form_autofill_profile_set	(	Ewk_Context *	context,
		unsigned	id,
		Ewk_Autofill_Profile *	profile
	)

Sets the given profile for the given id.

Data can be added to the created profile by ewk_autofill_profile_data_set.

Since :: 2.4

Parameters:

[in]	context	Context object
[in]	id	Profile
[in]	profile	Ewk_Autofill_Profile

Returns:: EINA_TRUE if the profile data is set successfully, otherwise EINA_FALSE

See also:: ewk_autofill_profile_new; ewk_context_form_autofill_profile_add

void ewk_context_form_candidate_data_delete_all ( Ewk_Context * context )

Deletes all candidate form data from DB.

Since :: 2.4

Parameters:

[in] context Context object

void ewk_context_form_password_data_delete_all ( Ewk_Context * context )

Deletes whole password data from DB.

Since :: 2.4

Parameters:

context Context object

Evas_Object* ewk_context_icon_database_icon_object_add	(	Ewk_Context *	context,
		const char *	uri,
		Evas *	canvas
	)

Requests to get image representing the given URL.

Since :: 2.4

Parameters:

[in]	context	Context object
[in]	url	Which url to query icon, must not be `0`
[in]	canvas	Evas instance where to add resulting object, must not be `0`

Returns:: Evas_Object instance, otherwise 0

Eina_Bool ewk_context_menu_item_append	(	Ewk_Context_Menu *	menu,
		Ewk_Context_Menu_Item_Tag	tag,
		const char *	title,
		const char *	icon_file,
		Eina_Bool	enabled
	)

Adds the context menu item to the context menu object.

Since :: 2.3

Parameters:

[in]	menu	The context menu object
[in]	tag	The tag of the context menu item
[in]	title	The title of the context menu item
[in]	icon_file	The path of the icon to be set on the context menu item
[in]	enabled	If `true` the context menu item is enabled, otherwise `false`

Returns:: EINA_TRUE on a successful request,
otherwise EINA_FALSE on failure

Eina_Bool ewk_context_menu_item_append_as_action	(	Ewk_Context_Menu *	menu,
		Ewk_Context_Menu_Item_Tag	tag,
		const char *	title,
		Eina_Bool	enabled
	)

Adds the context menu item to the context menu object.

Since :: 2.3

Parameters:

[in]	menu	The context menu object
[in]	tag	The tag of the context menu item
[in]	title	The title of the context menu item
[in]	enabled	If `true` the context menu item is enabled, otherwise `false`

Returns:: EINA_TRUE on a successful request,
otherwise EINA_FALSE on failure

unsigned ewk_context_menu_item_count ( Ewk_Context_Menu * menu )

Counts the number of context menu items.

Since :: 2.3

Parameters:

[in] menu The context menu object

Returns:: The number of current context menu items

const char* ewk_context_menu_item_image_url_get ( Ewk_Context_Menu_Item * item )

Returns the image URL string of the context menu item.

Since :: 2.3

Parameters:

[in] item The context menu item object

Returns:: The current image URL string on success,
otherwise 0 on failure

const char* ewk_context_menu_item_link_url_get ( Ewk_Context_Menu_Item * item )

Returns the link URL string of the context menu item.

Since :: 2.3

Parameters:

[in] item The context menu item object

Returns:: The current link URL string on success,
otherwise 0 on failure

Eina_Bool ewk_context_menu_item_remove	(	Ewk_Context_Menu *	menu,
		Ewk_Context_Menu_Item *	item
	)

Removes the context menu item from the context menu object.

Since :: 2.3

Parameters:

[in]	menu	The context menu object
[in]	item	The context menu item to remove

Returns:: EINA_TRUE on a successful request,
otherwise EINA_FALSE on failure

Ewk_Context_Menu_Item_Tag ewk_context_menu_item_tag_get ( Ewk_Context_Menu_Item * item )

Returns the tag of the context menu item.

Since :: 2.3

Parameters:

[in] item The context menu item object

Returns:: The tag of the context menu item

Ewk_Context_Menu_Item* ewk_context_menu_nth_item_get	(	Ewk_Context_Menu *	menu,
		unsigned int	n
	)

Returns the nth item in a context menu.

Since :: 2.3

Parameters:

[in]	menu	The context menu object
[in]	n	The number of the item

Returns:: The nth item of the context menu

void ewk_context_preferred_languages_set ( Eina_List * languages )

Sets the list of preferred languages.

Deprecated:: Deprecated since 2.4

This function sets the list of preferred langages.
This list will be used to build the "Accept-Language" header that will be included in the network requests.
The client can pass NULL for languages to clear what is set before.

Since :: 2.3

Remarks:: All contexts will be affected.

Parameters:

[in] languages The list of preferred languages (char* as data),
otherwise NULL

void ewk_context_resource_cache_clear ( Ewk_Context * context )

Clears HTTP caches in the local storage and all resources cached in memory
such as images, CSS, JavaScript, XSL, and fonts for context.

Since :: 2.3

Parameters:

[in] context The context object to clear all resource caches

Eina_Bool ewk_context_web_indexed_database_delete_all ( Ewk_Context * context )

Requests for deleting all web indexed databases.

Since :: 2.4

Parameters:

[in] context Context object

Returns:: EINA_TRUE on success, otherwise EINA_FALSE

Eina_Bool ewk_context_web_storage_delete_all ( Ewk_Context * context )

Deletes all web storage.

Since :: 2.4

Parameters:

[in] context Context object

Returns:: EINA_TRUE on success, otherwise EINA_FALSE

void ewk_cookie_manager_accept_policy_async_get	(	const Ewk_Cookie_Manager *	manager,
		Ewk_Cookie_Manager_Policy_Async_Get_Cb	callback,
		void *	data
	)

Gets the cookie acceptance policy of manager asynchronously.

By default, only cookies set by the main document loaded are accepted.

Since :: 2.3

Parameters:

[in]	manager	The cookie manager to query
[in]	callback	The function to call when the policy is received
[in]	data	The user data (may be `NULL`)

void ewk_cookie_manager_accept_policy_set	(	Ewk_Cookie_Manager *	manager,
		Ewk_Cookie_Accept_Policy	policy
	)

Sets policy as the cookie acceptance policy for manager.

By default, only cookies set by the main document loaded are accepted.

Since :: 2.3

Parameters:

[in]	manager	The cookie manager to update
[in]	policy	A Ewk_Cookie_Accept_Policy

void ewk_cookie_manager_cookies_clear ( Ewk_Cookie_Manager * manager )

Deletes all the cookies of manager.

Since :: 2.3

Parameters:

[in] manager The cookie manager to update

Eina_Bool ewk_error_cancellation_get ( const Ewk_Error * error )

Query if error should be treated as a cancellation.

Since :: 2.3

Parameters:

[in] error The error object to query

Returns:: EINA_TRUE if this error should be treated as a cancellation
otherwise EINA_FALSE

int ewk_error_code_get ( const Ewk_Error * error )

Query the error code.

Since :: 2.3

Parameters:

[in] error The error object to query

Returns:: The error code Ewk_Error_Code

const char* ewk_error_description_get ( const Ewk_Error * error )

Query description for this error.

Since :: 2.3

Parameters:

[in] error The error object to query

Returns:: The description pointer, that may be NULL. This pointer is
guaranteed to be eina_stringshare, so whenever possible
save yourself some cpu cycles and use
eina_stringshare_ref() instead of eina_stringshare_add() or
strdup()

const char* ewk_error_url_get ( const Ewk_Error * error )

Query failing URL for this error.

URL that failed loading.

Since :: 2.3

Parameters:

[in] error The error object to query

Returns:: The URL pointer, that may be NULL. This pointer is
guaranteed to be eina_stringshare, so whenever possible
save yourself some cpu cycles and use
eina_stringshare_ref() instead of eina_stringshare_add() or
strdup()

const Ewk_Security_Origin* ewk_geolocation_permission_request_origin_get ( const Ewk_Geolocation_Permission_Request * request )

Requests for getting origin of geolocation permission request.

Since :: 2.4

Parameters:

[in] request Ewk_Geolocation_Permission_Request object to get origin

Returns:: security origin of geolocation permission data

int ewk_init ( void )

Initializes WebKit's instance.

Initializes components needed by EFL,
Increases a reference count of WebKit's instance.

Since :: 2.3

Returns:: A reference count of WebKit's instance on success,
otherwise 0 on failure

const char* ewk_policy_decision_cookie_get ( Ewk_Policy_Decision * policy_decision )

Returns a cookie from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The cookie string on success,
otherwise an empty string on failure

const char* ewk_policy_decision_host_get ( Ewk_Policy_Decision * policy_decision )

Returns a host from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The host string on success,
otherwise an empty string on failure

const char* ewk_policy_decision_http_method_get ( Ewk_Policy_Decision * policy_decision )

Returns an HTTP method from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The HTTP method string on success,
otherwise an empty string on failure

Eina_Bool ewk_policy_decision_ignore ( Ewk_Policy_Decision * policy_decision )

Ignores the action which triggers this decision.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Ewk_Policy_Navigation_Type ewk_policy_decision_navigation_type_get ( Ewk_Policy_Decision * policy_decision )

Returns a navigation type from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The navigation type

const Eina_Hash* ewk_policy_decision_response_headers_get ( Ewk_Policy_Decision * policy_decision )

Returns HTTP headers for response data from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The HTTP headers on success,
otherwise NULL on failure

const char* ewk_policy_decision_response_mime_get ( Ewk_Policy_Decision * policy_decision )

Returns a MIME type for response data from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision policy decision object

Returns:: The MIME type string on success,
otherwise an empty string on failure

int ewk_policy_decision_response_status_code_get ( Ewk_Policy_Decision * policy_decision )

Returns an HTTP status code from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The HTTP status code number

const char* ewk_policy_decision_scheme_get ( Ewk_Policy_Decision * policy_decision )

Returns a scheme from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The scheme string on success,
otherwise an empty string on failure

Ewk_Policy_Decision_Type ewk_policy_decision_type_get ( const Ewk_Policy_Decision * policy_decision )

Returns a policy type from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The policy type

const char* ewk_policy_decision_url_get ( Ewk_Policy_Decision * policy_decision )

Returns a URL from the Policy Decision object.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: The URL string on success,
otherwise an empty string on failure

Eina_Bool ewk_policy_decision_use ( Ewk_Policy_Decision * policy_decision )

Accepts the action which triggers this decision.

Since :: 2.3

Parameters:

[in] policy_decision The policy decision object

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

const char* ewk_security_origin_host_get ( const Ewk_Security_Origin * origin )

Requests for getting host of security origin.

Since :: 2.4

Parameters:

[in] origin Security origin

Returns:: host of security origin

const char* ewk_security_origin_protocol_get ( const Ewk_Security_Origin * origin )

Requests for getting host of security origin.

Since :: 2.4

Parameters:

[in] origin Security origin

Returns:: host of security origin

Eina_Bool ewk_settings_auto_fitting_get ( const Ewk_Settings * settings )

Returns the auto fit status.

Since :: 2.3

Parameters:

[in] settings The settings object to fit to width

Returns:: EINA_TRUE if auto fit is enabled,
otherwise EINA_FALSE

Eina_Bool ewk_settings_auto_fitting_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Requests setting of auto fit.

Since :: 2.3

Parameters:

[in]	settings	The settings object to fit to width
[in]	enable	If `true` the settings object is fit to width, otherwise `false`

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Eina_Bool ewk_settings_autofill_password_form_enabled_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Requests enable/disable password form autofill.

Since :: 2.4

Parameters:

[in]	setting	Setting object to set password form autofill
[in]	enable	`EINA_TRUE` to enable password form autofill `EINA_FALSE` to disable

Returns:: EINA_TRUE on success, otherwise EINA_FALSE

int ewk_settings_default_font_size_get ( const Ewk_Settings * settings )

Returns the default font size.

Since :: 2.3

Parameters:

[in] settings The settings object to get the default font size

Returns:: The default font size,
otherwise 0 on failure

Eina_Bool ewk_settings_default_font_size_set	(	Ewk_Settings *	settings,
		int	size
	)

Sets the default font size.

By default, the default font size is 16.

Since :: 2.3

Parameters:

[in]	settings	The settings object to set the default font size
[in]	size	A new default font size to set

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

const char* ewk_settings_default_text_encoding_name_get ( const Ewk_Settings * settings )

Gets the default text encoding name.

The returned string is guaranteed to be stringshared.

Since :: 2.3

Parameters:

[in] settings The settings object to query the default text encoding name

Returns:: The default text encoding name

Eina_Bool ewk_settings_default_text_encoding_name_set	(	Ewk_Settings *	settings,
		const char *	encoding
	)

Sets the default text encoding name.

Since :: 2.3

Parameters:

[in]	settings	The settings object to set the default text encoding name
[in]	encoding	The default text encoding name

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Eina_Bool ewk_settings_form_candidate_data_enabled_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Requests enable/disable form candidate data for autofill.

Since :: 2.4

Parameters:

[in]	setting	Setting object to set form candidate data for autofill
[in]	enable	`EINA_TRUE` to enable form candidate data for autofill `EINA_FALSE` to disable

Returns:: EINA_TRUE on success, otherwise EINA_FALSE

Eina_Bool ewk_settings_form_profile_data_enabled_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Enables/disables form autofill profile feature.

Since :: 2.4

Parameters:

[in]	settings	Settings object to set the form autofill profile
[in]	enable	`EINA_TRUE` to enable the text autosizing `EINA_FALSE` to disable

Returns:: EINA_TRUE on success, otherwise EINA_FALSE

Eina_Bool ewk_settings_javascript_enabled_get ( const Ewk_Settings * settings )

Returns whether JavaScript can be executable.

Since :: 2.3

Parameters:

[in] settings The settings object to query if JavaScript can be executed

Returns:: EINA_TRUE if JavaScript can be executed,
otherwise EINA_FALSE if not or on failure

Eina_Bool ewk_settings_javascript_enabled_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Enables/disables JavaScript executing.

Since :: 2.3

Parameters:

[in]	settings	The settings object to set JavaScript executing
[in]	enable	If `EINA_TRUE` JavaScript executing is enabled, otherwise `EINA_FALSE` to disable it

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Eina_Bool ewk_settings_loads_images_automatically_get ( const Ewk_Settings * settings )

Returns whether images can be loaded automatically.

Since :: 2.3

Parameters:

[in] settings The settings object to get auto loading of images

Returns:: EINA_TRUE if images are loaded automatically,
otherwise EINA_FALSE if not or on failure

Eina_Bool ewk_settings_loads_images_automatically_set	(	Ewk_Settings *	settings,
		Eina_Bool	automatic
	)

Enables/disables auto loading of images.

Since :: 2.3

Parameters:

[in]	settings	The settings object to set auto loading of images
[in]	automatic	If `EINA_TRUE` auto loading of images is enabled, otherwise `EINA_FALSE` to disable it

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Eina_Bool ewk_settings_private_browsing_enabled_get ( const Ewk_Settings * settings )

Enables/disables private browsing.

Deprecated:: Deprecated since 2.4

Since :: 2.3

Parameters:

[in] settings The settings object to query if private browsing is enabled

Returns:: EINA_TRUE if private browsing is enabled,
otherwise EINA_FALSE if not or on failure

Eina_Bool ewk_settings_private_browsing_enabled_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Requests to enable/disable private browsing.

Deprecated:: Deprecated since 2.4

Since :: 2.3

Parameters:

[in]	settings	The settings object to set private browsing
[in]	enable	If `EINA_TRUE` private browsing is enabled otherwise `EINA_FALSE` to disable it

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Eina_Bool ewk_settings_scripts_can_open_windows_get ( const Ewk_Settings * settings )

Returns whether the scripts can open new windows.

Since :: 2.3

Parameters:

[in] settings The settings object to query whether the scripts can open new windows

Returns:: EINA_TRUE if the scripts can open new windows
otherwise EINA_FALSE if not or on failure (scripts are disabled)

Eina_Bool ewk_settings_scripts_can_open_windows_set	(	Ewk_Settings *	settings,
		Eina_Bool	enable
	)

Enables/disables if the scripts can open new windows.

By default, the scripts can open new windows.

Since :: 2.3

Parameters:

[in]	settings	The settings object to set if the scripts can open new windows
[in]	enable	If `EINA_TRUE` the scripts can open new windows otherwise `EINA_FALSE` if not

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure (scripts are disabled)

int ewk_shutdown ( void )

Decreases a reference count of WebKit's instance, possibly destroying it.

If the reference count reaches 0, WebKit's instance is destroyed.

Since :: 2.3

Returns:: A reference count of WebKit's instance

Evas_Object* ewk_view_add ( Evas * e )

Creates a new EFL WebKit view object.

Since :: 2.3

Parameters:

[in] e The canvas object where to create the view object

Returns:: The view object on success,
otherwise NULL on failure

Eina_Bool ewk_view_back ( Evas_Object * o )

Asks the main frame to navigate back in history.

Since :: 2.3

Parameters:

[in] o The view object to navigate back

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

void ewk_view_back_forward_list_clear ( const Evas_Object * o )

Clears the back-forward list of a page.

Since :: 2.3

Parameters:

[in] o The view object to clear the back-forward list

Ewk_Back_Forward_List* ewk_view_back_forward_list_get ( const Evas_Object * o )

Gets the back-forward list associated with this view.

The returned instance is unique for this view and thus multiple calls
to this function with the same view as a parameter returns the same handle.
This handle is alive while the view is alive, thus one might want
to listen for EVAS_CALLBACK_DEL on a given view (o) to know
when to stop using the returned handle.

Since :: 2.3

Parameters:

[in] o The view object to get the back-forward navigation list

Returns:: The back-forward list instance handle associated with this view

Eina_Bool ewk_view_back_possible ( Evas_Object * o )

Checks whether it is possible to navigate backwards one item in history.

Since :: 2.3

Parameters:

[in] o The view object to query if backward navigation is possible

Returns:: EINA_TRUE if it is possible to navigate backwards in history,
otherwise EINA_FALSE

Eina_Bool ewk_view_contents_set	(	Evas_Object *	o,
		const char *	contents,
		size_t	contents_size,
		char *	mime_type,
		char *	encoding,
		char *	base_uri
	)

Requests loading the given contents by MIME type into the view object.

Since :: 2.3

Parameters:

[in]	o	The view object to load
[in]	contents	The content to load
[in]	contents_size	The size of contents (in bytes)
[in]	mime_type	The type of contents, if `0` is given "text/html" is assumed
[in]	encoding	The encoding for contents, if `0` is given "UTF-8" is assumed
[in]	base_uri	The base URI to use for relative resources, may be `0`, if provided must be an absolute URI

Returns:: EINA_TRUE on a successful request,
otherwise EINA_FALSE on errors

Eina_Bool ewk_view_contents_size_get	(	const Evas_Object *	o,
		Evas_Coord *	width,
		Evas_Coord *	height
	)

Gets the last known content's size.

Since :: 2.3

Parameters:

[in]	o	The view object to get the content's size
[in]	width	The width pointer to store the content's size width, may be `0`
[in]	height	The height pointer to store the content's size height, may be `0`

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure and
width and height are zeroed

Ewk_Context* ewk_view_context_get ( const Evas_Object * o )

Gets the Ewk_Context of this view.

Since :: 2.3

Parameters:

[in] o The view object to get the Ewk_Context

Returns:: The Ewk_Context of this view,
otherwise NULL on failure

Eina_Bool ewk_view_forward ( Evas_Object * o )

Asks the main frame to navigate forward in history.

Since :: 2.3

Parameters:

[in] o The view object to navigate forward

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

Eina_Bool ewk_view_forward_possible ( Evas_Object * o )

Checks whether it is possible to navigate forwards one item in history.

Since :: 2.3

Parameters:

[in] o The view object to query if forward navigation is possible

Returns:: EINA_TRUE if it is possible to navigate forwards in history,
otherwise EINA_FALSE

Eina_Bool ewk_view_fullscreen_exit ( Evas_Object * o )

Exits fullscreen when the back key is pressed.

Since :: 2.3

Parameters:

[in] o The view object to exit the fullscreen mode

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

Eina_Bool ewk_view_html_string_load	(	Evas_Object *	o,
		const char *	html,
		const char *	base_url,
		const char *	unreachable_url
	)

Loads the specified html string as the content of the view.

External objects such as stylesheets or images referenced in the HTML
document are located relative to baseUrl.

If an unreachableUrl is passed it is used as the url for the loaded content.
This is typically used to display error pages for a failed load.

Since :: 2.4

Parameters:

[in]	o	view object to load the HTML into
[in]	html	HTML data to load
[in]	base_url	Base URL used for relative paths to external objects (optional)
[in]	unreachable_url	URL that could not be reached (optional)

Returns:: EINA_TRUE if it the HTML was successfully loaded, EINA_FALSE otherwise

double ewk_view_load_progress_get ( const Evas_Object * o )

Gets the current load progress of the page.

The progress estimation from 0.0 to 1.0.

Since :: 2.3

Parameters:

[in] o The view object to get the current progress

Returns:: The load progress of the page, value from 0.0 to 1.0,
otherwise -1.0 on failure

void ewk_view_orientation_send	(	Evas_Object *	o,
		int	orientation
	)

Sends the orientation of the device.

If orientation value is changed, orientationchanged event will occur.

Since :: 2.4

Parameters:

[in]	o	View object to receive orientation event.
[in]	orientation	The new orientation of the device. (degree)

orientation will be 0 degrees when the device is oriented to natural position, -90 degrees when it's left side is at the top, 90 degrees when it's right side is at the top, 180 degrees when it is upside down.

Eina_Bool ewk_view_reload ( Evas_Object * o )

Asks the main frame to reload the current document.

Since :: 2.3

Parameters:

[in] o The view object to reload the current document

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

void ewk_view_resume ( Evas_Object * o )

Resumes the operation associated with the view object after calling ewk_view_suspend().

Since :: 2.3

Parameters:

[in] o The view object to resume

double ewk_view_scale_get ( const Evas_Object * o )

Gets the current scale factor of the page.

It returns the previous scale factor after ewk_view_scale_set() is called immediately
until the scale factor of the page is really changed.

Since :: 2.3

Parameters:

[in] o The view object to get the scale factor of

Returns:: The current scale factor in use on success,
otherwise -1.0 on failure

Eina_Bool ewk_view_scale_set	(	Evas_Object *	o,
		double	scale_factor,
		int	cx,
		int	cy
	)

Scales the current page, centered at the given point.

Since :: 2.3

Parameters:

[in]	o	The view object to set the zoom level
[in]	scale_factor	A new level to set
[in]	cx	The x value of the center coordinate
[in]	cy	The y value of the center coordinate

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

Eina_Bool ewk_view_script_execute	(	Evas_Object *	o,
		const char *	script,
		Ewk_View_Script_Execute_Cb	callback,
		void *	user_data
	)

Requests the execution of the given script.

Since :: 2.3

Remarks:: This allows to use NULL for the callback parameter.
So, if the result data from the script is not required, NULL might be used for the callback parameter.

Parameters:

[in]	o	The view object to execute the script
[in]	script	The JavaScript to execute
[in]	callback	The result callback
[in]	user_data	The user data

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

void ewk_view_scroll_by	(	Evas_Object *	o,
		int	dx,
		int	dy
	)

Scrolls the webpage of view by dx and dy.

Since :: 2.3

Parameters:

[in]	o	The view object to scroll
[in]	dx	The horizontal offset to scroll
[in]	dy	The vertical offset to scroll

Eina_Bool ewk_view_scroll_pos_get	(	Evas_Object *	o,
		int *	x,
		int *	y
	)

Gets the current scroll position of the given view.

Since :: 2.3

Parameters:

[in]	o	The view object to get the current scroll position
[in]	x	The pointer to store the horizontal position, may be `0`
[in]	y	The pointer to store the vertical position, may be `0`

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE and
values are zeroed.

Eina_Bool ewk_view_scroll_set	(	Evas_Object *	o,
		int	x,
		int	y
	)

Sets an absolute scroll of the given view.

Both values are from zero to the contents size minus the viewport size.

Since :: 2.3

Parameters:

[in]	o	The view object to scroll
[in]	x	The horizontal position to scroll
[in]	y	The vertical position to scroll

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

Ewk_Settings* ewk_view_settings_get ( const Evas_Object * o )

Gets the Ewk_Settings of this view.

Since :: 2.3

Parameters:

[in] o The view object to get the Ewk_Settings

Returns:: The Ewk_Settings of this view,
otherwise NULL on failure

Eina_Bool ewk_view_stop ( Evas_Object * o )

Asks the main frame to stop loading.

Since :: 2.3

Parameters:

[in] o The view object to stop loading

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE

void ewk_view_suspend ( Evas_Object * o )

Suspends the operation associated with the view object.

Since :: 2.3

Parameters:

[in] o The view object to suspend

Eina_Bool ewk_view_text_find	(	Evas_Object *	o,
		const char *	text,
		Ewk_Find_Options	options,
		unsigned	max_match_count
	)

Searches and highlights the given string in the document.

Since :: 2.3

Parameters:

[in]	o	The view object to find text
[in]	text	The text to find
[in]	options	The options to find
[in]	max_match_count	The maximum match count to find, unlimited if `0`

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on errors

Eina_Bool ewk_view_text_selection_clear ( Evas_Object * o )

Clears the current selection.

Since :: 2.4

Parameters:

[in] o View object with selection in progress

Returns:: EINA_TRUE on success, otherwise EINA_FALSE

const char* ewk_view_text_selection_text_get ( Evas_Object * o )

Returns the selection text.

Since :: 2.4

Parameters:

[in] o View object to get selection text.

Returns:: selection text, otherwise NULL

const char* ewk_view_title_get ( const Evas_Object * o )

Gets the current title of the main frame.

It returns an internal string that should not be modified.
The string is guaranteed to be stringshared.

Since :: 2.3

Parameters:

[in] o The view object to get the current title

Returns:: The current title on success,
otherwise NULL on failure

const char* ewk_view_url_get ( const Evas_Object * o )

Returns the current URL string of the view object.

It returns an internal string that should not be modified.
The string is guaranteed to be stringshared.

Since :: 2.3

Parameters:

[in] o The view object to get the current URL

Returns:: The current URL on success,
otherwise NULL on failure

Eina_Bool ewk_view_url_request_set	(	Evas_Object *	o,
		const char *	url,
		Ewk_Http_Method	method,
		Eina_Hash *	headers,
		const char *	body
	)

Requests loading of the given request data.

Since :: 2.3

Parameters:

[in]	o	The view object to load
[in]	url	The uniform resource identifier to load
[in]	method	The http method
[in]	headers	The http headers
[in]	body	The http body data

Returns:: EINA_TRUE on a successful request,
otherwise EINA_FALSE on failure

Eina_Bool ewk_view_url_set	(	Evas_Object *	o,
		const char *	url
	)

Asks the object to load the given URL.

Since :: 2.3

Parameters:

[in]	o	The view object to load url
[in]	url	The uniform resource identifier to load

Returns:: EINA_TRUE if o is valid, irrespective of load,
otherwise EINA_FALSE on failure

const char* ewk_view_user_agent_get ( const Evas_Object * o )

Returns the user agent string.

Since :: 2.3

Parameters:

[in] o The view object to get the user agent string

Returns:: The user agent string

Eina_Bool ewk_view_user_agent_set	(	Evas_Object *	o,
		const char *	user_agent
	)

Requests to set the user agent string.

Since :: 2.3

Parameters:

[in]	o	The view object to set the user agent string
[in]	user_agent	The user agent string to set, otherwise `NULL` to restore the default one

Returns:: EINA_TRUE on success,
otherwise EINA_FALSE on failure

Eina_Bool ewk_view_visibility_set	(	Evas_Object *	o,
		Eina_Bool	enable
	)

Request to set the current page's visibility.

Since :: 2.4

Parameters:

[in]	o	View object to set the visibility.
[in]	enable	EINA_TRUE to set on the visibility of the page, EINA_FALSE otherwise.

Returns:: EINA_TRUE on success, othetwise EINA_FALSE

Functions

Typedefs

Required Header

Overview

Smart object

Typedef Documentation

Enumeration Type Documentation

Function Documentation