gtkadjustment

			gtk+ reference manual
top \| description \| object hierarchy \| properties \| signals

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` :	данные помещаемые при подключении обработчика сигнала.

gtkadjustment

краткое описание

иерархия объектов

свойства

сигналы

описание

детали

gtkadjustment

gtk_adjustment_new ()

gtk_adjustment_get_value ()

gtk_adjustment_set_value ()

gtk_adjustment_clamp_page ()

gtk_adjustment_changed ()

gtk_adjustment_value_changed ()

детали свойств

свойство "lower"

свойство "page-increment"

свойство "page-size"

свойство "step-increment"

свойство "upper"

свойство "value"

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

сигнал "changed"

сигнал "value-changed"

свойство "`lower`"

свойство "`page-increment`"

свойство "`page-size`"

свойство "`step-increment`"

свойство "`upper`"

свойство "`value`"