2 * Copyright (C) 2013-2016 Samsung Electronics. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution.
13 * THIS SOFTWARE IS PROVIDED BY SAMSUNG ELECTRONICS. AND ITS CONTRIBUTORS
14 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SAMSUNG ELECTRONICS. OR ITS
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
20 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
21 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
22 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
23 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 * @file ewk_settings_product.h
28 * @brief Describes the settings API.
30 * @note The ewk_settings is for setting the preference of specific ewk_view.
31 * We can get the ewk_settings from ewk_view using ewk_view_settings_get() API.
34 #ifndef ewk_settings_product_h
35 #define ewk_settings_product_h
37 #include "ewk_settings_internal.h"
44 * Requests setting of force zoom.
46 * @param settings settings object to enable force zoom
47 * @param enable to force zoom
49 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
51 EXPORT_API Eina_Bool ewk_settings_force_zoom_set(Ewk_Settings *settings, Eina_Bool enable);
54 * Returns the force zoom status.
56 * @param settings settings object to enable force zoom
58 * @return @c EINA_TRUE if enable force zoom or @c EINA_FALSE.
60 EXPORT_API Eina_Bool ewk_settings_force_zoom_get(const Ewk_Settings *settings);
63 * Requests to set the default font size.
65 * @param settings settings object to set the default font size
66 * @param size a new default font size to set
68 * @return @c EINA_TRUE on success @c EINA_FALSE otherwise
70 EXPORT_API Eina_Bool ewk_settings_font_default_size_set(Ewk_Settings *settings, int size);
73 * Returns the default font size.
75 * @param settings settings object to set the default font size
77 * @return @c default font size.
79 EXPORT_API int ewk_settings_font_default_size_get(const Ewk_Settings *settings);
82 * Requests enables/disables if the scripts can open the new windows.
84 * @param settings settings object to set if the scripts can open the new windows
85 * @param allow @c EINA_TRUE if the scripts can open the new windows
86 * @c EINA_FALSE if not
88 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure (scripts are disabled)
90 EXPORT_API Eina_Bool ewk_settings_scripts_window_open_set(Ewk_Settings *settings, Eina_Bool allow);
93 * Returns enables/disables if the scripts can open the new windows.
95 * @param settings settings object to set if the scripts can open the new windows
97 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure (scripts are disabled)
99 EXPORT_API Eina_Bool ewk_settings_scripts_window_open_get(const Ewk_Settings *settings);
102 * Returns default text encoding name.
104 * @param settings settings object to query default text encoding nae
106 * @return default text encoding name
108 EXPORT_API const char* ewk_settings_default_encoding_get(const Ewk_Settings *settings);
111 * Requests to set default text encoding name.
113 * @param settings settings object to set default text encoding name
114 * @param encoding default text encoding name
116 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
118 EXPORT_API Eina_Bool ewk_settings_default_encoding_set(Ewk_Settings *settings, const char* encoding);
121 * Requests to set editable link behavior.
123 * @param settings settings object to set editable link behavior
124 * @param behavior editable link behaviro
126 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
128 EXPORT_API Eina_Bool ewk_settings_editable_link_behavior_set(Ewk_Settings *settings, Ewk_Editable_Link_Behavior behavior);
131 * Requests to set the load remote images enable/disable
133 * @param settings settings object to set load remote images
135 * @param loadRemoteImages @c EINA_TRUE to enable the load remote images
136 * @c EINA_FALSE to disable
138 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
140 EXPORT_API Eina_Bool ewk_settings_load_remote_images_set(Ewk_Settings *settings, Eina_Bool loadRemoteImages);
143 * Returns enable/disable the load remote images
145 * @param settings settings object to get editable link behavior
147 * @return @c EINA_TRUE on enable or @c EINA_FALSE on disable
149 EXPORT_API Eina_Bool ewk_settings_load_remote_images_get(const Ewk_Settings *settings);
152 * Returns uses encoding detector.
154 * @deprecated Deprecated since Tizen 3.0.
156 * @param settings settings object to query uses encoding detector
158 * @see ewk_settings_encoding_detector_enabled_get
160 * @return uses encoding detector
162 EINA_DEPRECATED EXPORT_API Eina_Bool ewk_settings_uses_encoding_detector_get(const Ewk_Settings *settings);
165 * Returns if password form autofill is enabled or disabled.
167 * @param setting setting object to get password form autofill
169 * @return @c EINA_TRUE if password form autofill is enabled
170 * @c EINA_FALSE if password form autofill is disabled
172 EXPORT_API Eina_Bool ewk_settings_autofill_password_form_enabled_get(Ewk_Settings* settings);
175 * Returns if form candidate data for autofill is enabled or disabled.
177 * @param setting setting object to get form candidate data for autofill
179 * @return @c EINA_TRUE if form candidate data for autofill is enabled
180 * @c EINA_FALSE if form candidate data for autofill is disabled
182 EXPORT_API Eina_Bool ewk_settings_form_candidate_data_enabled_get(Ewk_Settings* settings);
185 * Returns whether the autofill_text feature is enabled.
187 * @param settings settings object to query whether autofill_text feature is enabled
189 * @return @c EINA_TRUE if the autofill_text feature is enabled
190 * @c EINA_FALSE if not or on failure
192 EXPORT_API Eina_Bool ewk_settings_form_profile_data_enabled_get(const Ewk_Settings *settings);
195 * Returns whether text selection is cleared when webview lose focus or not.
197 * @param settings setting object to get whether text selection is cleared when webview lose focus or not
199 * @return @c EINA_TRUE if text selection is cleared when webview lose focus
200 * @c EINA_FALSE if not or on failure
202 EXPORT_API Eina_Bool ewk_settings_clear_text_selection_automatically_get(const Ewk_Settings* settings);
205 * Requests for drawing layer borders.
207 * @param settings settings object to drawing layer borders.
208 * @param enable EINA_TRUE to draw layer borders.
210 * @return @c EINA_TRUE on successful request or @c EINA_FALSE on failure
213 EXPORT_API Eina_Bool ewk_settings_compositing_borders_visible_set(Ewk_Settings *settings, Eina_Bool enable);
216 * Requests to set the scan malware enable/disable.
218 * @param settings settings object to set scan malware
220 * @param scan_malware_enabled @c EINA_TRUE to enable the scan malware
221 * @c EINA_FALSE to disable
223 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
225 EXPORT_API Eina_Bool ewk_settings_scan_malware_enabled_set(Ewk_Settings *settings, Eina_Bool scan_malware_enabled);
228 * @brief Returns enable/disable scan malware.
232 * @param[in] settings settings object to get malware scan behavior
234 * @return @c EINA_TRUE on enable or @c EINA_FALSE on disable
236 EXPORT_API Eina_Bool ewk_settings_scan_malware_enabled_get(const Ewk_Settings* settings);
239 * Requests to enable/disable spdy.
241 * @deprecated Deprecated since Tizen 4.0.
243 * @param settings param not needed, only present for API compatibility
245 * @param spdy_enabled @c EINA_TRUE to enable the spdy @c EINA_FALSE to disable
247 * @return always @c EINA_TRUE, only present for API compatibility
249 EINA_DEPRECATED EXPORT_API Eina_Bool ewk_settings_spdy_enabled_set(Ewk_Settings *settings, Eina_Bool spdy_enabled);
252 * Get spdy enabled/disabled state.
254 * @deprecated Deprecated since Tizen 4.0.
256 * @param settings param not needed, only present for API compatibility
258 * @return @c EINA_TRUE if enabled or @c EINA_FALSE if disabled
260 EINA_DEPRECATED EXPORT_API Eina_Bool ewk_settings_spdy_enabled_get(Ewk_Settings *settings);
263 * Requests to set the performance features of soup enable/disable.
265 * @param settings settings object to set performance features on soup
267 * @param spdy_enabled @c EINA_TRUE to enable the performance features on soup
268 * @c EINA_FALSE to disable
270 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
272 EXPORT_API Eina_Bool ewk_settings_performance_features_enabled_set(Ewk_Settings *settings, Eina_Bool performance_features_enabled);
275 * @brief Returns enable/disable performance features on soup.
279 * @param[in] settings settings object to get performance features
281 * @return @c EINA_TRUE on enable or @c EINA_FALSE on disable
283 EXPORT_API Eina_Bool ewk_settings_performance_features_enabled_get(const Ewk_Settings* settings);
286 * Requests to set using encoding detector.
288 * @deprecated Deprecated since Tizen 3.0.
290 * @param settings settings object to set using encoding detector
291 * @param use use encoding detector
293 * @see ewk_settings_encoding_detector_enabled_set
295 EINA_DEPRECATED EXPORT_API Eina_Bool ewk_settings_uses_encoding_detector_set(Ewk_Settings *settings, Eina_Bool use);
298 * Enables/disables the encoding detector.
300 * By default, the encoding detector is disabled.
302 * @param settings settings object to set the encoding detector
303 * @param enable @c EINA_TRUE to enable the encoding detector,
304 * @c EINA_FALSE to disable
308 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
310 EXPORT_API Eina_Bool ewk_settings_encoding_detector_enabled_set(Ewk_Settings* settings, Eina_Bool enable);
313 * Queries whether the encoding detector is enabled or not.
317 * @param settings settings object to query using encoding detector
319 * @return @c EINA_TRUE if encoding detecor is enabled
320 * @c EINA_FALSE otherwise
322 EXPORT_API Eina_Bool ewk_settings_encoding_detector_enabled_get(const Ewk_Settings* settings);
326 * Set to load https sub resource when it has certificate error.
328 * @param settings settings object to enable/disable load sub resource
329 * @param enabled a state to set
331 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
333 EXPORT_API Eina_Bool ewk_settings_load_sub_resource_with_certificate_error_set(Ewk_Settings* settings, Eina_Bool enabled);
336 * Set to add http head DNT(do not track).
338 * @param settings settings object to enable/disable set DNT in http head.
339 * @param enabled a state to set
341 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
343 EXPORT_API Eina_Bool ewk_settings_do_not_track_set(Ewk_Settings* settings, Eina_Bool enabled);
346 *@brief Set to allow running mixed contents or not.
350 * @param[in] settings The settings object to set mixed contents reply
351 * @param[in] allow If @c EINA_TRUE allow to run mixed contents\n
352 * otherwise @c EINA_FALSE to not allow running mixed contents
353 * @return @c EINA_TRUE on success,\n
354 * otherwise @c EINA_FALSE on failure
357 ewk_settings_mixed_contents_set(const Ewk_Settings* settings, Eina_Bool allow);
360 * @deprecated Deprecated since Tizen 3.0.
362 * Enable/disable cache builder extension mode.
364 * By default, the cache builder extension is disabled.
365 * Notify node position to client when focused node is change.
366 * Can find focusable node from last known mouse position.
367 * Support fast scroll when long pressing the direction key.
369 * @param settings settings object
370 * @param enabled @c EINA_TRUE to enable the cache builder extension
371 * @c EINA_FALSE to disable
373 EINA_DEPRECATED EXPORT_API void ewk_settings_cache_builder_extension_enabled_set(Ewk_Settings *settings, Eina_Bool enabled);
376 * @deprecated Deprecated since Tizen 3.0.
378 * Enable/disable focus ring.
380 * @note Focus ring is enabled by default but disabled for wrt on TV profile
382 * @param settings settings object
383 * @param enabled @c EINA_TRUE to enable the focus ring
384 * @c EINA_FALSE to disable
386 EINA_DEPRECATED EXPORT_API void ewk_settings_focus_ring_enabled_set(Ewk_Settings *settings, Eina_Bool enabled);
389 * Enables/disables the viewport meta tag.
391 * By default, the viewport meta tag is enabled on mobile and wearable,
392 * but it is disabled on TV.
394 * @param settings settings object
395 * @param enable @c EINA_TRUE to enable the viewport meta tag
396 * @c EINA_FALSE to disable
398 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
400 EXPORT_API Eina_Bool ewk_settings_viewport_meta_tag_set(Ewk_Settings *settings, Eina_Bool enable);
403 * Returns whether the viewport meta tag is enabled.
405 * @param settings settings object
407 * @return @c EINA_TRUE if the viewport meta tag is enabled
408 * @c EINA_FALSE if not or on failure
410 EXPORT_API Eina_Bool ewk_settings_viewport_meta_tag_get(const Ewk_Settings *settings);
413 * Allow/disallow to run and display mixed contents.
415 * By default, WebCore don't allow run and display mixed contents.
416 * Some Apps want to allow them by default
418 * @param settings settings object
419 * @param enable @c EINA_TRUE to allow run and display mixed contents
420 * @c EINA_FALSE to disable
423 EXPORT_API void ewk_settings_default_mixed_contents_policy_set(Ewk_Settings* settings, Eina_Bool enable);
426 * Enable/disable the WebGL feature.
428 * By default, the WebGL feature is Enabled.
429 * Some Apps want to disallow WebGL feature.
431 * @note Should be used before ewk_view_url_set().
433 * @param settings settings object
434 * @param disable @c EINA_TRUE to disable WebGL.
435 * @c EINA_FALSE to enable.
438 EXPORT_API void ewk_settings_disable_webgl_set(Ewk_Settings* settings, Eina_Bool disable);
441 * Enables/disables web security.
443 * By default, the web security is enabled.
445 * @param settings settings object to set the web security
446 * @param enable @c EINA_TRUE to enable the web security
447 * @c EINA_FALSE to disable
449 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
451 * @see ewk_settings_web_security_enabled_get()
453 EXPORT_API Eina_Bool ewk_settings_web_security_enabled_set(Ewk_Settings *settings, Eina_Bool enable);
456 * Returns whether the web security is enabled.
458 * @param settings settings object to query whether web security is enabled
460 * @return @c EINA_TRUE if the web security is enabled
461 * @c EINA_FALSE if not or on failure
463 EXPORT_API Eina_Bool ewk_settings_web_security_enabled_get(const Ewk_Settings *settings);
466 * Set to uses the arrow scroll.
468 * @param settings settings object
469 * @param enabled a state to set
471 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
473 EXPORT_API Eina_Bool ewk_settings_uses_arrow_scroll_set(Ewk_Settings* settings, Eina_Bool enabled);
476 * Returns whether uses arrow scroll is enabled or not.
478 * @param settings settings object
480 * @return @c EINA_TRUE if uses arrow is enabled, @c EINA_FALSE otherwise
482 EXPORT_API Eina_Bool ewk_settings_uses_arrow_scroll_get(Ewk_Settings* settings);
485 * Set to uses scrollbar thumb focus notifications.
487 * @param settings settings object
488 * @param enabled a state to set
490 EXPORT_API Eina_Bool ewk_settings_uses_scrollbar_thumb_focus_notifications_set(
491 Ewk_Settings* settings,
495 * Allow/Disallow file access from external url
497 * By default, file access from external url is disallowed
499 * This is only for TV Product
501 * @param settings settings object to allow file access from external url
502 * @param enable @c EINA_TRUE to allow file access from external url
503 * @c EINA_FALSE to disallow
505 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
507 * @see ewk_settings_allow_file_access_from_external_url_get()
510 ewk_settings_allow_file_access_from_external_url_set(Ewk_Settings* settings,
514 * Set to support the media playback notification.
516 * This is only for TV Product
518 * @param settings settings object
519 * @param enabled a state to set
522 EXPORT_API void ewk_settings_media_playback_notification_set(Ewk_Settings* settings, Eina_Bool enabled);
525 * Returns enable/disable the media playback notification.
527 * This is only for TV Product
529 * @param settings settings object
531 * @return @c EINA_TRUE if media plyaback notification is enabled, @c EINA_FALSE otherwise
533 EXPORT_API Eina_Bool ewk_settings_media_playback_notification_get(const Ewk_Settings* settings);
536 * Set to support the subtitle notification.
538 * @param settings settings object
539 * @param enabled a state to set
542 EXPORT_API void ewk_settings_media_subtitle_notification_set(Ewk_Settings *settings, Eina_Bool enabled);
545 * Returns enable/disable the subtitle notification.
547 * @param settings settings object
549 * @return @c EINA_TRUE if subtitle notification is enabled, @c EINA_FALSE
552 EXPORT_API Eina_Bool ewk_settings_media_subtitle_notification_get(const Ewk_Settings *settings);
555 * Returns whether file access from external url is enabled
557 * This is only for TV Product
559 * @param settings settings object to query whether file access from external
562 * @return @c EINA_TRUE if file access from external url is allow
563 * @c EINA_FALSE if not or on failure
565 EXPORT_API Eina_Bool ewk_settings_allow_file_access_from_external_url_get(
566 const Ewk_Settings* settings);
569 * @brief Requests to enable/disable private browsing.
571 * @details This setting change affects all webview with same context.
575 * @param[in] settings The settings object to set private browsing
576 * @param[in] enable If @c EINA_TRUE private browsing is enabled\n
577 * otherwise @c EINA_FALSE to disable it
579 * @return @c EINA_TRUE on success,\n
580 * otherwise @c EINA_FALSE on failure
582 EXPORT_API Eina_Bool ewk_settings_private_browsing_enabled_set(Ewk_Settings* settings, Eina_Bool enable);
585 * @brief Enables/disables private browsing.
589 * @param[in] settings The settings object to query if private browsing is
592 * @return @c EINA_TRUE if private browsing is enabled,\n
593 * otherwise @c EINA_FALSE if not or on failure
595 EXPORT_API Eina_Bool ewk_settings_private_browsing_enabled_get(const Ewk_Settings* settings);
598 * Requests enables/disables to the specific extra feature
600 * @param settings setting object to enable/disable the specific extra feature
601 * @param feature feature name
602 * @param enable @c EINA_TRUE to enable the specific extra feature
603 * @c EINA_FALSE to disable
605 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
607 EXPORT_API void ewk_settings_extra_feature_set(Ewk_Settings* settings, const char* feature, Eina_Bool enable);
610 * Returns enable/disable to the specific extra feature
612 * @param settings settings object to get whether the specific extra feature is enabled or not.
613 * @param feature feature name
615 * @return @c EINA_TRUE on enable or @c EINA_FALSE on disable
617 EXPORT_API Eina_Bool ewk_settings_extra_feature_get(const Ewk_Settings* settings, const char* feature);
620 * Enables/disables text autosizing.
622 * By default, the text autosizing is disabled.
624 * @param settings settings object to set the text autosizing
625 * @param enable @c EINA_TRUE to enable the text autosizing
626 * @c EINA_FALSE to disable
628 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
630 * @see ewk_settings_text_autosizing_enabled_get()
632 EXPORT_API Eina_Bool ewk_settings_text_autosizing_enabled_set(Ewk_Settings *settings, Eina_Bool enable);
635 * Returns whether the text autosizing is enabled.
637 * The text autosizing is a feature which adjusts the font size of text in wide
638 * columns, and makes text more legible.
640 * @param settings settings object to query whether text autosizing is enabled
642 * @return @c EINA_TRUE if the text autosizing is enabled
643 * @c EINA_FALSE if not or on failure
645 EXPORT_API Eina_Bool ewk_settings_text_autosizing_enabled_get(const Ewk_Settings *settings);
648 * Sets the scale factor for text autosizing.
650 * Default value is 1.0.
652 * @param settings settings object to set the text autosizing
653 * @param factor font scale factor for text autosizing
655 EXPORT_API Eina_Bool ewk_settings_text_autosizing_font_scale_factor_set(Ewk_Settings *settings, double factor);
658 * Gets the current scale factor for text autosizing.
660 * @param settings settings object to set scale factor for text autosizing
662 * @return the current font scale factor for text autosizing.
663 * In case of error, it returns non-positive value.
665 EXPORT_API double ewk_settings_text_autosizing_font_scale_factor_get(const Ewk_Settings *settings);
668 * @brief Sets the scale factor for text autosizing.
670 * @details Default value is 1.0.
672 * @param settings settings object to set the text autosizing
673 * @param factor font scale factor for text autosizing
675 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
677 EXPORT_API Eina_Bool ewk_settings_text_autosizing_scale_factor_set(Ewk_Settings* settings, double factor);
680 * @brief Gets the current scale factor for text autosizing.
682 * @param settings settings object to set scale factor for text autosizing
684 * @return the current font scale factor for text autosizing
686 EXPORT_API double ewk_settings_text_autosizing_scale_factor_get(const Ewk_Settings* settings);
689 * Sets text style for selection mode enabled.
691 * @param settings settings object
692 * @param enabled text style for selection mode
695 EXPORT_API void ewk_settings_text_style_state_enabled_set(Ewk_Settings *settings, Eina_Bool enabled);
698 * Gets text style for selection mode enabled.
700 * @param settings settings object
702 * @return @c EINA_TRUE if text style for selection mode enabled, @c EINA_FALSE otherwise
704 EXPORT_API Eina_Bool ewk_settings_text_style_state_enabled_get(const Ewk_Settings *settings);
707 * @brief Enables/disables legacy font size mode
709 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
711 * @param[in] settings settings object
712 * @param[in] enable If @c EINA_TRUE legacy font size is enabled\n
713 * otherwise @c EINA_FALSE to disable it
715 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
717 EXPORT_API Eina_Bool ewk_settings_legacy_font_size_enabled_set(Ewk_Settings* settings, Eina_Bool enabled);
720 * @brief Return whether legacy font size mode is enabled
722 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
724 * @param[in] settings settings object
726 * @return @c EINA_TRUE if Ewk_Legacy_Font_Size_Mode set to legacy font size mode
727 * @c EINA_FALSE if Ewk_Legacy_Font_Size_Mode not set to legacy font size mode
729 EXPORT_API Eina_Bool ewk_settings_legacy_font_size_enabled_get(Ewk_Settings* settings);
732 * @brief Sets font-family as system font for font rendering
734 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
736 * @param[in] settings settings object
737 * @param[in] use @c EINA_TRUE to use one of the system fonts which is selected by user in Settings
738 * @c EINA_FALSE to use a system default font
740 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
742 EXPORT_API Eina_Bool ewk_settings_use_system_font_set(Ewk_Settings* settings, Eina_Bool use);
745 * @brief Returns whether we use the system font which is selected by user in Settings or use a system default font
747 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
749 * @param[in] settings settings object
751 * @return @c EINA_TRUE if we use the sysem font which is selected by user in Settings
752 * @c EINA_FALSE if we use a system default font or on failure
754 EXPORT_API Eina_Bool ewk_settings_use_system_font_get(Ewk_Settings* settings);
757 * @brief Requests enables/disables to control text selection handles from app
761 * @param[in] settings setting object to set to control text selection handles from app
762 * @param[in] enable @c EINA_TRUE to control text selection handles from app\n
763 * @c EINA_FALSE to disable
765 * @return @c EINA_TRUE on success or @c EINA_FALSE on failure
767 EXPORT_API void ewk_settings_selection_handle_enabled_set(Ewk_Settings* settings, Eina_Bool enable);
770 * @brief Returns whether text selection handles are controlled from app or not
774 * @param[in] settings setting object to get whether text selection handles are controlled from app
777 * @return @c EINA_TRUE if text selection handles are controlled from app\n
778 * @c EINA_FALSE if not or on failure
780 EXPORT_API Eina_Bool ewk_settings_selection_handle_enabled_get(const Ewk_Settings* settings);
783 * @brief disclose Set-Cookie headers over IPC.
784 * Some apps which get cookie through xhr.getAllResponseHeaders interface
785 * Currently blink don't disclose response header with Set-Cookie field
790 * @param[in] settings setting object
791 * @param[in] Enabled true means app allow to disclose "Set-Cookie"
794 EXPORT_API void ewk_settings_disclose_set_cookie_headers_enabled(Ewk_Settings* settings, Eina_Bool Enabled);
797 * @brief Request to set the spatial navigation usage set by hbbtv
801 * @param[in] settings setting object
802 * @param[in] enable @c EINA_TRUE enable to use spatial navigation
803 * @c EINA_FALSE to disable
805 EXPORT_API void ewk_settings_spatial_navigation_enabled_set(Ewk_Settings* settings, Eina_Bool enable);
808 * Request to set enable/disable the ime panel
810 * By default, the ime panel is enabled
811 * Some Apps want to disable ime panel
813 * @param settings setting object
814 * @param enabled @c EINA_TRUE to enable ime panel
815 * @c EINA_FALSE to disable ime panel
818 EXPORT_API void ewk_settings_ime_panel_enabled_set(Ewk_Settings* settings, Eina_Bool enabled);
821 * Returns whether the ime panel is enabled or disabled
823 * @param settings setting object
825 * @return @c EINA_TRUE enable ime panel or @c EINA_FALSE disable ime panel
827 EXPORT_API Eina_Bool ewk_settings_ime_panel_enabled_get(const Ewk_Settings *settings);
831 * Request to set enable/disable drag and drop
833 * By default, the drag and drop is Disabled
835 * @param settings settings object
836 * @param enabled @c EINA_TRUE to enable drag and drop
837 * @c EINA_FALSE to disable drag and drop
840 EXPORT_API void ewk_settings_drag_drop_enabled_set(Ewk_Settings* settings, Eina_Bool enabled);
843 * Returns whether drag and drop is enabled or disabled
845 * @param settings settings object
847 * @return @c EINA_TRUE drag and drop is enabled, @c EINA_FALSE drag and drop is disabled
849 EXPORT_API Eina_Bool ewk_settings_drag_drop_enabled_get(const Ewk_Settings* settings);
852 * Request to set enable/disable clipboard
854 * By default, the clipboard is Disabled
856 * @param settings settings object
857 * @param enabled @c EINA_TRUE to enable clipboard
858 * @c EINA_FALSE to disable clipboard
861 EXPORT_API void ewk_settings_clipboard_enabled_set(Ewk_Settings* settings, Eina_Bool enabled);
864 * Returns whether clipboard is enabled
866 * @param settings settings object
868 * @return @c EINA_TRUE clipboard is enabled, @c EINA_FALSE clipboard is disabled
870 EXPORT_API Eina_Bool ewk_settings_clipboard_enabled_get(const Ewk_Settings* settings);
876 #endif // ewk_settings_product_h