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

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

Реализуемые интерфейсы

GtkRange реализует AtkImplementorIface.

Свойства

Свойства тиля

Сигналы

Описание

Детали

GtkRange

typedef struct _GtkRange GtkRange;

gtk_range_get_adjustment ()
GtkAdjustment* gtk_range_get_adjustment     (GtkRange *range);

Определяет GtkAdjustment
который является "шаблоном" объекта
для GtkRange. Смотрите
gtk_range_set_adjustment()
для подробностей. Возвращаемое значение
не имеет дополнительных ссылок, поэтому
не должно освобождаться.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
Возвращает :
		
		

			
GtkAdjustment 
			
		
	


gtk_range_set_update_policy ()
void        gtk_range_set_update_policy     (GtkRange *range,
                                             GtkUpdateType policy);

Устанавливает политику обновления для
диапазона. GTK_UPDATE_CONTINUOUS означает, что
при любом перемещении слайдера изменяется
значение диапазона и издаётся сигнал
value_changed. GTK_UPDATE_DELAYED означает, что будет
обновлено после короткой паузы когда
не происходит движение слайдера, таким
образом обновление происходит короткими
промежутками, а не непрерывно.
GTK_UPDATE_DISCONTINUOUS означает, что обновление
будет происходить только когда
пользователь отпустит слайдер после
операции перемещения.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
policy :
		
		

			
Политика обновления 
			
		
	


gtk_range_set_adjustment ()
void        gtk_range_set_adjustment        (GtkRange *range,
                                             GtkAdjustment *adjustment);

Устанавливает настройки используемые
как "шаблон" объекта для этого
виджета диапазона. Настройки указывают
текущеме значение диапазона, минимум и
максимум диапазона, пошаговое/постраничное
увеличение используемое для привязки
клавиш и для прокручивания, а также
размер страницы. Размер страницы, обычно
0 для GtkScale и не ноль для
GtkScrollbar, указывает
размер видимой, прокручиваемой области
виджета. Размер страницы влияет на
размер слайдера.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
adjustment :
		
		

			
GtkAdjustment 
			
		
	


gtk_range_get_inverted ()
gboolean    gtk_range_get_inverted          (GtkRange *range);

Определяет значение установленное с
помощью gtk_range_set_inverted().

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
Возвращает :
		
		

			
TRUE
			если диапазон инвертирован
		
	


gtk_range_set_inverted ()
void        gtk_range_set_inverted          (GtkRange *range,
                                             gboolean setting);

Обычный диапазон перемещение от нижнего
до верхнего значения соответствует
перемещению слайдера сверху вниз или
слева на право. У инвертированного
диапазона всё наоборот, то есть снизу вверх
или с право на лево.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
setting :
		
		

			
TRUE
			для инвертированного диапазона 
			
		
	


gtk_range_get_update_policy ()
GtkUpdateType gtk_range_get_update_policy   (GtkRange *range);

Определяет политику обновления range.
Смотрите gtk_range_set_update_policy().

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
Возвращает :
		
		

			
текущая политика обновления 
			
		
	


gtk_range_get_value ()
gdouble     gtk_range_get_value             (GtkRange *range);

Определяет текущеме значение диапазона.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
Возвращает :
		
		

			
Текущее значение диапазона.
		
	


gtk_range_set_increments ()
void        gtk_range_set_increments        (GtkRange *range,
                                             gdouble step,
                                             gdouble page);

Устанавливает шаг и страницу для
диапазона. Размер шага используется
когда пользователь нажимает стрелки
на шкале прокручивания GtkScrollbar
или перемещает GtkScale с
помощью клавиатурных стрелок. Страничная
прокрутка используется, например, когда
перемещение выполняется с помощью
клавиш Page Up или Page Down.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
step :
		
		

			
Размер шага 
			
		
	
	

		

			
page :
		
		

			
Размер страничного прокручивания 
			
		
	


gtk_range_set_range ()
void        gtk_range_set_range             (GtkRange *range,
                                             gdouble min,
                                             gdouble max);

Устанавливает допустимые значения в
GtkRange, и фиксирует значение
диапазона между min и max.
(Если диапазон имеет не  нулевой размер
страницы, он фиксируется между min
и max  размера страницы.)

	
	
	

		

			
range :
		
		

			
 GtkRange 
			
		
	
	

		

			
