GtkRange

gtk_range_get_fill_level ()

gdouble
gtk_range_get_fill_level (GtkRange *range);

Получает текущее положение индикатора уровня заполнения.

С версии: 2.12

gtk_range_get_restrict_to_fill_level ()

gboolean
gtk_range_get_restrict_to_fill_level (GtkRange *range);

Получает, ограничено ли значение диапазона уровнем заполнения.

С версии: 2.12

gtk_range_get_show_fill_level ()

gboolean
gtk_range_get_show_fill_level (GtkRange *range);

Получает, отображается ли графически уровень заполнения диапазона.

С версии: 2.12

gtk_range_set_fill_level ()

void
gtk_range_set_fill_level (GtkRange *range,
                          gdouble fill_level);

Устанавливает новое положение индикатора уровня заполнения.

«Уровень заполнения» лучше всего описать на примере его наиболее распространённого применения — индикатор предварительной буферизации в проигрывателе потокового медиа. В этом случае значение диапазона будет указывать текущую позицию воспроизведения, а уровень заполнения — позицию, до которой файл/поток был загружен.

Этот объём предварительной буферизации может быть отображен на шкале диапазона и стилизуется отдельно от неё. Чтобы включить отображение уровня заполнения, используйте gtk_range_set_show_fill_level(). По умолчанию отображение уровня заполнения выключено.

Кроме того, можно ограничить положение ползунка диапазона значениями, которые меньше уровня заполнения. Это контролируется gtk_range_set_restrict_to_fill_level() и по умолчанию включено.

С версии: 2.12

gtk_range_set_restrict_to_fill_level ()

void
gtk_range_set_restrict_to_fill_level (GtkRange *range,
                                      gboolean restrict_to_fill_level);

Устанавливает, ограничено ли движение ползунка уровнем заполнения. См. gtk_range_set_fill_level() для общего описания понятия уровня заполнения.

С версии: 2.12

gtk_range_set_show_fill_level ()

void
gtk_range_set_show_fill_level (GtkRange *range,
                               gboolean show_fill_level);

Устанавливает, отображается ли графический индикатор уровня заполнения. См. gtk_range_set_fill_level() для общего описания понятия уровня заполнения.

С версии: 2.12

gtk_range_get_adjustment ()

GtkAdjustment *
gtk_range_get_adjustment (GtkRange *range);

Получить GtkAdjustment, являющийся объектом «модели» для GtkRange. См. gtk_range_set_adjustment() для подробностей. Возвращаемое значение не имеет ссылок, поэтому не должно быть удалено.

gtk_range_set_adjustment ()

void
gtk_range_set_adjustment (GtkRange *range,
                          GtkAdjustment *adjustment);

Устанавливает GtkAdjustment в качестве объекта «модели» для этого виджета диапазона. GtkAdjustment указывает текущее значение диапазона, минимальные и максимальные значения диапазона, приращения шага/страницы, используемые для горячих клавиш и прокрутки, и размер страницы. Размер страницы обычно равен 0 для GtkScale и ненулевому для GtkScrollbar и указывает размер видимой области виджета, который прокручивается. Размер страницы влияет на размер ползунка полосы прокрутки.

gtk_range_get_inverted ()

gboolean
gtk_range_get_inverted (GtkRange *range);

Получает значение, установленное функцией gtk_range_set_inverted().

gtk_range_set_inverted ()

void
gtk_range_set_inverted (GtkRange *range,
                        gboolean setting);

Диапазоны обычно перемещаются от меньших к большим значениям, по мере того, как ползунок перемещается сверху вниз или слева направо. В инвертированных диапазонах большие значения находятся сверху или справа, а не снизу или слева.

gtk_range_get_value ()

gdouble
gtk_range_get_value (GtkRange *range);

Получает текущее значение диапазона.

gtk_range_set_value ()

void
gtk_range_set_value (GtkRange *range,
                     gdouble value);

Устанавливает текущее значение диапазона; если значение находится за пределами минимального или максимального значений диапазона, оно будет ограничено, чтобы поместиться в них. Диапазон излучает сигнал “value-changed”, если значение изменяется.

gtk_range_set_increments ()

void
gtk_range_set_increments (GtkRange *range,
                          gdouble step,
                          gdouble page);

