GtkAdjustment
GtkAdjustment — Представление настраиваемого значения с границами
Функции
Свойства
Сигналы
| void | changed | Без рекурсии |
| void | value-changed | Без рекурсии |
Типы и значения
Иерархия объектов
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+ сам излучает “changed”, когда изменяются любые свойства (кроме значения)
Выпускает сигнал “changed” от GtkAdjustment. Это обычно вызывается владельцем GtkAdjustment после изменения свойств GtkAdjustment, кроме значения.
Параметры
adjustment |
gtk_adjustment_value_changed ()
void
gtk_adjustment_value_changed (GtkAdjustment *adjustment); gtk_adjustment_value_changed устарел с версии 3.18 и не должен использоваться в новых кодах.
GTK+ сам излучает “value-changed”, когда изменяется значение
Выпускает сигнал “value-changed” от GtkAdjustment. Это обычно вызывается владельцем GtkAdjustment после изменения свойства “value”.
Параметры
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);
Устанавливает все свойства корректировки сразу.
Используйте эту функцию, чтобы избежать многократного излучения сигнала “changed”. См. gtk_adjustment_set_lower() для альтернативного способа объединения нескольких излучений “changed” в один.
Параметры
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 | объект GtkAdjustment |
Возвращаемое значение
Текущее значение приращения страницы корректировки
С: 2.14
gtk_adjustment_get_page_size ()
gdouble
gtk_adjustment_get_page_size (GtkAdjustment *adjustment); Возвращает размер страницы корректировки.
Параметры
adjustment | объект GtkAdjustment |
Возвращаемое значение
Текущий размер страницы корректировки
С: 2.14
gtk_adjustment_get_step_increment ()
gdouble
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment); Возвращает значение приращения шага корректировки.
Параметры
adjustment | объект GtkAdjustment |
Возвращаемое значение
Текущее значение приращения шага корректировки.
С: 2.14
gtk_adjustment_get_minimum_increment ()
gdouble
gtk_adjustment_get_minimum_increment (GtkAdjustment *adjustment); Возвращает меньшее из значения приращения шага и значения приращения страницы.
Параметры
adjustment | объект GtkAdjustment |
Возвращаемое значение
минимальное приращение adjustment
С: 3.2
gtk_adjustment_get_upper ()
gdouble
gtk_adjustment_get_upper (GtkAdjustment *adjustment); Возвращает максимальное значение корректировки.
Параметры
adjustment | объект GtkAdjustment |
Возвращаемое значение
Текущее максимальное значение корректировки
С: 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 | объект GtkAdjustment | |
lower | новое минимальное значение |
С: 2.14
gtk_adjustment_set_page_increment ()
void gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,gdouble page_increment);
Устанавливает значение приращения страницы для корректировки.
См. gtk_adjustment_set_lower(), чтобы узнать, как сжать несколько отправлений сигнала «changed» при настройке нескольких свойств корректировки.
Параметры
adjustment | объект GtkAdjustment | |
page_increment | новое значение приращения страницы |
С: 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 | объект GtkAdjustment | |
page_size | новый размер страницы |
С: 2.14
gtk_adjustment_set_step_increment ()
void gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,gdouble step_increment);
Устанавливает значение приращения шага корректировки.
См. gtk_adjustment_set_lower(), чтобы узнать, как сжать несколько отправлений сигнала «changed» при настройке нескольких свойств корректировки.
Параметры
adjustment | объект GtkAdjustment | |
step_increment | новое значение приращения шага |
С: 2.14
gtk_adjustment_set_upper ()
void gtk_adjustment_set_upper (GtkAdjustment *adjustment,gdouble upper);
Устанавливает максимальное значение корректировки.
Обратите внимание, что значения будут ограничены upper - page-size , если свойство размера страницы не равно нулю.
См. gtk_adjustment_set_lower(), чтобы узнать, как сжать несколько отправлений сигнала «changed» при настройке нескольких свойств корректировки.
Параметры
adjustment | объект GtkAdjustment | |
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, кроме свойства “value”.
Параметры
adjustment | объект, получивший сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Без рекурсии
Сигнал “value-changed”
void user_function (GtkAdjustment *adjustment, gpointer user_data)
Выдаётся, когда изменено свойство “value”.
Параметры
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.22/GtkAdjustment.html