GtkRange

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

			GTK+ Reference Manual
Top \| Description \| Object Hierarchy \| Implemented Interfaces \| Properties \| Style Properties \| Signals

GtkRange

GtkRange Базовый класс для виджетов которые визуализируют регулировки

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

#include <gtk/gtk.h>


            GtkRange;
GtkAdjustment* gtk_range_get_adjustment     (GtkRange *range);
void        gtk_range_set_update_policy     (GtkRange *range,
                                             GtkUpdateType policy);
void        gtk_range_set_adjustment        (GtkRange *range,
                                             GtkAdjustment *adjustment);

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

GtkUpdateType gtk_range_get_update_policy   (GtkRange *range);
gdouble     gtk_range_get_value             (GtkRange *range);
void        gtk_range_set_increments        (GtkRange *range,
                                             gdouble step,
                                             gdouble page);
void        gtk_range_set_range             (GtkRange *range,
                                             gdouble min,
                                             gdouble max);
void        gtk_range_set_value             (GtkRange *range,
                                             gdouble value);
enum        GtkSensitivityType;
void        gtk_range_set_lower_stepper_sensitivity

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

                                            (GtkRange *range,
                                             GtkSensitivityType sensitivity);
GtkSensitivityType gtk_range_get_upper_stepper_sensitivity
                                            (GtkRange *range);

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

  GObject
   +----GInitiallyUnowned
         +----GtkObject

               +----GtkWidget
                     +----GtkRange
                           +----GtkScale
                           +----GtkScrollbar

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

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

Свойства

  "adjustment"           GtkAdjustment         : Read / Write / Construct
  "inverted"             gboolean              : Read / Write
  "lower-stepper-sensitivity" GtkSensitivityType    : Read / Write
  "update-policy"        GtkUpdateType         : Read / Write
  "upper-stepper-sensitivity" GtkSensitivityType    : Read / Write

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

  "activate-slider"      gboolean              : Read
  "arrow-displacement-x" gint                  : Read
  "arrow-displacement-y" gint                  : Read
  "slider-width"         gint                  : Read
  "stepper-size"         gint                  : Read
  "stepper-spacing"      gint                  : Read
  "trough-border"        gint                  : Read
  "trough-side-details"  gboolean              : Read
  "trough-under-steppers" gboolean              : Read

Сигналы

"adjust-bounds"
            void        user_function      (GtkRange *range,
                                            gdouble   arg1,
                                            gpointer  user_data)      : Run last
"change-value"
            gboolean    user_function      (GtkRange     *range,
                                            GtkScrollType scroll,
                                            gdouble       value,
                                            gpointer      user_data)      : Run last
"move-slider"
            void        user_function      (GtkRange     *range,
                                            GtkScrollType arg1,
                                            gpointer      user_data)      : Run last / Action
"value-changed"
            void        user_function      (GtkRange *range,
                                            gpointer  user_data)      : Run last

Описание

Детали

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

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2025 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

GtkRange

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

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

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

Свойства

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

Сигналы

Описание

Детали

GtkRange

gtk_range_get_adjustment ()

gtk_range_set_update_policy ()

gtk_range_set_adjustment ()

gtk_range_get_inverted ()

gtk_range_set_inverted ()

gtk_range_get_update_policy ()

gtk_range_get_value ()

gtk_range_set_increments ()

gtk_range_set_range ()

gtk_range_set_value ()

enum GtkSensitivityType

gtk_range_set_lower_stepper_sensitivity ()

gtk_range_get_lower_stepper_sensitivity ()

gtk_range_set_upper_stepper_sensitivity ()

gtk_range_get_upper_stepper_sensitivity ()

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

Свойство "adjustment"

Свойство "inverted" property

Свойство "lower-stepper-sensitivity"

Свойство "update-policy"

Свойство "upper-stepper-sensitivity"

Детали свойств стиля

Свойство стиля "activate-slider"

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

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

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

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

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

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

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

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

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

Сигнал "adjust-bounds"

Сигнал "change-value"

Сигнал "move-slider"

Сигнал "value-changed"

Свойство "`adjustment`"

Свойство "`inverted`" property

Свойство "`lower-stepper-sensitivity`"

Свойство "`update-policy`"

Свойство "`upper-stepper-sensitivity`"

Свойство стиля "`activate-slider`"

Свойство стиля "`arrow-displacement-x`"

Свойство стиля "`arrow-displacement-y`"

Свойство стиля "`slider-width`"

Свойство стиля "`stepper-size`"

Свойство стиля "`stepper-spacing`"

Свойство стиля "`trough-border`"

Свойство стиля "`trough-side-details`"

Свойство стиля "`trough-under-steppers`"