GtkScaleButton
GtkScaleButton — Кнопка, которая выводит масштаб
Функции
Свойства
| GtkAdjustment * | adjustment | Чтение / Запись |
| GStrv | icons | Чтение / Запись |
| GtkIconSize | размер | Чтение / Запись |
| double | значение | Чтение / Запись |
Сигналы
| void | popdown | Действие |
| void | popup | Действие |
| void | изменение-значения | Выполнить последним |
Типы и значения
| 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.
У виджета всплывающего окна, содержащего масштаб, есть класс стиля .scale-popup.
Функции
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 |
Возвращаемое значение
кнопку «плюс» GtkScaleButton в виде GtkButton.
[transfer none][type Gtk.Button]
С: 2.14
gtk_scale_button_get_minus_button ()
GtkWidget *
gtk_scale_button_get_minus_button (GtkScaleButton *button); Возвращает кнопку «минус» GtkScaleButton.
Параметры
button |
Возвращаемое значение
кнопку «минус» GtkScaleButton в виде GtkButton.
[transfer none][type Gtk.Button]
С: 2.14
Типы и значения
struct GtkScaleButton
struct GtkScaleButton;
Подробное описание свойств
Свойство “adjustment”
“adjustment” GtkAdjustment *
GtkAdjustment, содержащий текущее значение этого объекта кнопки масштаба.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
Свойство “icons”
“icons” GStrv
Названия иконок, используемых кнопкой масштаба. Первый элемент массива будет использоваться в кнопке, когда текущее значение является минимальным, второй — для максимального значения. Все последующие иконки будут использоваться для всех остальных значений, равномерно распределенных по диапазону значений.
Если в массиве icons указано только одно имя иконки, оно будет использоваться для всех значений. Если в массиве icons указано только два имени иконок, первое будет использоваться для нижних 50% шкалы, а второе — для верхних 50%.
Рекомендуется использовать как минимум 3 иконки, чтобы GtkScaleButton лучше отражал текущее значение шкалы для пользователя.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
С версии: 2.12
Свойство “size”
“size” GtkIconSize
Размер иконки.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
Значение по умолчанию: GTK_ICON_SIZE_SMALL_TOOLBAR
Свойство “value”
“value” double
Значение шкалы.
Владелец: GtkScaleButton
Флаги: Чтение / Запись
Значение по умолчанию: 0
Подробное описание сигналов
Сигнал “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 — это сигнал привязки клавиш, который генерируется для отображения виджета масштаба.
По умолчанию для этого сигнала привязаны клавиши Space, Enter и Return.
Параметры
button | объект, получивший сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Действие
С версии: 2.12
Сигнал “value-changed”
void user_function (GtkScaleButton *button, double 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.24/GtkScaleButton.html
