GtkAdjustment
GtkAdjustment — Представление регулируемого значения в заданных пределах
Функции
| void | gtk_adjustment_set_upper () |
Свойства
| gdouble | нижняя_граница | Чтение / Запись |
| gdouble | приращение_страницы | Чтение / Запись |
| gdouble | размер_страницы | Чтение / Запись |
| gdouble | шаг_приращения | Чтение / Запись |
| gdouble | верхняя_граница | Чтение / Запись |
| gdouble | значение | Чтение / Запись |
Сигналы
| void | изменён | Без рекурсии |
| void | изменено_значение | Без рекурсии |
Типы и значения
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkAdjustment
Включаемые файлы
#include <gtk/gtk.h>
Описание
Объект GtkAdjustment представляет значение с привязкой к нижней и верхней границам, а также шагами и размером страницы. Он используется в нескольких виджетах GTK+, включая GtkSpinButton, GtkViewport и GtkRange (который является базовым классом для GtkScrollbar и GtkScale).
Объект GtkAdjustment не обновляет значение самостоятельно. Вместо этого, владельцу объекта GtkAdjustment необходимо управлять значением.
Функции
gtk_adjustment_new ()
GtkAdjustment * gtk_adjustment_new (gdouble value,gdouble lower,gdouble upper,gdouble step_increment,gdouble page_increment,gdouble page_size);
Создаёт новый GtkAdjustment.
Параметры
value | начальное значение | |
lower | минимальное значение | |
upper | максимальное значение | |
step_increment | шаг приращения | |
page_increment | шаг страницы | |
page_size | размер страницы |
Возвращаемое значение
новый GtkAdjustment
gtk_adjustment_get_value ()
gdouble
gtk_adjustment_get_value (GtkAdjustment *adjustment); Получает текущее значение корректировки. См. gtk_adjustment_set_value().
Параметры
adjustment |
Возвращаемое значение
Текущее значение корректировки
gtk_adjustment_set_value ()
void gtk_adjustment_set_value (GtkAdjustment *adjustment,gdouble value);
Устанавливает значение GtkAdjustment. Значение ограничено диапазоном между “lower” и “upper”.
Обратите внимание, что для корректировок, используемых в GtkScrollbar, эффективный диапазон разрешённых значений находится от “lower” до “upper” - “page-size”.
Параметры
adjustment | ||
value | новое значение |
gtk_adjustment_clamp_page ()
void gtk_adjustment_clamp_page (GtkAdjustment *adjustment,gdouble lower,gdouble upper);
Обновляет свойство “value”, чтобы гарантировать, что диапазон между lower и upper находится на текущей странице (т.е. между “value” и “value” + “page-size”). Если диапазон больше размера страницы, то только его начало будет на текущей странице.
Если значение изменено, будет выпущен сигнал “value-changed”.
Параметры
adjustment | ||
lower | нижние значение | |
upper | верхнее значение |
gtk_adjustment_changed ()
void
gtk_adjustment_changed (GtkAdjustment *adjustment); gtk_adjustment_changed устарело начиная с версии 3.18 и не должно использоваться в новом коде.
GTK+ излучает “изменён” сам по себе всякий раз, когда изменяются любые свойства (кроме значения).
Излучает сигнал “изменён” от GtkAdjustment. Как правило, это вызывается владельцем GtkAdjustment после изменения любых свойств GtkAdjustment, кроме значения.
Параметры
adjustment |
gtk_adjustment_value_changed ()
void
gtk_adjustment_value_changed (GtkAdjustment *adjustment); gtk_adjustment_value_changed устарело начиная с версии 3.18 и не должно использоваться в новом коде.
GTK+ излучает “изменённое значение” сам по себе всякий раз, когда значение изменяется.
Излучает сигнал “изменённое значение” от GtkAdjustment. Как правило, это вызывается владельцем GtkAdjustment после изменения свойства “значение”.
Параметры
adjustment |
gtk_adjustment_configure ()
void gtk_adjustment_configure (GtkAdjustment *adjustment,gdouble value,gdouble lower,gdouble upper,gdouble step_increment,gdouble page_increment,gdouble page_size);
Устанавливает все свойства регулировки сразу.
Используйте эту функцию, чтобы избежать многократного излучения сигнала “изменён”. См. gtk_adjustment_set_lower() для альтернативного способа сжатия нескольких излучений “изменён” в один.
Параметры
adjustment | ||
value | новое значение | |
lower | новое минимальное значение | |
upper | новое максимальное значение | |
step_increment | новый шаг увеличения | |
page_increment | новый шаг страницы | |
page_size | новый размер страницы |
С: 2.14
gtk_adjustment_get_lower ()
gdouble
gtk_adjustment_get_lower (GtkAdjustment *adjustment); Возвращает минимальное значение регулировки.
Параметры
adjustment |
Возвращает
Текущее минимальное значение регулировки
С: 2.14
gtk_adjustment_get_page_increment ()
gdouble
gtk_adjustment_get_page_increment (GtkAdjustment *adjustment); Возвращает приращение страницы корректировки.
Параметры
adjustment |
Возвращаемое значение
Текущее приращение страницы корректировки
Since: 2.14
gtk_adjustment_get_page_size ()
gdouble
gtk_adjustment_get_page_size (GtkAdjustment *adjustment); Возвращает размер страницы корректировки.
Параметры
adjustment |
Возвращаемое значение
Текущий размер страницы корректировки
Since: 2.14
gtk_adjustment_get_step_increment ()
gdouble
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment); Возвращает приращение шага корректировки.
Параметры
adjustment |
Возвращаемое значение
Текущее приращение шага корректировки.
Since: 2.14
gtk_adjustment_get_minimum_increment ()
gdouble
gtk_adjustment_get_minimum_increment (GtkAdjustment *adjustment); Возвращает меньшее из приращения шага и приращения страницы.
Параметры
adjustment |
Возвращаемое значение
минимальное приращение adjustment
Since: 3.2
gtk_adjustment_get_upper ()
gdouble
gtk_adjustment_get_upper (GtkAdjustment *adjustment); Возвращает максимальное значение корректировки.
Параметры
adjustment |
Возвращаемое значение
Текущее максимальное значение корректировки
Since: 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”.
Параметры
adjustment | ||
lower | новое минимальное значение |
Since: 2.14
gtk_adjustment_set_page_increment ()
void gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,gdouble page_increment);
Устанавливает шаг страницы регулировки.
См. gtk_adjustment_set_lower(), как сжать несколько излучений сигнала “changed” при установке нескольких свойств регулировки.
Параметры
adjustment | ||
page_increment | новый шаг страницы |
Since: 2.14
gtk_adjustment_set_page_size ()
void gtk_adjustment_set_page_size (GtkAdjustment *adjustment,gdouble page_size);
Устанавливает размер страницы регулировки.
См. gtk_adjustment_set_lower() о том, как сжать несколько излучений сигнала GtkAdjustment::changed при установке нескольких свойств регулировки.
Параметры
adjustment | ||
page_size | новый размер страницы |
Since: 2.14
gtk_adjustment_set_step_increment ()
void gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,gdouble step_increment);
Устанавливает шаг регулировки.
См. gtk_adjustment_set_lower() о том, как сжать несколько излучений сигнала “changed” при установке нескольких свойств регулировки.
Параметры
adjustment | ||
step_increment | новый шаг |
Since: 2.14
gtk_adjustment_set_upper ()
void gtk_adjustment_set_upper (GtkAdjustment *adjustment,gdouble upper);
Устанавливает максимальное значение регулировки.
Обратите внимание, что значения будут ограничены upper - page-size , если свойство размера страницы не равно нулю.
См. gtk_adjustment_set_lower(), чтобы узнать, как сжать несколько срабатываний сигнала “изменён” при установке нескольких свойств регулировки.
Параметры
adjustment | ||
upper | новое максимальное значение |
С: 2.14
Типы и значения
GtkAdjustment
typedef struct _GtkAdjustment GtkAdjustment;
Структура GtkAdjustment содержит только закрытые поля и не должна использоваться напрямую.
Подробное описание свойств
Свойство “lower”
“lower” gdouble
Минимальное значение регулировки.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Свойство “page-increment”
“page-increment” gdouble
Приращение страницы регулировки.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Свойство “page-size”
“page-size” gdouble
Размер страницы регулировки. Обратите внимание, что размер страницы не имеет значения и должен быть установлен в ноль, если регулировка используется для простого скалярного значения, например, в элементе GtkSpinButton.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Свойство “step-increment”
“step-increment” gdouble
Приращение шага регулировки.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Свойство “upper”
“upper” gdouble
Максимальное значение регулировки. Обратите внимание, что значения будут ограничены upper - page-size , если свойство размера страницы не равно нулю.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Свойство “value”
“value” gdouble
Значение регулировки.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Подробное описание сигналов
Сигнал “changed”
void user_function (GtkAdjustment *adjustment, gpointer user_data)
Выдаётся, когда одно или несколько свойств GtkAdjustment были изменены, за исключением свойства “значение”.
Параметры
adjustment | объект, получивший сигнал | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Без рекурсии
Сигнал “value-changed”
void user_function (GtkAdjustment *adjustment, gpointer user_data)
Выдаётся, когда свойство “значение” было изменено.
Параметры
adjustment | объект, получивший сигнал | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Без рекурсии
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkAdjustment.html