min :
		
		

			
Минимальное значение диапазона 
			
		
	
	

		

			
max :
		
		

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


gtk_range_set_value ()
void        gtk_range_set_value             (GtkRange *range,
                                             gdouble value);

Устанавливает текущеме значение диапазона;
если значение выходит за минимум или
максимум диапазона, он будет зафиксирован
в соответствующих пределах. Диапазон
издаёт сигнал "value_changed" если значение
изменяется.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
value :
		
		

			
Новое значение диапазона 
			
		
	


enum GtkSensitivityType
typedef enum
{
  GTK_SENSITIVITY_AUTO,
  GTK_SENSITIVITY_ON,
  GTK_SENSITIVITY_OFF
} GtkSensitivityType;

Описывает как GTK+ обрабатывает
чувствительность пошаговых стрелок на
концах виджета. 


	
	
	

		

			
GTK_SENSITIVITY_AUTO
		
		

			
Стрелка становится не чувствительной
			если слайдер находится в самом конце
			шкалы. 
			
		
	
	

		

			
GTK_SENSITIVITY_ON
		
		

			
Стрелки всегда чувствительны.
		
	
	

		

			
GTK_SENSITIVITY_OFF
		
		

			
Стрелки всегда не чувствительны. 
			
		
	


gtk_range_set_lower_stepper_sensitivity ()
void        gtk_range_set_lower_stepper_sensitivity
                                            (GtkRange *range,
                                             GtkSensitivityType sensitivity);

Устанавливает политику чувствительности
для пошаговой прокрутки указывающей в
'нижний' конец GtkRange's настроек.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
sensitivity :
		
		

			
Политика нисходящей пошаговой
			прокрутки. 
			
		
	

Начиная с версии 2.10 


gtk_range_get_lower_stepper_sensitivity ()
GtkSensitivityType gtk_range_get_lower_stepper_sensitivity
                                            (GtkRange *range);

Определяет политику чувствительности
для пошаговой прокрутки указывающей в
'нижний' конец GtkRange's настроек.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
Возвращает :
		
		

			
Политика нисходящей пошаговой
			прокрутки. 
			
		
	

Начиная с версии 2.10 


gtk_range_set_upper_stepper_sensitivity ()
void        gtk_range_set_upper_stepper_sensitivity
                                            (GtkRange *range,
                                             GtkSensitivityType sensitivity);

Устанавливает политику чувствительности
для пошаговой прокрутки указывающей в
'высший' конец GtkRange's настроек.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
sensitivity :
		
		

			
Политика восходящей пошаговой
			прокрутки. 
			
		
	

Начиная с версии 2.10 


gtk_range_get_upper_stepper_sensitivity ()
GtkSensitivityType gtk_range_get_upper_stepper_sensitivity
                                            (GtkRange *range);

Определяет политику чувствительности
для пошаговой прокрутки указывающей в
'высший' конец GtkRange's настроек.

	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
Возвращает :
		
		

			
Политика восходящей пошаговой
			прокрутки. 
			
		
	

Начиная с версии 2.10 

Детали свойств
Свойство "adjustment"
  "adjustment"           GtkAdjustment         : Read / Write / Construct

 GtkAdjustment который содержит текущие
значения объекта диапазона.

Свойство "inverted" property
  "inverted"             gboolean              : Read / Write

Обратное направление изменения значений
диапазона при перемещении слайдера.
Значение по умолчанию: FALSE

Свойство "lower-stepper-sensitivity"
  "lower-stepper-sensitivity" GtkSensitivityType    : Read / Write

Политика чувствительности для пошагового
понижения.
Значение по умолчанию: GTK_SENSITIVITY_AUTO

Свойство "update-policy"
  "update-policy"        GtkUpdateType         : Read / Write

Как диапазон должен обновлять экран.
Значение по умолчанию: GTK_UPDATE_CONTINUOUS

Свойство "upper-stepper-sensitivity"
  "upper-stepper-sensitivity" GtkSensitivityType    : Read / Write

Политика пошагового увеличения.
Значение по умолчанию: GTK_SENSITIVITY_AUTO
Детали свойств стиля
Свойство стиля "activate-slider"
  "activate-slider"      gboolean              : Read

При установки этой опции в значение
TRUE, слайдеры рисуются активными (ACTIVE) и
с затенением при перемещении.
Значение по умолчанию: FALSE

