From bdaf20fb4c4bca57c165fc3a7126b3963306750a Mon Sep 17 00:00:00 2001 From: Xavi Artigas Date: Thu, 16 Jan 2020 15:05:43 +0000 Subject: [PATCH] docs: Give some love to progress bar docs. Differential Revision: https://phab.enlightenment.org/D11112 --- .../efl/interfaces/efl_ui_range_display.eo | 2 +- src/lib/elementary/efl_ui_progressbar.eo | 29 +++++++++++++++---- 2 files changed, 24 insertions(+), 7 deletions(-) diff --git a/src/lib/efl/interfaces/efl_ui_range_display.eo b/src/lib/efl/interfaces/efl_ui_range_display.eo index 4b8cade311..2a9a75abb7 100644 --- a/src/lib/efl/interfaces/efl_ui_range_display.eo +++ b/src/lib/efl/interfaces/efl_ui_range_display.eo @@ -4,7 +4,7 @@ interface Efl.Ui.Range_Display A value range contains a value restricted between specified minimum and maximum limits at all times. - This can be used for progressbars, sliders or spinners, for example. + This can be used for progress bars, sliders or spinners, for example. @since 1.23 ]] diff --git a/src/lib/elementary/efl_ui_progressbar.eo b/src/lib/elementary/efl_ui_progressbar.eo index 1bc55057f3..3f6917b95c 100644 --- a/src/lib/elementary/efl_ui_progressbar.eo +++ b/src/lib/elementary/efl_ui_progressbar.eo @@ -2,24 +2,41 @@ class @beta Efl.Ui.Progressbar extends Efl.Ui.Layout_Base implements Efl.Ui.Rang Efl.Ui.Layout_Orientable, Efl.Access.Value, Efl.Text, Efl.Content, Efl.Text_Markup { - [[Elementary progressbar class]] + [[Progress bar widget. + + It shows a graphical indication of the current progress of some lengthy operation, + typically as a bar that gradually fills or a pointer that moves from one side of the + bar to the other. The bar can be horizontal or vertical, controlled with @Efl.Ui.Layout_Orientable. + + The minimum and maximum values (or starting and ending values), along with the current + value can be set using the @Efl.Ui.Range_Display interface. + + @.infinite_mode can be set when the progress state is unknown. + An optional textual label can be shown to indicate the exact numerical value of the progress. + ]] methods { @property infinite_mode { - [[Start/stop a given progress bar "pulsing" animation, if this mode is enabled.]] + [[When this mode is enabled the progress bar indicates that there is an operation + going on, but does not give information about its progress. + This is typically shown as a "pulsing" animation or an endless spinning bar, + depending on the theme. + ]] set { } get { } values { - state: bool; [[$true if the progressbar should animate infinitely, - $false if the progressbar should animate based on a fixed endpoint.]] + state: bool; [[$true if the progress bar should animate infinitely.]] } } @property show_progress_label { - [[Whether a textual progress label is shown alongside the progressbar to give an exact - numerical indication of the current progress. + [[Whether a textual progress label is shown alongside the progress bar to give an exact + numerical indication of the current progress. Control the conversion of the numerical + value to a text string using @Efl.Ui.Format. Not to be confused with the widget label set through @Efl.Text.text. + + The exact location and appearance of the progress label depend on the theme. ]] values { show: bool; [[$true to show the progress label.]]