The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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 :

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






Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру