efl_ui_single_selectable: add properties and events

this commit adds 2 new features, a new event and a new property

The fallback property is usefull if you want to have a selection that always falls back
to some preconfigured things.
As a usecase, think about a list of languges where you can select the
languages you want to have. When everything is deselected, the list will
simply fallback to the preconfigured element (for example the language
configured before)

The event is annoncing that there was a change to the selection. The
event is allowed to be defered, it will be emitted once for a range of
selection elements that happened during one loop iteration. This is
usefull if you are interested in a general selection where you want to
know that we changed from a specific set of selected element to another
set of elements, without monitoring every selectable in the widget.

ref T8057

Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com>
Reviewed-by: Cedric BAIL <cedric.bail@free.fr>
Differential Revision: https://phab.enlightenment.org/D9662

2 files changed, 80 insertions, 71 deletions

diff --git a/src/tests/elementary/spec/efl_test_multi_selectable.c b/src/tests/elementary/spec/efl_test_multi_selectable.c
index 5d5c1ed824..da36e5b8f2 100644
--- a/src/tests/elementary/spec/efl_test_multi_selectable.c
+++ b/src/tests/elementary/spec/efl_test_multi_selectable.c
@@ -42,23 +42,22 @@ _iterator_to_array(Eina_Array **arr, Eina_Iterator *iter)
 
 EFL_START_TEST(test_multi_select)
 {
-   Efl_Ui_Item *selected = NULL;
-   Efl_Ui_Item *unselected = NULL;
+   int c = 0;
+
    Eina_Array *arr_selected;
    efl_ui_select_mode_set(widget, EFL_UI_SELECT_MODE_MULTI);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 0), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 0));
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
+
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 2));
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    ck_assert_int_eq(efl_ui_selectable_selected_get(efl_pack_content_get(widget, 0)), EINA_TRUE);
    ck_assert_int_eq(efl_ui_selectable_selected_get(efl_pack_content_get(widget, 2)), EINA_TRUE);
    ck_assert_ptr_eq(efl_ui_single_selectable_last_selected_get(widget), efl_pack_content_get(widget, 2));
@@ -68,68 +67,59 @@ EFL_START_TEST(test_multi_select)
    ck_assert_ptr_eq(eina_array_data_get(arr_selected, 1), efl_pack_content_get(widget, 2));
 
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   ck_assert_ptr_eq(selected, NULL);
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   ck_assert_int_eq(c, 0);
+
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 }
 EFL_END_TEST
 
 EFL_START_TEST(test_multi_select_removal)
 {
-   Efl_Ui_Item *selected = NULL;
-   Efl_Ui_Item *unselected = NULL;
+   int c = 0;
    Eina_Array *arr_selected;
    efl_ui_select_mode_set(widget, EFL_UI_SELECT_MODE_MULTI);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 0), EINA_TRUE);
-   selected = NULL;//No need to ckeck the flag, we asserted in the tcase before
+   c = 0;
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   selected = NULL;//No need to ckeck the flag, we asserted in the tcase before
-   unselected = NULL;
+   c = 0;
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 0), EINA_FALSE);
-   ck_assert_ptr_eq(selected, NULL);
-   ck_assert_ptr_eq(unselected, efl_pack_content_get(widget, 0));
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_FALSE);
-   ck_assert_ptr_eq(selected, NULL);
-   ck_assert_ptr_eq(unselected, efl_pack_content_get(widget, 2));
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
 
    ck_assert_ptr_eq(efl_ui_single_selectable_last_selected_get(widget), NULL);
    _iterator_to_array(&arr_selected, efl_ui_selected_items_get(widget));
    ck_assert_int_eq(eina_array_count(arr_selected), 0);
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 }
 EFL_END_TEST
 
 EFL_START_TEST(test_single_select)
 {
-   Efl_Ui_Item *selected = NULL;
-   Efl_Ui_Item *unselected = NULL;
+   int c = 0;
    Eina_Array *arr_selected;
 
    efl_ui_select_mode_set(widget, EFL_UI_SELECT_MODE_SINGLE);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 0), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 0));
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 2));
-   ck_assert_ptr_eq(unselected, efl_pack_content_get(widget, 0));
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    ck_assert_int_eq(efl_ui_selectable_selected_get(efl_pack_content_get(widget, 0)), EINA_FALSE);
    ck_assert_int_eq(efl_ui_selectable_selected_get(efl_pack_content_get(widget, 2)), EINA_TRUE);
    ck_assert_ptr_eq(efl_ui_single_selectable_last_selected_get(widget), efl_pack_content_get(widget, 2));
