Spec-Zone.ru › GTK 3.22

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 lower Чтение / Запись
gdouble page-increment Чтение / Запись
gdouble page-size Чтение / Запись
gdouble step-increment Чтение / Запись
gdouble upper Чтение / Запись
gdouble value Чтение / Запись

Сигналы

void changed Без рекурсии
void value-changed Без рекурсии

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

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+ сам излучает “changed”, когда изменяются любые свойства (кроме значения)

Выпускает сигнал “changed” от GtkAdjustment. Это обычно вызывается владельцем GtkAdjustment после изменения свойств GtkAdjustment, кроме значения.

Параметры

adjustment

a GtkAdjustment

gtk_adjustment_value_changed ()

void
gtk_adjustment_value_changed (GtkAdjustment *adjustment);

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

GTK+ сам излучает “value-changed”, когда изменяется значение

Выпускает сигнал “value-changed” от GtkAdjustment. Это обычно вызывается владельцем GtkAdjustment после изменения свойства “value”.

Параметры

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);

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

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

Параметры

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

объект GtkAdjustment

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

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

С: 2.14

gtk_adjustment_get_page_size ()

gdouble
gtk_adjustment_get_page_size (GtkAdjustment *adjustment);

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

Параметры

adjustment

объект GtkAdjustment

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

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

С: 2.14

gtk_adjustment_get_step_increment ()

gdouble
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment);

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

Параметры

adjustment

объект GtkAdjustment

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

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

С: 2.14

gtk_adjustment_get_minimum_increment ()

gdouble
gtk_adjustment_get_minimum_increment (GtkAdjustment *adjustment);

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

Параметры

adjustment

объект GtkAdjustment

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

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

С: 3.2

gtk_adjustment_get_upper ()

gdouble
gtk_adjustment_get_upper (GtkAdjustment *adjustment);

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

Параметры

adjustment

объект GtkAdjustment

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

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

С: 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

объект GtkAdjustment

lower

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

С: 2.14

gtk_adjustment_set_page_increment ()

void
gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,
                                   gdouble page_increment);

Устанавливает значение приращения страницы для корректировки.

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

Параметры

adjustment

объект GtkAdjustment

page_increment

новое значение приращения страницы

С: 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

объект GtkAdjustment

page_size

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

С: 2.14

gtk_adjustment_set_step_increment ()

void
gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,
                                   gdouble step_increment);

Устанавливает значение приращения шага корректировки.

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

Параметры

adjustment

объект GtkAdjustment

step_increment

новое значение приращения шага

С: 2.14

gtk_adjustment_set_upper ()

void
gtk_adjustment_set_upper (GtkAdjustment *adjustment,
                          gdouble upper);

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

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

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

Параметры

adjustment

объект 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, кроме свойства “value”.

Параметры

adjustment

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

user_data

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

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

Сигнал “value-changed”

void
user_function (GtkAdjustment *adjustment,
               gpointer       user_data)

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

Параметры

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.22/GtkAdjustment.html

Spec-Zone.ru

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