- /**
- * @defgroup Config Elementary Config
- *
- * Elementary configuration is formed by a set options bounded to a
- * given @ref Profile profile, like @ref Theme theme, @ref Fingers
- * "finger size", etc. These are functions with which one syncronizes
- * changes made to those values to the configuration storing files, de
- * facto. You most probably don't want to use the functions in this
- * group unlees you're writing an elementary configuration manager.
- *
- * @{
- */
-
- /**
- * Save back Elementary's configuration, so that it will persist on
- * future sessions.
- *
- * @return @c EINA_TRUE, when sucessful. @c EINA_FALSE, otherwise.
- * @ingroup Config
- *
- * This function will take effect -- thus, do I/O -- immediately. Use
- * it when you want to apply all configuration changes at once. The
- * current configuration set will get saved onto the current profile
- * configuration file.
- *
- */
- EAPI Eina_Bool elm_config_save(void);
-
- /**
- * Reload Elementary's configuration, bounded to current selected
- * profile.
- *
- * @return @c EINA_TRUE, when sucessful. @c EINA_FALSE, otherwise.
- * @ingroup Config
- *
- * Useful when you want to force reloading of configuration values for
- * a profile. If one removes user custom configuration directories,
- * for example, it will force a reload with system values instead.
- *
- */
- EAPI void elm_config_reload(void);
-
- /**
- * @}
- */
-
- /**
- * @defgroup Profile Elementary Profile
- *
- * Profiles are pre-set options that affect the whole look-and-feel of
- * Elementary-based applications. There are, for example, profiles
- * aimed at desktop computer applications and others aimed at mobile,
- * touchscreen-based ones. You most probably don't want to use the
- * functions in this group unlees you're writing an elementary
- * configuration manager.
- *
- * @{
- */
-
- /**
- * Get Elementary's profile in use.
- *
- * This gets the global profile that is applied to all Elementary
- * applications.
- *
- * @return The profile's name
- * @ingroup Profile
- */
- EAPI const char *elm_profile_current_get(void);
-
- /**
- * Get an Elementary's profile directory path in the filesystem. One
- * may want to fetch a system profile's dir or an user one (fetched
- * inside $HOME).
- *
- * @param profile The profile's name
- * @param is_user Whether to lookup for an user profile (@c EINA_TRUE)
- * or a system one (@c EINA_FALSE)
- * @return The profile's directory path.
- * @ingroup Profile
- *
- * @note You must free it with elm_profile_dir_free().
- */
- EAPI const char *elm_profile_dir_get(const char *profile, Eina_Bool is_user);
-
- /**
- * Free an Elementary's profile directory path, as returned by
- * elm_profile_dir_get().
- *
- * @param p_dir The profile's path
- * @ingroup Profile
- *
- */
- EAPI void elm_profile_dir_free(const char *p_dir);
-
- /**
- * Get Elementary's list of available profiles.
- *
- * @return The profiles list. List node data are the profile name
- * strings.
- * @ingroup Profile
- *
- * @note One must free this list, after usage, with the function
- * elm_profile_list_free().
- */
- EAPI Eina_List *elm_profile_list_get(void);
-
- /**
- * Free Elementary's list of available profiles.
- *
- * @param l The profiles list, as returned by elm_profile_list_get().
- * @ingroup Profile
- *
- */
- EAPI void elm_profile_list_free(Eina_List *l);
-
- /**
- * Set Elementary's profile.
- *
- * This sets the global profile that is applied to Elementary
- * applications. Just the process the call comes from will be
- * affected.
- *
- * @param profile The profile's name
- * @ingroup Profile
- *
- */
- EAPI void elm_profile_set(const char *profile);
-
- /**
- * Set Elementary's profile.
- *
- * This sets the global profile that is applied to all Elementary
- * applications. All running Elementary windows will be affected.
- *
- * @param profile The profile's name
- * @ingroup Profile
- *
- */
- EAPI void elm_profile_all_set(const char *profile);
-
- /**
- * @}
- */
-
- /**
- * @defgroup Scrolling Scrolling
- *
- * These are functions setting how scrollable views in Elementary
- * widgets should behave on user interaction.
- *
- * @{
- */
-
- /**
- * Get whether scrollers should bounce when they reach their
- * viewport's edge during a scroll.
- *
- * @return the thumb scroll bouncing state
- *
- * This is the default behavior for touch screens, in general.
- * @ingroup Scrolling
- */
- EAPI Eina_Bool elm_scroll_bounce_enabled_get(void);
-
- /**
- * Set whether scrollers should bounce when they reach their
- * viewport's edge during a scroll.
- *
- * @param enabled the thumb scroll bouncing state
- *
- * @see elm_thumbscroll_bounce_enabled_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_bounce_enabled_set(Eina_Bool enabled);
-
- /**
- * Set whether scrollers should bounce when they reach their
- * viewport's edge during a scroll, for all Elementary application
- * windows.
- *
- * @param enabled the thumb scroll bouncing state
- *
- * @see elm_thumbscroll_bounce_enabled_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
-
- /**
- * Get the amount of inertia a scroller will impose at bounce
- * animations.
- *
- * @return the thumb scroll bounce friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_bounce_friction_get(void);
-
- /**
- * Set the amount of inertia a scroller will impose at bounce
- * animations.
- *
- * @param friction the thumb scroll bounce friction
- *
- * @see elm_thumbscroll_bounce_friction_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_bounce_friction_set(double friction);
-
- /**
- * Set the amount of inertia a scroller will impose at bounce
- * animations, for all Elementary application windows.
- *
- * @param friction the thumb scroll bounce friction
- *
- * @see elm_thumbscroll_bounce_friction_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_bounce_friction_all_set(double friction);
-
- /**
- * Get the amount of inertia a <b>paged</b> scroller will impose at
- * page fitting animations.
- *
- * @return the page scroll friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_page_scroll_friction_get(void);
-
- /**
- * Set the amount of inertia a <b>paged</b> scroller will impose at
- * page fitting animations.
- *
- * @param friction the page scroll friction
- *
- * @see elm_thumbscroll_page_scroll_friction_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_page_scroll_friction_set(double friction);
-
- /**
- * Set the amount of inertia a <b>paged</b> scroller will impose at
- * page fitting animations, for all Elementary application windows.
- *
- * @param friction the page scroll friction
- *
- * @see elm_thumbscroll_page_scroll_friction_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_page_scroll_friction_all_set(double friction);
-
- /**
- * Get the amount of inertia a scroller will impose at region bring
- * animations.
- *
- * @return the bring in scroll friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_bring_in_scroll_friction_get(void);
-
- /**
- * Set the amount of inertia a scroller will impose at region bring
- * animations.
- *
- * @param friction the bring in scroll friction
- *
- * @see elm_thumbscroll_bring_in_scroll_friction_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_bring_in_scroll_friction_set(double friction);
-
- /**
- * Set the amount of inertia a scroller will impose at region bring
- * animations, for all Elementary application windows.
- *
- * @param friction the bring in scroll friction
- *
- * @see elm_thumbscroll_bring_in_scroll_friction_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction);
-
- /**
- * Get the amount of inertia scrollers will impose at animations
- * triggered by Elementary widgets' zooming API.
- *
- * @return the zoom friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_zoom_friction_get(void);
-
- /**
- * Set the amount of inertia scrollers will impose at animations
- * triggered by Elementary widgets' zooming API.
- *
- * @param friction the zoom friction
- *
- * @see elm_thumbscroll_zoom_friction_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_zoom_friction_set(double friction);
-
- /**
- * Set the amount of inertia scrollers will impose at animations
- * triggered by Elementary widgets' zooming API, for all Elementary
- * application windows.
- *
- * @param friction the zoom friction
- *
- * @see elm_thumbscroll_zoom_friction_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_zoom_friction_all_set(double friction);
-
- /**
- * Get whether scrollers should be draggable from any point in their
- * views.
- *
- * @return the thumb scroll state
- *
- * @note This is the default behavior for touch screens, in general.
- * @note All other functions namespaced with "thumbscroll" will only
- * have effect if this mode is enabled.
- *
- * @ingroup Scrolling
- */
- EAPI Eina_Bool elm_scroll_thumbscroll_enabled_get(void);
-
- /**
- * Set whether scrollers should be draggable from any point in their
- * views.
- *
- * @param enabled the thumb scroll state
- *
- * @see elm_thumbscroll_enabled_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_thumbscroll_enabled_set(Eina_Bool enabled);
-
- /**
- * Set whether scrollers should be draggable from any point in their
- * views, for all Elementary application windows.
- *
- * @param enabled the thumb scroll state
- *
- * @see elm_thumbscroll_enabled_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
-
- /**
- * Get the number of pixels one should travel while dragging a
- * scroller's view to actually trigger scrolling.
- *
- * @return the thumb scroll threshould
- *
- * One would use higher values for touch screens, in general, because
- * of their inherent imprecision.
- * @ingroup Scrolling
- */
- EAPI unsigned int elm_scroll_thumbscroll_threshold_get(void);
-
- /**
- * Set the number of pixels one should travel while dragging a
- * scroller's view to actually trigger scrolling.
- *
- * @param threshold the thumb scroll threshould
- *
- * @see elm_thumbscroll_threshould_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_thumbscroll_threshold_set(unsigned int threshold);
-
- /**
- * Set the number of pixels one should travel while dragging a
- * scroller's view to actually trigger scrolling, for all Elementary
- * application windows.
- *
- * @param threshold the thumb scroll threshould
- *
- * @see elm_thumbscroll_threshould_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
-
- /**
- * Get the minimum speed of mouse cursor movement which will trigger
- * list self scrolling animation after a mouse up event
- * (pixels/second).
- *
- * @return the thumb scroll momentum threshould
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_thumbscroll_momentum_threshold_get(void);
-
- /**
- * Set the minimum speed of mouse cursor movement which will trigger
- * list self scrolling animation after a mouse up event
- * (pixels/second).
- *
- * @param threshold the thumb scroll momentum threshould
- *
- * @see elm_thumbscroll_momentum_threshould_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_thumbscroll_momentum_threshold_set(double threshold);
-
- /**
- * Set the minimum speed of mouse cursor movement which will trigger
- * list self scrolling animation after a mouse up event
- * (pixels/second), for all Elementary application windows.
- *
- * @param threshold the thumb scroll momentum threshould
- *
- * @see elm_thumbscroll_momentum_threshould_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
-
- /**
- * Get the amount of inertia a scroller will impose at self scrolling
- * animations.
- *
- * @return the thumb scroll friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_thumbscroll_friction_get(void);
-
- /**
- * Set the amount of inertia a scroller will impose at self scrolling
- * animations.
- *
- * @param friction the thumb scroll friction
- *
- * @see elm_thumbscroll_friction_get()
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_thumbscroll_friction_set(double friction);
-
- /**
- * Set the amount of inertia a scroller will impose at self scrolling
- * animations, for all Elementary application windows.
- *
- * @param friction the thumb scroll friction
- *
- * @see elm_thumbscroll_friction_get()
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_thumbscroll_friction_all_set(double friction);
-
- /**
- * Get the amount of lag between your actual mouse cursor dragging
- * movement and a scroller's view movement itself, while pushing it
- * into bounce state manually.
- *
- * @return the thumb scroll border friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_thumbscroll_border_friction_get(void);
-
- /**
- * Set the amount of lag between your actual mouse cursor dragging
- * movement and a scroller's view movement itself, while pushing it
- * into bounce state manually.
- *
- * @param friction the thumb scroll border friction. @c 0.0 for
- * perfect synchrony between two movements, @c 1.0 for maximum
- * lag.
- *
- * @see elm_thumbscroll_border_friction_get()
- * @note parameter value will get bound to 0.0 - 1.0 interval, always
- *
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_thumbscroll_border_friction_set(double friction);
-
- /**
- * Set the amount of lag between your actual mouse cursor dragging
- * movement and a scroller's view movement itself, while pushing it
- * into bounce state manually, for all Elementary application windows.
- *
- * @param friction the thumb scroll border friction. @c 0.0 for
- * perfect synchrony between two movements, @c 1.0 for maximum
- * lag.
- *
- * @see elm_thumbscroll_border_friction_get()
- * @note parameter value will get bound to 0.0 - 1.0 interval, always
- *
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction);
-
- /**
- * Get the sensitivity amount which is be multiplied by the length of
- * mouse dragging.
- *
- * @return the thumb scroll sensitivity friction
- *
- * @ingroup Scrolling
- */
- EAPI double elm_scroll_thumbscroll_sensitivity_friction_get(void);
-
- /**
- * Set the sensitivity amount which is be multiplied by the length of
- * mouse dragging.
- *
- * @param friction the thumb scroll sensitivity friction. @c 0.1 for
- * minimun sensitivity, @c 1.0 for maximum sensitivity. 0.25
- * is proper.
- *
- * @see elm_thumbscroll_sensitivity_friction_get()
- * @note parameter value will get bound to 0.1 - 1.0 interval, always
- *
- * @ingroup Scrolling
- */
- EAPI void elm_scroll_thumbscroll_sensitivity_friction_set(double friction);
-
- /**
- * Set the sensitivity amount which is be multiplied by the length of
- * mouse dragging, for all Elementary application windows.
- *
- * @param friction the thumb scroll sensitivity friction. @c 0.1 for
- * minimun sensitivity, @c 1.0 for maximum sensitivity. 0.25
- * is proper.
- *
- * @see elm_thumbscroll_sensitivity_friction_get()
- * @note parameter value will get bound to 0.1 - 1.0 interval, always
- *
- * @ingroup Scrolling
- */
- // XXX: deprecate and replace with elm_config_all_flush()
- EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
-
- /**
- * @}
- */
-
- /**
- * Get the duration for occuring long press event.
- *
- * @return Timeout for long press event
- * @ingroup Longpress
- */
- EAPI double elm_longpress_timeout_get(void);
-
- /**
- * Set the duration for occuring long press event.
- *
- * @param lonpress_timeout Timeout for long press event
- * @ingroup Longpress
- */
- EAPI void elm_longpress_timeout_set(double longpress_timeout);
-
+/**
+ * @defgroup Config Elementary Config
+ * @ingroup Elementary
+ *
+ * Elementary configuration is formed by a set options bounded to a
+ * given @ref Profile profile, like @ref Theme theme, @ref Fingers
+ * "finger size", etc. These are functions with which one synchronizes
+ * changes made to those values to the configuration storing files, de
+ * facto. You most probably don't want to use the functions in this
+ * group unless you're writing an elementary configuration manager.
+ *
+ * @{
+ */
+
+/**
+ * Save back Elementary's configuration, so that it will persist on
+ * future sessions.
+ *
+ * @return @c EINA_TRUE, when successful. @c EINA_FALSE, otherwise.
+ * @ingroup Config
+ *
+ * This function will take effect -- thus, do I/O -- immediately. Use
+ * it when you want to save all configuration changes at once. The
+ * current configuration set will get saved onto the current profile
+ * configuration file.
+ *
+ */
+EAPI Eina_Bool elm_config_save(void);
+
+/**
+ * Reload Elementary's configuration, bounded to current selected
+ * profile.
+ *
+ * @return @c EINA_TRUE, when successful. @c EINA_FALSE, otherwise.
+ * @ingroup Config
+ *
+ * Useful when you want to force reloading of configuration values for
+ * a profile. If one removes user custom configuration directories,
+ * for example, it will force a reload with system values instead.
+ *
+ */
+EAPI void elm_config_reload(void);
+
+/**
+ * Flush all config settings then apply those settings to all applications
+ * using elementary on the current display.
+ *
+ * @ingroup Config
+ */
+EAPI void elm_config_all_flush(void);
+
+/**
+ * @}
+ */
+
+/**
+ * @defgroup Profile Elementary Profile
+ * @ingroup Elementary
+ *
+ * Profiles are pre-set options that affect the whole look-and-feel of
+ * Elementary-based applications. There are, for example, profiles
+ * aimed at desktop computer applications and others aimed at mobile,
+ * touchscreen-based ones. You most probably don't want to use the
+ * functions in this group unless you're writing an elementary
+ * configuration manager.
+ *
+ * @{
+ */
+
+/**
+ * Get Elementary's profile in use.
+ *
+ * This gets the global profile that is applied to all Elementary
+ * applications.
+ *
+ * @return The profile's name
+ * @ingroup Profile
+ */
+EAPI const char *elm_config_profile_get(void);
+
+/**
+ * Get an Elementary's profile directory path in the filesystem. One
+ * may want to fetch a system profile's dir or a user one (fetched
+ * inside $HOME).
+ *
+ * @param profile The profile's name
+ * @param is_user Whether to lookup for a user profile (@c EINA_TRUE)
+ * or a system one (@c EINA_FALSE)
+ * @return The profile's directory path.
+ * @ingroup Profile
+ *
+ * @note You must free it with elm_config_profile_dir_free().
+ */
+EAPI const char *elm_config_profile_dir_get(const char *profile, Eina_Bool is_user);
+
+/**
+ * Free an Elementary's profile directory path, as returned by
+ * elm_config_profile_dir_get().
+ *
+ * @param p_dir The profile's path
+ * @ingroup Profile
+ *
+ */
+EAPI void elm_config_profile_dir_free(const char *p_dir);
+
+/**
+ * Get Elementary's list of available profiles.
+ *
+ * @return The profiles list. List node data are the profile name
+ * strings.
+ * @ingroup Profile
+ *
+ * @note One must free this list, after usage, with the function
+ * elm_config_profile_list_free().
+ */
+EAPI Eina_List *elm_config_profile_list_get(void);
+
+/**
+ * Free Elementary's list of available profiles.
+ *
+ * @param l The profiles list, as returned by elm_config_profile_list_get().
+ * @ingroup Profile
+ *
+ */
+EAPI void elm_config_profile_list_free(Eina_List *l);
+
+/**
+ * Set Elementary's profile.
+ *
+ * This sets the global profile that is applied to Elementary
+ * applications. Just the process the call comes from will be
+ * affected.
+ *
+ * @param profile The profile's name
+ * @ingroup Profile
+ *
+ */
+EAPI void elm_config_profile_set(const char *profile);
+
+/**
+ * Check if the given Elementary's profile exists.
+ *
+ * @param profile The profile's name
+ * @return EINA_TRUE if the profile exists, EINA_FALSE otherwise.
+ *
+ * @ingroup Profile
+ */
+EAPI Eina_Bool elm_config_profile_exists(const char *profile);
+
+/**
+ * @}
+ */
+
+/**
+ * @defgroup Scrolling Elementary Scrolling
+ * @ingroup Elementary
+ *
+ * These are functions setting how scrollable views in Elementary
+ * widgets should behave on user interaction.
+ *
+ * @{
+ */
+
+/**
+ * Get whether scrollers should bounce when they reach their
+ * viewport's edge during a scroll.
+ *
+ * @return the thumb scroll bouncing state
+ *
+ * This is the default behavior for touch screens, in general.
+ * @ingroup Scrolling
+ */
+EAPI Eina_Bool elm_config_scroll_bounce_enabled_get(void);
+
+/**
+ * Set whether scrollers should bounce when they reach their
+ * viewport's edge during a scroll.
+ *
+ * @param enabled the thumb scroll bouncing state
+ *
+ * @see elm_config_scroll_bounce_enabled_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_bounce_enabled_set(Eina_Bool enabled);
+
+/**
+ * Get the amount of inertia a scroller will impose at bounce
+ * animations.
+ *
+ * @return the thumb scroll bounce friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_bounce_friction_get(void);
+
+/**
+ * Set the amount of inertia a scroller will impose at bounce
+ * animations.
+ *
+ * @param friction the thumb scroll bounce friction
+ *
+ * @see elm_config_scroll_bounce_friction_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_bounce_friction_set(double friction);
+
+/**
+ * Get the amount of inertia a <b>paged</b> scroller will impose at
+ * page fitting animations.
+ *
+ * @return the page scroll friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_page_scroll_friction_get(void);
+
+/**
+ * Set the amount of inertia a <b>paged</b> scroller will impose at
+ * page fitting animations.
+ *
+ * @param friction the page scroll friction
+ *
+ * @see elm_config_scroll_page_scroll_friction_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_page_scroll_friction_set(double friction);
+
+/**
+ * Get the amount of inertia a scroller will impose at region bring
+ * animations.
+ *
+ * @return the bring in scroll friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_bring_in_scroll_friction_get(void);
+
+/**
+ * Set the amount of inertia a scroller will impose at region bring
+ * animations.
+ *
+ * @param friction the bring in scroll friction
+ *
+ * @see elm_config_scroll_bring_in_scroll_friction_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_bring_in_scroll_friction_set(double friction);
+
+/**
+ * Get the amount of inertia scrollers will impose at animations
+ * triggered by Elementary widgets' zooming API.
+ *
+ * @return the zoom friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_zoom_friction_get(void);
+
+/**
+ * Set the amount of inertia scrollers will impose at animations
+ * triggered by Elementary widgets' zooming API.
+ *
+ * @param friction the zoom friction
+ *
+ * @see elm_config_scroll_zoom_friction_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_zoom_friction_set(double friction);
+
+/**
+ * Get whether scrollers should be draggable from any point in their
+ * views.
+ *
+ * @return the thumb scroll state
+ *
+ * @note This is the default behavior for touch screens, in general.
+ * @note All other functions namespaced with "thumbscroll" will only
+ * have effect if this mode is enabled.
+ *
+ * @ingroup Scrolling
+ */
+EAPI Eina_Bool elm_config_scroll_thumbscroll_enabled_get(void);
+
+/**
+ * Set whether scrollers should be draggable from any point in their
+ * views.
+ *
+ * @param enabled the thumb scroll state
+ *
+ * @see elm_config_scroll_thumbscroll_enabled_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_thumbscroll_enabled_set(Eina_Bool enabled);
+
+/**
+ * Get the number of pixels one should travel while dragging a
+ * scroller's view to actually trigger scrolling.
+ *
+ * @return the thumb scroll threshold
+ *
+ * One would use higher values for touch screens, in general, because
+ * of their inherent imprecision.
+ * @ingroup Scrolling
+ */
+EAPI unsigned int elm_config_scroll_thumbscroll_threshold_get(void);
+
+/**
+ * Set the number of pixels one should travel while dragging a
+ * scroller's view to actually trigger scrolling.
+ *
+ * @param threshold the thumb scroll threshold
+ *
+ * @see elm_config_thumbscroll_threshold_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_thumbscroll_threshold_set(unsigned int threshold);
+
+/**
+ * Get the minimum speed of mouse cursor movement which will trigger
+ * list self scrolling animation after a mouse up event
+ * (pixels/second).
+ *
+ * @return the thumb scroll momentum threshold
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_thumbscroll_momentum_threshold_get(void);
+
+/**
+ * Set the minimum speed of mouse cursor movement which will trigger
+ * list self scrolling animation after a mouse up event
+ * (pixels/second).
+ *
+ * @param threshold the thumb scroll momentum threshold
+ *
+ * @see elm_config_thumbscroll_momentum_threshold_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_thumbscroll_momentum_threshold_set(double threshold);
+
+/**
+ * Get the amount of inertia a scroller will impose at self scrolling
+ * animations.
+ *
+ * @return the thumb scroll friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_thumbscroll_friction_get(void);
+
+/**
+ * Set the amount of inertia a scroller will impose at self scrolling
+ * animations.
+ *
+ * @param friction the thumb scroll friction
+ *
+ * @see elm_config_thumbscroll_friction_get()
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_thumbscroll_friction_set(double friction);
+
+/**
+ * Get the amount of lag between your actual mouse cursor dragging
+ * movement and a scroller's view movement itself, while pushing it
+ * into bounce state manually.
+ *
+ * @return the thumb scroll border friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_thumbscroll_border_friction_get(void);
+
+/**
+ * Set the amount of lag between your actual mouse cursor dragging
+ * movement and a scroller's view movement itself, while pushing it
+ * into bounce state manually.
+ *
+ * @param friction the thumb scroll border friction. @c 0.0 for
+ * perfect synchrony between two movements, @c 1.0 for maximum
+ * lag.
+ *
+ * @see elm_config_thumbscroll_border_friction_get()
+ * @note parameter value will get bound to 0.0 - 1.0 interval, always
+ *
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_thumbscroll_border_friction_set(double friction);
+
+/**
+ * Get the sensitivity amount which is be multiplied by the length of
+ * mouse dragging.
+ *
+ * @return the thumb scroll sensitivity friction
+ *
+ * @ingroup Scrolling
+ */
+EAPI double elm_config_scroll_thumbscroll_sensitivity_friction_get(void);
+
+/**
+ * Set the sensitivity amount which is be multiplied by the length of
+ * mouse dragging.
+ *
+ * @param friction the thumb scroll sensitivity friction. @c 0.1 for
+ * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
+ * is proper.
+ *
+ * @see elm_config_thumbscroll_sensitivity_friction_get()
+ * @note parameter value will get bound to 0.1 - 1.0 interval, always
+ *
+ * @ingroup Scrolling
+ */
+EAPI void elm_config_scroll_thumbscroll_sensitivity_friction_set(double friction);
+
+/**
+ * @}
+ */
+
+/**
+ * Get the duration for occurring long press event.
+ *
+ * @return Timeout for long press event
+ * @ingroup Longpress
+ */
+EAPI double elm_config_longpress_timeout_get(void);
+
+/**
+ * Set the duration for occurring long press event.
+ *
+ * @param lonpress_timeout Timeout for long press event
+ * @ingroup Longpress
+ */
+EAPI void elm_config_longpress_timeout_set(double longpress_timeout);
+
+/**
+ * Get the duration after which tooltip will be shown.
+ *
+ * @return Duration after which tooltip will be shown.
+ */
+EAPI double elm_config_tooltip_delay_get(void);
+
+/**
+ * Set the duration after which tooltip will be shown.
+ *
+ * @return EINA_TRUE if value is set.
+ */
+EAPI void elm_config_tooltip_delay_set(double delay);
+
+/**
+ * Get the configured cursor engine only usage
+ *
+ * This gets the globally configured exclusive usage of engine cursors.
+ *
+ * @return 1 if only engine cursors should be used
+ * @ingroup Cursors
+ */
+EAPI Eina_Bool elm_config_cursor_engine_only_get(void);
+
+/**
+ * Set the configured cursor engine only usage
+ *
+ * This sets the globally configured exclusive usage of engine cursors.
+ * It won't affect cursors set before changing this value.
+ *
+ * @param engine_only If 1 only engine cursors will be enabled, if 0 will
+ * look for them on theme before.
+ * @ingroup Cursors
+ */
+EAPI void elm_config_cursor_engine_only_set(Eina_Bool engine_only);
+
+/**
+ * Get the global scaling factor
+ *
+ * This gets the globally configured scaling factor that is applied to all
+ * objects.
+ *
+ * @return The scaling factor
+ * @ingroup Scaling
+ */
+EAPI double elm_config_scale_get(void);
+EAPI double elm_scale_get(void);
+
+/**
+ * Set the global scaling factor
+ *
+ * This sets the globally configured scaling factor that is applied to all
+ * objects.
+ *
+ * @param scale The scaling factor to set
+ * @ingroup Scaling
+ */
+EAPI void elm_config_scale_set(double scale);
+EAPI void elm_scale_set(double scale);
+
+/**
+ * @defgroup Password_last_show Password show last
+ * @ingroup Elementary
+ *
+ * Show last feature of password mode enables user to view
+ * the last input entered for few seconds before masking it.
+ * These functions allow to set this feature in password mode
+ * of entry widget and also allow to manipulate the duration
+ * for which the input has to be visible.
+ *
+ * @{
+ */
+
+/**
+ * Get the "show last" setting of password mode.
+ *
+ * This gets the "show last" setting of password mode which might be
+ * enabled or disabled.
+ *
+ * @return @c EINA_TRUE, if the "show last" setting is enabled,
+ * @c EINA_FALSE if it's disabled.
+ *
+ * @ingroup Password_last_show
+ */
+EAPI Eina_Bool elm_config_password_show_last_get(void);
+
+/**
+ * Set show last setting in password mode.
+ *
+ * This enables or disables show last setting of password mode.
+ *
+ * @param password_show_last If EINA_TRUE enables "show last" in password mode.
+ * @see elm_config_password_show_last_timeout_set()
+ * @ingroup Password_last_show
+ */
+EAPI void elm_config_password_show_last_set(Eina_Bool password_show_last);
+
+/**
+ * Gets the timeout value in "show last" password mode.
+ *
+ * This gets the time out value for which the last input entered in password
+ * mode will be visible.
+ *
+ * @return The timeout value of "show last" password mode.
+ * @ingroup Password_last_show
+ */
+EAPI double elm_config_password_show_last_timeout_get(void);
+
+/**
+ * Set's the timeout value in "show last" password mode.
+ *
+ * This sets the time out value for which the last input entered in password
+ * mode will be visible.
+ *
+ * @param password_show_last_timeout The timeout value.
+ * @see elm_config_password_show_last_set()
+ * @ingroup Password_last_show
+ */
+EAPI void elm_config_password_show_last_timeout_set(double password_show_last_timeout);
+
+/**
+ * @}
+ */
+
+/**
+ * @defgroup Engine Elementary Engine
+ * @ingroup Elementary
+ *
+ * These are functions setting and querying which rendering engine
+ * Elementary will use for drawing its windows' pixels.
+ *
+ * The following are the available engines:
+ * @li "software_x11"
+ * @li "fb"
+ * @li "directfb"
+ * @li "software_16_x11"
+ * @li "software_8_x11"
+ * @li "xrender_x11"
+ * @li "opengl_x11"
+ * @li "software_gdi"
+ * @li "software_16_wince_gdi"
+ * @li "sdl"
+ * @li "software_16_sdl"
+ * @li "opengl_sdl"
+ * @li "buffer"
+ * @li "ews"
+ * @li "opengl_cocoa"
+ * @li "psl1ght"
+ *
+ * @{
+ */
+
+/**
+ * @brief Get Elementary's rendering engine in use.
+ *
+ * @return The rendering engine's name
+ * @note there's no need to free the returned string, here.
+ *
+ * This gets the global rendering engine that is applied to all Elementary
+ * applications.
+ *
+ * @see elm_config_engine_set()
+ */
+EAPI const char *elm_config_engine_get(void);
+
+/**
+ * @brief Set Elementary's rendering engine for use.
+ *
+ * @param engine The rendering engine's name
+ *
+ * Note that it will take effect only to Elementary windows created after
+ * this is called.
+ *
+ * @see elm_win_add()
+ */
+EAPI void elm_config_engine_set(const char *engine);
+
+/**
+ * @brief Get Elementary's preferred engine to use.
+ *
+ * @return The rendering engine's name
+ * @note there's no need to free the returned string, here.
+ *
+ * This gets the global rendering engine that is applied to all Elementary
+ * applications and is PREFERRED by the application. This can (and will)
+ * override the engine configured for all applications which.
+ *
+ * @see elm_config_preferred_engine_set()
+ */
+EAPI const char *elm_config_preferred_engine_get(void);
+
+/**
+ * @brief Set Elementary's preferred rendering engine for use.
+ *
+ * @param engine The rendering engine's name
+ *
+ * Note that it will take effect only to Elementary windows created after
+ * this is called. This overrides the engine set by configuration at
+ * application startup. Note that it is a hint and may not be honored.
+ *
+ * @see elm_win_add()
+ */
+EAPI void elm_config_preferred_engine_set(const char *engine);
+
+typedef struct _Elm_Text_Class
+{
+ const char *name;
+ const char *desc;
+} Elm_Text_Class;
+
+typedef struct _Elm_Font_Overlay
+{
+ const char *text_class;
+ const char *font;
+ Evas_Font_Size size;
+} Elm_Font_Overlay;
+
+/**
+ * Get Elementary's list of supported text classes.
+ *
+ * @return The text classes list, with @c Elm_Text_Class blobs as data.
+ * @ingroup Fonts
+ *
+ * Release the list with elm_text_classes_list_free().
+ */
+EAPI Eina_List *elm_config_text_classes_list_get(void);
+
+/**
+ * Free Elementary's list of supported text classes.
+ *
+ * @ingroup Fonts
+ *
+ * @see elm_config_text_classes_list_get().
+ */
+EAPI void elm_config_text_classes_list_free(Eina_List *list);
+
+/**
+ * Get Elementary's list of font overlays, set with
+ * elm_config_font_overlay_set().
+ *
+ * @return The font overlays list, with @c Elm_Font_Overlay blobs as
+ * data.
+ *
+ * @ingroup Fonts
+ *
+ * For each text class, one can set a <b>font overlay</b> for it,
+ * overriding the default font properties for that class coming from
+ * the theme in use. There is no need to free this list.
+ *
+ * @see elm_config_font_overlay_set() and elm_config_font_overlay_unset().
+ */
+EAPI const Eina_List *elm_config_font_overlay_list_get(void);
+
+/**
+ * Set a font overlay for a given Elementary text class.
+ *
+ * @param text_class Text class name
+ * @param font Font name and style string
+ * @param size Font size
+ *
+ * @ingroup Fonts
+ *
+ * @p font has to be in the format returned by
+ * elm_font_fontconfig_name_get(). @see elm_config_font_overlay_list_get()
+ * and elm_config_font_overlay_unset().
+ */
+EAPI void elm_config_font_overlay_set(const char *text_class, const char *font, Evas_Font_Size size);
+
+/**
+ * Unset a font overlay for a given Elementary text class.
+ *
+ * @param text_class Text class name
+ *
+ * @ingroup Fonts
+ *
+ * This will bring back text elements belonging to text class
+ * @p text_class back to their default font settings.
+ */
+EAPI void elm_config_font_overlay_unset(const char *text_class);
+
+/**
+ * Apply the changes made with elm_config_font_overlay_set() and
+ * elm_config_font_overlay_unset() on the current Elementary window.
+ *
+ * @ingroup Fonts
+ *
+ * This applies all font overlays set to all objects in the UI.
+ */
+EAPI void elm_config_font_overlay_apply(void);
+
+/**
+ * Get the configured "finger size"
+ *
+ * @return The finger size
+ *
+ * This gets the globally configured finger size, <b>in pixels</b>
+ *
+ * @ingroup Fingers
+ */
+EAPI Evas_Coord elm_config_finger_size_get(void);
+// WRAPPER: Temperary Added.
+EAPI Evas_Coord elm_finger_size_get(void);
+
+/**
+ * Set the configured finger size
+ *
+ * This sets the globally configured finger size in pixels
+ *
+ * @param size The finger size
+ * @ingroup Fingers
+ */
+EAPI void elm_config_finger_size_set(Evas_Coord size);
+// WRAPPER: Temperary Added.
+EAPI void elm_finger_size_set(Evas_Coord size);
+
+
+/**
+ * Get the configured cache flush interval time
+ *
+ * This gets the globally configured cache flush interval time, in
+ * ticks
+ *
+ * @return The cache flush interval time
+ * @ingroup Caches
+ *
+ * @see elm_cache_all_flush()
+ */
+EAPI int elm_config_cache_flush_interval_get(void);
+
+/**
+ * Set the configured cache flush interval time
+ *
+ * This sets the globally configured cache flush interval time, in ticks
+ *
+ * @param size The cache flush interval time
+ * @ingroup Caches
+ *
+ * @see elm_cache_all_flush()
+ */
+EAPI void elm_config_cache_flush_interval_set(int size);
+
+/**
+ * Get the configured cache flush enabled state
+ *
+ * This gets the globally configured cache flush state - if it is enabled
+ * or not. When cache flushing is enabled, elementary will regularly
+ * (see elm_config_cache_flush_interval_get() ) flush caches and dump data out of
+ * memory and allow usage to re-seed caches and data in memory where it
+ * can do so. An idle application will thus minimize its memory usage as
+ * data will be freed from memory and not be re-loaded as it is idle and
+ * not rendering or doing anything graphically right now.
+ *
+ * @return The cache flush state
+ * @ingroup Caches
+ *
+ * @see elm_cache_all_flush()
+ */
+EAPI Eina_Bool elm_config_cache_flush_enabled_get(void);
+
+/**
+ * Set the configured cache flush enabled state
+ *
+ * This sets the globally configured cache flush enabled state.
+ *
+ * @param enabled The cache flush enabled state
+ * @ingroup Caches
+ *
+ * @see elm_cache_all_flush()
+ */
+EAPI void elm_config_cache_flush_enabled_set(Eina_Bool enabled);
+
+/**
+ * Get the configured font cache size
+ *
+ * This gets the globally configured font cache size, in bytes.
+ *
+ * @return The font cache size
+ * @ingroup Caches
+ */
+EAPI int elm_config_cache_font_cache_size_get(void);
+
+/**
+ * Set the configured font cache size
+ *
+ * This sets the globally configured font cache size, in bytes
+ *
+ * @param size The font cache size
+ * @ingroup Caches
+ */
+EAPI void elm_config_cache_font_cache_size_set(int size);
+
+/**
+ * Get the configured image cache size
+ *
+ * This gets the globally configured image cache size, in bytes
+ *
+ * @return The image cache size
+ * @ingroup Caches
+ */
+EAPI int elm_config_cache_image_cache_size_get(void);
+
+/**
+ * Set the configured image cache size
+ *
+ * This sets the globally configured image cache size, in bytes
+ *
+ * @param size The image cache size
+ * @ingroup Caches
+ */
+EAPI void elm_config_cache_image_cache_size_set(int size);
+
+
+/**
+ * Get the configured edje file cache size.
+ *
+ * This gets the globally configured edje file cache size, in number
+ * of files.
+ *
+ * @return The edje file cache size
+ * @ingroup Caches
+ */
+EAPI int elm_config_cache_edje_file_cache_size_get(void);
+
+/**
+ * Set the configured edje file cache size
+ *
+ * This sets the globally configured edje file cache size, in number
+ * of files.
+ *
+ * @param size The edje file cache size
+ * @ingroup Caches
+ */
+EAPI void elm_config_cache_edje_file_cache_size_set(int size);
+
+/**
+ * Get the configured edje collections (groups) cache size.
+ *
+ * This gets the globally configured edje collections cache size, in
+ * number of collections.
+ *
+ * @return The edje collections cache size
+ * @ingroup Caches
+ */
+EAPI int elm_config_cache_edje_collection_cache_size_get(void);
+
+/**
+ * Set the configured edje collections (groups) cache size
+ *
+ * This sets the globally configured edje collections cache size, in
+ * number of collections.
+ *
+ * @param size The edje collections cache size
+ * @ingroup Caches
+ */
+EAPI void elm_config_cache_edje_collection_cache_size_set(int size);
+
+/**
+ * Get the enable status of the focus highlight
+ *
+ * This gets whether the highlight on focused objects is enabled or not
+ *
+ * @see elm_config_focus_highlight_enabled_set()
+ * @ingroup Focus
+ */
+EAPI Eina_Bool elm_config_focus_highlight_enabled_get(void);
+
+/**
+ * Set the enable status of the focus highlight
+ *
+ * @param enable Enable highlight if EINA_TRUE, disable otherwise
+ *
+ * Set whether to show or not the highlight on focused objects
+ *
+ * Note that it will take effect only to Elementary windows created after
+ * this is called.
+ *
+ * @see elm_win_add()
+ *
+ * @ingroup Focus
+ */
+EAPI void elm_config_focus_highlight_enabled_set(Eina_Bool enable);
+
+/**
+ * Get the enable status of the highlight animation
+ *
+ * @return The focus highlight mode set
+ *
+ * Get whether the focus highlight, if enabled, will animate its switch from
+ * one object to the next
+ *
+ * @ingroup Focus
+ */
+EAPI Eina_Bool elm_config_focus_highlight_animate_get(void);
+
+/**
+ * Set the enable status of the highlight animation
+ *
+ * @param animate Enable animation if EINA_TRUE, disable otherwise
+ *
+ * Set whether the focus highlight, if enabled, will animate its switch from
+ * one object to the next
+ *
+ * Note that it will take effect only to Elementary windows created after
+ * this is called.
+ *
+ * @see elm_win_add()
+ *
+ * @ingroup Focus
+ */
+EAPI void elm_config_focus_highlight_animate_set(Eina_Bool animate);
+
+/**
+ * Get the system mirrored mode. This determines the default mirrored mode
+ * of widgets.
+ *
+ * @return EINA_TRUE if mirrored is set, EINA_FALSE otherwise
+ */
+EAPI Eina_Bool elm_config_mirrored_get(void);
+
+/**
+ * Set the system mirrored mode. This determines the default mirrored mode
+ * of widgets.
+ *
+ * @param mirrored EINA_TRUE to set mirrored mode, EINA_FALSE to unset it.
+ */
+EAPI void elm_config_mirrored_set(Eina_Bool mirrored);
+
+/**
+ * @}
+ */
projects / framework / uifw / elementary.git / blobdiff