382 lines
12 KiB
C
382 lines
12 KiB
C
#ifndef _ELM_PREFS_EO_H_
|
|
#define _ELM_PREFS_EO_H_
|
|
|
|
#ifndef _ELM_PREFS_EO_CLASS_TYPE
|
|
#define _ELM_PREFS_EO_CLASS_TYPE
|
|
|
|
typedef Eo Elm_Prefs;
|
|
|
|
#endif
|
|
|
|
#ifndef _ELM_PREFS_EO_TYPES
|
|
#define _ELM_PREFS_EO_TYPES
|
|
|
|
|
|
#endif
|
|
/** Elementary preferences class
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
#define ELM_PREFS_CLASS elm_prefs_class_get()
|
|
|
|
EWAPI const Efl_Class *elm_prefs_class_get(void);
|
|
|
|
/**
|
|
* @brief Set user data for a given prefs widget
|
|
*
|
|
* Once a prefs widget is created, after elm_prefs_file_set() is issued on it,
|
|
* all of its UI elements will get default values, when declared on that file.
|
|
* To fetch a user's own, personal set of those values, one gets to pair a
|
|
* prefs data handle to the prefs widget. This is what this call is intended
|
|
* for.
|
|
*
|
|
* Prefs data values from @c prefs_data with keys matching the ones present on
|
|
* the file passed on elm_prefs_file_set() to @c obj will have their values
|
|
* applied to the respective UI elements of the widget.
|
|
*
|
|
* When @c obj dies, the values of the elements declared on its $.epb file (the
|
|
* one set on elm_prefs_file_set()) marked as permanent will be written back to
|
|
* prefs_data, if it is writable. One is also able to make this writing event
|
|
* to take place automatically after each UI element modification by using
|
|
* elm_prefs_autosave_set().
|
|
*
|
|
* @note @c obj will keep a reference of its own for @c prefs_data, but you
|
|
* should still unreference it by yourself, after the widget is gone.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] data A valid prefs_data handle
|
|
*
|
|
* @return @c true, on success, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_data_set(Eo *obj, Elm_Prefs_Data *data);
|
|
|
|
/**
|
|
* @brief Set user data for a given prefs widget
|
|
*
|
|
* Once a prefs widget is created, after elm_prefs_file_set() is issued on it,
|
|
* all of its UI elements will get default values, when declared on that file.
|
|
* To fetch a user's own, personal set of those values, one gets to pair a
|
|
* prefs data handle to the prefs widget. This is what this call is intended
|
|
* for.
|
|
*
|
|
* Prefs data values from @c prefs_data with keys matching the ones present on
|
|
* the file passed on elm_prefs_file_set() to @c obj will have their values
|
|
* applied to the respective UI elements of the widget.
|
|
*
|
|
* When @c obj dies, the values of the elements declared on its $.epb file (the
|
|
* one set on elm_prefs_file_set()) marked as permanent will be written back to
|
|
* prefs_data, if it is writable. One is also able to make this writing event
|
|
* to take place automatically after each UI element modification by using
|
|
* elm_prefs_autosave_set().
|
|
*
|
|
* @note @c obj will keep a reference of its own for @c prefs_data, but you
|
|
* should still unreference it by yourself, after the widget is gone.
|
|
*
|
|
* @param[in] obj The object.
|
|
*
|
|
* @return A valid prefs_data handle
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Elm_Prefs_Data *elm_obj_prefs_data_get(const Eo *obj);
|
|
|
|
/**
|
|
* @brief Control whether a given prefs widget should save its values back (on
|
|
* the user data file, if set) automatically on every UI element changes.
|
|
*
|
|
* If @c autosave is @c true, every call to elm_prefs_item_value_set(), every
|
|
* Elm_Prefs_Data_Event_Type.ELM_PREFS_DATA_EVENT_ITEM_CHANGED event coming for
|
|
* its prefs data and every UI element direct value changing will implicitly
|
|
* make the prefs values to be flushed back to it prefs data. If a prefs data
|
|
* handle with no writing permissions or no prefs data is set on @c prefs,
|
|
* naturally nothing will happen.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] autosave @c true to save automatically, @c false otherwise.
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI void elm_obj_prefs_autosave_set(Eo *obj, Eina_Bool autosave);
|
|
|
|
/**
|
|
* @brief Control whether a given prefs widget should save its values back (on
|
|
* the user data file, if set) automatically on every UI element changes.
|
|
*
|
|
* If @c autosave is @c true, every call to elm_prefs_item_value_set(), every
|
|
* Elm_Prefs_Data_Event_Type.ELM_PREFS_DATA_EVENT_ITEM_CHANGED event coming for
|
|
* its prefs data and every UI element direct value changing will implicitly
|
|
* make the prefs values to be flushed back to it prefs data. If a prefs data
|
|
* handle with no writing permissions or no prefs data is set on @c prefs,
|
|
* naturally nothing will happen.
|
|
*
|
|
* @param[in] obj The object.
|
|
*
|
|
* @return @c true to save automatically, @c false otherwise.
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_autosave_get(const Eo *obj);
|
|
|
|
/**
|
|
* @brief Reset the values of a given prefs widget to a previous state.
|
|
*
|
|
* As can be seen on #Elm_Prefs_Reset_Mode, there are two possible actions to
|
|
* be taken by this call -- either to reset @c prefs' values to the defaults
|
|
* (declared on the $.epb file it is bound to) or to reset to the state they
|
|
* were before the last modification it got.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] mode The reset mode to apply on @c prefs
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI void elm_obj_prefs_reset(Eo *obj, Elm_Prefs_Reset_Mode mode);
|
|
|
|
/**
|
|
* @brief Set the value on a given prefs widget's item.
|
|
*
|
|
* This will change the value of item named @c name programmatically.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* @param[in] value The value to set on the item. It should be typed as the
|
|
* item expects, preferably, or a conversion will take place
|
|
*
|
|
* @return @c true, on success, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_item_value_set(Eo *obj, const char *name, const Eina_Value *value);
|
|
|
|
/**
|
|
* @brief Get the value of a given prefs widget's item.
|
|
*
|
|
* This will retrieve the value of item named @c name.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to get value from
|
|
* @param[out] value Where to store the value of the item. It will be
|
|
* overwritten and setup with the type the item is bound to
|
|
*
|
|
* @return @c true, on success, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_item_value_get(const Eo *obj, const char *name, Eina_Value *value);
|
|
|
|
/**
|
|
* @brief Get the Elementary widget bound to a given prefs widget's item.
|
|
*
|
|
* This will retrieve a handle to the real widget implementing a given item of
|
|
* @c prefs, <b>for read-only</b> actions.
|
|
*
|
|
* @warning You should never modify the state of the returned widget, because
|
|
* it's meant to be managed by @c prefs, solely.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to get object from
|
|
*
|
|
* @return A valid widget handle, on success, or @c NULL, otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI const Efl_Canvas_Object *elm_obj_prefs_item_object_get(Eo *obj, const char *name);
|
|
|
|
/**
|
|
* @brief Set whether the widget bound to a given prefs widget's item is
|
|
* disabled or not.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to act on
|
|
* @param[in] disabled @c true, to make it disabled, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI void elm_obj_prefs_item_disabled_set(Eo *obj, const char *name, Eina_Bool disabled);
|
|
|
|
/**
|
|
* @brief Get whether the widget bound to a given prefs widget's item is
|
|
* disabled or not.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to get disabled state from
|
|
*
|
|
* @return @c true, if it is disabled, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_item_disabled_get(const Eo *obj, const char *name);
|
|
|
|
/**
|
|
* @brief "Swallows" an object into a SWALLOW item of a prefs widget.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the SWALLOW item (as declared in the prefs
|
|
* collection)
|
|
* @param[in] child The object to occupy the item
|
|
*
|
|
* @return @c true, on success, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_item_swallow(Eo *obj, const char *name, Efl_Canvas_Object *child);
|
|
|
|
/**
|
|
* @brief Set whether the widget bound to a given prefs widget's item is
|
|
* editable or not.
|
|
*
|
|
* @note Only @c TEXT or @c TEXTAREA items' default widgets implement the
|
|
* 'editable' property. Custom registered widgets may as well implement them.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to act on
|
|
* @param[in] editable @c true, to make it editable, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI void elm_obj_prefs_item_editable_set(Eo *obj, const char *name, Eina_Bool editable);
|
|
|
|
/**
|
|
* @brief Get whether the widget bound to a given prefs widget's item is
|
|
* editable or not.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to get editable state from
|
|
*
|
|
* @return @c true, if it is editable, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_item_editable_get(const Eo *obj, const char *name);
|
|
|
|
/**
|
|
* @brief Unswallow an object from a SWALLOW item of a prefs widget.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the SWALLOW item (as declared in the prefs
|
|
* collection)
|
|
*
|
|
* @return The unswallowed object, or NULL on errors
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Efl_Canvas_Object *elm_obj_prefs_item_unswallow(Eo *obj, const char *name);
|
|
|
|
/**
|
|
* @brief Set whether the widget bound to given prefs widget's item should be
|
|
* visible or not.
|
|
*
|
|
* Each prefs item may have a default visibility state, declared on the $.epb
|
|
* @c prefs it was loaded with. By this call one may alter that state,
|
|
* programmatically.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to change visibility of
|
|
* @param[in] visible @c true, to make it visible, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI void elm_obj_prefs_item_visible_set(Eo *obj, const char *name, Eina_Bool visible);
|
|
|
|
/**
|
|
* @brief Get whether the widget bound to a given prefs widget's item is
|
|
* visible or not.
|
|
*
|
|
* @param[in] obj The object.
|
|
* @param[in] name The name of the item (as declared in the prefs collection)
|
|
* to get visibility state from
|
|
*
|
|
* @return @c true, if it is visible, @c false otherwise
|
|
*
|
|
* @since 1.8
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
EOAPI Eina_Bool elm_obj_prefs_item_visible_get(const Eo *obj, const char *name);
|
|
|
|
EWAPI extern const Efl_Event_Description _ELM_PREFS_EVENT_PAGE_CHANGED;
|
|
|
|
/** Called when page changed
|
|
* @return const char *
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
#define ELM_PREFS_EVENT_PAGE_CHANGED (&(_ELM_PREFS_EVENT_PAGE_CHANGED))
|
|
|
|
EWAPI extern const Efl_Event_Description _ELM_PREFS_EVENT_PAGE_SAVED;
|
|
|
|
/** Called when page was saved
|
|
* @return const char *
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
#define ELM_PREFS_EVENT_PAGE_SAVED (&(_ELM_PREFS_EVENT_PAGE_SAVED))
|
|
|
|
EWAPI extern const Efl_Event_Description _ELM_PREFS_EVENT_PAGE_LOADED;
|
|
|
|
/** Called when page got loaded
|
|
* @return const char *
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
#define ELM_PREFS_EVENT_PAGE_LOADED (&(_ELM_PREFS_EVENT_PAGE_LOADED))
|
|
|
|
EWAPI extern const Efl_Event_Description _ELM_PREFS_EVENT_ITEM_CHANGED;
|
|
|
|
/** Called when item changed
|
|
* @return const char *
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
#define ELM_PREFS_EVENT_ITEM_CHANGED (&(_ELM_PREFS_EVENT_ITEM_CHANGED))
|
|
|
|
EWAPI extern const Efl_Event_Description _ELM_PREFS_EVENT_ACTION;
|
|
|
|
/** Called when action was done
|
|
* @return const char *
|
|
*
|
|
* @ingroup Elm_Prefs
|
|
*/
|
|
#define ELM_PREFS_EVENT_ACTION (&(_ELM_PREFS_EVENT_ACTION))
|
|
|
|
#endif
|