Class range - cl-cffi-gtk4 API documentation

Package: gtk

Class gtk:range

Superclasses

gtk:widget, gobject:initially-unowned, gtk:accessible-range, gtk:accessible, gtk:buildable, gtk:constraint-target, gtk:orientable, gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

gtk:scale

Direct Slots

adjustment

The adjustment property of type gtk:adjustment (Read / Write / Construct)
The adjustment that contains the current value of this range object.

fill-level

The fill-level property of type :double (Read / Write)
The fill level, for example, prebuffering of a network stream.
Default value: 1.79769e+308

inverted

The inverted property of type :boolean (Read / Write)
Invert direction slider moves to increase range value.
Default value: false

restrict-to-fill-level

The restrict-to-fill-level property of type :boolean (Read / Write)
Controls whether slider movement is restricted to an upper boundary set by the fill level.
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)
Controls whether fill level indicator graphics are displayed on the trough.
Default value: false

Details

The gtk:range class is the common base class for widgets which visualize an adjustment, for example the gtk:scale widget.

Apart from signals for monitoring the parameters of the adjustment, the gtk:range class 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 gtk:range-fill-level function.

Signal Details

The "adjust-bounds" signal

lambda (range value)    :run-last

range: The gtk:range widget that received the signal.
value: The double float for the value before we clamp.

Emitted before clamping a value, to give the application a chance to adjust the bounds.

The "change-value" signal

lambda (range scroll value)    :run-last

range: The gtk:range widget that received the signal.
scroll: The gtk:scroll-type value of scroll action that was performed.
value: The double float resulting from the scroll action.
Returns: True to prevent other handlers from being invoked for the signal, false to propagate the signal further.

The 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 false, 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" signal handler.