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

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

Свойства

Сигналы

Описание

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 :
		
		

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