GtkScrollbar
GtkScrollbar — Ползунок прокрутки
Функции
Свойства стиля
| gboolean | фиксированная-длина-ползунка | Чтение |
| gboolean | имеет-кнопку-назад | Чтение |
| gboolean | имеет-кнопку-вперед | Чтение |
| gboolean | имеет-вторичную-кнопку-назад | Чтение |
| gboolean | имеет-вторичную-кнопку-вперед | Чтение |
| int | минимальная-длина-ползунка | Чтение |
Типы и значения
| struct | GtkScrollbar |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkRange
╰── GtkScrollbar
├── GtkHScrollbar
╰── GtkVScrollbar
Реализованные интерфейсы
GtkScrollbar реализует AtkImplementorIface, GtkBuildable и GtkOrientable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
Виджет GtkScrollbar представляет собой ползунок прокрутки, горизонтальный или вертикальный, в зависимости от значения свойства “направление”.
Его положение и движение контролируются настройкой, которая передаётся или создаётся с помощью gtk_scrollbar_new(). Более подробную информацию см. в GtkAdjustment. Поле “значение” задаёт положение ползунка и должно находиться между “нижним” и “верхним” - “размер_страницы”. “размер_страницы” представляет размер видимой области прокрутки. Поля “шаг_приращения” и “приращение_страницы” добавляются к или вычитаются из “значения”, когда пользователь просит выполнить перемещение на шаг (например, используя клавиши со стрелками или, если присутствуют, кнопки шага) или на страницу (например, используя клавиши Page Down/Up).
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);
Создаёт новый ползунок прокрутки с указанным направлением.
Параметры
orientation | направление ползунка прокрутки. | |
adjustment | настройка GtkAdjustment для использования, или | [allow-none] |
Возвращаемое значение
новый GtkScrollbar.
Since: 3.0
Типы и значения
struct GtkScrollbar
struct GtkScrollbar;
Подробности свойств стиля
Свойство стиля “fixed-slider-length”
“fixed-slider-length” gboolean
Не изменяйте размер ползунка, просто зафиксируйте его на минимальную длину.
Владелец: GtkScrollbar
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство стиля “has-backward-stepper”
“has-backward-stepper” gboolean
Отображает стандартную кнопку стрелки назад.
Владелец: GtkScrollbar
Флаги: Чтение
Значение по умолчанию: TRUE
Свойство стиля “has-forward-stepper”
“has-forward-stepper” gboolean
Отображает стандартную кнопку стрелки вперед.
Владелец: GtkScrollbar
Флаги: Чтение
Значение по умолчанию: TRUE
Свойство стиля “has-secondary-backward-stepper”
“has-secondary-backward-stepper” gboolean
Отображает вторую кнопку стрелки назад в противоположном конце ползунка прокрутки.
Владелец: GtkScrollbar
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство стиля “has-secondary-forward-stepper”
“has-secondary-forward-stepper” gboolean
Отображает вторую кнопку стрелки вперед в противоположном конце ползунка прокрутки.
Владелец: GtkScrollbar
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство стиля “min-slider-length”
“min-slider-length” int
Минимальная длина ползунка прокрутки.
GtkScrollbar:min-slider-length устарело с версии 3.20 и не должно использоваться в новом коде.
Используйте вместо этого свойства min-height/min-width CSS для элемента ползунка. Значение этого свойства стиля игнорируется.
Владелец: GtkScrollbar
Флаги: Чтение
Допустимые значения: >= 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.24/GtkScrollbar.html
