GtkScrollbar
GtkScrollbar — Полоса прокрутки
Функции
Свойства
| GtkAdjustment * | adjustment | Чтение / Запись / Создание |
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkScrollbar
Реализованные интерфейсы
GtkScrollbar реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkOrientable.
Файлы заголовков
#include <gtk/gtk.h>
Описание
Виджет GtkScrollbar представляет собой горизонтальную или вертикальную полосу прокрутки, в зависимости от значения свойства «orientation».
Его положение и перемещение контролируются настройкой, передаваемой или создаваемой с помощью gtk_scrollbar_new(). Подробнее см. GtkAdjustment. Поле «value» устанавливает положение ползунка и должно находиться между значениями «lower» и «upper» — «page-size». Значение «page-size» представляет размер видимой области прокручиваемого контента. Поля «step-increment» и «page-increment» добавляются или вычитаются из «value», когда пользователь просит выполнить шаг перемещения (например, стрелки курсора) или пролистать страницу (например, клавиши Page Down/Up).
CSS узлы
scrollbar
╰── range[.fine-tune]
╰── trough
╰── sliderGtkScrollbar имеет основной CSS узел с именем scrollbar и дочерний узел для своего содержимого. Основному узлу применяются стили .horizontal или .vertical, в зависимости от ориентации полосы прокрутки.
Узел range получает стиль .fine-tune, когда полоса прокрутки находится в режиме «тонкой настройки».
Другие стили, которые могут быть добавлены к полосам прокрутки внутри GtkScrolledWindow, включают позиционные классы (.left, .right, .top, .bottom) и стили, связанные с перекрытием прокрутки (.overlay-indicator, .dragging, .hovering).
Удобство для пользователей
GtkScrollbar использует роль GTK_ACCESSIBLE_ROLE_SCROLLBAR.
Функции
gtk_scrollbar_new ()
GtkWidget * gtk_scrollbar_new (GtkOrientation orientation,GtkAdjustment *adjustment);
Создаёт новую полосу прокрутки с заданной ориентацией.
Параметры
orientation | ориентация полосы прокрутки. | |
adjustment | используемая настройка GtkAdjustment, или | [allow-none] |
Возвращаемое значение
новая GtkScrollbar.
gtk_scrollbar_get_adjustment ()
GtkAdjustment *
gtk_scrollbar_get_adjustment (GtkScrollbar *self); Возвращает настройку полосы прокрутки.
Параметры
self |
Возвращаемое значение
настройка полосы прокрутки.
[transfer none]
gtk_scrollbar_set_adjustment ()
void gtk_scrollbar_set_adjustment (GtkScrollbar *self,GtkAdjustment *adjustment);
Устанавливает для полосы прокрутки использование заданной настройки.
Параметры
self | ||
adjustment | настройка для установки. | [nullable] |
Типы и значения
GtkScrollbar
typedef struct _GtkScrollbar GtkScrollbar;
Подробности свойств
Свойство “adjustment”
“adjustment” GtkAdjustment *
GtkAdjustment, содержащий текущее значение этой полосы прокрутки.
Владелец: GtkScrollbar
Флаги: Чтение / Запись / Создание
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkScrollbar.html