forked from enlightenment/efl
General Group created in Edje documentation.
Author: Lucas Joia <lucasjoia@profusion.mobi> SVN revision: 76608
This commit is contained in:
parent
d892ddd73d
commit
ad9c856233
|
@ -56,7 +56,8 @@
|
|||
<li><a href="luaref.html">LUA scripting</a></li>
|
||||
<li><a href="Edje_8h.html">Edje API</a></li>
|
||||
<li><a href="edcref.html">EDC Reference</a></li>
|
||||
<li><a href="pages.html">Releted Pages</a></li>
|
||||
<li><a href="modules.html">Modules</a></li>
|
||||
<li><a href="pages.html">Related Pages</a></li>
|
||||
<li class="current"><a href="index.html">Main Page</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
|
|
@ -259,6 +259,25 @@ param in edje programs
|
|||
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file Edje.h
|
||||
* @brief Edje Graphical Design Library
|
||||
*
|
||||
* These routines are used for Edje.
|
||||
*/
|
||||
|
||||
/**
|
||||
* @defgroup Edje_General_Group Edje General
|
||||
*
|
||||
* @brief This group discusses functions that have general purposes or affect Edje as a whole.
|
||||
*
|
||||
* Besides containing the initialize and shutdown functions of the library, which should
|
||||
* always be called when we are using Edje, this module contains some other utilities that
|
||||
* could be used in many contexts or should do their jobs independent of the context inside Edje.
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
|
||||
#ifndef _EDJE_H
|
||||
#define _EDJE_H
|
||||
|
||||
|
@ -318,11 +337,142 @@ extern "C" {
|
|||
|
||||
EAPI extern Edje_Version *edje_version;
|
||||
|
||||
typedef enum _Edje_Action_Type
|
||||
{
|
||||
EDJE_ACTION_TYPE_NONE = 0,
|
||||
EDJE_ACTION_TYPE_STATE_SET = 1,
|
||||
EDJE_ACTION_TYPE_ACTION_STOP = 2,
|
||||
EDJE_ACTION_TYPE_SIGNAL_EMIT = 3,
|
||||
EDJE_ACTION_TYPE_DRAG_VAL_SET = 4,
|
||||
EDJE_ACTION_TYPE_DRAG_VAL_STEP = 5,
|
||||
EDJE_ACTION_TYPE_DRAG_VAL_PAGE = 6,
|
||||
EDJE_ACTION_TYPE_SCRIPT = 7,
|
||||
EDJE_ACTION_TYPE_FOCUS_SET = 8,
|
||||
EDJE_ACTION_TYPE_RESERVED00 = 9,
|
||||
EDJE_ACTION_TYPE_FOCUS_OBJECT = 10,
|
||||
EDJE_ACTION_TYPE_PARAM_COPY = 11,
|
||||
EDJE_ACTION_TYPE_PARAM_SET = 12,
|
||||
EDJE_ACTION_TYPE_SOUND_SAMPLE = 13, /**< @since 1.1 */
|
||||
EDJE_ACTION_TYPE_SOUND_TONE = 14, /**< @since 1.1 */
|
||||
EDJE_ACTION_TYPE_LAST = 15
|
||||
} Edje_Action_Type;
|
||||
|
||||
typedef enum _Edje_Load_Error
|
||||
{
|
||||
EDJE_LOAD_ERROR_NONE = 0, /**< No error happened, the loading was successful */
|
||||
EDJE_LOAD_ERROR_GENERIC = 1, /**< A generic error happened during the loading */
|
||||
EDJE_LOAD_ERROR_DOES_NOT_EXIST = 2, /**< The file pointed to did not exist */
|
||||
EDJE_LOAD_ERROR_PERMISSION_DENIED = 3, /**< Permission to read the given file was denied */
|
||||
EDJE_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED = 4, /**< Resource allocation failed during the loading */
|
||||
EDJE_LOAD_ERROR_CORRUPT_FILE = 5, /**< The file pointed to was corrupt */
|
||||
EDJE_LOAD_ERROR_UNKNOWN_FORMAT = 6, /**< The file pointed to had an unknown format */
|
||||
EDJE_LOAD_ERROR_INCOMPATIBLE_FILE = 7, /**< The file pointed to is incompatible, i.e., it doesn't match the library's current version's format */
|
||||
EDJE_LOAD_ERROR_UNKNOWN_COLLECTION = 8, /**< The group/collection set to load from was @b not found in the file */
|
||||
EDJE_LOAD_ERROR_RECURSIVE_REFERENCE = 9 /**< The group/collection set to load from had <b>recursive references</b> on its components */
|
||||
} Edje_Load_Error; /**< Edje file loading error codes one can get - see edje_load_error_str() too. */
|
||||
|
||||
/**
|
||||
* @file Edje.h
|
||||
* @brief Edje Graphical Design Library
|
||||
* @brief Initialize the Edje library.
|
||||
*
|
||||
* These routines are used for Edje.
|
||||
* @return The new init count. The initial value is zero.
|
||||
*
|
||||
* This function initializes the Ejde library, making the proper calls
|
||||
* to internal initialization functions. It will also initialize its
|
||||
* @b dependencies, making calls to @c eina_init(), @c ecore_init(),
|
||||
* @c embryo_init() and @c eet_init(). So, there is no need to call
|
||||
* those functions again, in your code. To shutdown Edje there is the
|
||||
* function edje_shutdown().
|
||||
*
|
||||
* @see edje_shutdown()
|
||||
* @see eina_init()
|
||||
* @see ecore_init()
|
||||
* @see embryo_init()
|
||||
* @see eet_init()
|
||||
*
|
||||
*/
|
||||
EAPI int edje_init (void);
|
||||
|
||||
/**
|
||||
* @brief Shutdown the Edje library.
|
||||
*
|
||||
* @return The number of times the library has been initialised
|
||||
* without being shutdown.
|
||||
*
|
||||
* This function shuts down the Edje library. It will also call the
|
||||
* shutdown functions of its @b dependencies, which are @c
|
||||
* eina_shutdown(), @c ecore_shutdown(), @c embryo_shutdown() and @c
|
||||
* eet_shutdown(), so there is no need to call these functions again,
|
||||
* in your code.
|
||||
*
|
||||
* @see edje_init()
|
||||
* @see eina_shutdown()
|
||||
* @see ecore_shutdown()
|
||||
* @see embryo_shutdown()
|
||||
* @see eet_shutdown()
|
||||
*
|
||||
*/
|
||||
EAPI int edje_shutdown (void);
|
||||
|
||||
/**
|
||||
* @brief Set the edje append fontset.
|
||||
*
|
||||
* @param fonts The fontset to append.
|
||||
*
|
||||
* This function sets the edje append fontset.
|
||||
*
|
||||
*/
|
||||
EAPI void edje_fontset_append_set (const char *fonts);
|
||||
|
||||
/**
|
||||
* Get data from the file level data block of an edje file
|
||||
* @param file The path to the .edj file
|
||||
* @param key The data key
|
||||
* @return The string value of the data. Must be freed by the user when no
|
||||
* longer needed.
|
||||
*
|
||||
* If an edje file is built from the following edc:
|
||||
*
|
||||
* data {
|
||||
* item: "key1" "value1";
|
||||
* item: "key2" "value2";
|
||||
* }
|
||||
* collections { ... }
|
||||
*
|
||||
* Then, edje_file_data_get("key1") will return "value1"
|
||||
*/
|
||||
EAPI char *edje_file_data_get (const char *file, const char *key);
|
||||
|
||||
/**
|
||||
* @brief Get the edje append fontset.
|
||||
*
|
||||
* @return The edje append fontset.
|
||||
*
|
||||
* This function returns the edje append fontset set by
|
||||
* edje_fontset_append_set() function.
|
||||
*
|
||||
* @see edje_fontset_append_set().
|
||||
*
|
||||
*/
|
||||
EAPI const char *edje_fontset_append_get (void);
|
||||
|
||||
/**
|
||||
* Converts the given Edje file load error code into a string
|
||||
* describing it in English.
|
||||
*
|
||||
* @param error the error code, a value in ::Edje_Load_Error.
|
||||
* @return Always returns a valid string. If the given @p error is not
|
||||
* supported, <code>"Unknown error"</code> is returned.
|
||||
*
|
||||
* edje_object_file_set() is a function which sets an error value,
|
||||
* afterwards, which can be fetched with
|
||||
* edje_object_load_error_get(). The function in question is meant
|
||||
* to be used in conjunction with the latter, for pretty-printing any
|
||||
* possible error cause.
|
||||
*/
|
||||
EAPI const char *edje_load_error_str (Edje_Load_Error error);
|
||||
|
||||
/**
|
||||
* @}
|
||||
*/
|
||||
|
||||
/**
|
||||
|
@ -419,26 +569,6 @@ typedef enum _Edje_Text_Effect
|
|||
EDJE_TEXT_EFFECT_SHADOW_DIRECTION_RIGHT = (0x7 << 4)
|
||||
} Edje_Text_Effect;
|
||||
|
||||
typedef enum _Edje_Action_Type
|
||||
{
|
||||
EDJE_ACTION_TYPE_NONE = 0,
|
||||
EDJE_ACTION_TYPE_STATE_SET = 1,
|
||||
EDJE_ACTION_TYPE_ACTION_STOP = 2,
|
||||
EDJE_ACTION_TYPE_SIGNAL_EMIT = 3,
|
||||
EDJE_ACTION_TYPE_DRAG_VAL_SET = 4,
|
||||
EDJE_ACTION_TYPE_DRAG_VAL_STEP = 5,
|
||||
EDJE_ACTION_TYPE_DRAG_VAL_PAGE = 6,
|
||||
EDJE_ACTION_TYPE_SCRIPT = 7,
|
||||
EDJE_ACTION_TYPE_FOCUS_SET = 8,
|
||||
EDJE_ACTION_TYPE_RESERVED00 = 9,
|
||||
EDJE_ACTION_TYPE_FOCUS_OBJECT = 10,
|
||||
EDJE_ACTION_TYPE_PARAM_COPY = 11,
|
||||
EDJE_ACTION_TYPE_PARAM_SET = 12,
|
||||
EDJE_ACTION_TYPE_SOUND_SAMPLE = 13, /**< @since 1.1 */
|
||||
EDJE_ACTION_TYPE_SOUND_TONE = 14, /**< @since 1.1 */
|
||||
EDJE_ACTION_TYPE_LAST = 15
|
||||
} Edje_Action_Type;
|
||||
|
||||
typedef enum _Edje_Tween_Mode
|
||||
{
|
||||
EDJE_TWEEN_MODE_NONE = 0,
|
||||
|
@ -570,20 +700,6 @@ typedef enum _Edje_Drag_Dir
|
|||
EDJE_DRAG_DIR_XY = 3
|
||||
} Edje_Drag_Dir;
|
||||
|
||||
typedef enum _Edje_Load_Error
|
||||
{
|
||||
EDJE_LOAD_ERROR_NONE = 0, /**< No error happened, the loading was successful */
|
||||
EDJE_LOAD_ERROR_GENERIC = 1, /**< A generic error happened during the loading */
|
||||
EDJE_LOAD_ERROR_DOES_NOT_EXIST = 2, /**< The file pointed to did not exist */
|
||||
EDJE_LOAD_ERROR_PERMISSION_DENIED = 3, /**< Permission to read the given file was denied */
|
||||
EDJE_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED = 4, /**< Resource allocation failed during the loading */
|
||||
EDJE_LOAD_ERROR_CORRUPT_FILE = 5, /**< The file pointed to was corrupt */
|
||||
EDJE_LOAD_ERROR_UNKNOWN_FORMAT = 6, /**< The file pointed to had an unknown format */
|
||||
EDJE_LOAD_ERROR_INCOMPATIBLE_FILE = 7, /**< The file pointed to is incompatible, i.e., it doesn't match the library's current version's format */
|
||||
EDJE_LOAD_ERROR_UNKNOWN_COLLECTION = 8, /**< The group/collection set to load from was @b not found in the file */
|
||||
EDJE_LOAD_ERROR_RECURSIVE_REFERENCE = 9 /**< The group/collection set to load from had <b>recursive references</b> on its components */
|
||||
} Edje_Load_Error; /**< Edje file loading error codes one can get - see edje_load_error_str() too. */
|
||||
|
||||
typedef enum _Edje_Text_Filter_Type
|
||||
{
|
||||
EDJE_TEXT_FILTER_TEXT = 0,
|
||||
|
@ -904,48 +1020,6 @@ typedef void (*Edje_Text_Filter_Cb) (void *data, Evas_Object *obj, c
|
|||
typedef void (*Edje_Markup_Filter_Cb) (void *data, Evas_Object *obj, const char *part, char **text);
|
||||
typedef Evas_Object *(*Edje_Item_Provider_Cb) (void *data, Evas_Object *obj, const char *part, const char *item);
|
||||
|
||||
/**
|
||||
* @brief Initialize the Edje library.
|
||||
*
|
||||
* @return The new init count. The initial value is zero.
|
||||
*
|
||||
* This function initializes the Ejde library, making the proper calls
|
||||
* to internal initialization functions. It will also initialize its
|
||||
* @b dependencies, making calls to @c eina_init(), @c ecore_init(),
|
||||
* @c embryo_init() and @c eet_init(). So, there is no need to call
|
||||
* those functions again, in your code. To shutdown Edje there is the
|
||||
* function edje_shutdown().
|
||||
*
|
||||
* @see edje_shutdown()
|
||||
* @see eina_init()
|
||||
* @see ecore_init()
|
||||
* @see embryo_init()
|
||||
* @see eet_init()
|
||||
*
|
||||
*/
|
||||
EAPI int edje_init (void);
|
||||
|
||||
/**
|
||||
* @brief Shutdown the Edje library.
|
||||
*
|
||||
* @return The number of times the library has been initialised
|
||||
* without being shutdown.
|
||||
*
|
||||
* This function shuts down the Edje library. It will also call the
|
||||
* shutdown functions of its @b dependencies, which are @c
|
||||
* eina_shutdown(), @c ecore_shutdown(), @c embryo_shutdown() and @c
|
||||
* eet_shutdown(), so there is no need to call these functions again,
|
||||
* in your code.
|
||||
*
|
||||
* @see edje_init()
|
||||
* @see eina_shutdown()
|
||||
* @see ecore_shutdown()
|
||||
* @see embryo_shutdown()
|
||||
* @see eet_shutdown()
|
||||
*
|
||||
*/
|
||||
EAPI int edje_shutdown (void);
|
||||
|
||||
/**
|
||||
* @brief Set edje trasitions' frame time.
|
||||
*
|
||||
|
@ -998,29 +1072,6 @@ EAPI void edje_freeze (void);
|
|||
*/
|
||||
EAPI void edje_thaw (void);
|
||||
|
||||
/**
|
||||
* @brief Set the edje append fontset.
|
||||
*
|
||||
* @param fonts The fontset to append.
|
||||
*
|
||||
* This function sets the edje append fontset.
|
||||
*
|
||||
*/
|
||||
EAPI void edje_fontset_append_set (const char *fonts);
|
||||
|
||||
/**
|
||||
* @brief Get the edje append fontset.
|
||||
*
|
||||
* @return The edje append fontset.
|
||||
*
|
||||
* This function returns the edje append fontset set by
|
||||
* edje_fontset_append_set() function.
|
||||
*
|
||||
* @see edje_fontset_append_set().
|
||||
*
|
||||
*/
|
||||
EAPI const char *edje_fontset_append_get (void);
|
||||
|
||||
/**
|
||||
* @brief Set Edje's global scaling factor.
|
||||
*
|
||||
|
@ -1171,25 +1222,6 @@ EAPI void edje_file_collection_list_free (Eina_List *lst);
|
|||
*/
|
||||
EAPI Eina_Bool edje_file_group_exists (const char *file, const char *glob);
|
||||
|
||||
/**
|
||||
* Get data from the file level data block of an edje file
|
||||
* @param file The path to the .edj file
|
||||
* @param key The data key
|
||||
* @return The string value of the data. Must be freed by the user when no
|
||||
* longer needed.
|
||||
*
|
||||
* If an edje file is built from the following edc:
|
||||
*
|
||||
* data {
|
||||
* item: "key1" "value1";
|
||||
* item: "key2" "value2";
|
||||
* }
|
||||
* collections { ... }
|
||||
*
|
||||
* Then, edje_file_data_get("key1") will return "value1"
|
||||
*/
|
||||
EAPI char *edje_file_data_get (const char *file, const char *key);
|
||||
|
||||
/**
|
||||
* @brief Set the file cache size.
|
||||
*
|
||||
|
@ -1651,22 +1683,6 @@ EAPI void edje_object_file_get (const Evas_Object *obj, const
|
|||
*/
|
||||
EAPI Edje_Load_Error edje_object_load_error_get (const Evas_Object *obj);
|
||||
|
||||
/**
|
||||
* Converts the given Edje file load error code into a string
|
||||
* describing it in English.
|
||||
*
|
||||
* @param error the error code, a value in ::Edje_Load_Error.
|
||||
* @return Always returns a valid string. If the given @p error is not
|
||||
* supported, <code>"Unknown error"</code> is returned.
|
||||
*
|
||||
* edje_object_file_set() is a function which sets an error value,
|
||||
* afterwards, which can be fetched with
|
||||
* edje_object_load_error_get(). The function in question is meant
|
||||
* to be used in conjunction with the latter, for pretty-printing any
|
||||
* possible error cause.
|
||||
*/
|
||||
EAPI const char *edje_load_error_str (Edje_Load_Error error);
|
||||
|
||||
/**
|
||||
* @brief Preload the images on the Edje Object in the background.
|
||||
*
|
||||
|
|
Loading…
Reference in New Issue