GtkScrollbar
GtkScrollbar — Ползунок прокрутки
Функции
Свойства стиля
| gboolean | фиксированная-длина-ползунка | Чтение |
| gboolean | есть-кнопка-назад | Чтение |
| gboolean | есть-кнопка-вперед | Чтение |
| gboolean | есть-вторая-кнопка-назад | Чтение |
| gboolean | есть-вторая-кнопка-вперед | Чтение |
| gint | минимальная-длина-ползунка | Чтение |
Типы и значения
| struct | GtkScrollbar |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkRange ╰── GtkScrollbar ├── GtkHScrollbar ╰── GtkVScrollbar
Реализованные интерфейсы
GtkScrollbar реализует AtkImplementorIface, GtkBuildable и GtkOrientable.
Файлы заголовков
#include <gtk/gtk.h>
Описание
Виджет GtkScrollbar представляет собой ползунок прокрутки, горизонтальный или вертикальный, в зависимости от значения свойства “ориентация”.
Положение ползунка в ползунке прокрутки управляется настройками прокрутки. См. GtkAdjustment для полей в настройках — для GtkScrollbar поле “значение” представляет положение ползунка, которое должно быть между полем “нижнее” и “верхнее” — “размер страницы”. Поле “размер страницы” представляет размер видимой области прокручиваемого содержимого. Поля “шаг приращения” и “приращение страницы” представляют собой свойства, когда пользователь просит выполнить шаг вниз (с помощью маленьких стрелок) или прокрутить страницу вниз (например, с помощью Page Down клавиши).
Узлы CSS
scrollbar[.fine-tune]
╰── contents
├── [button.up]
├── [button.down]
├── trough
│ ╰── slider
├── [button.up]
╰── [button.down]GtkScrollbar имеет главный узел CSS с именем scrollbar и под-узел для его содержимого, с под-узлами с именами trough и slider.
Главный узел получает класс стиля .fine-tune, когда ползунок прокрутки находится в режиме «тонкой настройки».
Если кнопки шага включены, они представлены до четырёх дополнительных под-узлов с именем button. Они получают классы стиля .up и .down, чтобы указать, в каком направлении они перемещаются.
Другие классы стилей, которые могут быть добавлены к ползункам прокрутки внутри GtkScrolledWindow, включают позиционные классы (.left, .right, .top, .bottom) и классы стилей, связанные с наложением прокрутки (.overlay-indicator, .dragging, .hovering).
Функции
gtk_scrollbar_new ()
GtkWidget * gtk_scrollbar_new (GtkOrientation orientation,GtkAdjustment *adjustment);
Создаёт новый ползунок прокрутки с заданной ориентацией.
Параметры
ориентация | ориентация ползунка прокрутки. | |
настройка | используемая настройка GtkAdjustment, или | [allow-none] |
Возвращает
новый GtkScrollbar.
С: 3.0
Типы и значения
struct GtkScrollbar
struct GtkScrollbar;
Подробное описание свойств стиля
Свойство стиля “fixed-slider-length”
“fixed-slider-length” gboolean
Не менять размер ползунка, просто зафиксировать его на минимальную длину.
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство стиля “has-backward-stepper”
“has-backward-stepper” gboolean
Отобразить стандартную кнопку стрелки назад.
Флаги: Чтение
Значение по умолчанию: TRUE
Свойство стиля “has-forward-stepper”
“has-forward-stepper” gboolean
Отобразить стандартную кнопку стрелки вперед.
Флаги: Чтение
Значение по умолчанию: TRUE
Свойство стиля “has-secondary-backward-stepper”
“has-secondary-backward-stepper” gboolean
Отобразить вторую кнопку стрелки назад в противоположном конце ползунка.
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство стиля “has-secondary-forward-stepper”
“has-secondary-forward-stepper” gboolean
Отобразить вторую кнопку стрелки вперед в противоположном конце ползунка.
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство стиля “min-slider-length”
“min-slider-length” gint
Минимальная длина ползунка прокрутки.
GtkScrollbar:min-slider-length устарело с версии 3.20 и не должно использоваться в новом коде.
Вместо этого используйте свойства CSS min-height/min-width для элемента ползунка. Значение этого свойства стиля игнорируется.
Флаги: Чтение
Допустимые значения: >= 0
Значение по умолчанию: 21
См. также
© 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/GtkScrollbar.html
