GtkRange

gtk_range_get_fill_level ()

gdouble
gtk_range_get_fill_level (GtkRange *range);

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

Since: 2.12

gtk_range_get_restrict_to_fill_level ()

gboolean
gtk_range_get_restrict_to_fill_level (GtkRange *range);

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

Since: 2.12

gtk_range_get_show_fill_level ()

gboolean
gtk_range_get_show_fill_level (GtkRange *range);

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

Since: 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() и по умолчанию включено.

Since: 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() для общего описания концепции уровня заполнения.

Since: 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() для общего описания концепции уровня заполнения.

Since: 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);

Устанавливает корректировку, которая будет использоваться в качестве объекта «модели» для этого виджета диапазона. Корректировка указывает текущее значение диапазона, минимальные и максимальные значения диапазона, приращения шага/страницы, используемые для клавишных комбинаций и прокрутки, и размер страницы. Размер страницы обычно равен 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”.

С версии: 2.24

gtk_range_set_round_digits ()

void
gtk_range_set_round_digits (GtkRange *range,
                            gint round_digits);

Задает количество знаков после запятой, до которых должно быть округлено значение при его изменении. См. “change-value”.

С версии: 2.24

gtk_range_set_lower_stepper_sensitivity ()

void
gtk_range_set_lower_stepper_sensitivity
                               (GtkRange *range,
                                GtkSensitivityType sensitivity);

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

С версии: 2.10

gtk_range_get_lower_stepper_sensitivity ()

GtkSensitivityType
gtk_range_get_lower_stepper_sensitivity
                               (GtkRange *range);

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

С версии: 2.10

gtk_range_set_upper_stepper_sensitivity ()

void
gtk_range_set_upper_stepper_sensitivity
                               (GtkRange *range,
                                GtkSensitivityType sensitivity);

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

С версии: 2.10

gtk_range_get_upper_stepper_sensitivity ()

GtkSensitivityType
gtk_range_get_upper_stepper_sensitivity
                               (GtkRange *range);

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

С версии: 2.10

gtk_range_get_flippable ()

gboolean
gtk_range_get_flippable (GtkRange *range);

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

С версии: 2.18

gtk_range_set_flippable ()

void
gtk_range_set_flippable (GtkRange *range,
                         gboolean flippable);

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

См. gtk_widget_get_direction().

С версии: 2.18

gtk_range_get_min_slider_size ()

gint
gtk_range_get_min_slider_size (GtkRange *range);

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

См. gtk_range_set_min_slider_size().

С версии: 2.20

gtk_range_get_range_rect ()

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

Эта функция возвращает область, которая содержит канал диапазона и его шагомеры, в координатах widget->window.

Эта функция полезна в основном для подклассов 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