GtkScrollable
GtkScrollable — Интерфейс для прокручиваемых виджетов
Функции
Свойства
| GtkAdjustment * | hadjustment | Чтение / Запись / Создание |
| GtkScrollablePolicy | hscroll-policy | Чтение / Запись |
| GtkAdjustment * | vadjustment | Чтение / Запись / Создание |
| GtkScrollablePolicy | vscroll-policy | Чтение / Запись |
Типы и значения
| GtkScrollable | |
| перечисление | GtkScrollablePolicy |
Иерархия объектов
GInterface ╰── GtkScrollable
Предварительные требования
GtkScrollable требует GObject.
Известные реализации
GtkScrollable реализован в GtkIconView, GtkLayout, GtkTextView, GtkToolPalette, GtkTreeView и GtkViewport.
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkScrollable — интерфейс, реализуемый виджетами с внутренней прокруткой.
Для реализации этого интерфейса необходимо переопределить свойства «hadjustment» и «vadjustment».
Создание прокручиваемого виджета
Все прокручиваемые виджеты должны выполнять следующие действия.
При установке родительским виджетом настроек прокрутки дочернему виджету, виджет должен заполнить свойства настроек «lower», «upper», «step-increment», «page-increment» и «page-size», и подключиться к сигналу «value-changed».
Поскольку предпочтительный размер — это размер полностью развернутого виджета, прокручиваемый виджет должен уметь справляться с недостатками выделения. Это означает, что он должен принимать любое значение, переданное в его функцию
GtkWidgetClass.size_allocate().При выделении родительским элементом места дочернему прокручиваемому виджету, виджет должен обновить свойства настроек новыми значениями.
При выводе любого из настроек сигнала «value-changed» прокручиваемый виджет должен прокрутить свой контент.
Функции
gtk_scrollable_get_hadjustment ()
GtkAdjustment *
gtk_scrollable_get_hadjustment (GtkScrollable *scrollable); Возвращает GtkAdjustment, используемый для горизонтальной прокрутки.
Параметры
scrollable |
С: 3.0
gtk_scrollable_set_hadjustment ()
void gtk_scrollable_set_hadjustment (GtkScrollable *scrollable,GtkAdjustment *hadjustment);
Устанавливает горизонтальную настройку GtkScrollable.
Параметры
scrollable | ||
hadjustment | [allow-none] |
С: 3.0
gtk_scrollable_get_vadjustment ()
GtkAdjustment *
gtk_scrollable_get_vadjustment (GtkScrollable *scrollable); Возвращает GtkAdjustment, используемый для вертикальной прокрутки.
Параметры
scrollable |
С: 3.0
gtk_scrollable_set_vadjustment ()
void gtk_scrollable_set_vadjustment (GtkScrollable *scrollable,GtkAdjustment *vadjustment);
Устанавливает вертикальную настойку GtkScrollable.
Параметры
scrollable | ||
vadjustment | [allow-none] |
С: 3.0
gtk_scrollable_get_hscroll_policy ()
GtkScrollablePolicy
gtk_scrollable_get_hscroll_policy (GtkScrollable *scrollable); Возвращает горизонтальную GtkScrollablePolicy.
Параметры
scrollable |
Возвращаемое значение
Горизонтальная GtkScrollablePolicy.
С: 3.0
gtk_scrollable_set_hscroll_policy ()
void gtk_scrollable_set_hscroll_policy (GtkScrollable *scrollable,GtkScrollablePolicy policy);
Устанавливает GtkScrollablePolicy для определения, должна ли горизонтальная прокрутка начинаться ниже минимальной ширины или ниже естественной ширины.
Параметры
scrollable | ||
policy | горизонтальная GtkScrollablePolicy |
С: 3.0
gtk_scrollable_get_vscroll_policy ()
GtkScrollablePolicy
gtk_scrollable_get_vscroll_policy (GtkScrollable *scrollable); Возвращает вертикальную GtkScrollablePolicy.
Параметры
scrollable |
Возвращаемое значение
Вертикальная GtkScrollablePolicy.
С: 3.0
gtk_scrollable_set_vscroll_policy ()
void gtk_scrollable_set_vscroll_policy (GtkScrollable *scrollable,GtkScrollablePolicy policy);
Устанавливает GtkScrollablePolicy для определения, должна ли вертикальная прокрутка начинаться ниже минимальной высоты или ниже естественной высоты.
Параметры
scrollable | ||
policy | вертикальная GtkScrollablePolicy |
С: 3.0
gtk_scrollable_get_border ()
gboolean gtk_scrollable_get_border (GtkScrollable *scrollable,GtkBorder *border);
Возвращает размер неподвижной границы вокруг внешней стороны объекта прокрутки. Пример: заголовки treeview. GTK+ может использовать эту информацию для отображения наложенной графики, например, указания перехода, в правильном положении.
Параметры
scrollable | ||
border | место для результатов. | [out caller-allocates] |
Возвращаемое значение
TRUE если border задано
С: 3.16
Типы и значения
GtkScrollable
typedef struct _GtkScrollable GtkScrollable;
enum GtkScrollablePolicy
Определяет политику, которая будет использоваться в виджете прокрутки при обновлении настроек окна прокрутки в данном направлении.
Члены
GTK_SCROLL_MINIMUM | Настройки прокрутки основаны на минимальном размере | |
GTK_SCROLL_NATURAL | Настройки прокрутки основаны на естественном размере |
Подробное описание свойств
Свойство “hadjustment”
“hadjustment” GtkAdjustment *
Горизонтальная GtkAdjustment свёртываемого виджета. Эта настройка используется совместно между свёртываемым виджетом и его родителем.
Владелец: GtkScrollable
Флаги: Чтение / Запись / Построение
С версии: 3.0
Свойство “hscroll-policy”
“hscroll-policy” GtkScrollablePolicy
Определяет, следует ли начинать горизонтальную прокрутку, когда свёртываемому виджету выделяется ширина меньше минимальной или естественной ширины.
Владелец: GtkScrollable
Флаги: Чтение / Запись
Значение по умолчанию: GTK_SCROLL_MINIMUM
С версии: 3.0
Свойство “vadjustment”
“vadjustment” GtkAdjustment *
Вертикальная GtkAdjustment свёртываемого виджета. Эта настройка используется совместно между свёртываемым виджетом и его родителем.
Владелец: GtkScrollable
Флаги: Чтение / Запись / Построение
С версии: 3.0
Свойство “vscroll-policy”
“vscroll-policy” GtkScrollablePolicy
Определяет, следует ли начинать вертикальную прокрутку, когда свёртываемому виджету выделяется высота меньше минимальной или естественной высоты.
Владелец: GtkScrollable
Флаги: Чтение / Запись
Значение по умолчанию: GTK_SCROLL_MINIMUM
С версии: 3.0
© 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/GtkScrollable.html
