Spec-Zone.ru › GTK 3.20

GtkAdjustment

GtkAdjustment — Представление регулируемого значения в заданных пределах

Функции

GtkAdjustment * gtk_adjustment_new ()
gdouble gtk_adjustment_get_value ()
void gtk_adjustment_set_value ()
void gtk_adjustment_clamp_page ()
void gtk_adjustment_changed ()
void gtk_adjustment_value_changed ()
void gtk_adjustment_configure ()
gdouble gtk_adjustment_get_lower ()
gdouble gtk_adjustment_get_page_increment ()
gdouble gtk_adjustment_get_page_size ()
gdouble gtk_adjustment_get_step_increment ()
gdouble gtk_adjustment_get_minimum_increment ()
gdouble gtk_adjustment_get_upper ()
void gtk_adjustment_set_lower ()
void gtk_adjustment_set_page_increment ()
void gtk_adjustment_set_page_size ()
void gtk_adjustment_set_step_increment ()
void gtk_adjustment_set_upper ()

Свойства

gdouble нижняя_граница Чтение / Запись
gdouble приращение_страницы Чтение / Запись
gdouble размер_страницы Чтение / Запись
gdouble шаг_приращения Чтение / Запись
gdouble верхняя_граница Чтение / Запись
gdouble значение Чтение / Запись

Сигналы

void изменён Без рекурсии
void изменено_значение Без рекурсии

Типы и значения

GtkAdjustment

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkAdjustment

Включаемые файлы

#include <gtk/gtk.h>

Описание

Объект GtkAdjustment представляет значение с привязкой к нижней и верхней границам, а также шагами и размером страницы. Он используется в нескольких виджетах GTK+, включая GtkSpinButton, GtkViewport и GtkRange (который является базовым классом для GtkScrollbar и GtkScale).

Объект GtkAdjustment не обновляет значение самостоятельно. Вместо этого, владельцу объекта GtkAdjustment необходимо управлять значением.

Функции

gtk_adjustment_new ()

GtkAdjustment *
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

a GtkAdjustment

Возвращаемое значение

Текущее значение корректировки

gtk_adjustment_set_value ()

void
gtk_adjustment_set_value (GtkAdjustment *adjustment,
                          gdouble value);

Устанавливает значение GtkAdjustment. Значение ограничено диапазоном между “lower” и “upper”.

Обратите внимание, что для корректировок, используемых в GtkScrollbar, эффективный диапазон разрешённых значений находится от “lower” до “upper” - “page-size”.

Параметры

adjustment

a GtkAdjustment

value

новое значение

gtk_adjustment_clamp_page ()

void
gtk_adjustment_clamp_page (GtkAdjustment *adjustment,
                           gdouble lower,
                           gdouble upper);

Обновляет свойство “value”, чтобы гарантировать, что диапазон между lower и upper находится на текущей странице (т.е. между “value” и “value” + “page-size”). Если диапазон больше размера страницы, то только его начало будет на текущей странице.

Если значение изменено, будет выпущен сигнал “value-changed”.

Параметры

adjustment

a GtkAdjustment

lower

нижние значение

upper

верхнее значение

gtk_adjustment_changed ()

void
gtk_adjustment_changed (GtkAdjustment *adjustment);

gtk_adjustment_changed устарело начиная с версии 3.18 и не должно использоваться в новом коде.

GTK+ излучает “изменён” сам по себе всякий раз, когда изменяются любые свойства (кроме значения).

Излучает сигнал “изменён” от GtkAdjustment. Как правило, это вызывается владельцем GtkAdjustment после изменения любых свойств GtkAdjustment, кроме значения.

Параметры

adjustment

a GtkAdjustment

gtk_adjustment_value_changed ()

void
gtk_adjustment_value_changed (GtkAdjustment *adjustment);

gtk_adjustment_value_changed устарело начиная с версии 3.18 и не должно использоваться в новом коде.

GTK+ излучает “изменённое значение” сам по себе всякий раз, когда значение изменяется.

Излучает сигнал “изменённое значение” от GtkAdjustment. Как правило, это вызывается владельцем GtkAdjustment после изменения свойства “значение”.

Параметры

adjustment

a GtkAdjustment

gtk_adjustment_configure ()

void
gtk_adjustment_configure (GtkAdjustment *adjustment,
                          gdouble value,
                          gdouble lower,
                          gdouble upper,
                          gdouble step_increment,
                          gdouble page_increment,
                          gdouble page_size);

Устанавливает все свойства регулировки сразу.

Используйте эту функцию, чтобы избежать многократного излучения сигнала “изменён”. См. gtk_adjustment_set_lower() для альтернативного способа сжатия нескольких излучений “изменён” в один.

Параметры

adjustment

a GtkAdjustment

value

новое значение

lower

новое минимальное значение

upper

новое максимальное значение

step_increment

новый шаг увеличения

page_increment

новый шаг страницы

page_size

новый размер страницы

С: 2.14

gtk_adjustment_get_lower ()

gdouble
gtk_adjustment_get_lower (GtkAdjustment *adjustment);

Возвращает минимальное значение регулировки.

Параметры

adjustment

a GtkAdjustment

Возвращает

Текущее минимальное значение регулировки

С: 2.14

gtk_adjustment_get_page_increment ()

gdouble
gtk_adjustment_get_page_increment (GtkAdjustment *adjustment);

Возвращает приращение страницы корректировки.

Параметры

adjustment

a GtkAdjustment

Возвращаемое значение

Текущее приращение страницы корректировки

Since: 2.14

gtk_adjustment_get_page_size ()

gdouble
gtk_adjustment_get_page_size (GtkAdjustment *adjustment);

Возвращает размер страницы корректировки.

Параметры

