GtkAdjustment

gtk_adjustment_new ()

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

Создаёт новую GtkAdjustment.

gtk_adjustment_get_value ()

gdouble
gtk_adjustment_get_value (GtkAdjustment *adjustment);

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

gtk_adjustment_set_value ()

void
gtk_adjustment_set_value (GtkAdjustment *adjustment,
                          gdouble value);

Устанавливает значение GtkAdjustment. Значение ограничено диапазоном между “lower” и “upper”.

Обратите внимание, что для корректировок, используемых в GtkScrollbar, эффективный диапазон допустимых значений составляет от “lower” до “upper” - “page-size”.

gtk_adjustment_clamp_page ()

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

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

Если значение изменено, будет выпущен сигнал “value-changed”.

gtk_adjustment_changed ()

void
gtk_adjustment_changed (GtkAdjustment *adjustment);

Выпускает сигнал “changed” от GtkAdjustment. Это обычно вызывается владельцем GtkAdjustment после изменения свойств GtkAdjustment, кроме значения.

gtk_adjustment_value_changed ()

void
gtk_adjustment_value_changed (GtkAdjustment *adjustment);

Выпускает сигнал “value-changed” от GtkAdjustment. Это обычно вызывается владельцем GtkAdjustment после изменения свойства “value”.

gtk_adjustment_configure ()

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

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

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

С: 2.14

gtk_adjustment_get_lower ()

gdouble
gtk_adjustment_get_lower (GtkAdjustment *adjustment);

Извлекает минимальное значение корректировки.

С: 2.14

gtk_adjustment_get_page_increment ()

gdouble
gtk_adjustment_get_page_increment (GtkAdjustment *adjustment);

Извлекает приращение страницы настройки.

С версии: 2.14

gtk_adjustment_get_page_size ()

gdouble
gtk_adjustment_get_page_size (GtkAdjustment *adjustment);

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

С версии: 2.14

gtk_adjustment_get_step_increment ()

gdouble
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment);

Извлекает приращение шага настройки.

С версии: 2.14

gtk_adjustment_get_minimum_increment ()

gdouble
gtk_adjustment_get_minimum_increment (GtkAdjustment *adjustment);

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

С версии: 3.2

gtk_adjustment_get_upper ()

gdouble
gtk_adjustment_get_upper (GtkAdjustment *adjustment);

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

С версии: 2.14

gtk_adjustment_set_lower ()

void
gtk_adjustment_set_lower (GtkAdjustment *adjustment,
                          gdouble lower);

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

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

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

С версии: 2.14

gtk_adjustment_set_page_increment ()

void
gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,
                                   gdouble page_increment);

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

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

С версии: 2.14

gtk_adjustment_set_page_size ()

void
gtk_adjustment_set_page_size (GtkAdjustment *adjustment,
                              gdouble page_size);

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

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

С версии: 2.14

gtk_adjustment_set_step_increment ()

void
gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,
                                   gdouble step_increment);

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

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

С версии: 2.14

gtk_adjustment_set_upper ()

void
gtk_adjustment_set_upper (GtkAdjustment *adjustment,
                          gdouble upper);

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

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

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

С версии: 2.14