Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkAdjustment

GtkAdjustment 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" соответственно.

Детали

GtkAdjustment

typedef struct _GtkAdjustment GtkAdjustment;

Структура GtkAdjustment содержит следующие поля.

gdouble lower;

Минимальное значение.

gdouble upper;

Максимальное значение.

gdouble value;

Текущее значение.

gdouble step_increment;

Приращение используемое для минимального изменения значения. В GtkScrollbar это приращение используется когда мышкой нажимают на стрелки верхней и нижней кнопки панели прокручивания, для прокрутки минимального промежутка.

gdouble page_increment;

Приращение используемое для максимально возможного изменения значения. В GtkScrollbar это приращение используется при нажатии мышкой в колее ползунка, для прокручивания на максимально возможное расстояние.

gdouble page_size;

Размер страницы. В GtkScrollbar это размер текущемй видимой области.


gtk_adjustment_new ()

GtkObject* 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 :

GtkAdjustment

Возвращает :

Текущее значение регуллятора.


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.

adjustment :

GtkAdjustment.

value :

Новое значение.


gtk_adjustment_clamp_page ()

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

Обновляет GtkAdjustment value для утверждения диапазона между lower и upper в текущемй странице (то есть между value и value + page_size). Если диапазон меньше размера страницы, то только его начало будет в текущемй странице. Сигнал "changed" издаётся при изменении значения.

adjustment :

GtkAdjustment.

lower :

Наименьшее значение.

upper :

Наибольшее значение.


gtk_adjustment_changed ()

void        gtk_adjustment_changed          (GtkAdjustment *adjustment);

Издаёт сигнал "changed" из GtkAdjustment. Обычно вызывается владельцем GtkAdjustment после изменения любого поля GtkAdjustment кроме значения.

adjustment :

GtkAdjustment


gtk_adjustment_value_changed ()

void        gtk_adjustment_value_changed    (GtkAdjustment *adjustment);

Издаёт сигнал "value_changed" из GtkAdjustment. Обычно вызывается владельцем GtkAdjustment после изменения поля значения GtkAdjustment.

adjustment :

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

Детали сигналов

Сигнал "changed"

void user_function (GtkAdjustment *adjustment, gpointer user_data) : Run first / No recursion

Издаётся при изменении одного или более полей GtkAdjustment, кроме поля значения.

adjustment :

Объект получающий сигнал.

user_data :

Данные помещаемые при подключении обработчика сигнала.


Сигнал "value-changed"

void user_function (GtkAdjustment *adjustment, gpointer user_data) : Run first / No recursion

Издаётся при изменении поля значения GtkAdjustment.

adjustment :

Объект получающий сигнал.

user_data :

Данные помещаемые при подключении обработчика сигнала.