GtkScrolledWindow

gtk_scrolled_window_new ()

GtkWidget *
gtk_scrolled_window_new (GtkAdjustment *hadjustment,
                         GtkAdjustment *vadjustment);

Создаёт новое окно со скроллингом.

Два аргумента — это корректировки (adjustments) окна со скроллингом; они будут объединены с полосами прокрутки и дочерним виджетом, чтобы полосы прокрутки синхронизировались с дочерним виджетом. Обычно вы хотите передать NULL для корректировок, что заставит окно со скроллингом создать их для вас.

gtk_scrolled_window_get_hadjustment ()

GtkAdjustment *
gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window);

Возвращает корректировку горизонтальной полосы прокрутки, используемую для подключения горизонтальной полосы прокрутки к горизонтальной функциональности прокрутки дочернего виджета.

gtk_scrolled_window_get_vadjustment ()

GtkAdjustment *
gtk_scrolled_window_get_vadjustment (GtkScrolledWindow *scrolled_window);

Возвращает корректировку вертикальной полосы прокрутки, используемую для подключения вертикальной полосы прокрутки к вертикальной функциональности прокрутки дочернего виджета.

gtk_scrolled_window_get_hscrollbar ()

GtkWidget *
gtk_scrolled_window_get_hscrollbar (GtkScrolledWindow *scrolled_window);

Возвращает горизонтальную полосу прокрутки scrolled_window.

С момента: 2.8

gtk_scrolled_window_get_vscrollbar ()

GtkWidget *
gtk_scrolled_window_get_vscrollbar (GtkScrolledWindow *scrolled_window);

Возвращает вертикальную полосу прокрутки scrolled_window.

С момента: 2.8

gtk_scrolled_window_set_policy ()

void
gtk_scrolled_window_set_policy (GtkScrolledWindow *scrolled_window,
                                GtkPolicyType hscrollbar_policy,
                                GtkPolicyType vscrollbar_policy);

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

Политика определяет, когда должна отображаться полоса прокрутки; это значение из перечисления GtkPolicyType. Если GTK_POLICY_ALWAYS, полоса прокрутки всегда присутствует; если GTK_POLICY_NEVER, полоса прокрутки никогда не отображается; если GTK_POLICY_AUTOMATIC, полоса прокрутки отображается только в случае необходимости (то есть, если область ползунка будет меньше, чем область для прокрутки — отображение больше, чем размер страницы).

gtk_scrolled_window_add_with_viewport ()

void
gtk_scrolled_window_add_with_viewport (GtkScrolledWindow *scrolled_window,
                                       GtkWidget *child);

Используется для добавления дочерних элементов без собственных возможностей прокрутки. Это просто функция удобства; она эквивалентна добавлению неподдерживающего прокрутку дочернего элемента в viewport, а затем добавлению viewport в окно со скроллингом. Если дочерний элемент поддерживает собственную прокрутку, используйте gtk_container_add() вместо этой функции.

Viewport прокручивает дочерний элемент, перемещая его GdkWindow, и принимает размер дочернего элемента как размер его верхнего GdkWindow. Это будет неправильно для большинства виджетов, поддерживающих собственную прокрутку; например, если вы добавите виджет, такой как GtkTreeView, с viewport, вся область виджета будет прокручиваться, включая заголовки столбцов. Таким образом, виджеты с поддержкой собственной прокрутки не должны использоваться с прокси GtkViewport.

Виджет поддерживает собственную прокрутку, если он реализует интерфейс GtkScrollable.

gtk_scrolled_window_set_placement ()

void
gtk_scrolled_window_set_placement (GtkScrolledWindow *scrolled_window,
                                   GtkCornerType window_placement);

Устанавливает расположение содержимого по отношению к полосам прокрутки для окна со скроллингом.

По умолчанию GTK_CORNER_TOP_LEFT, что означает, что дочерний элемент находится в левом верхнем углу, а полосы прокрутки находятся под ним и справа. Другие значения в GtkCornerType — это GTK_CORNER_TOP_RIGHT, GTK_CORNER_BOTTOM_LEFT и GTK_CORNER_BOTTOM_RIGHT.

См. также gtk_scrolled_window_get_placement() и gtk_scrolled_window_unset_placement().

gtk_scrolled_window_unset_placement ()

void
gtk_scrolled_window_unset_placement (GtkScrolledWindow *scrolled_window);

Снимает установку размещения содержимого относительно полос прокрутки для окна прокрутки. Если для окна прокрутки не установлено размещение, используется значение по умолчанию GTK_CORNER_TOP_LEFT.

См. также gtk_scrolled_window_set_placement() и gtk_scrolled_window_get_placement().

Since: 2.10

gtk_scrolled_window_set_shadow_type ()

void
gtk_scrolled_window_set_shadow_type (GtkScrolledWindow *scrolled_window,
                                     GtkShadowType type);

Изменяет тип тени, отображаемой вокруг содержимого scrolled_window.

