| Каталог документации / Раздел "Программирование, языки" / Оглавление документа |
| |
|
|
|
|
|
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 recursionGtkAdjustment - объект, представляющий значение которое имеет верхнюю и нижнюю границу, вместе с шагом приращения страницы и её размером. Он используется в нескольких виджетах 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 Добавить, Поддержать, Вебмастеру |