summaryrefslogtreecommitdiff
path: root/src/lib/elm_flipselector_common.h
blob: ef058f5b96d44e0d9e0defe72693c0156b35ac19 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
/**
 * Set whether a given flip selector widget's item should be the
 * currently selected one.
 *
 * @param it The flip selector item
 * @param selected @c EINA_TRUE to select it, @c EINA_FALSE to unselect.
 *
 * This sets whether @p item is or not the selected (thus, under
 * display) one. If @p item is different than the one under display,
 * the latter will be unselected. If the @p item is set to be
 * unselected, on the other hand, the @b first item in the widget's
 * internal members list will be the new selected one.
 *
 * @see elm_flipselector_item_selected_get()
 *
 * @ingroup Flipselector
 */
EAPI void                        elm_flipselector_item_selected_set(Elm_Object_Item *it, Eina_Bool selected);

/**
 * Get whether a given flip selector widget's item is the currently
 * selected one.
 *
 * @param it The flip selector item
 * @return @c EINA_TRUE, if it's selected, @c EINA_FALSE otherwise
 * (or on errors).
 *
 * @see elm_flipselector_item_selected_set()
 *
 * @ingroup Flipselector
 */
EAPI Eina_Bool  elm_flipselector_item_selected_get(const Elm_Object_Item *it);

/**
 * Get the item before @p item in a flip selector widget's internal list of
 * items.
 *
 * @param it The item to fetch previous from
 * @return The item before the @p item, in its parent's list. If there is no
 *         previous item for @p item or there's an error, @c NULL is returned.
 *
 * @see elm_flipselector_item_next_get()
 *
 * @ingroup Flipselector
 */
EAPI Elm_Object_Item *elm_flipselector_item_prev_get(const Elm_Object_Item *it);

/**
 * Get the item after @p item in a flip selector widget's
 * internal list of items.
 *
 * @param it The item to fetch next from
 * @return The item after the @p item, in its parent's list. If there is no next
 *         item for @p item or there's an error, @c NULL is returned.
 *
 * @see elm_flipselector_item_prev_get()
 *
 * @ingroup Flipselector
 */
EAPI Elm_Object_Item            *elm_flipselector_item_next_get(const Elm_Object_Item *it);