callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Scrollbar: Tweak intro docs a bit

Browse Source 
Explain where the adjustment comes from, clarify some of the wording
about how its fields influence the scrollbar, and also note that the
steppers may not be present, since they aren’t in our default themes.
This commit is contained in:
Daniel Boles
2017-03-20 23:54:57 +00:00
parent 93d68270c4
commit 369377369f
1 changed files with 9 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
gtk/gtkscrollbar.c
View File

@ -43,16 +43,15 @@
* The #GtkScrollbar widget is a horizontal or vertical scrollbar, * The #GtkScrollbar widget is a horizontal or vertical scrollbar,
* depending on the value of the #GtkOrientable:orientation property. * depending on the value of the #GtkOrientable:orientation property.
* *
* The position of the thumb in a scrollbar is controlled by the scroll * Its position and movement are controlled by the adjustment that is passed to
* adjustments. See #GtkAdjustment for the fields in an adjustment - for * or created by gtk_scrollbar_new(). See #GtkAdjustment for more details. The
* #GtkScrollbar, the #GtkAdjustment:value field represents the position * #GtkAdjustment:value field sets the position of the thumb and must be between
* of the scrollbar, which must be between the #GtkAdjustment:lower field * #GtkAdjustment:lower and #GtkAdjustment:upper - #GtkAdjustment:page-size. The
* and #GtkAdjustment:upper - #GtkAdjustment:page-size. The * #GtkAdjustment:page-size represents the size of the visible scrollable area.
* #GtkAdjustment:page-size field represents the size of the visible * The fields #GtkAdjustment:step-increment and #GtkAdjustment:page-increment
* scrollable area. The #GtkAdjustment:step-increment and * fields are added or subtracted to the #GtkAdjustment:value when the user asks
* #GtkAdjustment:page-increment fields are properties when the user asks to * to move by a step (using e.g. the cursor arrow keys or, if present, the
* step down (using the small stepper arrows) or page down (using for * stepper buttons) or by a page (using e.g. the Page Down/Up keys).
* example the `Page Down` key).
* *
* # CSS nodes * # CSS nodes
* *