GtkAdjustment

gtk_adjustment_new ()

GtkAdjustment *
gtk_adjustment_new (double value,
                    double lower,
                    double upper,
                    double step_increment,
                    double page_increment,
                    double page_size);

Создаёт новую настройку GtkAdjustment.

gtk_adjustment_get_value ()

double
gtk_adjustment_get_value (GtkAdjustment *adjustment);

Получает текущее значение настройки. См. gtk_adjustment_set_value().

gtk_adjustment_set_value ()

void
gtk_adjustment_set_value (GtkAdjustment *adjustment,
                          double value);

Устанавливает значение GtkAdjustment. Значение ограничено значениями между «нижним» и «верхним».

Обратите внимание, что для настроек, используемых в GtkScrollbar, эффективный диапазон допустимых значений составляет от «нижнего» до «верхнего» - «размер-страницы».

gtk_adjustment_clamp_page ()

void
gtk_adjustment_clamp_page (GtkAdjustment *adjustment,
                           double lower,
                           double upper);

Обновляет свойство «значение», чтобы убедиться, что диапазон между lower и upper находится на текущей странице (т.е. между «значением» и «значением» + «размер-страницы»). Если диапазон больше размера страницы, то только его начало будет на текущей странице.

Сигнал «value-changed» будет выпущен, если значение изменится.

gtk_adjustment_configure ()

void
gtk_adjustment_configure (GtkAdjustment *adjustment,
                          double value,
                          double lower,
                          double upper,
                          double step_increment,
                          double page_increment,
                          double page_size);

Устанавливает все свойства настройки сразу.

Используйте эту функцию, чтобы избежать многократного выдачи сигнала «changed». См. gtk_adjustment_set_lower() для альтернативного способа сжатия нескольких вызовов «changed» в один.

gtk_adjustment_get_lower ()

double
gtk_adjustment_get_lower (GtkAdjustment *adjustment);

Возвращает минимальное значение настройки.

gtk_adjustment_get_page_increment ()

double
gtk_adjustment_get_page_increment (GtkAdjustment *adjustment);

Возвращает шаг страницы настройки.

gtk_adjustment_get_page_size ()

double
gtk_adjustment_get_page_size (GtkAdjustment *adjustment);

Возвращает размер страницы настройки.

gtk_adjustment_get_step_increment ()

double
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment);

Возвращает шаг увеличения настройки.

gtk_adjustment_get_minimum_increment ()

double
gtk_adjustment_get_minimum_increment (GtkAdjustment *adjustment);

Получает меньшее из шага увеличения и шага страницы.

gtk_adjustment_get_upper ()

double
gtk_adjustment_get_upper (GtkAdjustment *adjustment);

Возвращает максимальное значение настройки.

gtk_adjustment_set_lower ()

void
gtk_adjustment_set_lower (GtkAdjustment *adjustment,
                          double lower);

Устанавливает минимальное значение регулировки.

При установке нескольких свойств регулировки с помощью отдельных методов-установщиков, будут генерироваться несколько сигналов “changed”. Однако, поскольку генерация сигнала “changed” связана с генерацией сигналов “notify” изменённых свойств, можно объединить сигналы “changed” в один, вызвав g_object_freeze_notify() и g_object_thaw_notify() перед вызовами отдельных методов-установщиков.

Альтернативно, использование одного g_object_set() для изменения всех свойств или использование gtk_adjustment_configure() имеет тот же эффект, что и объединение генерации сигналов “changed”.

gtk_adjustment_set_page_increment ()

void
gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,
                                   double page_increment);

Устанавливает приращение страницы регулировки.

См. gtk_adjustment_set_lower() о том, как объединить несколько генераций сигнала “changed” при установке нескольких свойств регулировки.

gtk_adjustment_set_page_size ()

void
gtk_adjustment_set_page_size (GtkAdjustment *adjustment,
                              double page_size);

Устанавливает размер страницы регулировки.

См. gtk_adjustment_set_lower() о том, как объединить несколько генераций сигнала GtkAdjustment::changed при установке нескольких свойств регулировки.

gtk_adjustment_set_step_increment ()

void
gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,
                                   double step_increment);

Устанавливает приращение шага регулировки.

См. gtk_adjustment_set_lower() о том, как объединить несколько генераций сигнала “changed” при установке нескольких свойств регулировки.

gtk_adjustment_set_upper ()

void
gtk_adjustment_set_upper (GtkAdjustment *adjustment,
                          double upper);

Устанавливает максимальное значение регулировки.

Обратите внимание, что значения будут ограничены upper - page-size, если свойство размера страницы отлично от нуля.

См. gtk_adjustment_set_lower() о том, как объединить несколько генераций сигнала “changed” при установке нескольких свойств регулировки.