Functions | |
Evas_Object * | elm_hoversel_add (Evas_Object *parent) |
Add a new Hoversel object. More... | |
EOAPI void | elm_obj_hoversel_horizontal_set (Eina_Bool horizontal) |
Control if the hoversel should expand horizontally. More... | |
EOAPI Eina_Bool | elm_obj_hoversel_horizontal_get (void) |
Control if the hoversel should expand horizontally. More... | |
EOAPI void | elm_obj_hoversel_hover_parent_set (Evas_Object *parent) |
Control the hover parent. More... | |
EOAPI Evas_Object * | elm_obj_hoversel_hover_parent_get (void) |
Control the hover parent. More... | |
EOAPI Eina_Bool | elm_obj_hoversel_expanded_get (void) |
Returns whether the hoversel is expanded. More... | |
EOAPI const Eina_List * | elm_obj_hoversel_items_get (void) |
Get the list of items within the given hoversel. | |
EOAPI void | elm_obj_hoversel_auto_update_set (Eina_Bool auto_update) |
Update icon and text of hoversel same to those of selected item automatically. More... | |
EOAPI Eina_Bool | elm_obj_hoversel_auto_update_get (void) |
Update icon and text of hoversel same to those of selected item automatically. More... | |
EOAPI void | elm_obj_hoversel_hover_begin (void) |
This triggers the hoversel popup from code, the same as if the user had clicked the button. | |
EOAPI void | elm_obj_hoversel_clear (void) |
This will remove all the children items from the hoversel. More... | |
EOAPI void | elm_obj_hoversel_hover_end (void) |
This dismisses the hoversel popup as if the user had clicked outside the hover. | |
EOAPI Elm_Widget_Item * | elm_obj_hoversel_item_add (const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data) |
Add an item to the hoversel button. More... | |
void | elm_hoversel_horizontal_set (Elm_Hoversel *obj, Eina_Bool horizontal) |
Control if the hoversel should expand horizontally. More... | |
Eina_Bool | elm_hoversel_horizontal_get (const Elm_Hoversel *obj) |
Control if the hoversel should expand horizontally. More... | |
void | elm_hoversel_hover_parent_set (Elm_Hoversel *obj, Evas_Object *parent) |
Control the hover parent. More... | |
Evas_Object * | elm_hoversel_hover_parent_get (const Elm_Hoversel *obj) |
Control the hover parent. More... | |
Eina_Bool | elm_hoversel_expanded_get (const Elm_Hoversel *obj) |
Returns whether the hoversel is expanded. More... | |
const Eina_List * | elm_hoversel_items_get (const Elm_Hoversel *obj) |
Get the list of items within the given hoversel. More... | |
void | elm_hoversel_auto_update_set (Elm_Hoversel *obj, Eina_Bool auto_update) |
Update icon and text of hoversel same to those of selected item automatically. More... | |
Eina_Bool | elm_hoversel_auto_update_get (const Elm_Hoversel *obj) |
Update icon and text of hoversel same to those of selected item automatically. More... | |
void | elm_hoversel_hover_begin (Elm_Hoversel *obj) |
This triggers the hoversel popup from code, the same as if the user had clicked the button. | |
void | elm_hoversel_clear (Elm_Hoversel *obj) |
This will remove all the children items from the hoversel. More... | |
void | elm_hoversel_hover_end (Elm_Hoversel *obj) |
This dismisses the hoversel popup as if the user had clicked outside the hover. | |
Elm_Widget_Item * | elm_hoversel_item_add (Elm_Hoversel *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data) |
Add an item to the hoversel button. More... | |
A hoversel is a button that pops up a list of items (automatically choosing the direction to display) that have a label and, optionally, an icon to select from. It is a convenience widget to avoid the need to do all the piecing together yourself. It is intended for a small number of items in the hoversel menu (no more than 8), though is capable of many more.
This widget inherits from the Button one, so that all the functions acting on it also work for hoversel objects.
This widget emits the following signals, besides the ones sent from Button:
"clicked"
- the user clicked the hoversel button and popped up the sel"selected"
- an item in the hoversel list is selected. event_info is the selected item"dismissed"
- the hover is dismissed"expanded"
- This is called on clicking hoversel and elm_hoversel_hover_begin()."language,changed"
- the program's language changed (since 1.9)"item,focused"
- When the hoversel item has received focus. (since 1.10)"item,unfocused"
- When the hoversel item has lost focus. (since 1.10)Default content parts of the hoversel widget that you can use for are:
Default text parts of the hoversel widget that you can use for are:
Supported elm_object common APIs.
Supported elm_object_item common APIs.
See Hoversel example for an example.
Evas_Object* elm_hoversel_add | ( | Evas_Object * | parent | ) |
Add a new Hoversel object.
parent | The parent object |
Eina_Bool elm_hoversel_auto_update_get | ( | const Elm_Hoversel * | obj | ) |
Update icon and text of hoversel same to those of selected item automatically.
true
if hoversel is updated automatically or false
otherwise References elm_obj_hoversel_auto_update_get().
void elm_hoversel_auto_update_set | ( | Elm_Hoversel * | obj, |
Eina_Bool | auto_update | ||
) |
Update icon and text of hoversel same to those of selected item automatically.
[in] | auto_update | true if hoversel is updated automatically or false otherwise |
References elm_obj_hoversel_auto_update_set().
void elm_hoversel_clear | ( | Elm_Hoversel * | obj | ) |
This will remove all the children items from the hoversel.
Warning Should not be called while the hoversel is active; use elm_hoversel_expanded_get to check first.
References elm_obj_hoversel_clear().
Eina_Bool elm_hoversel_expanded_get | ( | const Elm_Hoversel * | obj | ) |
Returns whether the hoversel is expanded.
true
if the hoversel is expanded or false
otherwiseEINA_TRUE
if the hoversel is expanded or EINA_FALSE
if it is not expanded. References elm_obj_hoversel_expanded_get().
Eina_Bool elm_hoversel_horizontal_get | ( | const Elm_Hoversel * | obj | ) |
Control if the hoversel should expand horizontally.
true
, the hover will expand horizontally to the right.Control if the hoversel should expand horizontally.
References elm_obj_hoversel_horizontal_get().
void elm_hoversel_horizontal_set | ( | Elm_Hoversel * | obj, |
Eina_Bool | horizontal | ||
) |
Control if the hoversel should expand horizontally.
[in] | horizontal | If true , the hover will expand horizontally to the right. |
Control if the hoversel should expand horizontally.
[in] | horizontal | If true, the hover will expand horizontally to the right. |
References elm_obj_hoversel_horizontal_set().
Evas_Object* elm_hoversel_hover_parent_get | ( | const Elm_Hoversel * | obj | ) |
Control the hover parent.
Sets the hover parent object, the area that will be darkened when the hoversel is clicked. Should probably be the window that the hoversel is in.
Control the hover parent.
Get the hover parent object.
References elm_obj_hoversel_hover_parent_get().
void elm_hoversel_hover_parent_set | ( | Elm_Hoversel * | obj, |
Evas_Object * | parent | ||
) |
Control the hover parent.
Sets the hover parent object, the area that will be darkened when the hoversel is clicked. Should probably be the window that the hoversel is in.
[in] | parent | The parent to use |
Control the hover parent.
Sets the hover parent object, the area that will be darkened when the hoversel is clicked. Should probably be the window that the hoversel is in. See Hover objects for more information.
[in] | parent | The parent to use |
References elm_obj_hoversel_hover_parent_set().
Elm_Widget_Item* elm_hoversel_item_add | ( | Elm_Hoversel * | obj, |
const char * | label, | ||
const char * | icon_file, | ||
Elm_Icon_Type | icon_type, | ||
Evas_Smart_Cb | func, | ||
const void * | data | ||
) |
Add an item to the hoversel button.
This adds an item to the hoversel to show when it is clicked. Note: if you need to use an icon from an edje file then use Elm.Hoversel_Item.icon.set right after this function, and set icon_file to null
here.
[in] | icon_file | An image file path on disk to use for the icon or standard icon name (NULL if not desired) |
[in] | icon_type | The icon type if relevant |
[in] | func | Convenience function to call when this item is selected. The last parameter event_info of func is the selected item pointer. |
[in] | data | Data to pass to item-related functions |
This adds an item to the hoversel to show when it is clicked. Note: if you need to use an icon from an edje file then use elm_hoversel_item_icon_set() right after this function, and set icon_file to NULL here.
For more information on what icon_file
and icon_type
are, see the icon documentation.
[in] | label | The text label to use for the item (NULL if not desired) |
[in] | icon_file | An image file path on disk to use for the icon or standard icon name (NULL if not desired) |
[in] | icon_type | The icon type if relevant |
[in] | func | Convenience function to call when this item is selected. The last parameter event_info of func is the selected item pointer. |
[in] | data | Data to pass to item-related functions |
References elm_obj_hoversel_item_add().
const Eina_List* elm_hoversel_items_get | ( | const Elm_Hoversel * | obj | ) |
Get the list of items within the given hoversel.
References elm_obj_hoversel_items_get().
EOAPI Eina_Bool elm_obj_hoversel_auto_update_get | ( | void | ) |
Update icon and text of hoversel same to those of selected item automatically.
true
if hoversel is updated automatically or false
otherwise Referenced by elm_hoversel_auto_update_get().
EOAPI void elm_obj_hoversel_auto_update_set | ( | Eina_Bool | auto_update | ) |
Update icon and text of hoversel same to those of selected item automatically.
[in] | auto_update | true if hoversel is updated automatically or false otherwise |
Referenced by elm_hoversel_auto_update_set().
EOAPI void elm_obj_hoversel_clear | ( | void | ) |
This will remove all the children items from the hoversel.
Warning Should not be called while the hoversel is active; use elm_obj_hoversel_expanded_get to check first.
Referenced by elm_hoversel_clear().
EOAPI Eina_Bool elm_obj_hoversel_expanded_get | ( | void | ) |
Returns whether the hoversel is expanded.
true
if the hoversel is expanded or false
otherwise Referenced by elm_hoversel_expanded_get().
EOAPI Eina_Bool elm_obj_hoversel_horizontal_get | ( | void | ) |
Control if the hoversel should expand horizontally.
true
, the hover will expand horizontally to the right. Referenced by elm_hoversel_horizontal_get().
EOAPI void elm_obj_hoversel_horizontal_set | ( | Eina_Bool | horizontal | ) |
Control if the hoversel should expand horizontally.
[in] | horizontal | If true , the hover will expand horizontally to the right. |
Referenced by elm_hoversel_horizontal_set().
EOAPI Evas_Object* elm_obj_hoversel_hover_parent_get | ( | void | ) |
Control the hover parent.
Sets the hover parent object, the area that will be darkened when the hoversel is clicked. Should probably be the window that the hoversel is in.
Referenced by elm_hoversel_hover_parent_get().
EOAPI void elm_obj_hoversel_hover_parent_set | ( | Evas_Object * | parent | ) |
Control the hover parent.
Sets the hover parent object, the area that will be darkened when the hoversel is clicked. Should probably be the window that the hoversel is in.
[in] | parent | The parent to use |
Referenced by elm_hoversel_hover_parent_set().
EOAPI Elm_Widget_Item* elm_obj_hoversel_item_add | ( | const char * | label, |
const char * | icon_file, | ||
Elm_Icon_Type | icon_type, | ||
Evas_Smart_Cb | func, | ||
const void * | data | ||
) |
Add an item to the hoversel button.
This adds an item to the hoversel to show when it is clicked. Note: if you need to use an icon from an edje file then use Elm.Hoversel_Item.icon.set right after this function, and set icon_file to null
here.
[in] | icon_file | An image file path on disk to use for the icon or standard icon name (NULL if not desired) |
[in] | icon_type | The icon type if relevant |
[in] | func | Convenience function to call when this item is selected. The last parameter event_info of func is the selected item pointer. |
[in] | data | Data to pass to item-related functions |
Referenced by elm_hoversel_item_add().