Устанавливает размеры шага и страницы для диапазона. Размер шага используется, когда пользователь нажимает стрелки GtkScrollbar или перемещает GtkScale с помощью клавиш со стрелками. Размер страницы используется, например, при перемещении с помощью клавиш Page Up или Page Down.

gtk_range_set_range ()

void
gtk_range_set_range (GtkRange *range,
                     gdouble min,
                     gdouble max);

Устанавливает допустимые значения в GtkRange и ограничивает значение диапазона, чтобы оно было между min и max. (Если у диапазона есть размер страницы, отличная от нуля, он ограничен между min и max - размером страницы.)

gtk_range_get_round_digits ()

gint
gtk_range_get_round_digits (GtkRange *range);

Возвращает количество цифр для округления значения при его изменении. См. “change-value”.

Since: 2.24

gtk_range_set_round_digits ()

void
gtk_range_set_round_digits (GtkRange *range,
                            gint round_digits);

Устанавливает количество цифр для округления значения при его изменении. См. “change-value”.

Since: 2.24

gtk_range_set_lower_stepper_sensitivity ()

void
gtk_range_set_lower_stepper_sensitivity
                               (GtkRange *range,
                                GtkSensitivityType sensitivity);

Устанавливает политику чувствительности для шагомера, указывающего на «нижний» конец корректировки GtkRange.

Since: 2.10

gtk_range_get_lower_stepper_sensitivity ()

GtkSensitivityType
gtk_range_get_lower_stepper_sensitivity
                               (GtkRange *range);

Получает политику чувствительности для шагомера, указывающего на «нижний» конец корректировки GtkRange.

Since: 2.10

gtk_range_set_upper_stepper_sensitivity ()

void
gtk_range_set_upper_stepper_sensitivity
                               (GtkRange *range,
                                GtkSensitivityType sensitivity);

Устанавливает политику чувствительности для шагомера, указывающего на «верхний» конец корректировки GtkRange.

Since: 2.10

gtk_range_get_upper_stepper_sensitivity ()

GtkSensitivityType
gtk_range_get_upper_stepper_sensitivity
                               (GtkRange *range);

Получает политику чувствительности для шагомера, указывающего на «верхний» конец корректировки GtkRange.

Since: 2.10

gtk_range_get_flippable ()

gboolean
gtk_range_get_flippable (GtkRange *range);

Возвращает значение, установленное функцией gtk_range_set_flippable().

Since: 2.18

gtk_range_set_flippable ()

void
gtk_range_set_flippable (GtkRange *range,
                         gboolean flippable);

Если диапазон может быть перевернут, он будет изменять своё направление, если он горизонтальный и его направление GTK_TEXT_DIR_RTL.

См. gtk_widget_get_direction().

Since: 2.18

gtk_range_get_min_slider_size ()

gint
gtk_range_get_min_slider_size (GtkRange *range);

Эта функция полезна в основном для подклассов GtkRange.

См. gtk_range_set_min_slider_size().

Since: 2.20

gtk_range_get_range_rect ()

void
gtk_range_get_range_rect (GtkRange *range,
                          GdkRectangle *range_rect);

Эта функция возвращает область, содержащую желоб диапазона и его ползунки, в координатах окна виджета.

Эта функция полезна в основном для подклассов GtkRange.

С версии: 2.20

gtk_range_get_slider_range ()

void
gtk_range_get_slider_range (GtkRange *range,
                            gint *slider_start,
                            gint *slider_end);

Эта функция возвращает диапазон ползунков по длинной оси в координатах окна виджета.

Эта функция полезна в основном для подклассов GtkRange.

С версии: 2.20

gtk_range_get_slider_size_fixed ()

gboolean
gtk_range_get_slider_size_fixed (GtkRange *range);

Эта функция полезна в основном для подклассов GtkRange.

См. gtk_range_set_slider_size_fixed().

С версии: 2.20

gtk_range_set_min_slider_size ()

void
gtk_range_set_min_slider_size (GtkRange *range,
                               gint min_size);

Устанавливает минимальный размер ползунка диапазона.

Эта функция полезна в основном для подклассов GtkRange.

С версии: 2.20

gtk_range_set_slider_size_fixed ()

void
gtk_range_set_slider_size_fixed (GtkRange *range,
                                 gboolean size_fixed);

Устанавливает, имеет ли ползунок диапазона фиксированный размер или размер, зависящий от размера страницы регулировки.

Эта функция полезна в основном для подклассов GtkRange.

С версии: 2.20