| |
![]() |
GTK+ Reference Manual |
||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
GtkAdjustmentGtkAdjustment GtkObject представляющий регулятор значений |
#include <gtk/gtk.h> GtkAdjustment; GtkObject* gtk_adjustment_new (gdouble value, gdouble lower, gdouble upper, gdouble step_increment, gdouble page_increment, gdouble page_size); gdouble gtk_adjustment_get_value (GtkAdjustment *adjustment); void gtk_adjustment_set_value (GtkAdjustment *adjustment, gdouble value); void gtk_adjustment_clamp_page (GtkAdjustment *adjustment, gdouble lower, gdouble upper); void gtk_adjustment_changed (GtkAdjustment *adjustment); void gtk_adjustment_value_changed (GtkAdjustment *adjustment);
GObject +----GInitiallyUnowned +----GtkObject +----GtkAdjustment
"lower" gdouble : Read / Write "page-increment" gdouble : Read / Write "page-size" gdouble : Read / Write "step-increment" gdouble : Read / Write "upper" gdouble : Read / Write "value" gdouble : Read / Write
"changed" void user_function (GtkAdjustment *adjustment, gpointer user_data) : Run first / No recursion "value-changed" void user_function (GtkAdjustment *adjustment, gpointer user_data) : Run first / No recursion
GtkAdjustment - объект, представляющий значение которое имеет верхнюю и нижнюю границу, вместе с шагом приращения страницы и её размером. Он используется в нескольких виджетах GTK+, включая GtkSpinButton, GtkViewport и GtkRange (которые являются основными классами для GtkHScrollbar, GtkVScrollbar, GtkHScale и GtkVScale).
Объект GtkAdjustment не обновляет значение самостоятельно. Вместо этого он обращается к GtkAdjustment для контролирования значения.
GtkAdjustment
обычно вызывает функции
gtk_adjustment_value_changed()
и gtk_adjustment_changed()
после изменения значения и его границ.
Это приводит к эмиссии сигналов
"value_changed" или "changed" соответственно.
typedef struct _GtkAdjustment GtkAdjustment;
Структура GtkAdjustment содержит следующие поля.
gdouble lower; |
Минимальное значение. |
gdouble upper; |
Максимальное значение. |
gdouble value; |
Текущее значение. |
gdouble step_increment; |
Приращение используемое для минимального изменения значения. В GtkScrollbar это приращение используется когда мышкой нажимают на стрелки верхней и нижней кнопки панели прокручивания, для прокрутки минимального промежутка. |
gdouble page_increment; |
Приращение используемое для максимально возможного изменения значения. В GtkScrollbar это приращение используется при нажатии мышкой в колее ползунка, для прокручивания на максимально возможное расстояние. |
gdouble page_size; |
Размер страницы. В GtkScrollbar это размер текущемй видимой области. |
GtkObject* gtk_adjustment_new (gdouble value, gdouble lower, gdouble upper, gdouble step_increment, gdouble page_increment, gdouble page_size);
Создаёт новый GtkAdjustment.
|
Начальное значение. |
|
Минимальное значение. |
|
Максимальное значение. |
|
Шаг приращения. |
|
Страничное приращение. |
|
Размер страницы. |
Возвращает : |
новый GtkAdjustment. |
gdouble gtk_adjustment_get_value (GtkAdjustment *adjustment);
Получает текущеме значение регулятора.
Смотрите gtk_adjustment_set_value()
.
|
|
Возвращает : |
Текущее значение регуллятора. |
void gtk_adjustment_set_value (GtkAdjustment *adjustment, gdouble value);
Устанавливает значение GtkAdjustment.
Значение зафиксировано между
adjustment->lower
и adjustment->upper
.
Помните, регулировки которые используются
в GtkScrollbar, находятся в
диапазоне допустимых значений начиная
с adjustment->lower
до adjustment->upper
- adjustment->page_size
.
|
|
|
Новое значение. |
void gtk_adjustment_clamp_page (GtkAdjustment *adjustment, gdouble lower, gdouble upper);
Обновляет GtkAdjustment
value
для утверждения диапазона
между lower
и upper
в текущемй странице (то есть между value
и value
+ page_size
).
Если диапазон меньше размера страницы,
то только его начало будет в текущемй
странице. Сигнал "changed" издаётся
при изменении значения.
|
|
|
Наименьшее значение. |
|
Наибольшее значение. |
void gtk_adjustment_changed (GtkAdjustment *adjustment);
Издаёт сигнал "changed" из GtkAdjustment. Обычно вызывается владельцем GtkAdjustment после изменения любого поля GtkAdjustment кроме значения.
|
void gtk_adjustment_value_changed (GtkAdjustment *adjustment);
Издаёт сигнал "value_changed" из GtkAdjustment. Обычно вызывается владельцем GtkAdjustment после изменения поля значения GtkAdjustment.
|
lower
""lower" gdouble : Read / Write
Минимальное значение регулятора.
Значение по умолчанию: 0
Начиная с версии 2.4
page-increment
""page-increment" gdouble : Read / Write
Страничное приращение регулятора.
Значение по умолчанию: 0
Начиная с версии 2.4
page-size
""page-size" gdouble : Read / Write
Размер страницы регулятора. Помните, размер страницы неуместен и должен устанавливаться равным 0 если регулятор используется для простого скалярного значения, например в GtkSpinButton.
Значение по умолчанию: 0
Начиная с версии 2.4
step-increment
""step-increment" gdouble : Read / Write
Шаг приращения регулятора.
Значение по умолчанию: 0
Начиная с версии 2.4
upper
""upper" gdouble : Read / Write
Максимальное значение регулятора.
Помните, это значение будет ограничено
upper - page-size
если параметр размера
страницы не ноль.
Значение по умолчанию: 0
Начиная с версии 2.4
value
""value" gdouble : Read / Write
Значение регулятора.
Значение по умолчанию: 0
Начиная с версии 2.4
void user_function (GtkAdjustment *adjustment, gpointer user_data) : Run first / No recursion
Издаётся при изменении одного или более полей GtkAdjustment, кроме поля значения.
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkAdjustment *adjustment, gpointer user_data) : Run first / No recursion
Издаётся при изменении поля значения GtkAdjustment.
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |