General Elementary API. More...
Macros | |
#define | ELM_MAIN() int main(int argc, char **argv) { int ret; _elm_startup_time = ecore_time_unix_get(); elm_init(argc, argv); ret = elm_main(argc, argv); elm_shutdown(); return ret; } |
macro to be used after the elm_main() function | |
#define | elm_object_item_text_set(it, label) elm_object_item_part_text_set((it), NULL, (label)) |
Macro to set a label of an object item. More... | |
Typedefs | |
typedef Eina_Bool(* | Elm_Event_Cb) (void *data, Evas_Object *obj, Evas_Object *src, Evas_Callback_Type type, void *event_info) |
Function prototype definition for callbacks on input events happening on Elementary widgets. More... | |
typedef Eo | Elm_Object_Item |
An Elementary Object item handle. | |
typedef void(* | Elm_Object_Item_Signal_Cb) (void *data, Elm_Object_Item *it, const char *emission, const char *source) |
Elm_Object_Item Signal Callback functions' prototype definition. More... | |
Enumerations | |
enum | Elm_Object_Layer { ELM_OBJECT_LAYER_BACKGROUND = EVAS_LAYER_MIN + 64, ELM_OBJECT_LAYER_DEFAULT = 0, ELM_OBJECT_LAYER_FOCUS = EVAS_LAYER_MAX - 128, ELM_OBJECT_LAYER_TOOLTIP = EVAS_LAYER_MAX - 64, ELM_OBJECT_LAYER_CURSOR = EVAS_LAYER_MAX - 32, ELM_OBJECT_LAYER_LAST } |
Defines couple of standard Evas_Object layers to be used with evas_object_layer_set(). More... | |
Functions | |
EINA_DEPRECATED void | elm_object_domain_translatable_text_part_set (Evas_Object *obj, const char *part, const char *domain, const char *text) |
Set the text for an object's part, marking it as translatable. More... | |
EINA_DEPRECATED const char * | elm_object_translatable_text_part_get (const Evas_Object *obj, const char *part) |
Get the original string set as translatable for an object. More... | |
int | elm_init (int argc, char **argv) |
Initialize Elementary. More... | |
int | elm_shutdown (void) |
Shut down Elementary. More... | |
void | elm_run (void) |
Run Elementary's main loop. More... | |
void | elm_exit (void) |
Ask to exit Elementary's main loop. More... | |
void | elm_quicklaunch_mode_set (Eina_Bool ql_on) |
Exposed symbol used only by macros and should not be used by apps. | |
Eina_Bool | elm_quicklaunch_mode_get (void) |
Exposed symbol used only by macros and should not be used by apps. | |
int | elm_quicklaunch_init (int argc, char **argv) |
Exposed symbol used only by macros and should not be used by apps. | |
int | elm_quicklaunch_sub_init (int argc, char **argv) |
Exposed symbol used only by macros and should not be used by apps. | |
int | elm_quicklaunch_sub_shutdown (void) |
Exposed symbol used only by macros and should not be used by apps. | |
int | elm_quicklaunch_shutdown (void) |
Exposed symbol used only by macros and should not be used by apps. | |
void | elm_quicklaunch_seed (void) |
Exposed symbol used only by macros and should not be used by apps. | |
Eina_Bool | elm_quicklaunch_prepare (int argc, char **argv, const char *cwd) |
Exposed symbol used only by macros and should not be used by apps. | |
Eina_Bool | elm_quicklaunch_fork (int argc, char **argv, char *cwd, void(*postfork_func)(void *data), void *postfork_data) |
Exposed symbol used only by macros and should not be used by apps. | |
void | elm_quicklaunch_cleanup (void) |
Exposed symbol used only by macros and should not be used by apps. | |
int | elm_quicklaunch_fallback (int argc, char **argv) |
Exposed symbol used only by macros and should not be used by apps. | |
char * | elm_quicklaunch_exe_path_get (const char *exe, const char *cwd) |
Exposed symbol used only by macros and should not be used by apps. | |
Eina_Bool | elm_policy_set (unsigned int policy, int value) |
Set a new policy's value (for a given policy group/identifier). More... | |
int | elm_policy_get (unsigned int policy) |
Get the policy value for given policy identifier. More... | |
void | elm_language_set (const char *lang) |
Change the language of the current application. More... | |
Elm_Process_State | elm_process_state_get (void) |
The state of the process as a whole. More... | |
void | elm_object_part_text_set (Evas_Object *obj, const char *part, const char *text) |
Set a text of an object. More... | |
const char * | elm_object_part_text_get (const Evas_Object *obj, const char *part) |
Get a text of an object. More... | |
void | elm_object_domain_translatable_part_text_set (Evas_Object *obj, const char *part, const char *domain, const char *text) |
Set the text for an object's part, marking it as translatable. More... | |
const char * | elm_object_translatable_part_text_get (const Evas_Object *obj, const char *part) |
Get the original string set as translatable for an object. More... | |
void | elm_object_domain_part_text_translatable_set (Evas_Object *obj, const char *part, const char *domain, Eina_Bool translatable) |
Mark the part text to be translatable or not. More... | |
void | elm_object_part_content_set (Evas_Object *obj, const char *part, Evas_Object *content) |
Set the content on part of a given container widget. More... | |
Evas_Object * | elm_object_part_content_get (const Evas_Object *obj, const char *part) |
Get the content on a part of a given container widget. More... | |
Evas_Object * | elm_object_part_content_unset (Evas_Object *obj, const char *part) |
Unset the content on a part of a given container widget. More... | |
void | elm_object_access_info_set (Evas_Object *obj, const char *txt) |
Set the text to read out when in accessibility mode. More... | |
const char * | elm_object_access_info_get (Evas_Object *obj) |
Get the text to read out when in accessibility mode. More... | |
Evas_Object * | elm_object_name_find (const Evas_Object *obj, const char *name, int recurse) |
Get a named object from the children. More... | |
void | elm_object_disabled_set (Evas_Object *obj, Eina_Bool disabled) |
Set the disabled state of an Elementary object. More... | |
Eina_Bool | elm_object_disabled_get (const Evas_Object *obj) |
Get the disabled state of an Elementary object. More... | |
void | elm_object_signal_emit (Evas_Object *obj, const char *emission, const char *source) |
Send a signal to the widget edje object. More... | |
void | elm_object_signal_callback_add (Evas_Object *obj, const char *emission, const char *source, Edje_Signal_Cb func, void *data) |
Add a callback for a signal emitted by widget edje object. More... | |
void * | elm_object_signal_callback_del (Evas_Object *obj, const char *emission, const char *source, Edje_Signal_Cb func) |
Remove a signal-triggered callback from a widget edje object. More... | |
void | elm_object_event_callback_add (Evas_Object *obj, Elm_Event_Cb func, const void *data) |
Add a callback for input events (key up, key down, mouse wheel) on a given Elementary widget. More... | |
void * | elm_object_event_callback_del (Evas_Object *obj, Elm_Event_Cb func, const void *data) |
Remove an event callback from a widget. More... | |
void | elm_object_orientation_mode_disabled_set (Evas_Object *obj, Eina_Bool disabled) |
Disable the orientation mode of a given widget. More... | |
Eina_Bool | elm_object_orientation_mode_disabled_get (const Evas_Object *obj) |
Get the orientation mode of a given widget. More... | |
void * | elm_object_item_data_get (const Elm_Object_Item *it) |
Get the data associated with an object item. More... | |
void | elm_object_item_data_set (Elm_Object_Item *it, void *data) |
Set the data associated with an object item. More... | |
EOAPI void | elm_wdg_item_tooltip_style_set (const char *style) |
Sets a different style for this item tooltip. More... | |
EOAPI const char * | elm_wdg_item_tooltip_style_get (void) |
Get the style for this item tooltip. More... | |
EOAPI void | elm_wdg_item_cursor_set (const char *cursor) |
Set the type of mouse pointer/cursor decoration to be shown, when the mouse pointer is over the given item. More... | |
EOAPI const char * | elm_wdg_item_cursor_get (void) |
Get the type of mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item. More... | |
EOAPI void | elm_wdg_item_cursor_style_set (const char *style) |
Set a different style for a given custom cursor set for an item. More... | |
EOAPI const char * | elm_wdg_item_cursor_style_get (void) |
Get the current style set for a given item's custom cursor. More... | |
EOAPI void | elm_wdg_item_cursor_engine_only_set (Eina_Bool engine_only) |
Set if the (custom)cursor for a given item should be searched in its theme, also, or should only rely on the rendering engine. More... | |
EOAPI Eina_Bool | elm_wdg_item_cursor_engine_only_get (void) |
Get if the (custom) cursor for a given item is being searched in its theme, also, or is only relying on the rendering engine. More... | |
EOAPI void | elm_wdg_item_part_content_set (const char *part, Evas_Object *content) |
Set a content of an object item. More... | |
EOAPI Evas_Object * | elm_wdg_item_part_content_get (const char *part) |
Get a content of an object item. More... | |
EOAPI void | elm_wdg_item_part_text_set (const char *part, const char *label) |
Set a label of an object item. More... | |
EOAPI const char * | elm_wdg_item_part_text_get (const char *part) |
Get a label of an object item. More... | |
EOAPI void | elm_wdg_item_style_set (const char *style) |
Set a style of an object item. More... | |
EOAPI const char * | elm_wdg_item_style_get (void) |
Get the style of an object item. More... | |
EOAPI const Eina_List * | elm_wdg_item_access_order_get (void) |
Get highlight order. More... | |
EOAPI void | elm_wdg_item_access_order_set (Eina_List *objs) |
Set highlight order. More... | |
EOAPI Evas_Object * | elm_wdg_item_widget_get (void) |
Get the widget object's handle which contains a given item. More... | |
EOAPI void | elm_wdg_item_del (void) |
Delete the given item. | |
EOAPI void | elm_wdg_item_tooltip_text_set (const char *text) |
Set the text to be shown in a given object item's tooltips. More... | |
EOAPI void | elm_wdg_item_tooltip_unset (void) |
Unset tooltip from item. More... | |
EOAPI void | elm_wdg_item_cursor_unset (void) |
Unset any custom mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item, thus making it show the default cursor again. More... | |
EOAPI Evas_Object * | elm_wdg_item_part_content_unset (const char *part) |
Unset a content of an object item. More... | |
EOAPI void | elm_wdg_item_signal_callback_add (const char *emission, const char *source, Elm_Object_Item_Signal_Cb func, void *data) |
Add a callback for a signal emitted by object item edje. More... | |
EOAPI void * | elm_wdg_item_signal_callback_del (const char *emission, const char *source, Elm_Object_Item_Signal_Cb func) |
Remove a signal-triggered callback from a object item edje object. More... | |
EOAPI void | elm_wdg_item_signal_emit (const char *emission, const char *source) |
Send a signal to the edje object of the widget item. More... | |
EOAPI void | elm_wdg_item_access_info_set (const char *txt) |
Set the text to read out when in accessibility mode. More... | |
EOAPI Evas_Object * | elm_wdg_item_access_object_get (void) |
Get an accessible object of the object item. More... | |
EOAPI void | elm_wdg_item_domain_translatable_part_text_set (const char *part, const char *domain, const char *label) |
Set the text for an object item's part, marking it as translatable. More... | |
EOAPI const char * | elm_wdg_item_translatable_part_text_get (const char *part) |
Get the original string set as translatable for an object item. More... | |
EOAPI void | elm_wdg_item_domain_part_text_translatable_set (const char *part, const char *domain, Eina_Bool translatable) |
Mark the part text to be translatable or not. More... | |
EOAPI Evas_Object * | elm_wdg_item_track (void) |
This returns track object of the item. More... | |
EOAPI void | elm_wdg_item_untrack (void) |
This retrieve the track object of the item. More... | |
EOAPI int | elm_wdg_item_track_get (void) |
Get the track object reference count. More... | |
EOAPI void | elm_wdg_item_del_cb_set (Evas_Smart_Cb del_cb) |
Set the function to be called when an item from the widget is freed. More... | |
EOAPI void | elm_wdg_item_tooltip_content_cb_set (Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) |
Set the content to be shown in the tooltip item. More... | |
EOAPI Evas_Object * | elm_wdg_item_access_register (void) |
Register object item as an accessible object. More... | |
EOAPI void | elm_wdg_item_access_unregister (void) |
Unregister accessible object of the object item. More... | |
EOAPI void | elm_wdg_item_access_order_unset (void) |
Unset highlight order. More... | |
void | elm_object_item_tooltip_style_set (Elm_Widget_Item *obj, const char *style) |
Sets a different style for this item tooltip. More... | |
const char * | elm_object_item_tooltip_style_get (const Elm_Widget_Item *obj) |
Get the style for this item tooltip. More... | |
void | elm_object_item_cursor_set (Elm_Widget_Item *obj, const char *cursor) |
Set the type of mouse pointer/cursor decoration to be shown, when the mouse pointer is over the given item. More... | |
const char * | elm_object_item_cursor_get (const Elm_Widget_Item *obj) |
Get the type of mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item. More... | |
void | elm_object_item_cursor_style_set (Elm_Widget_Item *obj, const char *style) |
Set a different style for a given custom cursor set for an item. More... | |
const char * | elm_object_item_cursor_style_get (const Elm_Widget_Item *obj) |
Get the current style set for a given item's custom cursor. More... | |
void | elm_object_item_cursor_engine_only_set (Elm_Widget_Item *obj, Eina_Bool engine_only) |
Set if the (custom)cursor for a given item should be searched in its theme, also, or should only rely on the rendering engine. More... | |
Eina_Bool | elm_object_item_cursor_engine_only_get (const Elm_Widget_Item *obj) |
Get if the (custom) cursor for a given item is being searched in its theme, also, or is only relying on the rendering engine. More... | |
void | elm_object_item_part_content_set (Elm_Widget_Item *obj, const char *part, Evas_Object *content) |
Set a content of an object item. More... | |
Evas_Object * | elm_object_item_part_content_get (const Elm_Widget_Item *obj, const char *part) |
Get a content of an object item. More... | |
void | elm_object_item_part_text_set (Elm_Widget_Item *obj, const char *part, const char *label) |
Set a label of an object item. More... | |
const char * | elm_object_item_part_text_get (const Elm_Widget_Item *obj, const char *part) |
Get a label of an object item. More... | |
void | elm_object_item_style_set (Elm_Widget_Item *obj, const char *style) |
Set a style of an object item. More... | |
const char * | elm_object_item_style_get (const Elm_Widget_Item *obj) |
Get the style of an object item. More... | |
const Eina_List * | elm_object_item_access_order_get (Elm_Widget_Item *obj) |
Get highlight order. More... | |
void | elm_object_item_access_order_set (Elm_Widget_Item *obj, Eina_List *objs) |
Set highlight order. More... | |
Evas_Object * | elm_object_item_widget_get (const Elm_Widget_Item *obj) |
Get the widget object's handle which contains a given item. More... | |
void | elm_object_item_del (Elm_Widget_Item *obj) |
Delete the given item. | |
void | elm_object_item_tooltip_text_set (Elm_Widget_Item *obj, const char *text) |
Set the text to be shown in a given object item's tooltips. More... | |
void | elm_object_item_tooltip_unset (Elm_Widget_Item *obj) |
Unset tooltip from item. More... | |
void | elm_object_item_cursor_unset (Elm_Widget_Item *obj) |
Unset any custom mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item, thus making it show the default cursor again. More... | |
Evas_Object * | elm_object_item_part_content_unset (Elm_Widget_Item *obj, const char *part) |
Unset a content of an object item. More... | |
void | elm_object_item_signal_callback_add (Elm_Widget_Item *obj, const char *emission, const char *source, Elm_Object_Item_Signal_Cb func, void *data) |
Add a callback for a signal emitted by object item edje. More... | |
void * | elm_object_item_signal_callback_del (Elm_Widget_Item *obj, const char *emission, const char *source, Elm_Object_Item_Signal_Cb func) |
Remove a signal-triggered callback from a object item edje object. More... | |
void | elm_object_item_signal_emit (Elm_Widget_Item *obj, const char *emission, const char *source) |
Send a signal to the edje object of the widget item. More... | |
void | elm_object_item_access_info_set (Elm_Widget_Item *obj, const char *txt) |
Set the text to read out when in accessibility mode. More... | |
Evas_Object * | elm_object_item_access_object_get (const Elm_Widget_Item *obj) |
Get an accessible object of the object item. More... | |
void | elm_object_item_domain_translatable_part_text_set (Elm_Widget_Item *obj, const char *part, const char *domain, const char *label) |
Set the text for an object item's part, marking it as translatable. More... | |
const char * | elm_object_item_translatable_part_text_get (const Elm_Widget_Item *obj, const char *part) |
Get the original string set as translatable for an object item. More... | |
void | elm_object_item_domain_part_text_translatable_set (Elm_Widget_Item *obj, const char *part, const char *domain, Eina_Bool translatable) |
Mark the part text to be translatable or not. More... | |
Evas_Object * | elm_object_item_track (Elm_Widget_Item *obj) |
This returns track object of the item. More... | |
void | elm_object_item_untrack (Elm_Widget_Item *obj) |
This retrieve the track object of the item. More... | |
int | elm_object_item_track_get (const Elm_Widget_Item *obj) |
Get the track object reference count. More... | |
void | elm_object_item_del_cb_set (Elm_Widget_Item *obj, Evas_Smart_Cb del_cb) |
Set the function to be called when an item from the widget is freed. More... | |
void | elm_object_item_tooltip_content_cb_set (Elm_Widget_Item *obj, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) |
Set the content to be shown in the tooltip item. More... | |
Evas_Object * | elm_object_item_access_register (Elm_Widget_Item *obj) |
Register object item as an accessible object. More... | |
void | elm_object_item_access_unregister (Elm_Widget_Item *obj) |
Unregister accessible object of the object item. More... | |
void | elm_object_item_access_order_unset (Elm_Widget_Item *obj) |
Unset highlight order. More... | |
Variables | |
int | ELM_EVENT_CONFIG_ALL_CHANGED |
Emitted when the application has reconfigured elementary settings due to an external configuration tool asking it to. | |
int | ELM_EVENT_POLICY_CHANGED |
Emitted when any Elementary's policy value is changed. | |
int | ELM_EVENT_PROCESS_BACKGROUND |
Emitted when nothing is visible and the process as a whole should go into a background state. More... | |
int | ELM_EVENT_PROCESS_FOREGROUND |
Emitted when going from nothing being visible to at least one window being visible. More... | |
General Elementary API.
Functions that don't relate to Elementary objects specifically.
Here are documented functions which init/shutdown the library, that apply to generic Elementary objects, that deal with configuration, et cetera.
This example contemplates some of these functions.
#define elm_object_item_text_set | ( | it, | |
label | |||
) | elm_object_item_part_text_set((it), NULL, (label)) |
Macro to set a label of an object item.
it | The Elementary object item. |
label | The new text of the label. |
typedef Eina_Bool(* Elm_Event_Cb) (void *data, Evas_Object *obj, Evas_Object *src, Evas_Callback_Type type, void *event_info) |
Function prototype definition for callbacks on input events happening on Elementary widgets.
data will receive the user data pointer passed to elm_object_event_callback_add(). src will be a pointer to the widget on which the input event took place. type will get the type of this event and event_info, the struct with details on this event.
Elm_Object_Item_Signal_Cb |
Elm_Object_Item Signal Callback functions' prototype definition.
data
will have the auxiliary data pointer at the time the callback registration. it
will be a pointer the Elm_Object_Item that have the edje object where the signal comes from. emission
will identify the exact signal's emission string and source
the exact signal's source one.
enum Elm_Object_Layer |
Defines couple of standard Evas_Object layers to be used with evas_object_layer_set().
void elm_exit | ( | void | ) |
Ask to exit Elementary's main loop.
If this call is issued, it will flag the main loop to cease processing and return back to its parent function (usually your elm_main() function). This does not mean the main loop instantly quits. So your ecore callbacks(timer, animator, event, job, and etc.) have chances to be called even after elm_exit().
References elm_policy_get().
int elm_init | ( | int | argc, |
char ** | argv | ||
) |
Initialize Elementary.
[in] | argc | System's argument count value |
[in] | argv | System's pointer to array of argument strings |
This function initializes Elementary and increments a counter of the number of calls to it. It returns the new counter's value.
ELM_MAIN()
macro. There is no need to use this if you use this macro (which is highly advisable). An elm_main() should contain the entry point code for your application, having the same prototype as elm_init(), and not being static (putting the EAPI_MAIN
symbol in front of its type declaration is advisable). The ELM_MAIN()
call should be placed just after it.Example:
See the full example.
References elm_quicklaunch_init(), and elm_quicklaunch_sub_init().
void elm_language_set | ( | const char * | lang | ) |
Change the language of the current application.
The lang
passed must be the full name of the locale to use, for example "en_US.utf8" or "es_ES@euro".
Changing language with this function will make Elementary run through all its widgets, translating strings set with elm_object_domain_translatable_part_text_set(). This way, an entire UI can have its language changed without having to restart the program.
For more complex cases, like having formatted strings that need translation, widgets will also emit a "language,changed" signal that the user can listen to and manually translate the text.
lang | Language to set, must be the full name of the locale |
const char* elm_object_access_info_get | ( | Evas_Object * | obj | ) |
Get the text to read out when in accessibility mode.
obj | The object which is to be described |
void elm_object_access_info_set | ( | Evas_Object * | obj, |
const char * | txt | ||
) |
Set the text to read out when in accessibility mode.
obj | The object which is to be described |
txt | The text that describes the widget to people with poor or no vision |
Eina_Bool elm_object_disabled_get | ( | const Evas_Object * | obj | ) |
Get the disabled state of an Elementary object.
obj | The Elementary object to operate on |
EINA_TRUE
, if the widget is disabled, EINA_FALSE
if it's enabled (or on errors)This gets the state of the widget, which might be enabled or disabled.
void elm_object_disabled_set | ( | Evas_Object * | obj, |
Eina_Bool | disabled | ||
) |
Set the disabled state of an Elementary object.
obj | The Elementary object to operate on |
disabled | The state to put in in: EINA_TRUE for disabled, EINA_FALSE for enabled |
Elementary objects can be disabled, in which state they won't receive input and, in general, will be themed differently from their normal state, usually greyed out. Useful for contexts where you don't want your users to interact with some of the parts of you interface.
This sets the state for the widget, either disabling it or enabling it back.
void elm_object_domain_part_text_translatable_set | ( | Evas_Object * | obj, |
const char * | part, | ||
const char * | domain, | ||
Eina_Bool | translatable | ||
) |
Mark the part text to be translatable or not.
Once you mark the part text to be translatable, the text will be translated internally regardless of elm_object_part_text_set() and elm_object_domain_translatable_part_text_set(). In other case, if you set the Elementary policy that all text will be translatable in default, you can set the part text to not be translated by calling this API.
obj | The object containing the text part |
part | The part name of the translatable text |
domain | The translation domain to use |
translatable | EINA_TRUE , the part text will be translated internally. EINA_FALSE , otherwise. |
void elm_object_domain_translatable_part_text_set | ( | Evas_Object * | obj, |
const char * | part, | ||
const char * | domain, | ||
const char * | text | ||
) |
Set the text for an object's part, marking it as translatable.
The string to set as text
must be the original one. Do not pass the return of gettext()
here. Elementary will translate the string internally and set it on the object using elm_object_part_text_set(), also storing the original string so that it can be automatically translated when the language is changed with elm_language_set().
The domain
will be stored along to find the translation in the correct catalog. It can be NULL, in which case it will use whatever domain was set by the application with textdomain()
. This is useful in case you are building a library on top of Elementary that will have its own translatable strings, that should not be mixed with those of programs using the library.
obj | The object containing the text part |
part | The name of the part to set |
domain | The translation domain to use |
text | The original, non-translated text to set |
Referenced by elm_object_domain_translatable_text_part_set().
EINA_DEPRECATED void elm_object_domain_translatable_text_part_set | ( | Evas_Object * | obj, |
const char * | part, | ||
const char * | domain, | ||
const char * | text | ||
) |
Set the text for an object's part, marking it as translatable.
The string to set as text
must be the original one. Do not pass the return of gettext()
here. Elementary will translate the string internally and set it on the object using elm_object_part_text_set(), also storing the original string so that it can be automatically translated when the language is changed with elm_language_set().
The domain
will be stored along to find the translation in the correct catalog. It can be NULL, in which case it will use whatever domain was set by the application with textdomain()
. This is useful in case you are building a library on top of Elementary that will have its own translatable strings, that should not be mixed with those of programs using the library.
obj | The object containing the text part |
part | The name of the part to set |
domain | The translation domain to use |
text | The original, non-translated text to set |
References elm_object_domain_translatable_part_text_set().
void elm_object_event_callback_add | ( | Evas_Object * | obj, |
Elm_Event_Cb | func, | ||
const void * | data | ||
) |
Add a callback for input events (key up, key down, mouse wheel) on a given Elementary widget.
obj | The widget to add an event callback on |
func | The callback function to be executed when the event happens |
data | Data to pass in to func |
Every widget in an Elementary interface set to receive focus, with elm_object_focus_allow_set(), will propagate all of its key up, key down and mouse wheel input events up to its parent object, and so on. All of the focusable ones in this chain which had an event callback set, with this call, will be able to treat those events. There are two ways of making the propagation of these event upwards in the tree of widgets to cease:
EINA_TRUE
on func
. EINA_FALSE
will mean the event was not processed, so the propagation will go on.event_info
pointer passed to func
will contain the event's structure and, if you OR its event_flags
inner value to EVAS_EVENT_FLAG_ON_HOLD
, you're telling Elementary one has already handled it, thus killing the event's propagation, too.obj
has consumed the event already.evas_object_event_callback_add()
, which will add event callbacks per type on general Evas objects (no event propagation infrastructure taken in account).elm_object_signal_callback_add()
, which will add callbacks to signals coming from a widget's theme, not input events.edje_object_signal_callback_add()
, which does the same as elm_object_signal_callback_add(), but directly on an Edje object.evas_object_smart_callback_add()
, which adds callbacks to smart objects' smart events, and not input events.void* elm_object_event_callback_del | ( | Evas_Object * | obj, |
Elm_Event_Cb | func, | ||
const void * | data | ||
) |
Remove an event callback from a widget.
This function removes a callback, previously attached to event emission by the obj
. The parameters func and data must match exactly those passed to a previous call to elm_object_event_callback_add(). The data pointer that was passed to this call will be returned.
obj | The object |
func | The callback function to be executed when the event is emitted. |
data | Data to pass in to the callback function. |
void elm_object_item_access_info_set | ( | Elm_Widget_Item * | obj, |
const char * | txt | ||
) |
Set the text to read out when in accessibility mode.
[in] | txt | The text that describes the widget to people with poor or no vision |
References elm_wdg_item_access_info_set().
Evas_Object* elm_object_item_access_object_get | ( | const Elm_Widget_Item * | obj | ) |
const Eina_List* elm_object_item_access_order_get | ( | Elm_Widget_Item * | obj | ) |
void elm_object_item_access_order_set | ( | Elm_Widget_Item * | obj, |
Eina_List * | objs | ||
) |
Set highlight order.
[in] | objs | Order of objects to pass highlight |
References elm_wdg_item_access_order_set().
void elm_object_item_access_order_unset | ( | Elm_Widget_Item * | obj | ) |
Evas_Object* elm_object_item_access_register | ( | Elm_Widget_Item * | obj | ) |
void elm_object_item_access_unregister | ( | Elm_Widget_Item * | obj | ) |
Unregister accessible object of the object item.
References elm_wdg_item_access_unregister().
Eina_Bool elm_object_item_cursor_engine_only_get | ( | const Elm_Widget_Item * | obj | ) |
Get if the (custom) cursor for a given item is being searched in its theme, also, or is only relying on the rendering engine.
EINA_TRUE
, if cursors are being looked for only on those provided by the rendering engine, EINA_FALSE
if they are being searched on the widget's theme, as well.References elm_wdg_item_cursor_engine_only_get().
void elm_object_item_cursor_engine_only_set | ( | Elm_Widget_Item * | obj, |
Eina_Bool | engine_only | ||
) |
Set if the (custom)cursor for a given item should be searched in its theme, also, or should only rely on the rendering engine.
[in] | engine_only | Use EINA_TRUE to have cursors looked for only on those provided by the rendering engine, EINA_FALSE to have them searched on the widget's theme, as well. |
References elm_wdg_item_cursor_engine_only_set().
const char* elm_object_item_cursor_get | ( | const Elm_Widget_Item * | obj | ) |
Get the type of mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item.
References elm_wdg_item_cursor_get().
void elm_object_item_cursor_set | ( | Elm_Widget_Item * | obj, |
const char * | cursor | ||
) |
Set the type of mouse pointer/cursor decoration to be shown, when the mouse pointer is over the given item.
This function works analogously as elm_object_cursor_set(), but here the cursor's changing area is restricted to the item's area, and not the whole widget's. Note that that item cursors have precedence over widget cursors, so that a mouse over an item with custom cursor set will always show that cursor.
If this function is called twice for an object, a previously set cursor will be unset on the second call.
[in] | cursor | the cursor type's name |
References elm_wdg_item_cursor_set().
const char* elm_object_item_cursor_style_get | ( | const Elm_Widget_Item * | obj | ) |
Get the current style set for a given item's custom cursor.
References elm_wdg_item_cursor_style_get().
void elm_object_item_cursor_style_set | ( | Elm_Widget_Item * | obj, |
const char * | style | ||
) |
Set a different style for a given custom cursor set for an item.
This function only makes sense when one is using custom mouse cursor decorations defined in a theme file, which can have, given a cursor name/type, alternate styles on it. It works analogously as elm_object_cursor_style_set(), but here applies only to item objects.
[in] | style | the theme style to use/in use (e.g. "default" , "transparent" , etc) |
References elm_wdg_item_cursor_style_set().
void elm_object_item_cursor_unset | ( | Elm_Widget_Item * | obj | ) |
Unset any custom mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item, thus making it show the default cursor again.
Use this call to undo any custom settings on this item's cursor decoration, bringing it back to defaults (no custom style set).
References elm_wdg_item_cursor_unset().
void* elm_object_item_data_get | ( | const Elm_Object_Item * | it | ) |
Get the data associated with an object item.
it | The Elementary object item |
it
void elm_object_item_data_set | ( | Elm_Object_Item * | it, |
void * | data | ||
) |
Set the data associated with an object item.
it | The Elementary object item |
data | The data to be associated with it |
void elm_object_item_del_cb_set | ( | Elm_Widget_Item * | obj, |
Evas_Smart_Cb | del_cb | ||
) |
Set the function to be called when an item from the widget is freed.
That function will receive these parameters:
[in] | del_cb | The function called |
References elm_wdg_item_del_cb_set().
void elm_object_item_domain_part_text_translatable_set | ( | Elm_Widget_Item * | obj, |
const char * | part, | ||
const char * | domain, | ||
Eina_Bool | translatable | ||
) |
Mark the part text to be translatable or not.
Once you mark the part text to be translatable, the text will be translated internally regardless of elm_object_item_part_text_set() and elm_object_item_domain_translatable_part_text_set(). In other case, if you set the Elementary policy that all text will be translatable in default, you can set the part text to not be translated by calling this API.
[in] | part | The part name of the translatable text |
[in] | domain | The translation domain to use |
[in] | translatable | EINA_TRUE , the part text will be translated internally. EINA_FALSE , otherwise. |
References elm_wdg_item_domain_part_text_translatable_set().
void elm_object_item_domain_translatable_part_text_set | ( | Elm_Widget_Item * | obj, |
const char * | part, | ||
const char * | domain, | ||
const char * | label | ||
) |
Set the text for an object item's part, marking it as translatable.
The string to set as text
must be the original one. Do not pass the return of gettext()
here. Elementary will translate the string internally and set it on the object item using elm_object_item_part_text_set(), also storing the original string so that it can be automatically translated when the language is changed with elm_language_set(). The domain
will be stored along to find the translation in the correct catalog. It can be NULL, in which case it will use whatever domain was set by the application with textdomain()
. This is useful in case you are building a library on top of Elementary that will have its own translatable strings, that should not be mixed with those of programs using the library.
[in] | part | The name of the part to set |
[in] | domain | The translation domain to use |
[in] | label | The original, non-translated text to set |
References elm_wdg_item_domain_translatable_part_text_set().
Evas_Object* elm_object_item_part_content_get | ( | const Elm_Widget_Item * | obj, |
const char * | part | ||
) |
Get a content of an object item.
[in] | part | The content part name (NULL for the default content) |
References elm_wdg_item_part_content_get().
void elm_object_item_part_content_set | ( | Elm_Widget_Item * | obj, |
const char * | part, | ||
Evas_Object * | content | ||
) |
Set a content of an object item.
This sets a new object to an item as a content object. If any object was already set as a content object in the same part, previous object will be deleted automatically.
[in] | part | The content part name (NULL for the default content) |
[in] | content | The content of the object item |
References elm_wdg_item_part_content_set().
Evas_Object* elm_object_item_part_content_unset | ( | Elm_Widget_Item * | obj, |
const char * | part | ||
) |
Unset a content of an object item.
[in] | part | The content part name to unset (NULL for the default content) |
References elm_wdg_item_part_content_unset().
const char* elm_object_item_part_text_get | ( | const Elm_Widget_Item * | obj, |
const char * | part | ||
) |
Get a label of an object item.
[in] | part | The text part name (NULL for the default label) |
References elm_wdg_item_part_text_get().
void elm_object_item_part_text_set | ( | Elm_Widget_Item * | obj, |
const char * | part, | ||
const char * | label | ||
) |
Set a label of an object item.
[in] | part | The text part name (NULL for the default label) |
[in] | label | Text of the label |
References elm_wdg_item_part_text_set().
void elm_object_item_signal_callback_add | ( | Elm_Widget_Item * | obj, |
const char * | emission, | ||
const char * | source, | ||
Elm_Object_Item_Signal_Cb | func, | ||
void * | data | ||
) |
Add a callback for a signal emitted by object item edje.
This function connects a callback function to a signal emitted by the edje object of the object item. Globs can occur in either the emission or source name.
[in] | emission | The signal's name. |
[in] | source | The signal's source. |
[in] | func | The callback function to be executed when the signal is emitted. |
[in] | data | A pointer to data to pass to the callback function. |
References elm_wdg_item_signal_callback_add().
void* elm_object_item_signal_callback_del | ( | Elm_Widget_Item * | obj, |
const char * | emission, | ||
const char * | source, | ||
Elm_Object_Item_Signal_Cb | func | ||
) |
Remove a signal-triggered callback from a object item edje object.
This function removes the last callback, previously attached to a signal emitted by an underlying Edje object of it, whose parameters emission, source and func
match exactly with those passed to a previous call to elm_object_item_signal_callback_add(). The data pointer that was passed to this call will be returned.
[in] | emission | The signal's name. |
[in] | source | The signal's source. |
[in] | func | The callback function to be executed when the signal is emitted. |
References elm_wdg_item_signal_callback_del().
void elm_object_item_signal_emit | ( | Elm_Widget_Item * | obj, |
const char * | emission, | ||
const char * | source | ||
) |
Send a signal to the edje object of the widget item.
This function sends a signal to the edje object of the obj item. An edje program can respond to a signal by specifying matching 'signal' and 'source' fields.
[in] | emission | The signal's name. |
[in] | source | The signal's source. |
References elm_wdg_item_signal_emit().
const char* elm_object_item_style_get | ( | const Elm_Widget_Item * | obj | ) |
void elm_object_item_style_set | ( | Elm_Widget_Item * | obj, |
const char * | style | ||
) |
Set a style of an object item.
[in] | style | The style of object item |
References elm_wdg_item_style_set().
void elm_object_item_tooltip_content_cb_set | ( | Elm_Widget_Item * | obj, |
Elm_Tooltip_Item_Content_Cb | func, | ||
const void * | data, | ||
Evas_Smart_Cb | del_cb | ||
) |
Set the content to be shown in the tooltip item.
Setup the tooltip to item. The item can have only one tooltip, so any previous tooltip data is removed. func
(with data
) will be called every time that need show the tooltip and it should return a valid Evas_Object. This object is then managed fully by tooltip system and is deleted when the tooltip is gone.
[in] | func | the function used to create the tooltip contents. |
[in] | data | what to provide to func as callback data/context. |
[in] | del_cb | called when data is not needed anymore, either when another callback replaces func, the tooltip is unset with elm_object_item_tooltip_unset() or the owner item dies. This callback receives as the first parameter the given data, and event_info is the item. |
References elm_wdg_item_tooltip_content_cb_set().
const char* elm_object_item_tooltip_style_get | ( | const Elm_Widget_Item * | obj | ) |
Get the style for this item tooltip.
References elm_wdg_item_tooltip_style_get().
void elm_object_item_tooltip_style_set | ( | Elm_Widget_Item * | obj, |
const char * | style | ||
) |
Sets a different style for this item tooltip.
[in] | style | the theme style used/to use (default, transparent, ...) |
References elm_wdg_item_tooltip_style_set().
void elm_object_item_tooltip_text_set | ( | Elm_Widget_Item * | obj, |
const char * | text | ||
) |
Set the text to be shown in a given object item's tooltips.
Setup the text as tooltip to object. The item can have only one tooltip, so any previous tooltip data - set with this function or elm_object_item_tooltip_content_cb_set() - is removed.
[in] | text | The text to set in the content. |
References elm_wdg_item_tooltip_text_set().
void elm_object_item_tooltip_unset | ( | Elm_Widget_Item * | obj | ) |
Unset tooltip from item.
Remove tooltip from item. The callback provided as del_cb to elm_object_item_tooltip_content_cb_set() will be called to notify it is not used anymore.
References elm_wdg_item_tooltip_unset().
Evas_Object* elm_object_item_track | ( | Elm_Widget_Item * | obj | ) |
This returns track object of the item.
NULL
if the widget item doesn't have it. Additionally, the widget item is managed/controlled by the widget, the widget item could be changed(moved, resized even deleted) anytime by it's own widget's decision. So please dont' change the track object as well as don't keep the track object in your side as possible but get the track object at the moment you need to refer. Otherwise, you need to add some callbacks to the track object to track it's attributes changes.References elm_wdg_item_track().
int elm_object_item_track_get | ( | const Elm_Widget_Item * | obj | ) |
Get the track object reference count.
References elm_wdg_item_track_get().
const char* elm_object_item_translatable_part_text_get | ( | const Elm_Widget_Item * | obj, |
const char * | part | ||
) |
Get the original string set as translatable for an object item.
When setting translated strings, the function elm_object_item_part_text_get() will return the translation returned by gettext()
. To get the original string use this function.
[in] | part | The name of the part that was set |
References elm_wdg_item_translatable_part_text_get().
void elm_object_item_untrack | ( | Elm_Widget_Item * | obj | ) |
This retrieve the track object of the item.
References elm_wdg_item_untrack().
Evas_Object* elm_object_item_widget_get | ( | const Elm_Widget_Item * | obj | ) |
Get the widget object's handle which contains a given item.
References elm_wdg_item_widget_get().
Evas_Object* elm_object_name_find | ( | const Evas_Object * | obj, |
const char * | name, | ||
int | recurse | ||
) |
Get a named object from the children.
obj | The parent object whose children to look at |
name | The name of the child to find |
recurse | Set to the maximum number of levels to recurse (0 == none, 1 is only look at 1 level of children etc.) |
This function searches the children (or recursively children of children and so on) of the given obj
object looking for a child with the name of name
. If the child is found the object is returned, or NULL is returned. You can set the name of an object with evas_object_name_set(). If the name is not unique within the child objects (or the tree is recurse
is greater than 0) then it is undefined as to which child of that name is returned, so ensure the name is unique amongst children. If recurse is set to -1 it will recurse without limit.
Eina_Bool elm_object_orientation_mode_disabled_get | ( | const Evas_Object * | obj | ) |
Get the orientation mode of a given widget.
obj | The Elementary widget to query for its orientation mode. |
EINA_TRUE
, if the orientation mode is disabled, EINA_FALSE
if the orientation mode is enabled (or on errors) void elm_object_orientation_mode_disabled_set | ( | Evas_Object * | obj, |
Eina_Bool | disabled | ||
) |
Disable the orientation mode of a given widget.
Orientation Mode is used for widgets to change it's styles or to send signals whenever it's window degree is changed. If the orientation mode is enabled and the widget has different looks and styles for the window degree(0, 90, 180, 270), it will apply a style that is readied for the current degree, otherwise, it will send signals to it's own edje to change it's states if the style doesn't be readied.
obj | The Elementary object to operate on orientation mode. |
disabled | The state to put in in: EINA_TRUE for disabled, EINA_FALSE for enabled. |
Evas_Object* elm_object_part_content_get | ( | const Evas_Object * | obj, |
const char * | part | ||
) |
Get the content on a part of a given container widget.
obj | The Elementary container widget |
part | The container's part name to get (some might accept NULL for the default part) |
NULL
, on errorsvoid elm_object_part_content_set | ( | Evas_Object * | obj, |
const char * | part, | ||
Evas_Object * | content | ||
) |
Set the content on part of a given container widget.
obj | The Elementary container widget |
part | The container's part name to set (some might accept NULL for the default part) |
content | The new content for that part |
All widgets deriving from the The Elementary Container Class may hold child objects as content at given parts. This sets new content to a given part. If any object was already set as a content object in the same part, the previous object will be deleted automatically with this call. If the content
is NULL, this call will just delete the previous object. If the If you wish to preserve it, issue elm_object_part_content_unset() on it first.
Evas_Object* elm_object_part_content_unset | ( | Evas_Object * | obj, |
const char * | part | ||
) |
Unset the content on a part of a given container widget.
obj | The Elementary container widget |
part | The container's part name to unset (some might accept NULL for the default part) |
NULL
, on errorsconst char* elm_object_part_text_get | ( | const Evas_Object * | obj, |
const char * | part | ||
) |
Get a text of an object.
obj | The Elementary object |
part | The text part name to get (NULL for the default part) |
void elm_object_part_text_set | ( | Evas_Object * | obj, |
const char * | part, | ||
const char * | text | ||
) |
Set a text of an object.
obj | The Elementary object |
part | The text part name to set (NULL for the default part) |
text | The new text of the part |
void elm_object_signal_callback_add | ( | Evas_Object * | obj, |
const char * | emission, | ||
const char * | source, | ||
Edje_Signal_Cb | func, | ||
void * | data | ||
) |
Add a callback for a signal emitted by widget edje object.
This function connects a callback function to a signal emitted by the edje object of the obj. Globs can occur in either the emission or source name.
obj | The object |
emission | The signal's name. |
source | The signal's source. |
func | The callback function to be executed when the signal is emitted. |
data | A pointer to data to pass to the callback function. |
void* elm_object_signal_callback_del | ( | Evas_Object * | obj, |
const char * | emission, | ||
const char * | source, | ||
Edje_Signal_Cb | func | ||
) |
Remove a signal-triggered callback from a widget edje object.
obj | The object handle |
emission | The signal's name. |
source | The signal's source. |
func | The callback function to be executed when the signal is emitted. |
NULL
, on errors.This function removes the last callback, previously attached to a signal emitted by an underlying Edje object of obj, whose parameters emission, source and func
match exactly with those passed to a previous call to elm_object_signal_callback_add(). The data pointer that was passed to this call will be returned.
void elm_object_signal_emit | ( | Evas_Object * | obj, |
const char * | emission, | ||
const char * | source | ||
) |
Send a signal to the widget edje object.
This function sends a signal to the edje object of the obj. An edje program can respond to a signal by specifying matching 'signal' and 'source' fields.
obj | The object |
emission | The signal's name. |
source | The signal's source. |
const char* elm_object_translatable_part_text_get | ( | const Evas_Object * | obj, |
const char * | part | ||
) |
Get the original string set as translatable for an object.
When setting translated strings, the function elm_object_part_text_get() will return the translation returned by gettext()
. To get the original string use this function.
obj | The object |
part | The name of the part that was set |
Referenced by elm_object_translatable_text_part_get().
EINA_DEPRECATED const char* elm_object_translatable_text_part_get | ( | const Evas_Object * | obj, |
const char * | part | ||
) |
Get the original string set as translatable for an object.
When setting translated strings, the function elm_object_part_text_get() will return the translation returned by gettext()
. To get the original string use this function.
obj | The object |
part | The name of the part that was set |
References elm_object_translatable_part_text_get().
int elm_policy_get | ( | unsigned int | policy | ) |
Get the policy value for given policy identifier.
policy | policy identifier, as in #Elm_Policy. |
0
if policy
passed is invalid. Referenced by elm_exit().
Eina_Bool elm_policy_set | ( | unsigned int | policy, |
int | value | ||
) |
Set a new policy's value (for a given policy group/identifier).
policy | policy identifier, as in Elm_Policy. |
value | policy value, which depends on the identifier |
EINA_TRUE
on success or EINA_FALSE
, on error.Elementary policies define applications' behavior, somehow. These behaviors are divided in policy groups (see #Elm_Policy enumeration). This call will emit the Ecore event ELM_EVENT_POLICY_CHANGED, which can be hooked at with handlers. An #Elm_Event_Policy_Changed struct will be passed, then.
References _Elm_Event_Policy_Changed::new_value, and _Elm_Event_Policy_Changed::old_value.
Elm_Process_State elm_process_state_get | ( | void | ) |
The state of the process as a whole.
The process may logically be some runnable state. a "foreground" application runs as normal and may be user-visible or "active" in some way. A background application is not user-visible or otherwise important and likely should release resources and not wake up often or process much.
void elm_run | ( | void | ) |
Run Elementary's main loop.
This call should be issued just after all initialization is completed. This function will not return until elm_exit() is called. It will keep looping, running the main (event/processing) loop for Elementary.
int elm_shutdown | ( | void | ) |
Shut down Elementary.
This should be called at the end of your application, just before it ceases to do any more processing. This will clean up any permanent resources your application may have allocated via Elementary that would otherwise persist.
References elm_quicklaunch_shutdown(), and elm_quicklaunch_sub_shutdown().
EOAPI void elm_wdg_item_access_info_set | ( | const char * | txt | ) |
Set the text to read out when in accessibility mode.
[in] | txt | The text that describes the widget to people with poor or no vision |
Referenced by elm_object_item_access_info_set().
EOAPI Evas_Object* elm_wdg_item_access_object_get | ( | void | ) |
Get an accessible object of the object item.
Referenced by elm_object_item_access_object_get().
EOAPI const Eina_List* elm_wdg_item_access_order_get | ( | void | ) |
EOAPI void elm_wdg_item_access_order_set | ( | Eina_List * | objs | ) |
Set highlight order.
[in] | objs | Order of objects to pass highlight |
Referenced by elm_object_item_access_order_set().
EOAPI void elm_wdg_item_access_order_unset | ( | void | ) |
EOAPI Evas_Object* elm_wdg_item_access_register | ( | void | ) |
Register object item as an accessible object.
Referenced by elm_object_item_access_register().
EOAPI void elm_wdg_item_access_unregister | ( | void | ) |
Unregister accessible object of the object item.
Referenced by elm_object_item_access_unregister().
EOAPI Eina_Bool elm_wdg_item_cursor_engine_only_get | ( | void | ) |
Get if the (custom) cursor for a given item is being searched in its theme, also, or is only relying on the rendering engine.
EINA_TRUE
, if cursors are being looked for only on those provided by the rendering engine, EINA_FALSE
if they are being searched on the widget's theme, as well.Referenced by elm_gengrid_item_cursor_engine_only_get(), elm_genlist_item_cursor_engine_only_get(), and elm_object_item_cursor_engine_only_get().
EOAPI void elm_wdg_item_cursor_engine_only_set | ( | Eina_Bool | engine_only | ) |
Set if the (custom)cursor for a given item should be searched in its theme, also, or should only rely on the rendering engine.
[in] | engine_only | Use EINA_TRUE to have cursors looked for only on those provided by the rendering engine, EINA_FALSE to have them searched on the widget's theme, as well. |
Referenced by elm_gengrid_item_cursor_engine_only_set(), elm_genlist_item_cursor_engine_only_set(), and elm_object_item_cursor_engine_only_set().
EOAPI const char* elm_wdg_item_cursor_get | ( | void | ) |
Get the type of mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item.
Referenced by elm_gengrid_item_cursor_get(), elm_genlist_item_cursor_get(), and elm_object_item_cursor_get().
EOAPI void elm_wdg_item_cursor_set | ( | const char * | cursor | ) |
Set the type of mouse pointer/cursor decoration to be shown, when the mouse pointer is over the given item.
This function works analogously as elm_object_cursor_set(), but here the cursor's changing area is restricted to the item's area, and not the whole widget's. Note that that item cursors have precedence over widget cursors, so that a mouse over an item with custom cursor set will always show that cursor.
If this function is called twice for an object, a previously set cursor will be unset on the second call.
[in] | cursor | the cursor type's name |
Referenced by elm_gengrid_item_cursor_set(), elm_genlist_item_cursor_set(), and elm_object_item_cursor_set().
EOAPI const char* elm_wdg_item_cursor_style_get | ( | void | ) |
Get the current style set for a given item's custom cursor.
Referenced by elm_gengrid_item_cursor_style_get(), elm_genlist_item_cursor_style_get(), and elm_object_item_cursor_style_get().
EOAPI void elm_wdg_item_cursor_style_set | ( | const char * | style | ) |
Set a different style for a given custom cursor set for an item.
This function only makes sense when one is using custom mouse cursor decorations defined in a theme file, which can have, given a cursor name/type, alternate styles on it. It works analogously as elm_object_cursor_style_set(), but here applies only to item objects.
[in] | style | the theme style to use/in use (e.g. "default" , "transparent" , etc) |
Referenced by elm_gengrid_item_cursor_style_set(), elm_genlist_item_cursor_style_set(), and elm_object_item_cursor_style_set().
EOAPI void elm_wdg_item_cursor_unset | ( | void | ) |
Unset any custom mouse pointer/cursor decoration set to be shown, when the mouse pointer is over the given item, thus making it show the default cursor again.
Use this call to undo any custom settings on this item's cursor decoration, bringing it back to defaults (no custom style set).
Referenced by elm_gengrid_item_cursor_unset(), elm_genlist_item_cursor_unset(), and elm_object_item_cursor_unset().
EOAPI void elm_wdg_item_del_cb_set | ( | Evas_Smart_Cb | del_cb | ) |
Set the function to be called when an item from the widget is freed.
That function will receive these parameters:
[in] | del_cb | The function called |
Referenced by elm_object_item_del_cb_set().
EOAPI void elm_wdg_item_domain_part_text_translatable_set | ( | const char * | part, |
const char * | domain, | ||
Eina_Bool | translatable | ||
) |
Mark the part text to be translatable or not.
Once you mark the part text to be translatable, the text will be translated internally regardless of elm_object_item_part_text_set() and elm_object_item_domain_translatable_part_text_set(). In other case, if you set the Elementary policy that all text will be translatable in default, you can set the part text to not be translated by calling this API.
[in] | part | The part name of the translatable text |
[in] | domain | The translation domain to use |
[in] | translatable | EINA_TRUE , the part text will be translated internally. EINA_FALSE , otherwise. |
Referenced by elm_object_item_domain_part_text_translatable_set().
EOAPI void elm_wdg_item_domain_translatable_part_text_set | ( | const char * | part, |
const char * | domain, | ||
const char * | label | ||
) |
Set the text for an object item's part, marking it as translatable.
The string to set as text
must be the original one. Do not pass the return of gettext()
here. Elementary will translate the string internally and set it on the object item using elm_object_item_part_text_set(), also storing the original string so that it can be automatically translated when the language is changed with elm_language_set(). The domain
will be stored along to find the translation in the correct catalog. It can be NULL, in which case it will use whatever domain was set by the application with textdomain()
. This is useful in case you are building a library on top of Elementary that will have its own translatable strings, that should not be mixed with those of programs using the library.
[in] | part | The name of the part to set |
[in] | domain | The translation domain to use |
[in] | label | The original, non-translated text to set |
Referenced by elm_object_item_domain_translatable_part_text_set().
EOAPI Evas_Object* elm_wdg_item_part_content_get | ( | const char * | part | ) |
Get a content of an object item.
[in] | part | The content part name (NULL for the default content) |
Referenced by elm_object_item_part_content_get().
EOAPI void elm_wdg_item_part_content_set | ( | const char * | part, |
Evas_Object * | content | ||
) |
Set a content of an object item.
This sets a new object to an item as a content object. If any object was already set as a content object in the same part, previous object will be deleted automatically.
[in] | part | The content part name (NULL for the default content) |
[in] | content | The content of the object item |
Referenced by elm_object_item_part_content_set().
EOAPI Evas_Object* elm_wdg_item_part_content_unset | ( | const char * | part | ) |
Unset a content of an object item.
[in] | part | The content part name to unset (NULL for the default content) |
Referenced by elm_object_item_part_content_unset().
EOAPI const char* elm_wdg_item_part_text_get | ( | const char * | part | ) |
Get a label of an object item.
[in] | part | The text part name (NULL for the default label) |
Referenced by elm_object_item_part_text_get().
EOAPI void elm_wdg_item_part_text_set | ( | const char * | part, |
const char * | label | ||
) |
Set a label of an object item.
[in] | part | The text part name (NULL for the default label) |
[in] | label | Text of the label |
Referenced by elm_object_item_part_text_set().
EOAPI void elm_wdg_item_signal_callback_add | ( | const char * | emission, |
const char * | source, | ||
Elm_Object_Item_Signal_Cb | func, | ||
void * | data | ||
) |
Add a callback for a signal emitted by object item edje.
This function connects a callback function to a signal emitted by the edje object of the object item. Globs can occur in either the emission or source name.
[in] | emission | The signal's name. |
[in] | source | The signal's source. |
[in] | func | The callback function to be executed when the signal is emitted. |
[in] | data | A pointer to data to pass to the callback function. |
Referenced by elm_object_item_signal_callback_add().
EOAPI void* elm_wdg_item_signal_callback_del | ( | const char * | emission, |
const char * | source, | ||
Elm_Object_Item_Signal_Cb | func | ||
) |
Remove a signal-triggered callback from a object item edje object.
This function removes the last callback, previously attached to a signal emitted by an underlying Edje object of it, whose parameters emission, source and func
match exactly with those passed to a previous call to elm_object_item_signal_callback_add(). The data pointer that was passed to this call will be returned.
[in] | emission | The signal's name. |
[in] | source | The signal's source. |
[in] | func | The callback function to be executed when the signal is emitted. |
Referenced by elm_object_item_signal_callback_del().
EOAPI void elm_wdg_item_signal_emit | ( | const char * | emission, |
const char * | source | ||
) |
Send a signal to the edje object of the widget item.
This function sends a signal to the edje object of the obj item. An edje program can respond to a signal by specifying matching 'signal' and 'source' fields.
[in] | emission | The signal's name. |
[in] | source | The signal's source. |
Referenced by elm_object_item_signal_emit().
EOAPI const char* elm_wdg_item_style_get | ( | void | ) |
EOAPI void elm_wdg_item_style_set | ( | const char * | style | ) |
Set a style of an object item.
[in] | style | The style of object item |
Referenced by elm_object_item_style_set().
EOAPI void elm_wdg_item_tooltip_content_cb_set | ( | Elm_Tooltip_Item_Content_Cb | func, |
const void * | data, | ||
Evas_Smart_Cb | del_cb | ||
) |
Set the content to be shown in the tooltip item.
Setup the tooltip to item. The item can have only one tooltip, so any previous tooltip data is removed. func
(with data
) will be called every time that need show the tooltip and it should return a valid Evas_Object. This object is then managed fully by tooltip system and is deleted when the tooltip is gone.
[in] | func | the function used to create the tooltip contents. |
[in] | data | what to provide to func as callback data/context. |
[in] | del_cb | called when data is not needed anymore, either when another callback replaces func, the tooltip is unset with elm_object_item_tooltip_unset() or the owner item dies. This callback receives as the first parameter the given data, and event_info is the item. |
Referenced by elm_gengrid_item_tooltip_content_cb_set(), elm_genlist_item_tooltip_content_cb_set(), and elm_object_item_tooltip_content_cb_set().
EOAPI const char* elm_wdg_item_tooltip_style_get | ( | void | ) |
Get the style for this item tooltip.
Referenced by elm_gengrid_item_tooltip_style_get(), elm_genlist_item_tooltip_style_get(), and elm_object_item_tooltip_style_get().
EOAPI void elm_wdg_item_tooltip_style_set | ( | const char * | style | ) |
Sets a different style for this item tooltip.
[in] | style | the theme style used/to use (default, transparent, ...) |
Referenced by elm_gengrid_item_tooltip_style_set(), elm_genlist_item_tooltip_style_set(), and elm_object_item_tooltip_style_set().
EOAPI void elm_wdg_item_tooltip_text_set | ( | const char * | text | ) |
Set the text to be shown in a given object item's tooltips.
Setup the text as tooltip to object. The item can have only one tooltip, so any previous tooltip data - set with this function or elm_object_item_tooltip_content_cb_set() - is removed.
[in] | text | The text to set in the content. |
Referenced by elm_gengrid_item_tooltip_text_set(), elm_genlist_item_tooltip_text_set(), and elm_object_item_tooltip_text_set().
EOAPI void elm_wdg_item_tooltip_unset | ( | void | ) |
Unset tooltip from item.
Remove tooltip from item. The callback provided as del_cb to elm_object_item_tooltip_content_cb_set() will be called to notify it is not used anymore.
Referenced by elm_gengrid_item_tooltip_unset(), elm_genlist_item_tooltip_unset(), and elm_object_item_tooltip_unset().
EOAPI Evas_Object* elm_wdg_item_track | ( | void | ) |
This returns track object of the item.
NULL
if the widget item doesn't have it. Additionally, the widget item is managed/controlled by the widget, the widget item could be changed(moved, resized even deleted) anytime by it's own widget's decision. So please dont' change the track object as well as don't keep the track object in your side as possible but get the track object at the moment you need to refer. Otherwise, you need to add some callbacks to the track object to track it's attributes changes.Referenced by elm_object_item_track().
EOAPI int elm_wdg_item_track_get | ( | void | ) |
Get the track object reference count.
Referenced by elm_object_item_track_get().
EOAPI const char* elm_wdg_item_translatable_part_text_get | ( | const char * | part | ) |
Get the original string set as translatable for an object item.
When setting translated strings, the function elm_object_item_part_text_get() will return the translation returned by gettext()
. To get the original string use this function.
[in] | part | The name of the part that was set |
Referenced by elm_object_item_translatable_part_text_get().
EOAPI void elm_wdg_item_untrack | ( | void | ) |
This retrieve the track object of the item.
Referenced by elm_object_item_untrack().
EOAPI Evas_Object* elm_wdg_item_widget_get | ( | void | ) |
Get the widget object's handle which contains a given item.
Referenced by elm_object_item_widget_get().
int ELM_EVENT_PROCESS_BACKGROUND |
Emitted when nothing is visible and the process as a whole should go into a background state.
int ELM_EVENT_PROCESS_FOREGROUND |
Emitted when going from nothing being visible to at least one window being visible.