adjustment

a GtkAdjustment

Возвращаемое значение

Текущий размер страницы корректировки

Since: 2.14

gtk_adjustment_get_step_increment ()

gdouble
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment);

Возвращает приращение шага корректировки.

Параметры

adjustment

a GtkAdjustment

Возвращаемое значение

Текущее приращение шага корректировки.

Since: 2.14

gtk_adjustment_get_minimum_increment ()

gdouble
gtk_adjustment_get_minimum_increment (GtkAdjustment *adjustment);

Возвращает меньшее из приращения шага и приращения страницы.

Параметры

adjustment

a GtkAdjustment

Возвращаемое значение

минимальное приращение adjustment

Since: 3.2

gtk_adjustment_get_upper ()

gdouble
gtk_adjustment_get_upper (GtkAdjustment *adjustment);

Возвращает максимальное значение корректировки.

Параметры

adjustment

a GtkAdjustment

Возвращаемое значение

Текущее максимальное значение корректировки

Since: 2.14

gtk_adjustment_set_lower ()

void
gtk_adjustment_set_lower (GtkAdjustment *adjustment,
                          gdouble lower);

Устанавливает минимальное значение регулировки.

При установке нескольких свойств регулировки с помощью отдельных методов установщиков, будет излучаться несколько сигналов “changed”. Однако, поскольку излучение сигнала “changed” связано с излучением сигналов “notify” изменённых свойств, можно сжать сигналы “changed” в один, вызвав g_object_freeze_notify() и g_object_thaw_notify() вокруг вызовов отдельных установщиков.

В качестве альтернативы, использование одного g_object_set() для всех свойств, которые нужно изменить, или использование gtk_adjustment_configure() имеет тот же эффект, что и сжатие излучений сигнала “changed”.

Параметры

adjustment

a GtkAdjustment

lower

новое минимальное значение

Since: 2.14

gtk_adjustment_set_page_increment ()

void
gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,
                                   gdouble page_increment);

Устанавливает шаг страницы регулировки.

См. gtk_adjustment_set_lower(), как сжать несколько излучений сигнала “changed” при установке нескольких свойств регулировки.

Параметры

adjustment

a GtkAdjustment

page_increment

новый шаг страницы

Since: 2.14

gtk_adjustment_set_page_size ()

void
gtk_adjustment_set_page_size (GtkAdjustment *adjustment,
                              gdouble page_size);

Устанавливает размер страницы регулировки.

См. gtk_adjustment_set_lower() о том, как сжать несколько излучений сигнала GtkAdjustment::changed при установке нескольких свойств регулировки.

Параметры

adjustment

a GtkAdjustment

page_size

новый размер страницы

Since: 2.14

gtk_adjustment_set_step_increment ()

void
gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,
                                   gdouble step_increment);

Устанавливает шаг регулировки.

См. gtk_adjustment_set_lower() о том, как сжать несколько излучений сигнала “changed” при установке нескольких свойств регулировки.

Параметры

adjustment

a GtkAdjustment

step_increment

новый шаг

Since: 2.14

gtk_adjustment_set_upper ()

void
gtk_adjustment_set_upper (GtkAdjustment *adjustment,
                          gdouble upper);

Устанавливает максимальное значение регулировки.

Обратите внимание, что значения будут ограничены upper - page-size , если свойство размера страницы не равно нулю.

См. gtk_adjustment_set_lower(), чтобы узнать, как сжать несколько срабатываний сигнала “изменён” при установке нескольких свойств регулировки.

Параметры

adjustment

a GtkAdjustment

upper

новое максимальное значение

С: 2.14

Типы и значения

GtkAdjustment

typedef struct _GtkAdjustment GtkAdjustment;

Структура GtkAdjustment содержит только закрытые поля и не должна использоваться напрямую.

Подробное описание свойств

Свойство “lower”

  “lower”                    gdouble

Минимальное значение регулировки.

Флаги: Чтение / Запись

Значение по умолчанию: 0

С: 2.4

Свойство “page-increment”

  “page-increment”           gdouble

Приращение страницы регулировки.

Флаги: Чтение / Запись

Значение по умолчанию: 0

С: 2.4

Свойство “page-size”

  “page-size”                gdouble

Размер страницы регулировки. Обратите внимание, что размер страницы не имеет значения и должен быть установлен в ноль, если регулировка используется для простого скалярного значения, например, в элементе GtkSpinButton.

Флаги: Чтение / Запись

Значение по умолчанию: 0

С: 2.4

Свойство “step-increment”

  “step-increment”           gdouble

Приращение шага регулировки.

Флаги: Чтение / Запись

Значение по умолчанию: 0

С: 2.4

Свойство “upper”

  “upper”                    gdouble

Максимальное значение регулировки. Обратите внимание, что значения будут ограничены upper - page-size , если свойство размера страницы не равно нулю.

Флаги: Чтение / Запись

Значение по умолчанию: 0

С: 2.4

Свойство “value”

  “value”                    gdouble

Значение регулировки.

Флаги: Чтение / Запись

Значение по умолчанию: 0

С: 2.4

Подробное описание сигналов

Сигнал “changed”

void
user_function (GtkAdjustment *adjustment,
               gpointer       user_data)

Выдаётся, когда одно или несколько свойств GtkAdjustment были изменены, за исключением свойства “значение”.

Параметры

adjustment

объект, получивший сигнал

user_data

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

Флаги: Без рекурсии

Сигнал “value-changed”

void
user_function (GtkAdjustment *adjustment,
               gpointer       user_data)

Выдаётся, когда свойство “значение” было изменено.

Параметры

adjustment

объект, получивший сигнал

user_data

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

Флаги: Без рекурсии

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkAdjustment.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API