gtk_scrolled_window_set_hadjustment ()

void
gtk_scrolled_window_set_hadjustment (GtkScrolledWindow *scrolled_window,
                                     GtkAdjustment *hadjustment);

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

gtk_scrolled_window_set_vadjustment ()

void
gtk_scrolled_window_set_vadjustment (GtkScrolledWindow *scrolled_window,
                                     GtkAdjustment *vadjustment);

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

gtk_scrolled_window_get_placement ()

GtkCornerType
gtk_scrolled_window_get_placement (GtkScrolledWindow *scrolled_window);

Получает размещение содержимого относительно полос прокрутки для окна прокрутки. См. gtk_scrolled_window_set_placement().

gtk_scrolled_window_get_policy ()

void
gtk_scrolled_window_get_policy (GtkScrolledWindow *scrolled_window,
                                GtkPolicyType *hscrollbar_policy,
                                GtkPolicyType *vscrollbar_policy);

Получает текущие значения политики для горизонтальной и вертикальной полос прокрутки. См. gtk_scrolled_window_set_policy().

gtk_scrolled_window_get_shadow_type ()

GtkShadowType
gtk_scrolled_window_get_shadow_type (GtkScrolledWindow *scrolled_window);

Получает тип тени для окна прокрутки. См. gtk_scrolled_window_set_shadow_type().

gtk_scrolled_window_get_min_content_width ()

gint
gtk_scrolled_window_get_min_content_width
                               (GtkScrolledWindow *scrolled_window);

Получает минимальную ширину содержимого scrolled_window, или -1, если не установлено.

Since: 3.0

gtk_scrolled_window_set_min_content_width ()

void
gtk_scrolled_window_set_min_content_width
                               (GtkScrolledWindow *scrolled_window,
                                gint width);

Устанавливает минимальную ширину, которую scrolled_window должно поддерживать видимой. Обратите внимание, что она может быть меньше, чем минимальный размер содержимого.

Since: 3.0

gtk_scrolled_window_get_min_content_height ()

gint
gtk_scrolled_window_get_min_content_height
                               (GtkScrolledWindow *scrolled_window);

Получает минимальную высоту содержимого scrolled_window, или -1, если не установлено.

Since: 3.0

gtk_scrolled_window_set_min_content_height ()

void
gtk_scrolled_window_set_min_content_height
                               (GtkScrolledWindow *scrolled_window,
                                gint height);

Устанавливает минимальную высоту, которую scrolled_window должно поддерживать видимой. Обратите внимание, что она может быть меньше, чем минимальный размер содержимого.

Since: 3.0

gtk_scrolled_window_set_kinetic_scrolling ()

void
gtk_scrolled_window_set_kinetic_scrolling
                               (GtkScrolledWindow *scrolled_window,
                                gboolean kinetic_scrolling);

Включает или отключает кинетическое прокручивание. Кинетическое прокручивание применяется только к устройствам с источником GDK_SOURCE_TOUCHSCREEN.

С: 3.4

gtk_scrolled_window_get_kinetic_scrolling ()

gboolean
gtk_scrolled_window_get_kinetic_scrolling
                               (GtkScrolledWindow *scrolled_window);

Возвращает указанное поведение кинетического прокручивания.

С: 3.4

gtk_scrolled_window_set_capture_button_press ()

void
gtk_scrolled_window_set_capture_button_press
                               (GtkScrolledWindow *scrolled_window,
                                gboolean capture_button_press);

Изменяет поведение scrolled_window относительно начального события, которое, возможно, запускает кинетическое прокручивание. Когда capture_button_press установлено в TRUE, событие захватывается окном прокрутки, а затем повторно воспроизводится, если оно предназначено для перемещения в дочерний виджет.

Это следует включить, если какие-либо дочерние виджеты выполняют необратимые действия при событии “button-press-event”. Если они этого не делают и дополнительно обрабатывают “grab-broken-event”, лучше установить capture_button_press в FALSE.

Это значение имеет эффект только при включенном кинетическом прокручивании.

С: 3.4

gtk_scrolled_window_get_capture_button_press ()

gboolean
gtk_scrolled_window_get_capture_button_press
                               (GtkScrolledWindow *scrolled_window);

Возвращает, захватываются ли нажатия кнопок во время кинетического прокручивания. См. gtk_scrolled_window_set_capture_button_press().

С: 3.4

gtk_scrolled_window_set_overlay_scrolling ()

void
gtk_scrolled_window_set_overlay_scrolling
                               (GtkScrolledWindow *scrolled_window,
                                gboolean overlay_scrolling);

Включает или отключает прокрутку наложения для этого окна прокрутки.

С: 3.16

gtk_scrolled_window_get_overlay_scrolling ()

gboolean
gtk_scrolled_window_get_overlay_scrolling
                               (GtkScrolledWindow *scrolled_window);

Возвращает, включена ли прокрутка наложения для этого окна прокрутки.

С: 3.16