Efl.Ui.Slider: Rename event delay,changed to steady

Summary:
And update the docs to explain its purpose.

Related to T7893

Test Plan: Everything builds and tests pass

Reviewers: zmike, bu5hm4n

Reviewed By: zmike

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D9090

src/examples/elementary/slider_cxx_example.cc

@@ -70,11 +70,11 @@ efl_main(void *data EINA_UNUSED, const Efl_Event *ev EINA_UNUSED)
    { std::cout << "Changed to " << obj.range_value_get() << std::endl; }
          , std::placeholders::_1);
 
-   auto delay =  std::bind ( [] (efl::ui::Slider obj)
+   auto steady =  std::bind ( [] (efl::ui::Slider obj)
-   { std::cout << "Delay changed to " << obj.range_value_get() << std::endl; }
+   { std::cout << "Steady to " << obj.range_value_get() << std::endl; }
          , std::placeholders::_1);
 
    sl7.changed_event_cb_add(changed);
-   sl7.delay_changed_event_cb_add(delay);
+   sl7.steady_event_cb_add(steady);
 }
 EFL_MAIN()

src/lib/elementary/efl_ui_slider.c

@@ -34,7 +34,7 @@ _delay_change(void *data)
    EFL_UI_SLIDER_DATA_GET(data, sd);
 
    sd->delay = NULL;
-   efl_event_callback_call(data, EFL_UI_SLIDER_EVENT_DELAY_CHANGED, NULL);
+   efl_event_callback_call(data, EFL_UI_SLIDER_EVENT_STEADY, NULL);
 
    if (_elm_config->atspi_mode)
      efl_access_value_changed_signal_emit(data);

src/lib/elementary/efl_ui_slider.eo

@@ -20,9 +20,15 @@ class @beta Efl.Ui.Slider extends Efl.Ui.Layout_Base implements Efl.Ui.Range_Int
       Efl.Access.Widget.Action.elm_actions { get; }
    }
    events {
-      changed: void; [[Called when slider changed]]
+      changed: void; [[Called when the slider position has changed.]]
-      delay,changed: void; [[Called when delay changed]]
+      steady: void; [[Called when the slider position has changed and has remained unchanged for 0.2s.
-      slider,drag,start: void; [[Called when slider drag started]]
+                      This allows filtering out unwanted "noise" from the slider signal if you are only
-      slider,drag,stop: void; [[Called when slider drag stopped]]
+                      interested in the final position of the slider.
+                      Use this signal instead of @[Efl.Ui.Slider.changed] if you are going to perform a costly operation
+                      on its handler.]]
+      slider,drag,start: void; [[Called when a slider drag operation has started. This means a $press event
+                                 has been received on the slider thumb but not the $unpress.]]
+      slider,drag,stop: void; [[Called when a slider drag operation has finished. This means an $unpress event
+                                has been received on the slider thumb.]]
    }
 }

src/lib/elementary/efl_ui_slider_interval.c

@@ -22,7 +22,7 @@ _delay_change(void *data)
    EFL_UI_SLIDER_INTERVAL_DATA_GET(data, pd);
 
    pd->delay = NULL;
-   efl_event_callback_call(data, EFL_UI_SLIDER_EVENT_DELAY_CHANGED, NULL);
+   efl_event_callback_call(data, EFL_UI_SLIDER_EVENT_STEADY, NULL);
 
    if (_elm_config->atspi_mode)
      efl_access_value_changed_signal_emit(data);

src/lib/elementary/elm_slider.c

@@ -62,7 +62,7 @@ _delay_change(void *data)
    ELM_SLIDER_DATA_GET(data, sd);
 
    sd->delay = NULL;
-   efl_event_callback_legacy_call(data, EFL_UI_SLIDER_EVENT_DELAY_CHANGED, NULL);
+   efl_event_callback_legacy_call(data, EFL_UI_SLIDER_EVENT_STEADY, NULL);
 
    if (_elm_config->atspi_mode)
      efl_access_value_changed_signal_emit(data);