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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
|
/**
* @defgroup Menu Menu
* @ingroup Elementary
*
* @image html img/widget/menu/preview-00.png
* @image latex img/widget/menu/preview-00.eps
*
* A menu is a list of items displayed above its parent. When the menu is
* showing its parent is darkened. Each item can have a sub-menu. The menu
* object can be used to display a menu on a right click event, in a toolbar,
* anywhere.
*
* Signals that you can add callbacks for are:
* @li "clicked" - the user clicked the empty space in the menu to dismiss.
*
* Default content parts of the menu items that you can use for are:
* @li "default" - A main content of the menu item
*
* Default text parts of the menu items that you can use for are:
* @li "default" - label in the menu item
*
* Supported elm_object_item common APIs.
* @li @ref elm_object_item_part_text_set
* @li @ref elm_object_item_part_text_get
* @li @ref elm_object_item_part_content_set
* @li @ref elm_object_item_part_content_get
* @li @ref elm_object_item_disabled_set
* @li @ref elm_object_item_disabled_get
*
* @see @ref tutorial_menu
* @{
*/
/**
* @brief Add a new menu to the parent
*
* @param parent The parent object.
* @return The new object or NULL if it cannot be created.
*
* @ingroup Menu
*/
EAPI Evas_Object *elm_menu_add(Evas_Object *parent);
/**
* @brief Set the parent for the given menu widget
*
* @param obj The menu object.
* @param parent The new parent.
*
* @ingroup Menu
*/
EAPI void elm_menu_parent_set(Evas_Object *obj, Evas_Object *parent);
/**
* @brief Get the parent for the given menu widget
*
* @param obj The menu object.
* @return The parent.
*
* @see elm_menu_parent_set()
*
* @ingroup Menu
*/
EAPI Evas_Object *elm_menu_parent_get(const Evas_Object *obj);
/**
* @brief Move the menu to a new position
*
* @param obj The menu object.
* @param x The new position.
* @param y The new position.
*
* Sets the top-left position of the menu to (@p x,@p y).
*
* @note @p x and @p y coordinates are relative to parent.
*
* @ingroup Menu
*/
EAPI void elm_menu_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y);
/**
* @brief Close a opened menu
*
* @param obj the menu object
* @return void
*
* Hides the menu and all it's sub-menus.
*
* @ingroup Menu
*/
EAPI void elm_menu_close(Evas_Object *obj);
/**
* @brief Returns a list of @p item's items.
*
* @param obj The menu object
* @return An Eina_List* of @p item's items
*
* @ingroup Menu
*/
EAPI const Eina_List *elm_menu_items_get(const Evas_Object *obj);
/**
* @brief Get the Evas_Object of an Elm_Object_Item
*
* @param it The menu item object.
* @return The edje object containing the swallowed content
*
* @warning Don't manipulate this object!
*
* @ingroup Menu
*/
EAPI Evas_Object *elm_menu_item_object_get(const Elm_Object_Item *it);
/**
* @brief Add an item at the end of the given menu widget
*
* @param obj The menu object.
* @param parent The parent menu item (optional)
* @param icon An icon display on the item. The icon will be destroyed by the menu.
* @param label The label of the item.
* @param func Function called when the user select the item.
* @param data Data sent by the callback.
* @return Returns the new item.
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_item_add(Evas_Object *obj, Elm_Object_Item *parent, const char *icon, const char *label, Evas_Smart_Cb func, const void *data);
/**
* @brief Set the icon of a menu item to the standard icon with name @p icon
*
* @param it The menu item object.
* @param icon The name of icon object to set for the content of @p item
*
* Once this icon is set, any previously set icon will be deleted.
*
* @ingroup Menu
*/
EAPI void elm_menu_item_icon_name_set(Elm_Object_Item *it, const char *icon);
/**
* @brief Get the string representation from the icon of a menu item
*
* @param it The menu item object.
* @return The string representation of @p item's icon or NULL
*
* @see elm_menu_item_icon_name_set()
*
* @ingroup Menu
*/
EAPI const char *elm_menu_item_icon_name_get(const Elm_Object_Item *it);
/**
* @brief Set the selected state of @p item.
*
* @param it The menu item object.
* @param selected The selected/unselected state of the item
*
* @ingroup Menu
*/
EAPI void elm_menu_item_selected_set(Elm_Object_Item *it, Eina_Bool selected);
/**
* @brief Get the selected state of @p item.
*
* @param it The menu item object.
* @return The selected/unselected state of the item
*
* @see elm_menu_item_selected_set()
*
* @ingroup Menu
*/
EAPI Eina_Bool elm_menu_item_selected_get(const Elm_Object_Item *it);
/**
* @brief Add a separator item to menu @p obj under @p parent.
*
* @param obj The menu object
* @param parent The item to add the separator under
* @return The created item or NULL on failure
*
* This is item is a @ref Separator.
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_item_separator_add(Evas_Object *obj, Elm_Object_Item *parent);
/**
* @brief Returns whether @p item is a separator.
*
* @param it The item to check
* @return If true, @p item is a separator
*
* @see elm_menu_item_separator_add()
*
* @ingroup Menu
*/
EAPI Eina_Bool elm_menu_item_is_separator(Elm_Object_Item *it);
/**
* @brief Returns a list of @p item's subitems.
*
* @param it The item
* @return An Eina_List* of @p item's subitems
*
* @see elm_menu_add()
*
* @ingroup Menu
*/
EAPI const Eina_List *elm_menu_item_subitems_get(const Elm_Object_Item *it);
/**
* @brief Get the position of a menu item
*
* @param it The menu item
* @return The item's index
*
* This function returns the index position of a menu item in a menu.
* For a sub-menu, this number is relative to the first item in the sub-menu.
*
* @note Index values begin with 0
*
* @ingroup Menu
*/
EAPI unsigned int elm_menu_item_index_get(const Elm_Object_Item *it);
/**
* @brief Get the selected item in the menu
*
* @param obj The menu object
* @return The selected item, or NULL if none
*
* @see elm_menu_item_selected_get()
* @see elm_menu_item_selected_set()
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_selected_item_get(const Evas_Object *obj);
/**
* @brief Get the last item in the menu
*
* @param obj The menu object
* @return The last item, or NULL if none
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_last_item_get(const Evas_Object *obj);
/**
* @brief Get the first item in the menu
*
* @param obj The menu object
* @return The first item, or NULL if none
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_first_item_get(const Evas_Object *obj);
/**
* @brief Get the next item in the menu.
*
* @param it The menu item object.
* @return The item after it, or NULL if none
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_item_next_get(const Elm_Object_Item *it);
/**
* @brief Get the previous item in the menu.
*
* @param it The menu item object.
* @return The item before it, or NULL if none
*
* @ingroup Menu
*/
EAPI Elm_Object_Item *elm_menu_item_prev_get(const Elm_Object_Item *it);
/**
* @}
*/
|
