Scale: Explain how to round value when !draw-value

Scale:digits is (now, again) ineffective if Scale:draw-value is FALSE.
To get rounding in that case, the base Range:round-digits must be used.
This commit is contained in:
Daniel Boles 2017-05-02 12:18:26 +01:00
parent 4452414635
commit aded963251

View File

@ -1117,9 +1117,10 @@ gtk_scale_new_with_range (GtkOrientation orientation,
* e.g. use 1 to display 1.0, 2 to display 1.00, etc
*
* Sets the number of decimal places that are displayed in the value. Also
* causes the value of the adjustment to be rounded to this number of digits
* whenever it is changed, so the retrieved value matches the displayed one, if
* #GtkScale:draw-value is TRUE at the time of the change.
* causes the value of the adjustment to be rounded to this number of digits,
* so the retrieved value matches the displayed one, if #GtkScale:draw-value is
* %TRUE when the value changes. If you want to enforce rounding the value when
* #GtkScale:draw-value is %FALSE, you can set #GtkRange:round-digits instead.
*
* Note that rounding to a small number of digits can interfere with
* the smooth autoscrolling that is built into #GtkScale. As an alternative,