GtkScrolledWindow

gtk_scrolled_window_new ()

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

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

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

gtk_scrolled_window_get_hadjustment ()

GtkAdjustment *
gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window);

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

gtk_scrolled_window_set_hadjustment ()

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

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

gtk_scrolled_window_get_vadjustment ()

GtkAdjustment *
gtk_scrolled_window_get_vadjustment (GtkScrolledWindow *scrolled_window);

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

gtk_scrolled_window_set_vadjustment ()

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

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

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_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_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);

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

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

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

gtk_scrolled_window_get_placement ()

GtkCornerType
gtk_scrolled_window_get_placement (GtkScrolledWindow *scrolled_window);

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

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().

С: 2.10

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_set_shadow_type ()

void
gtk_scrolled_window_set_shadow_type (GtkScrolledWindow *scrolled_window,
                                     GtkShadowType type);

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

gtk_scrolled_window_get_kinetic_scrolling ()

gboolean
gtk_scrolled_window_get_kinetic_scrolling
                               (GtkScrolledWindow *scrolled_window);

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

С: 3.4

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_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_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_overlay_scrolling ()

gboolean
gtk_scrolled_window_get_overlay_scrolling
                               (GtkScrolledWindow *scrolled_window);

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

С: 3.16

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_min_content_width ()

gint
gtk_scrolled_window_get_min_content_width
                               (GtkScrolledWindow *scrolled_window);

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

С: 3.0

gtk_scrolled_window_set_min_content_width ()

void
gtk_scrolled_window_set_min_content_width
                               (GtkScrolledWindow *scrolled_window,
                                gint width);

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

Ошибка программирования — установка минимальной ширины содержимого на значение, большее, чем “max-content-width”.

С: 3.0

gtk_scrolled_window_get_min_content_height ()

gint
gtk_scrolled_window_get_min_content_height
                               (GtkScrolledWindow *scrolled_window);

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

С: 3.0

gtk_scrolled_window_set_min_content_height ()

void
gtk_scrolled_window_set_min_content_height
                               (GtkScrolledWindow *scrolled_window,
                                gint height);

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

Ошибка программирования — установка минимальной высоты содержимого на значение, большее, чем “max-content-height”.

С: 3.0

gtk_scrolled_window_get_max_content_width ()

gint
gtk_scrolled_window_get_max_content_width
                               (GtkScrolledWindow *scrolled_window);

Возвращает установленную максимальную ширину содержимого.

С: 3.22

gtk_scrolled_window_set_max_content_width ()

void
gtk_scrolled_window_set_max_content_width
                               (GtkScrolledWindow *scrolled_window,
                                gint width);

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

Ошибка программирования — установка максимальной ширины содержимого на значение, меньшее, чем “min-content-width”.

С: 3.22

gtk_scrolled_window_get_max_content_height ()

gint
gtk_scrolled_window_get_max_content_height
                               (GtkScrolledWindow *scrolled_window);

Возвращает установленную максимальную высоту содержимого.

С: 3.22

gtk_scrolled_window_set_max_content_height ()

void
gtk_scrolled_window_set_max_content_height
                               (GtkScrolledWindow *scrolled_window,
                                gint height);

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

Установка максимальной высоты содержимого меньше, чем “минимальная высота содержимого” — это ошибка программирования.

С: 3.22

gtk_scrolled_window_get_propagate_natural_width ()

gboolean
gtk_scrolled_window_get_propagate_natural_width
                               (GtkScrolledWindow *scrolled_window);

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

С: 3.22

gtk_scrolled_window_set_propagate_natural_width ()

void
gtk_scrolled_window_set_propagate_natural_width
                               (GtkScrolledWindow *scrolled_window,
                                gboolean propagate);

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

С: 3.22

gtk_scrolled_window_get_propagate_natural_height ()

gboolean
gtk_scrolled_window_get_propagate_natural_height
                               (GtkScrolledWindow *scrolled_window);

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

С: 3.22

gtk_scrolled_window_set_propagate_natural_height ()

void
gtk_scrolled_window_set_propagate_natural_height
                               (GtkScrolledWindow *scrolled_window,
                                gboolean propagate);

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

С: 3.22