GtkScrollbar
GtkScrollbar — Полоса прокрутки
Функции
Стилизованные свойства
| gboolean | fixed-slider-length | Чтение |
| gboolean | has-backward-stepper | Чтение |
| gboolean | has-forward-stepper | Чтение |
| gboolean | has-secondary-backward-stepper | Чтение |
| gboolean | has-secondary-forward-stepper | Чтение |
| gint | min-slider-length | Чтение |
Типы и значения
| struct | GtkScrollbar |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkRange ╰── GtkScrollbar ├── GtkHScrollbar ╰── GtkVScrollbar
Реализованные интерфейсы
GtkScrollbar реализует AtkImplementorIface, GtkBuildable и GtkOrientable.
Включенные файлы
#include <gtk/gtk.h>
Описание
Виджет GtkScrollbar представляет собой полосу прокрутки, горизонтальную или вертикальную, в зависимости от значения свойства “orientation”.
Позиция ползунка в полосе прокрутки управляется настройками прокрутки. См. GtkAdjustment для полей в настройке – для GtkScrollbar поле “value” представляет положение полосы прокрутки, которое должно быть между полем “lower” и “upper” - “page-size”. Поле “page-size” представляет размер области видимой области прокрутки. Поля “step-increment” и “page-increment” являются свойствами, когда пользователь просит выполнить шаг вниз (используя маленькие стрелки шага) или прокрутить страницу вниз (используя, например, 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);
Создаёт новую полосу прокрутки с заданной ориентацией.
Параметры
orientation | ориентация полосы прокрутки. | |
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.20/GtkScrollbar.html
