2 * Get the widget object's handle which contains a given item
4 * @param item The Elementary object item
5 * @return The widget object
7 * @note This returns the widget object itself that an item belongs to.
12 elm_object_item_object_get(const Elm_Object_Item *it)
16 * Set a content of an object item
18 * @param it The Elementary object item
19 * @param part The content part name to set (NULL for the default content)
20 * @param content The new content of the object item
22 * @note Elementary object items may have many contents
23 * @deprecated Use elm_object_item_part_content_set instead.
26 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
29 * Set a content of an object item
31 * @param it The Elementary object item
32 * @param part The content part name to set (NULL for the default content)
33 * @param content The new content of the object item
35 * @note Elementary object items may have many contents
39 EAPI void elm_object_item_part_content_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
41 #define elm_object_item_content_set(it, content) elm_object_item_part_content_set((it), NULL, (content))
44 * Get a content of an object item
46 * @param it The Elementary object item
47 * @param part The content part name to unset (NULL for the default content)
48 * @return content of the object item or NULL for any error
50 * @note Elementary object items may have many contents
51 * @deprecated Use elm_object_item_part_content_get instead.
54 EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
57 * Get a content of an object item
59 * @param it The Elementary object item
60 * @param part The content part name to unset (NULL for the default content)
61 * @return content of the object item or NULL for any error
63 * @note Elementary object items may have many contents
67 EAPI Evas_Object *elm_object_item_part_content_get(const Elm_Object_Item *it, const char *part);
69 #define elm_object_item_content_get(it) elm_object_item_part_content_get((it), NULL)
72 * Unset a content of an object item
74 * @param it The Elementary object item
75 * @param part The content part name to unset (NULL for the default content)
77 * @note Elementary object items may have many contents
78 * @deprecated Use elm_object_item_part_content_unset instead.
81 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
84 * Unset a content of an object item
86 * @param it The Elementary object item
87 * @param part The content part name to unset (NULL for the default content)
89 * @note Elementary object items may have many contents
93 EAPI Evas_Object *elm_object_item_part_content_unset(Elm_Object_Item *it, const char *part);
95 #define elm_object_item_content_unset(it) elm_object_item_part_content_unset((it), NULL)
98 * Set a label of an object item
100 * @param it The Elementary object item
101 * @param part The text part name to set (NULL for the default label)
102 * @param label The new text of the label
104 * @note Elementary object items may have many labels
105 * @deprecated Use elm_object_item_part_text_set instead.
108 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
111 * Set a label of an object item
113 * @param it The Elementary object item
114 * @param part The text part name to set (NULL for the default label)
115 * @param label The new text of the label
117 * @note Elementary object items may have many labels
121 EAPI void elm_object_item_part_text_set(Elm_Object_Item *it, const char *part, const char *label);
123 #define elm_object_item_text_set(it, label) elm_object_item_part_text_set((it), NULL, (label))
126 * Get a label of an object item
128 * @param it The Elementary object item
129 * @param part The text part name to get (NULL for the default label)
130 * @return text of the label or NULL for any error
132 * @note Elementary object items may have many labels
133 * @deprecated Use elm_object_item_part_text_get instead.
136 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
138 * Get a label of an object item
140 * @param it The Elementary object item
141 * @param part The text part name to get (NULL for the default label)
142 * @return text of the label or NULL for any error
144 * @note Elementary object items may have many labels
148 EAPI const char *elm_object_item_part_text_get(const Elm_Object_Item *it, const char *part);
150 #define elm_object_item_text_get(it) elm_object_item_part_text_get((it), NULL)
153 * Set the text to read out when in accessibility mode
155 * @param it The object item which is to be described
156 * @param txt The text that describes the widget to people with poor or no vision
160 EAPI void elm_object_item_access_info_set(Elm_Object_Item *it, const char *txt);
163 * Get the data associated with an object item
164 * @param it The Elementary object item
165 * @return The data associated with @p it
169 EAPI void *elm_object_item_data_get(const Elm_Object_Item *it);
172 * Set the data associated with an object item
173 * @param it The Elementary object item
174 * @param data The data to be associated with @p it
178 EAPI void elm_object_item_data_set(Elm_Object_Item *it, void *data);
181 * Send a signal to the edje object of the widget item.
183 * This function sends a signal to the edje object of the obj item. An
184 * edje program can respond to a signal by specifying matching
185 * 'signal' and 'source' fields.
187 * @param it The Elementary object item
188 * @param emission The signal's name.
189 * @param source The signal's source.
192 EAPI void elm_object_item_signal_emit(Elm_Object_Item *it, const char *emission, const char *source) EINA_ARG_NONNULL(1);
195 * Set the disabled state of an widget item.
197 * @param obj The Elementary object item
198 * @param disabled The state to put in in: @c EINA_TRUE for
199 * disabled, @c EINA_FALSE for enabled
201 * Elementary object item can be @b disabled, in which state they won't
202 * receive input and, in general, will be themed differently from
203 * their normal state, usually greyed out. Useful for contexts
204 * where you don't want your users to interact with some of the
205 * parts of you interface.
207 * This sets the state for the widget item, either disabling it or
212 EAPI void elm_object_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled) EINA_ARG_NONNULL(1);
215 * Get the disabled state of an widget item.
217 * @param obj The Elementary object
218 * @return @c EINA_TRUE, if the widget item is disabled, @c EINA_FALSE
219 * if it's enabled (or on errors)
221 * This gets the state of the widget, which might be enabled or disabled.
225 EAPI Eina_Bool elm_object_item_disabled_get(const Elm_Object_Item *it) EINA_ARG_NONNULL(1);