Package: gtk

Class gtk-range

Superclasses

gtk-widget, g-initially-unowned, gtk-buildable, gtk-orientable, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

Direct Slots

adjustment
The adjustment property of type gtk-adjustment (Read / Write / Construct)
The gtk-adjustment that contains the current value of this range object.
fill-level
The fill-level property of type :double (Read / Write)
The fill level (e. g. prebuffering of a network stream).
See the gtk-range-fill-level function.
Default value: 1.79769e+308
inverted
The inverted property of type :boolean (Read / Write)
Invert direction slider moves to increase range value.
Default value: nil
lower-stepper-sensitivity
The lower-stepper-sensitivity property of type gtk-sensitivity-type (Read / Write)
The sensitivity policy for the stepper that points to the adjustment's lower side.
Default value: :auto
restrict-to-fill-level
The restrict-to-fill-level property of type :boolean (Read / Write)
The restrict-to-fill-level property controls whether slider movement is restricted to an upper boundary set by the fill level. See the gtk-range-restrict-to-fill-level function.
Default value: true
round-digits
The round-digits property of type :int (Read / Write)
The number of digits to round the value to when it changes, or -1. See the "change-value" signal.
Allowed values: >= -1
Default value: -1
show-fill-level
The show-fill-level property of type :boolean (Read / Write)
The show-fill-level property controls whether fill level indicator graphics are displayed on the trough. See the gtk-range-show-fill-level function.
Default value: nil
upper-stepper-sensitivity
The upper-stepper-sensitivity property of type gtk-sensitivity-type (Read / Write)
The sensitivity policy for the stepper that points to the adjustment's upper side.
Default value: :auto

Details

gtk-range is the common base class for widgets which visualize an adjustment, e. g. gtk-scale or gtk-scrollbar.

Apart from signals for monitoring the parameters of the adjustment, gtk-range provides properties and methods for influencing the sensitivity of the "steppers". It also provides properties and methods for setting a "fill level" on range widgets. See the function gtk-range-set-fill-level.

Style Property Details

arrow-displacement-x
The arrow-displacement-x style property of type :int (Read)
How far in the x direction to move the arrow when the button is depressed.
Warning: The arrow-displacement-x style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Default value: 0
arrow-displacement-y
The arrow-displacement-y style property of type :int (Read)
How far in the y direction to move the arrow when the button is depressed.
Warning: The arrow-displacement-y style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Default value: 0
arrow-scaling
The arrow-scaling style property of type :float (Read)
The arrow size proportion relative to the scroll button size.
Allowed values: [0,1]
Warning: The arrow-scaling style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Default value: 0.5
slider-width
The slider-width style property of type :int (Read)
Width of scrollbar or scale thumb.
Warning: The slider-width style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Allowed values: >= 0
Default value: 14
stepper-size
The stepper-size style property of type :int (Read)
Length of step buttons at ends.
Warning: The stepper-size style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Allowed values: >= 0
Default value: 14
stepper-spacing
The stepper-spacing style property of type :int (Read)
The spacing between the stepper buttons and thumb. Note that stepper-spacing will not have any effect if there are no steppers.
Warming: The stepper-spacing style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Allowed values: >= 0
Default value: 0
trough-border
The trough-border style property of type :int (Read)
Spacing between thumb/steppers and outer trough bevel.
Warning: The trough-border style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored.
Allowed values: >= 0
Default value: 1
trough-under-steppers
The trough-under-steppers style property of type :boolean (Read)
Whether to draw the trough across the full length of the range or to exclude the steppers and their spacing.
Warning: The trough-under-steppers style property has been deprecated since version 3.20 and should not be used in newly-written code. The value of this style property is ignored, and the widget will behave as if it was set to true.
Default value: true

Signal Details

The "adjust-bounds" signal
 lambda (range value)    : Run Last      
Emitted before clamping a value, to give the application a chance to adjust the bounds.
range
The gtk-range that received the signal.
value
The value before we clamp.
The "change-value" signal
 lambda (range scroll value)    : Run Last      
The "change-value" signal is emitted when a scroll action is performed on a range. It allows an application to determine the type of scroll event that occurred and the resultant new value. The application can handle the event itself and return true to prevent further processing. Or, by returning nil, it can pass the event to other handlers until the default GTK+ handler is reached. The value parameter is unrounded. An application that overrides the "change-value" signal is responsible for clamping the value to the desired number of decimal digits; the default GTK+ handler clamps the value based on "round-digits". It is not possible to use delayed update policies in an overridden "change-value" handler.
range
The gtk-range that received the signal.
scroll
The type of scroll action that was performed.
value
The new value resulting from the scroll action.
Returns
True to prevent other handlers from being invoked for the signal, nil to propagate the signal further.
The "move-slider" signal
 lambda (range step)    : Action      
Virtual function that moves the slider. Used for keybindings.
range
The gtk-range that received the signal.
step
How to move the slider.
The "value-changed" signal
 lambda (range)    : Run Last      
Emitted when the range value changes.
range
The gtk-range that received the signal.
 

Slot Access Functions

Inherited Slot Access Functions

2013-5-26