2 * Get the widget object's handle which contains a given item
4 * @param it The Elementary object item
5 * @return The widget object
7 * @note This returns the widget object itself that an item belongs to.
11 EAPI Evas_Object *elm_object_item_object_get(const Elm_Object_Item *it) EINA_ARG_NONNULL(1);
14 * Set a content of an object item
16 * @param it The Elementary object item
17 * @param part The content part name to set (NULL for the default content)
18 * @param content The new content of the object item
20 * @note Elementary object items may have many contents
21 * @deprecated Use elm_object_item_part_content_set instead.
24 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
27 * Set a content of an object item
29 * @param it The Elementary object item
30 * @param part The content part name to set (NULL for the default content)
31 * @param content The new content of the object item
33 * @note Elementary object items may have many contents
37 EAPI void elm_object_item_part_content_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
39 #define elm_object_item_content_set(it, content) elm_object_item_part_content_set((it), NULL, (content))
42 * Get a content of an object item
44 * @param it The Elementary object item
45 * @param part The content part name to unset (NULL for the default content)
46 * @return content of the object item or NULL for any error
48 * @note Elementary object items may have many contents
49 * @deprecated Use elm_object_item_part_content_get instead.
52 EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
55 * Get a content of an object item
57 * @param it The Elementary object item
58 * @param part The content part name to unset (NULL for the default content)
59 * @return content of the object item or NULL for any error
61 * @note Elementary object items may have many contents
65 EAPI Evas_Object *elm_object_item_part_content_get(const Elm_Object_Item *it, const char *part);
67 #define elm_object_item_content_get(it) elm_object_item_part_content_get((it), NULL)
70 * Unset a content of an object item
72 * @param it The Elementary object item
73 * @param part The content part name to unset (NULL for the default content)
75 * @note Elementary object items may have many contents
76 * @deprecated Use elm_object_item_part_content_unset instead.
79 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
82 * Unset a content of an object item
84 * @param it The Elementary object item
85 * @param part The content part name to unset (NULL for the default content)
87 * @note Elementary object items may have many contents
91 EAPI Evas_Object *elm_object_item_part_content_unset(Elm_Object_Item *it, const char *part);
93 #define elm_object_item_content_unset(it) elm_object_item_part_content_unset((it), NULL)
96 * Set a label of an object item
98 * @param it The Elementary object item
99 * @param part The text part name to set (NULL for the default label)
100 * @param label The new text of the label
102 * @note Elementary object items may have many labels
103 * @deprecated Use elm_object_item_part_text_set instead.
106 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
109 * Set a label of an object item
111 * @param it The Elementary object item
112 * @param part The text part name to set (NULL for the default label)
113 * @param label The new text of the label
115 * @note Elementary object items may have many labels
119 EAPI void elm_object_item_part_text_set(Elm_Object_Item *it, const char *part, const char *label);
121 #define elm_object_item_text_set(it, label) elm_object_item_part_text_set((it), NULL, (label))
124 * Get a label of an object item
126 * @param it The Elementary object item
127 * @param part The text part name to get (NULL for the default label)
128 * @return text of the label or NULL for any error
130 * @note Elementary object items may have many labels
131 * @deprecated Use elm_object_item_part_text_get instead.
134 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
136 * Get a label of an object item
138 * @param it The Elementary object item
139 * @param part The text part name to get (NULL for the default label)
140 * @return text of the label or NULL for any error
142 * @note Elementary object items may have many labels
146 EAPI const char *elm_object_item_part_text_get(const Elm_Object_Item *it, const char *part);
148 #define elm_object_item_text_get(it) elm_object_item_part_text_get((it), NULL)
151 * Set the text to read out when in accessibility mode
153 * @param it The object item which is to be described
154 * @param txt The text that describes the widget to people with poor or no vision
158 EAPI void elm_object_item_access_info_set(Elm_Object_Item *it, const char *txt);
161 * Get the data associated with an object item
162 * @param it The Elementary object item
163 * @return The data associated with @p it
167 EAPI void *elm_object_item_data_get(const Elm_Object_Item *it);
170 * Set the data associated with an object item
171 * @param it The Elementary object item
172 * @param data The data to be associated with @p it
176 EAPI void elm_object_item_data_set(Elm_Object_Item *it, void *data);
179 * Send a signal to the edje object of the widget item.
181 * This function sends a signal to the edje object of the obj item. An
182 * edje program can respond to a signal by specifying matching
183 * 'signal' and 'source' fields.
185 * @param it The Elementary object item
186 * @param emission The signal's name.
187 * @param source The signal's source.
190 EAPI void elm_object_item_signal_emit(Elm_Object_Item *it, const char *emission, const char *source) EINA_ARG_NONNULL(1);
193 * Set the disabled state of an widget item.
195 * @param obj The Elementary object item
196 * @param disabled The state to put in in: @c EINA_TRUE for
197 * disabled, @c EINA_FALSE for enabled
199 * Elementary object item can be @b disabled, in which state they won't
200 * receive input and, in general, will be themed differently from
201 * their normal state, usually greyed out. Useful for contexts
202 * where you don't want your users to interact with some of the
203 * parts of you interface.
205 * This sets the state for the widget item, either disabling it or
210 EAPI void elm_object_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled) EINA_ARG_NONNULL(1);
213 * Get the disabled state of an widget item.
215 * @param obj The Elementary object
216 * @return @c EINA_TRUE, if the widget item is disabled, @c EINA_FALSE
217 * if it's enabled (or on errors)
219 * This gets the state of the widget, which might be enabled or disabled.
223 EAPI Eina_Bool elm_object_item_disabled_get(const Elm_Object_Item *it) EINA_ARG_NONNULL(1);