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.
Параметры
размер | размер значка из стандартного набора (GtkIconSize). | [type int] |
мин | минимальное значение шкалы (обычно 0) | |
макс | максимальное значение шкалы (обычно 100) | |
шаг | шаг изменения значения при событиях прокрутки колёсиком или нажатии стрелок вверх/вниз (обычно 2) | |
значки | массив имён значков, завершённый | [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().
Параметры
кнопка | ||
регулировка |
С: 2.12
gtk_scale_button_set_icons ()
void gtk_scale_button_set_icons (GtkScaleButton *button,const gchar **icons);
Устанавливает значки, которые будут использоваться кнопкой шкалы. Подробнее см. свойство “значки”.
Параметры
кнопка | ||
значки | массив имён значков, завершённый | [array zero-terminated=1] |
С: 2.12
gtk_scale_button_set_value ()
void gtk_scale_button_set_value (GtkScaleButton *button,gdouble value);
Устанавливает текущее значение шкалы; если значение находится вне диапазона от минимального до максимального, оно будет ограничено этим диапазоном. Кнопка шкалы генерирует сигнал “значение изменено”, если значение изменяется.
Параметры
кнопка | ||
значение | новое значение кнопки шкалы |
С: 2.12
gtk_scale_button_get_adjustment ()
GtkAdjustment *
gtk_scale_button_get_adjustment (GtkScaleButton *button); Получает GtkAdjustment, связанный со шкалой GtkScaleButton. Подробнее см. gtk_range_get_adjustment().
Параметры
кнопка |
Возвращаемое значение
регулировка, связанная со шкалой.
[transfer none]
С: 2.12
gtk_scale_button_get_value ()
gdouble
gtk_scale_button_get_value (GtkScaleButton *button); Получает текущее значение кнопки шкалы.
Параметры
кнопка |
Возвращаемое значение
текущее значение кнопки шкалы
С: 2.12
gtk_scale_button_get_popup ()
GtkWidget *
gtk_scale_button_get_popup (GtkScaleButton *button); Возвращает всплывающее меню GtkScaleButton.
Параметры
кнопка |
С: 2.14
gtk_scale_button_get_plus_button ()
GtkWidget *
gtk_scale_button_get_plus_button (GtkScaleButton *button); Возвращает кнопку «плюс» GtkScaleButton.
Параметры
кнопка |
С: 2.14
gtk_scale_button_get_minus_button ()
GtkWidget *
gtk_scale_button_get_minus_button (GtkScaleButton *button); Возвращает кнопку «минус» GtkScaleButton.
Параметры
кнопка |
С: 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 и Возврат.
Параметры
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.22/GtkScaleButton.html
