The OpenNET Project / Index page

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

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

Prev

Up

Home

GTK+ Reference Manual

Next

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 :

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






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

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