Свойство стиля "arrow-displacement-x"
  "arrow-displacement-x" gint                  : Read

Как далеко перемещать в направлении x
при нажатии кнопки.
Значение по умолчанию: 0

Свойство стиля "arrow-displacement-y"
  "arrow-displacement-y" gint                  : Read

Как далеко перемещать в направлении y
при нажатии кнопки.
Значение по умолчанию: 0

Свойство стиля "slider-width"
  "slider-width"         gint                  : Read

Ширина полосы прокручивания или слайдера.
Допустимые значения: >= 0
Значение по умолчанию: 14

Свойство стиля "stepper-size"
  "stepper-size"         gint                  : Read

Размер пошаговых кнопок на концах.
Допустимые значения: >= 0
Значение по умолчанию: 14

Свойство стиля "stepper-spacing"
  "stepper-spacing"      gint                  : Read

Интервал между пошаговыми кнопками и
слайдером. Помните, что установка
значения больше нуля, автоматически
установит свойство стиля trough-under-steppers
в значение TRUE. Кроме того, stepper-spacing не
будет иметь эффекта если нет пошаговых
кнопок.
Допустимые значения: >= 0
Значение по умолчанию: 0

Свойство стиля "trough-border"
  "trough-border"        gint                  : Read

Интервал между слайдером/пошаговыми-кнопками
и внешними скосами колеи.
Допустимые значения: >= 0
Значение по умолчанию: 1

Свойство стиля "trough-side-details"
  "trough-side-details"  gboolean              : Read

Значение по умолчанию: FALSE
Начиная с версии 2.10 


Свойство стиля "trough-under-steppers"
  "trough-under-steppers" gboolean              : Read

Отрисовывать ли колею диапазона через
пошаговые кнопки и их интервал. Помните,
установка свойства стиля stepper-spacing в
значение больше ноля, автоматически
включит trough-under-steppers.
Значение по умолчанию: TRUE
Начиная с версии 2.10 

Детали сигналов
Сигнал "adjust-bounds"
void        user_function                  (GtkRange *range,
                                            gdouble   arg1,
                                            gpointer  user_data)      : Run last

	
	
	

		

			
range :
		
		

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

		

			
arg1 :
		
		

	
	

		

			
user_data :
		
		

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


Сигнал "change-value"
gboolean    user_function                  (GtkRange     *range,
                                            GtkScrollType scroll,
                                            gdouble       value,
                                            gpointer      user_data)      : Run last

Сигнал ::change-value издаётся когда выполняется
действие прокручивания диапазона. Это
позволяет приложениям определять тип
события прокручивания, которое произошло
и результат нового значения. Приложения
могут обработать событие самостоятельно
и вернуть TRUE
для предотвращения дальнейшей обработки.
Или вернуть FALSE,
это передаст событие другим обработчикам.

Значение параметра не округляется.
Приложения переписывающие сигнал
::change-value, отвечают за определение
количества десятичных; по умолчанию
обработчик GTK+ фиксирует значение
основываясь на range->round_digits.

Ииспользовать промежуточную политику
обновления не возможно в отменённом
::change-value обработчике.

	
	
	

		

			
range :
		
		

			
Диапазон получающий сигнал. 
			
		
	
	

		

			
scroll :
		
		

			
Тип выполненного действия прокручивания.
						
		
	
	

		

			
value :
		
		

			
Новое значение в результате действия
			прокручивания. 
			
		
	
	

		

			
Возвращает :
		
		

			
TRUE
			препятствует вызову других обработчиков
			сигнала. FALSE
			для распространения сигнала в будущем.
						
		
	
	

		

			
user_data :
		
		

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

Начиная с версии 2.6 


Сигнал "move-slider"
void        user_function                  (GtkRange     *range,
                                            GtkScrollType arg1,
                                            gpointer      user_data)      : Run last / Action

Виртуальная функция перемещения
слайдера. Используется клавиатурными
привязками. 


	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
arg1 :
		
		

	
	

		

			
user_data :
		
		

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


Сигнал "value-changed"
void        user_function                  (GtkRange *range,
                                            gpointer  user_data)      : Run last

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


	
	
	

		

			
range :
		
		

			
GtkRange 
			
		
	
	

		

			
user_data :
		
		

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