@@ -138,48 +128,42 @@ EFL_START_TEST(test_single_select)
    ck_assert_ptr_eq(eina_array_data_get(arr_selected, 0), efl_pack_content_get(widget, 2));
 
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   ck_assert_ptr_eq(selected, NULL);
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   ck_assert_int_eq(c, 0);
+
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 }
 EFL_END_TEST
 
 EFL_START_TEST(test_single_select_always)
 {
-   Efl_Ui_Item *selected = NULL;
-   Efl_Ui_Item *unselected = NULL;
+   int c = 0;
    Eina_Array *arr_selected;
 
    efl_ui_select_mode_set(widget, EFL_UI_SELECT_MODE_SINGLE_ALWAYS);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_add(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 0), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 0));
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 2));
-   ck_assert_ptr_eq(unselected, efl_pack_content_get(widget, 0));
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    efl_ui_selectable_selected_set(efl_pack_content_get(widget, 2), EINA_TRUE);
-   ck_assert_ptr_eq(selected, efl_pack_content_get(widget, 2));
-   ck_assert_ptr_eq(unselected, NULL);
-   selected = NULL;
-   unselected = NULL;
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
    ck_assert_int_eq(efl_ui_selectable_selected_get(efl_pack_content_get(widget, 0)), EINA_FALSE);
    ck_assert_int_eq(efl_ui_selectable_selected_get(efl_pack_content_get(widget, 2)), EINA_TRUE);
    ck_assert_ptr_eq(efl_ui_single_selectable_last_selected_get(widget), efl_pack_content_get(widget, 2));
    _iterator_to_array(&arr_selected, efl_ui_selected_items_get(widget));
    ck_assert_int_eq(eina_array_count(arr_selected), 1);
    ck_assert_ptr_eq(eina_array_data_get(arr_selected, 0), efl_pack_content_get(widget, 2));
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_SELECTED, _set_pointer_quit, &selected);
-   efl_event_callback_del(widget, EFL_UI_EVENT_ITEM_UNSELECTED, _set_pointer_quit, &unselected);
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_del(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
 }
 EFL_END_TEST
 
diff --git a/src/tests/elementary/spec/efl_test_single_selectable.c b/src/tests/elementary/spec/efl_test_single_selectable.c
index c62f78afc4..fd4b5e0a8b 100644
--- a/src/tests/elementary/spec/efl_test_single_selectable.c
+++ b/src/tests/elementary/spec/efl_test_single_selectable.c
@@ -33,11 +33,19 @@ _setup(void)
 
 EFL_START_TEST(last_selectable_check)
 {
+   int c = 0;
+
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, (Efl_Event_Cb) event_callback_single_call_int_data, &c);
+   efl_event_callback_add(widget, EFL_UI_SINGLE_SELECTABLE_EVENT_SELECTION_CHANGED, event_callback_that_quits_the_main_loop_when_called, NULL);
+
    Eo *c1 = efl_pack_content_get(widget, 0);
    Eo *c2 = efl_pack_content_get(widget, 2);
 
    efl_ui_selectable_selected_set(c1, EINA_TRUE);
    ck_assert_ptr_eq(efl_ui_single_selectable_last_selected_get(widget), c1);
+   if (c == 0) efl_loop_begin(efl_main_loop_get());
+   ck_assert_int_eq(c, 1);
+   c = 0;
 
    efl_ui_selectable_selected_set(c2, EINA_TRUE);
    ck_assert_ptr_eq(efl_ui_single_selectable_last_selected_get(widget), c2);
@@ -48,9 +56,26 @@ EFL_START_TEST(last_selectable_check)
 }
 EFL_END_TEST
 
+EFL_START_TEST(fallback_selection)
+{
+   Eo *c1 = efl_pack_content_get(widget, 0);
+   Eo *c2 = efl_pack_content_get(widget, 2);
+
+   efl_ui_single_selectable_fallback_selection_set(widget, c2);
+   ck_assert_int_eq(efl_ui_selectable_selected_get(c2), EINA_TRUE);
+   efl_ui_selectable_selected_set(c1, EINA_TRUE);
+   ck_assert_int_eq(efl_ui_selectable_selected_get(c2), EINA_FALSE);
+   ck_assert_int_eq(efl_ui_selectable_selected_get(c1), EINA_TRUE);
+   efl_ui_selectable_selected_set(c1, EINA_FALSE);
+   ck_assert_int_eq(efl_ui_selectable_selected_get(c2), EINA_TRUE);
+   ck_assert_int_eq(efl_ui_selectable_selected_get(c1), EINA_FALSE);
+}
+EFL_END_TEST
+
 void
 efl_ui_single_selectable_behavior_test(TCase *tc)
 {
    tcase_add_checked_fixture(tc, _setup, NULL);
    tcase_add_test(tc, last_selectable_check);
+   tcase_add_test(tc, fallback_selection);
 }