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
|
#ifndef EFL_MODEL_COMMON_H__
# define EFL_MODEL_COMMON_H__
/**
* @struct _Efl_Model_Children_Event
* Every time a child id added the event
* EFL_MODEL_EVENT_CHILD_ADDED is dispatched
* passing along this structure.
*/
struct _Efl_Model_Children_Event
{
Eo *child; /**< child, for child_add */
/**
* index is a hint and is intended
* to provide a way for applications
* to control/know children relative
* positions through listings.
*
* NOTE: If listing is performed asynchronously
* exact order may not be guaranteed.
*/
unsigned int index;
};
/**
* @struct Efl_Model_Children_Event
*/
typedef struct _Efl_Model_Children_Event Efl_Model_Children_Event;
#include "interfaces/efl_model_base.eo.h"
/**
* @brief Sets the new load status signaling an event if changed
*
* @param model The model to call the event @c EFL_MODEL_EVENT_LOAD_STATUS
* @param load The load status to be changed
* @param status The new status
*
* @since 1.17
*/
EAPI void efl_model_load_set(Efl_Model_Base *model, Efl_Model_Load *load, Efl_Model_Load_Status status) EINA_ARG_NONNULL(1, 2);
/**
* @brief Slices a list
*
* If the @p start and @p count are 0, a new accessor of the entire list is returned
*
* @param list The list to get the slice
* @param start The nth element to start the slice
* @param count The number of elements
* @return The accessor to the sliced elements or @c NULL if error
*
* @since 1.17
*/
EAPI Eina_Accessor *efl_model_list_slice(Eina_List *list, unsigned start, unsigned count) EINA_ARG_NONNULL(1);
/**
* @brief Notifies an error with an @c EFL_MODEL_EVENT_LOAD_STATUS
*
* @param model The model to be notified
*
* @since 1.17
*/
EAPI void efl_model_error_notify(Efl_Model_Base *model) EINA_ARG_NONNULL(1);
/**
* @brief Notifies a property changed event with an @c EFL_MODEL_EVENT_PROPERTIES_CHANGED
*
* @param model The model to be notified
* @param property The changed property
*
* @since 1.17
*/
EAPI void efl_model_property_changed_notify(Efl_Model_Base *model, const char *property);
/**
* @brief Notifies a property invalidated event with an @c EFL_MODEL_EVENT_PROPERTIES_CHANGED
*
* @param model The model to be notified
* @param property The invalidated property
*
* @since 1.17
*/
EAPI void efl_model_property_invalidated_notify(Efl_Model_Base *model, const char *property);
/**
* @brief Callback to setup a member of @c Eina_Value_Struct
*
* @param data The user data
* @param index The member index
* @param member The member to fill its name and type. Must use @c Eina_Stringshare for name.
*/
typedef void (*Efl_Model_Value_Struct_Member_Setup_Cb)(void *data, int index, Eina_Value_Struct_Member *member);
/**
* @brief Creates a new struct description
*
* @param member_count The number of struct members
* @param setup_cb The callback to setup struct members
* @param data The user data
* @return Returns the struct description
*
* @since 1.17
*/
EAPI Eina_Value_Struct_Desc *efl_model_value_struct_description_new(unsigned int member_count, Efl_Model_Value_Struct_Member_Setup_Cb setup_cb, void *data) EINA_ARG_NONNULL(2);
/**
* @brief Frees the memory allocated to the struct description.
*
* @param desc The struct description. If @c NULL, the function returns immediately.
*
* @since 1.17
*/
EAPI void efl_model_value_struct_description_free(Eina_Value_Struct_Desc *desc);
#endif
|
