Sets our main struct and passes it to the parent class
Creates a new GtkScale.
Creates a new scale widget with the given orientation that lets the user input a number between min and max (including min and max) with the increment step. step must be nonzero; it's the distance the slider moves when using the arrow keys to adjust the scale value. Note that the way in which the precision is derived works best if step is a power of ten. If the resulting precision is not suitable for your needs, use gtk_scale_set_digits() to correct it.
Adds a mark at value. A mark is indicated visually by drawing a tick mark next to the scale, and GTK+ makes it easy for the user to position the scale exactly at the marks value. If markup is not NULL, text is shown next to the tick mark. To remove marks from a scale, use gtk_scale_clear_marks(). Since 2.16
Signal which allows you to change how the scale value is displayed. Connect a signal handler which returns an allocated string representing value. That string will then be used to display the scale's value. Here's an example signal handler which displays a value 1.0 as with "-->1.0<--".
Removes any marks that have been added with gtk_scale_add_mark(). Since 2.16
Gets the number of decimal places that are displayed in the value.
Returns whether the current value is displayed as a string next to the slider.
Returns whether the scale has an origin.
Gets the PangoLayout used to display the scale. The returned object is owned by the scale so does not need to be freed by the caller. Since 2.4
Obtains the coordinates where the scale will draw the PangoLayout representing the text in the scale. Remember when using the PangoLayout function you need to convert to and from pixels using PANGO_PIXELS() or PANGO_SCALE. If the "draw-value" property is FALSE, the return values are undefined. Since 2.4
the main Gtk struct as a void*
Gets the position in which the current value is displayed.
Sets the number of decimal places that are displayed in the value. Also causes the value of the adjustment to be rounded off to this number of digits, so the retrieved value matches the value the user saw.
Specifies whether the current value is displayed as a string next to the slider.
If has_origin is set to TRUE (the default), the scale will highlight the part of the scale between the origin (bottom or left side) of the scale and the current value.
Sets the position in which the current value is displayed.
the main Gtk struct
the main Gtk struct
the main Gtk struct as a void*
Emitted before clamping a value, to give the application a chance to adjust the bounds.
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 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 GtkRange::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. TRUE to prevent other handlers from being invoked for the signal, FALSE to propagate the signal further Since 2.6
Virtual function that moves the slider. Used for keybindings.
Emitted when the range value changes.
Gets the current position of the fill level indicator. Since 2.12
Gets whether the range is restricted to the fill level. Since 2.12
Gets whether the range displays the fill level graphically. Since 2.12
Set the new position of the fill level indicator. The "fill level" is probably best described by its most prominent use case, which is an indicator for the amount of pre-buffering in a streaming media player. In that use case, the value of the range would indicate the current play position, and the fill level would be the position up to which the file/stream has been downloaded. This amount of prebuffering can be displayed on the range's trough and is themeable separately from the trough. To enable fill level display, use gtk_range_set_show_fill_level(). The range defaults to not showing the fill level. Additionally, it's possible to restrict the range's slider position to values which are smaller than the fill level. This is controller by gtk_range_set_restrict_to_fill_level() and is by default enabled. Since 2.12
Sets whether the slider is restricted to the fill level. See gtk_range_set_fill_level() for a general description of the fill level concept. Since 2.12
Sets whether a graphical fill level is show on the trough. See gtk_range_set_fill_level() for a general description of the fill level concept. Since 2.12
Get the GtkAdjustment which is the "model" object for GtkRange. See gtk_range_set_adjustment() for details. The return value does not have a reference added, so should not be unreferenced.
Sets the adjustment to be used as the "model" object for this range widget. The adjustment indicates the current range value, the minimum and maximum range values, the step/page increments used for keybindings and scrolling, and the page size. The page size is normally 0 for GtkScale and nonzero for GtkScrollbar, and indicates the size of the visible area of the widget being scrolled. The page size affects the size of the scrollbar slider.
Gets the value set by gtk_range_set_inverted().
Ranges normally move from lower to higher values as the slider moves from top to bottom or left to right. Inverted ranges have higher values at the top or on the right rather than on the bottom or left.
Gets the current value of the range.
Sets the current value of the range; if the value is outside the minimum or maximum range values, it will be clamped to fit inside them. The range emits the "value-changed" signal if the value changes.
Sets the step and page sizes for the range. The step size is used when the user clicks the GtkScrollbar arrows or moves GtkScale via arrow keys. The page size is used for example when moving via Page Up or Page Down keys.
Sets the allowable values in the GtkRange, and clamps the range value to be between min and max. (If the range has a non-zero page size, it is clamped between min and max - page-size.)
Gets the number of digits to round the value to when it changes. See "change-value". Since 2.24
Sets the number of digits to round the value to when it changes. See "change-value". Since 2.24
Sets the sensitivity policy for the stepper that points to the 'lower' end of the GtkRange's adjustment. Since 2.10
Gets the sensitivity policy for the stepper that points to the 'lower' end of the GtkRange's adjustment. Since 2.10
Sets the sensitivity policy for the stepper that points to the 'upper' end of the GtkRange's adjustment. Since 2.10
Gets the sensitivity policy for the stepper that points to the 'upper' end of the GtkRange's adjustment. Since 2.10
Gets the value set by gtk_range_set_flippable(). Since 2.18
If a range is flippable, it will switch its direction if it is horizontal and its direction is GTK_TEXT_DIR_RTL. See gtk_widget_get_direction(). Since 2.18
This function is useful mainly for GtkRange subclasses. See gtk_range_set_min_slider_size(). Since 2.20
This function returns the area that contains the range's trough and its steppers, in widget->window coordinates. This function is useful mainly for GtkRange subclasses. Since 2.20
This function returns sliders range along the long dimension, in widget->window coordinates. This function is useful mainly for GtkRange subclasses. Since 2.20
This function is useful mainly for GtkRange subclasses. See gtk_range_set_slider_size_fixed(). Since 2.20
Sets the minimum size of the range's slider. This function is useful mainly for GtkRange subclasses. Since 2.20
Sets whether the range's slider has a fixed size, or a size that depends on its adjustment's page size. This function is useful mainly for GtkRange subclasses. Since 2.20
A GtkScale is a slider control used to select a numeric value. To use it, you'll probably want to investigate the methods on its base class, GtkRange, in addition to the methods for GtkScale itself. To set the value of a scale, you would normally use gtk_range_set_value(). To detect changes to the value, you would normally use the "value-changed" signal.
Note that using the same upper and lower bounds for the GtkScale (through the GtkRange methods) will hide the slider itself. This is useful for applications that want to show an undeterminate value on the scale, without changing the layout of the application (such as movie or music players).
GtkScale as GtkBuildable
GtkScale supports a custom <marks> element, which can contain multiple <mark> elements. The "value" and "position" attributes have the same meaning as gtk_scale_add_mark() parameters of the same name. If the element is not empty, its content is taken as the markup to show at the mark. It can be translated with the usual "translatable and "context" attributes.