GtkScaleButton
GtkScaleButton — Кнопка, которая отображает шкалу
Функции
Свойства
| GtkAdjustment * | adjustment | Чтение/Запись |
| GStrv | icons | Чтение/Запись |
| double | value | Чтение/Запись |
Сигналы
| void | popdown | Действие |
| void | popup | Действие |
| void | value-changed | Выполнить последним |
Типы и значения
| struct | GtkScaleButton |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkScaleButton
╰── GtkVolumeButton
Реализованные интерфейсы
GtkScaleButton реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkOrientable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkScaleButton предоставляет кнопку, которая отображает виджет шкалы. Этот виджет обычно используется для управления громкостью в мультимедийных приложениях, и GTK предоставляет подкласс GtkVolumeButton, который оптимизирован для этого случая.
Узлы CSS
GtkScaleButton имеет один узел CSS с именем button. Для отличия от обычной кнопки GtkButton он получает класс стиля .scale.
Функции
gtk_scale_button_new ()
GtkWidget * gtk_scale_button_new (double min,double max,double step,const char **icons);
Создаёт GtkScaleButton с диапазоном от min до max и шагом step.
Параметры
min | минимальное значение шкалы (обычно 0) | |
max | максимальное значение шкалы (обычно 100) | |
step | шаг изменения значения при прокрутке колёсиком или нажатии стрелок вверх/вниз (обычно 2) | |
icons | массив имён значков, завершённый нулём, или | [allow-none][array zero-terminated=1] |
Возвращаемое значение
новый GtkScaleButton
gtk_scale_button_set_adjustment ()
void gtk_scale_button_set_adjustment (GtkScaleButton *button,GtkAdjustment *adjustment);
Устанавливает GtkAdjustment в качестве модели для шкалы GtkScaleButton. Подробности см. в gtk_range_set_adjustment().
Параметры
button | ||
adjustment |
gtk_scale_button_set_icons ()
void gtk_scale_button_set_icons (GtkScaleButton *button,const char **icons);
Устанавливает значки, которые будут использоваться кнопкой шкалы. Подробности см. в свойстве “значки”.
Параметры
button | ||
icons | массив имён значков, завершённый нулём. | [array zero-terminated=1] |
gtk_scale_button_set_value ()
void gtk_scale_button_set_value (GtkScaleButton *button,double value);
Устанавливает текущее значение шкалы; если значение выходит за пределы диапазона минимального и максимального значений, оно будет ограничено, чтобы уместиться в них. Кнопка шкалы генерирует сигнал “изменение значения”, если значение изменяется.
Параметры
button | ||
value | новое значение кнопки шкалы |
gtk_scale_button_get_adjustment ()
GtkAdjustment *
gtk_scale_button_get_adjustment (GtkScaleButton *button); Получает GtkAdjustment, связанный со шкалой GtkScaleButton. Подробности см. в gtk_range_get_adjustment().
Параметры
button |
Возвращаемое значение
регулировка, связанная со шкалой.
[transfer none]
gtk_scale_button_get_value ()
double
gtk_scale_button_get_value (GtkScaleButton *button); Получает текущее значение кнопки шкалы.
Параметры
button |
Возвращаемое значение
текущее значение кнопки шкалы
gtk_scale_button_get_popup ()
GtkWidget *
gtk_scale_button_get_popup (GtkScaleButton *button); Возвращает всплывающее меню GtkScaleButton.
Параметры
button |
gtk_scale_button_get_plus_button ()
GtkWidget *
gtk_scale_button_get_plus_button (GtkScaleButton *button); Возвращает кнопку «плюс» GtkScaleButton.
Параметры
button |
gtk_scale_button_get_minus_button ()
GtkWidget *
gtk_scale_button_get_minus_button (GtkScaleButton *button); Возвращает кнопку «минус» GtkScaleButton.
Параметры
button |
Типы и значения
struct GtkScaleButton
struct GtkScaleButton;
Подробности свойств
Свойство “adjustment”
“adjustment” GtkAdjustment *
GtkAdjustment, содержащий текущее значение этого объекта кнопки масштабирования.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
Свойство “icons”
“icons” GStrv
Имена значков, которые будут использоваться кнопкой масштабирования. Первый элемент массива будет использоваться в кнопке, когда текущее значение является минимальным, второй — для максимального значения. Все последующие значки будут использоваться для всех остальных значений, равномерно распределенных по диапазону значений.
Если в массиве icons указано только одно имя значка, оно будет использоваться для всех значений. Если в массиве icons указаны только два имени значков, первое будет использоваться для нижних 50% шкалы, а второе — для верхних 50%.
Рекомендуется использовать как минимум 3 значка, чтобы GtkScaleButton лучше отображал текущее значение шкалы для пользователей.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
Свойство “value”
“value” double
Значение шкалы.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
Значение по умолчанию: 0
Подробности сигналов
Сигнал “popdown”
void user_function (GtkScaleButton *button, gpointer user_data)
Сигнал ::popdown — это сигнал для привязки клавиш, который генерируется для скрытия виджета шкалы.
Стандартная привязка для этого сигнала — Escape.
Параметры
button | объект, получивший сигнал | |
user_data | пользовательские данные, заданные при подключении обработчика сигнала. |
Флаги: Действие
Сигнал “popup”
void user_function (GtkScaleButton *button, gpointer user_data)
Сигнал ::popup — это сигнал для привязки клавиш, который генерируется для отображения виджета шкалы.
Стандартные привязки для этого сигнала — Space, Enter и Return.
Параметры
button | объект, получивший сигнал | |
user_data | пользовательские данные, заданные при подключении обработчика сигнала. |
Флаги: Действие
Сигнал “value-changed”
void user_function (GtkScaleButton *button, double value, gpointer user_data)
Сигнал ::value-changed генерируется при изменении поля значения.
Параметры
button | объект, получивший сигнал | |
value | новое значение | |
user_data | пользовательские данные, заданные при подключении обработчика сигнала. |
Флаги: Выполнить последним
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkScaleButton.html
