GtkScaleButton
GtkScaleButton — Кнопка, которая отображает шкалу
Функции
Свойства
| GtkAdjustment * | adjustment | Чтение/Запись |
| GStrv | icons | Чтение/Запись |
| GtkIconSize | size | Чтение/Запись |
| gdouble | value | Чтение/Запись |
Сигналы
| void | popdown | Действие |
| void | popup | Действие |
| void | value-changed | Выполнить последним |
Типы и значения
| struct | GtkScaleButton |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkButton ╰── GtkScaleButton ╰── GtkVolumeButton
Реализованные интерфейсы
GtkScaleButton реализует AtkImplementorIface, GtkBuildable, GtkActionable, GtkActivatable и GtkOrientable.
Включения
#include <gtk/gtk.h>
Описание
GtkScaleButton предоставляет кнопку, которая отображает виджет шкалы. Этот виджет обычно используется для управления громкостью в мультимедийных приложениях, и GTK+ предоставляет подкласс GtkVolumeButton, который настроен для этого случая.
CSS узлы
GtkScaleButton имеет один CSS узел с именем button. Для отличия от обычной GtkButton он получает класс стиля .scale.
Функции
gtk_scale_button_new ()
GtkWidget * gtk_scale_button_new (GtkIconSize size,gdouble min,gdouble max,gdouble step,const gchar **icons);
Создаёт GtkScaleButton с диапазоном от min до max и шагом step.
Параметры
size | размер значка (GtkIconSize). | [type int] |
min | минимальное значение шкалы (обычно 0) | |
max | максимальное значение шкалы (обычно 100) | |
step | шаг изменения значения при событии прокрутки колёсика мыши или нажатии стрелок вверх/вниз (обычно 2) | |
icons | массив имён значков, завершённый | [allow-none][array zero-terminated=1] |
Возвращаемое значение
новый GtkScaleButton
С: 2.12
gtk_scale_button_set_adjustment ()
void gtk_scale_button_set_adjustment (GtkScaleButton *button,GtkAdjustment *adjustment);
Устанавливает GtkAdjustment в качестве модели для шкалы GtkScaleButton. Подробнее см. gtk_range_set_adjustment().
Параметры
button | ||
adjustment |
С: 2.12
gtk_scale_button_set_icons ()
void gtk_scale_button_set_icons (GtkScaleButton *button,const gchar **icons);
Устанавливает значки, используемые кнопкой шкалы. Подробнее см. свойство “icons”.
Параметры
button | ||
icons | массив имён значков, завершённый | [array zero-terminated=1] |
С: 2.12
gtk_scale_button_set_value ()
void gtk_scale_button_set_value (GtkScaleButton *button,gdouble value);
Устанавливает текущее значение шкалы; если значение находится вне диапазона минимального и максимального значений, оно будет ограничено диапазоном. Кнопка шкалы генерирует сигнал “value-changed”, если значение изменилось.
Параметры
button | ||
value | новое значение кнопки шкалы |
С: 2.12
gtk_scale_button_get_adjustment ()
GtkAdjustment *
gtk_scale_button_get_adjustment (GtkScaleButton *button); Возвращает GtkAdjustment, связанный со шкалой GtkScaleButton. Подробнее см. gtk_range_get_adjustment().
Параметры
button |
Возвращаемое значение
связанная настройка.
[transfer none]
С: 2.12
gtk_scale_button_get_value ()
gdouble
gtk_scale_button_get_value (GtkScaleButton *button); Возвращает текущее значение кнопки шкалы.
Параметры
button |
Возвращаемое значение
текущее значение кнопки шкалы
С: 2.12
gtk_scale_button_get_popup ()
GtkWidget *
gtk_scale_button_get_popup (GtkScaleButton *button); Возвращает всплывающее меню GtkScaleButton.
Параметры
button |
С: 2.14
gtk_scale_button_get_plus_button ()
GtkWidget *
gtk_scale_button_get_plus_button (GtkScaleButton *button); Возвращает кнопку «плюс» GtkScaleButton.
Параметры
button |
С: 2.14
gtk_scale_button_get_minus_button ()
GtkWidget *
gtk_scale_button_get_minus_button (GtkScaleButton *button); Возвращает кнопку «минус» GtkScaleButton.
Параметры
button |
С: 2.14
Типы и значения
struct GtkScaleButton
struct GtkScaleButton;
Подробные сведения о свойствах
Свойство “adjustment”
“adjustment” GtkAdjustment *
GtkAdjustment, содержащий текущее значение этого объекта кнопки масштаба.
Флаги: Чтение/Запись
Свойство “icons”
“icons” GStrv
Имена значков, которые будут использоваться кнопкой масштаба. Первый элемент массива будет использоваться в кнопке, когда текущее значение является минимальным, второй элемент — для максимального значения. Все последующие значки будут использоваться для всех остальных значений, равномерно распределяясь по диапазону значений.
Если в массиве icons содержится только одно имя значка, оно будет использоваться для всех значений. Если в массиве icons содержатся только два имени значков, первый будет использоваться для нижних 50% шкалы, а второй — для верхних 50%.
Рекомендуется использовать как минимум 3 значка, чтобы GtkScaleButton лучше отражал текущее значение шкалы для пользователей.
Флаги: Чтение/Запись
С версии 2.12
Свойство “size”
“size” GtkIconSize
Размер значка.
Флаги: Чтение/Запись
Значение по умолчанию: GTK_ICON_SIZE_SMALL_TOOLBAR
Подробные сведения о сигналах
Сигнал “popdown”
void user_function (GtkScaleButton *button, gpointer user_data)
Сигнал ::popdown — это сигнал привязки клавиш, который генерируется для скрытия виджета шкалы.
Стандартная привязка для этого сигнала — клавиша Escape.
Параметры
button | объект, получивший сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Действие
С версии 2.12
Сигнал “popup”
void user_function (GtkScaleButton *button, gpointer user_data)
Сигнал ::popup — это сигнал привязки клавиш, который генерируется для отображения виджета шкалы.
Стандартные привязки для этого сигнала — пробел, Enter и Return.
Параметры
button | объект, получивший сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Действие
С версии 2.12
Сигнал “value-changed”
void user_function (GtkScaleButton *button, gdouble value, gpointer user_data)
Сигнал ::value-changed генерируется, когда значение поля изменилось.
Параметры
button | объект, получивший сигнал | |
value | новое значение | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнять последним
С версии 2.12
© 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/GtkScaleButton.html
