Spec-Zone.ru › GTK 4.0

GtkScrollbar

GtkScrollbar — Полоса прокрутки

Функции

GtkWidget * gtk_scrollbar_new ()
GtkAdjustment * gtk_scrollbar_get_adjustment ()
void gtk_scrollbar_set_adjustment ()

Свойства

GtkAdjustment * adjustment Чтение / Запись / Создание

Типы и значения

GtkScrollbar

Иерархия объектов

    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
        ╰── slider

GtkScrollbar имеет основной 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, или NULL для создания новой настройки.

[allow-none]

Возвращаемое значение

новая GtkScrollbar.

gtk_scrollbar_get_adjustment ()

GtkAdjustment *
gtk_scrollbar_get_adjustment (GtkScrollbar *self);

Возвращает настройку полосы прокрутки.

Параметры

self

a GtkScrollbar

Возвращаемое значение

настройка полосы прокрутки.

[transfer none]

gtk_scrollbar_set_adjustment ()

void
gtk_scrollbar_set_adjustment (GtkScrollbar *self,
                              GtkAdjustment *adjustment);

Устанавливает для полосы прокрутки использование заданной настройки.

Параметры

self

a GtkScrollbar

adjustment

настройка для установки.

[nullable]

Типы и значения

GtkScrollbar

typedef struct _GtkScrollbar GtkScrollbar;

Подробности свойств

Свойство “adjustment”

  “adjustment”               GtkAdjustment *

GtkAdjustment, содержащий текущее значение этой полосы прокрутки.

Владелец: GtkScrollbar

Флаги: Чтение / Запись / Создание

См. также

GtkAdjustment, GtkScrolledWindow

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API