gtkrange

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

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

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`"