#include <Elementary.h>
#include "elm_priv.h"
-/**
- * @defgroup Hoversel
- *
- * A hoversel is a button that pops up a list of items (automatically
- * choosing the direction to display) that have a lable and/or 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.
- *
- * Signals that you can add callbacks for are:
- *
- * "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 item
- * "dismissed" - the hover is dismissed
- */
typedef struct _Widget_Data Widget_Data;
+typedef struct _Elm_Hoversel_Item Elm_Hoversel_Item;
struct _Widget_Data
{
struct _Elm_Hoversel_Item
{
- Elm_Widget_Item base;
+ ELM_WIDGET_ITEM;
const char *label;
const char *icon_file;
const char *icon_group;
Elm_Hoversel_Item *item;
Widget_Data *wd = elm_widget_data_get(obj);
if (!wd) return;
+ evas_object_event_callback_del_full(wd->btn, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
+ _changed_size_hints, obj);
elm_hoversel_hover_end(obj);
elm_hoversel_hover_parent_set(obj, NULL);
EINA_LIST_FREE(wd->items, item)
{
- elm_widget_item_pre_notify_del(item);
eina_stringshare_del(item->label);
eina_stringshare_del(item->icon_file);
eina_stringshare_del(item->icon_group);
- elm_widget_item_del(item);
+ elm_widget_item_free(item);
}
}
_item_clicked(void *data, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
{
Elm_Hoversel_Item *item = data;
- Evas_Object *obj2 = item->base.widget;
+ Evas_Object *obj2 = WIDGET(item);
elm_hoversel_hover_end(obj2);
if (item->func) item->func((void *)item->base.data, obj2, item);
if (item->icon_file)
{
ic = elm_icon_add(obj);
- elm_icon_scale_set(ic, 0, 1);
+ elm_icon_resizable_set(ic, EINA_FALSE, EINA_TRUE);
if (item->icon_type == ELM_ICON_FILE)
elm_icon_file_set(ic, item->icon_file, item->icon_group);
else if (item->icon_type == ELM_ICON_STANDARD)
elm_icon_standard_set(ic, item->icon_file);
- elm_button_icon_set(bt, ic);
+ elm_object_part_content_set(bt, "icon", ic);
evas_object_show(ic);
}
evas_object_size_hint_weight_set(bt, EVAS_HINT_EXPAND, 0.0);
}
if (wd->horizontal)
- elm_hover_content_set(wd->hover,
+ elm_object_part_content_set(wd->hover,
elm_hover_best_content_location_get(wd->hover,
ELM_HOVER_AXIS_HORIZONTAL),
bx);
else
- elm_hover_content_set(wd->hover,
+ elm_object_part_content_set(wd->hover,
elm_hover_best_content_location_get(wd->hover,
ELM_HOVER_AXIS_VERTICAL),
bx);
wd->hover_parent = NULL;
}
-/**
- * Add a new Hoversel object
- *
- * @param parent The parent object
- * @return The new object or NULL if it cannot be created
- *
- * @ingroup Hoversel
- */
+static void
+_elm_hoversel_label_set(Evas_Object *obj, const char *item, const char *label)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype);
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if (item && strcmp(item, "default")) return;
+ if (!wd) return;
+ elm_object_text_set(wd->btn, label);
+}
+
+static const char *
+_elm_hoversel_label_get(const Evas_Object *obj, const char *item)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if (item && strcmp(item, "default")) return NULL;
+ if ((!wd) || (!wd->btn)) return NULL;
+ return elm_object_text_get(wd->btn);
+}
+
+static void
+_content_set_hook(Evas_Object *obj, const char *part, Evas_Object *content)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype);
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if (!wd) return;
+ elm_object_part_content_set(wd->btn, part, content);
+}
+
+static Evas_Object *
+_content_get_hook(const Evas_Object *obj, const char *part)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if ((!wd) || (!wd->btn)) return NULL;
+ return elm_object_part_content_get(wd->btn, part);
+}
+
+static Evas_Object *
+_content_unset_hook(Evas_Object *obj, const char *part)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if ((!wd) || (!wd->btn)) return NULL;
+ return elm_object_part_content_unset(wd->btn, part);
+}
+
+static const char *
+_item_text_get_hook(const Elm_Object_Item *it, const char *part)
+{
+ if (part && strcmp(part, "default")) return NULL;
+ return ((Elm_Hoversel_Item *)it)->label;
+}
+
+static Eina_Bool
+_item_del_pre_hook(Elm_Object_Item *it)
+{
+ Widget_Data *wd;
+ Elm_Hoversel_Item *item = (Elm_Hoversel_Item *)it;
+ wd = elm_widget_data_get(WIDGET(item));
+ if (!wd) return EINA_FALSE;
+ elm_hoversel_hover_end(WIDGET(item));
+ wd->items = eina_list_remove(wd->items, item);
+ eina_stringshare_del(item->label);
+ eina_stringshare_del(item->icon_file);
+ eina_stringshare_del(item->icon_group);
+
+ return EINA_TRUE;
+}
+
EAPI Evas_Object *
elm_hoversel_add(Evas_Object *parent)
{
elm_widget_activate_hook_set(obj, _activate_hook);
elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
elm_widget_can_focus_set(obj, EINA_TRUE);
+ elm_widget_text_set_hook_set(obj, _elm_hoversel_label_set);
+ elm_widget_text_get_hook_set(obj, _elm_hoversel_label_get);
+ elm_widget_content_set_hook_set(obj, _content_set_hook);
+ elm_widget_content_get_hook_set(obj, _content_get_hook);
+ elm_widget_content_unset_hook_set(obj, _content_unset_hook);
wd->btn = elm_button_add(parent);
elm_widget_mirrored_automatic_set(wd->btn, EINA_FALSE);
return obj;
}
-/**
- * Set the Hover parent
- *
- * Sets the hover parent object. Should probably be the window that the hoversel
- * is in. See Hover objects for more information.
- *
- * @param obj The hoversel object
- * @param parent The parent to use
- *
- * @ingroup Hoversel
- */
EAPI void
elm_hoversel_hover_parent_set(Evas_Object *obj, Evas_Object *parent)
{
_parent_del, obj);
}
-/**
- * Get the Hover parent
- *
- * Gets the hover parent object. Should probably be the window that the hoversel
- * is in. See Hover objects for more information.
- *
- * @param obj The hoversel object
- * @return The used parent
- *
- * @ingroup Hoversel
- */
EAPI Evas_Object *
elm_hoversel_hover_parent_get(const Evas_Object *obj)
{
return wd->hover_parent;
}
-/**
- * Set the hoversel button label
- *
- * This sets the label of the button that is always visible (before it is
- * clicked and expanded). Also see elm_object_text_set().
- *
- * @param obj The hoversel object
- * @param label The label text.
- *
- * @ingroup Hoversel
- */
-EAPI void
-elm_hoversel_label_set(Evas_Object *obj, const char *label)
-{
- ELM_CHECK_WIDTYPE(obj, widtype);
- Widget_Data *wd = elm_widget_data_get(obj);
- if (!wd) return;
- elm_object_text_set(wd->btn, label);
-}
-
-/**
- * Get the hoversel button label
- *
- * @param obj The hoversel object
- * @return The label text.
- *
- * @ingroup Hoversel
- */
-EAPI const char *
-elm_hoversel_label_get(const Evas_Object *obj)
-{
- ELM_CHECK_WIDTYPE(obj, widtype) NULL;
- Widget_Data *wd = elm_widget_data_get(obj);
- if ((!wd) || (!wd->btn)) return NULL;
- return elm_object_text_get(wd->btn);
-}
-
-/**
- * This sets the hoversel to expand horizontally. The initial button
- * will display horizontally regardless of this setting.
- *
- * @param obj The hoversel object
- * @param horizontal If true, the hover will expand horizontally to the right.
- *
- * @ingroup Hoversel
- */
EAPI void
elm_hoversel_horizontal_set(Evas_Object *obj, Eina_Bool horizontal)
{
wd->horizontal = !!horizontal;
}
-
-/**
- * This returns whether the hoversel is set to expand horizontally.
- *
- * @param obj The hoversel object
- * @return If true, the hover will expand horizontally to the right.
- *
- * @ingroup Hoversel
- */
EAPI Eina_Bool
elm_hoversel_horizontal_get(const Evas_Object *obj)
{
return wd->horizontal;
}
-/**
- * Set the icon of the hoversel button
- *
- * Sets the icon of the button that is always visible (before it is clicked
- * and expanded). Also see elm_button_icon_set().
- * Once the icon object is set, a previously set one will be deleted
- * If you want to keep that old content object, use the
- * elm_hoversel_icon_unset() function.
- *
- * @param obj The hoversel object
- * @param icon The icon object
- *
- * @ingroup Hoversel
- */
-EAPI void
-elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon)
-{
- ELM_CHECK_WIDTYPE(obj, widtype);
- Widget_Data *wd = elm_widget_data_get(obj);
- if (!wd) return;
- elm_button_icon_set(wd->btn, icon);
-}
-
-/**
- * Get the icon of the hoversel button
- *
- * Get the icon of the button that is always visible (before it is clicked
- * and expanded). Also see elm_button_icon_get().
- *
- * @param obj The hoversel object
- * @return The icon object
- *
- * @ingroup Hoversel
- */
-EAPI Evas_Object *
-elm_hoversel_icon_get(const Evas_Object *obj)
-{
- ELM_CHECK_WIDTYPE(obj, widtype) NULL;
- Widget_Data *wd = elm_widget_data_get(obj);
- if ((!wd) || (!wd->btn)) return NULL;
- return elm_button_icon_get(wd->btn);
-}
-
-/**
- * Get the icon of the hoversel button
- *
- * Unparent and return the icon of the button that is always visible
- * (before it is clicked and expanded). Also see elm_button_icon_unset().
- *
- * @param obj The hoversel object
- * @return The icon object that was being used
- *
- * @ingroup Hoversel
- */
-EAPI Evas_Object *
-elm_hoversel_icon_unset(Evas_Object *obj)
-{
- ELM_CHECK_WIDTYPE(obj, widtype) NULL;
- Widget_Data *wd = elm_widget_data_get(obj);
- if ((!wd) || (!wd->btn)) return NULL;
- return elm_button_icon_unset(wd->btn);
-}
-
-/**
- * This triggers the hoversel popup from code, the same as though the
- * user clicked the button.
- *
- * @param obj The hoversel object
- *
- * @ingroup Hoversel
- */
EAPI void
elm_hoversel_hover_begin(Evas_Object *obj)
{
_activate(obj);
}
-/**
- * This ends the hoversel popup as though the user clicked outside the hover.
- *
- * @param obj The hoversel object
- *
- * @ingroup Hoversel
- */
EAPI void
elm_hoversel_hover_end(Evas_Object *obj)
{
evas_object_smart_callback_call(obj, SIG_DISMISSED, NULL);
}
-/**
- * Returns whether the hoversel is expanded.
- *
- * @param obj The hoversel object
- * @return This will return EINA_TRUE if the hoversel
- * is expanded or EINA_FALSE if it is not expanded.
- *
- * @ingroup Hoversel
- */
EAPI Eina_Bool
elm_hoversel_expanded_get(const Evas_Object *obj)
{
return (wd->hover) ? EINA_TRUE : EINA_FALSE;
}
-/**
- * This will remove all the children items from the hoversel. (should not be
- * called while the hoversel is active; use elm_hoversel_expanded_get()
- * to check first).
- *
- * @param obj The hoversel object
- *
- * @ingroup Hoversel
- */
EAPI void
elm_hoversel_clear(Evas_Object *obj)
{
- Elm_Hoversel_Item *item;
+ Elm_Object_Item *it;
Eina_List *l, *ll;
ELM_CHECK_WIDTYPE(obj, widtype);
Widget_Data *wd = elm_widget_data_get(obj);
if (!wd) return;
- EINA_LIST_FOREACH_SAFE(wd->items, l, ll, item) elm_hoversel_item_del(item);
+ EINA_LIST_FOREACH_SAFE(wd->items, l, ll, it)
+ {
+ _item_del_pre_hook(it);
+ elm_widget_item_free(it);
+ }
}
-/**
- * Get the list of items within the given hoversel.
- *
- * @param obj The hoversel object
- * @return Returns a list of Elm_Hoversel_Item*
- *
- * @ingroup Hoversel
- */
EAPI const Eina_List *
elm_hoversel_items_get(const Evas_Object *obj)
{
return wd->items;
}
-/**
- * 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 the this function, and set icon_file to NULL here.
- *
- * @param obj The hoversel object
- * @param label The text label to use for the item (NULL if not desired)
- * @param icon_file An image file path on disk to use for the icon or standard
- * icon name (NULL if not desired)
- * @param icon_type The icon type if relevant
- * @param func Convenience function to call when this item is selected
- * @param data Data to pass to item-related functions
- * @return A handle to the item added.
- *
- * @ingroup Hoversel
- */
-EAPI Elm_Hoversel_Item *
+EAPI Elm_Object_Item *
elm_hoversel_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data)
{
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
if (!wd) return NULL;
Elm_Hoversel_Item *item = elm_widget_item_new(obj, Elm_Hoversel_Item);
if (!item) return NULL;
+ elm_widget_item_del_pre_hook_set(item, _item_del_pre_hook);
+ elm_widget_item_text_get_hook_set(item, _item_text_get_hook);
wd->items = eina_list_append(wd->items, item);
item->label = eina_stringshare_add(label);
item->icon_file = eina_stringshare_add(icon_file);
item->icon_type = icon_type;
item->func = func;
item->base.data = data;
- return item;
-}
-
-/**
- * Delete an item from the hoversel
- *
- * This deletes the item from the hoversel (should not be called while the
- * hoversel is active; use elm_hoversel_expanded_get()
- * to check first).
- *
- * @param item The item to delete
- *
- * @ingroup Hoversel
- */
-EAPI void
-elm_hoversel_item_del(Elm_Hoversel_Item *item)
-{
- ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
- Widget_Data *wd = elm_widget_data_get(item->base.widget);
- if (!wd) return;
- elm_hoversel_hover_end(item->base.widget);
- wd->items = eina_list_remove(wd->items, item);
- elm_widget_item_pre_notify_del(item);
- eina_stringshare_del(item->label);
- eina_stringshare_del(item->icon_file);
- eina_stringshare_del(item->icon_group);
- elm_widget_item_del(item);
-}
-
-/**
- * Set the function called when an item within the hoversel
- * is freed. That function will receive these parameters:
- *
- * void *item_data
- * Evas_Object *the_item_object
- * Elm_Hoversel_Item *the_object_struct
- *
- * @param item The item to set the callback on
- * @param func The function called
- *
- * @ingroup Hoversel
- */
-EAPI void
-elm_hoversel_item_del_cb_set(Elm_Hoversel_Item *item, Evas_Smart_Cb func)
-{
- ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
- elm_widget_item_del_cb_set(item, func);
-}
-
-/**
- * This returns the data pointer supplied with elm_hoversel_item_add() that
- * will be passed to associated function callbacks.
- *
- * @param item The item to get the data from
- * @return The data pointer set with elm_hoversel_item_add()
- *
- * @ingroup Hoversel
- */
-EAPI void *
-elm_hoversel_item_data_get(const Elm_Hoversel_Item *item)
-{
- ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
- return elm_widget_item_data_get(item);
-}
-
-/**
- * This returns the label text of the given hoversel item.
- *
- * @param item The item to get the label
- * @return The label text of the hoversel item
- *
- * @ingroup Hoversel
- */
-EAPI const char *
-elm_hoversel_item_label_get(const Elm_Hoversel_Item *item)
-{
- ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
- return item->label;
-}
-
-/**
- * This sets the icon for the given hoversel item. The icon can be loaded from
- * the standard set, from an image file, or from an edje file.
- *
- * @param item The item to set the icon
- * @param icon_file An image file path on disk to use for the icon or standard
- * icon name
- * @param icon_group The edje group to use if @p icon_file is an edje file. Set this
- * to NULL if the icon is not an edje file
- * @param icon_type The icon type
- *
- * @ingroup Hoversel
- */
+ return (Elm_Object_Item *)item;
+}
+
EAPI void
-elm_hoversel_item_icon_set(Elm_Hoversel_Item *item, const char *icon_file, const char *icon_group, Elm_Icon_Type icon_type)
+elm_hoversel_item_icon_set(Elm_Object_Item *it, const char *icon_file, const char *icon_group, Elm_Icon_Type icon_type)
{
- ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
+ ELM_OBJ_ITEM_CHECK_OR_RETURN(it);
+ Elm_Hoversel_Item *item = (Elm_Hoversel_Item *)it;
eina_stringshare_replace(&item->icon_file, icon_file);
eina_stringshare_replace(&item->icon_group, icon_group);
item->icon_type = icon_type;
}
-/**
- * Get the icon object of the hoversel item
- *
- * @param item The item to get the icon from
- * @param icon_file The image file path on disk used for the icon or standard
- * icon name
- * @param icon_group The edje group used if @p icon_file is an edje file. NULL
- * if the icon is not an edje file
- * @param icon_type The icon type
- *
- * @ingroup Hoversel
- */
EAPI void
-elm_hoversel_item_icon_get(const Elm_Hoversel_Item *item, const char **icon_file, const char **icon_group, Elm_Icon_Type *icon_type)
+elm_hoversel_item_icon_get(const Elm_Object_Item *it, const char **icon_file, const char **icon_group, Elm_Icon_Type *icon_type)
{
- ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
+ ELM_OBJ_ITEM_CHECK_OR_RETURN(it);
+ Elm_Hoversel_Item *item = (Elm_Hoversel_Item *)it;
if (icon_file) *icon_file = item->icon_file;
if (icon_group) *icon_group = item->icon_group;
if (icon_type) *icon_type = item->icon_type;