forked from AuroraMiddleware/gtk
4465 lines
150 KiB
C
4465 lines
150 KiB
C
/* GTK - The GIMP Toolkit
|
||
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
|
||
*
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU Lesser General Public
|
||
* License as published by the Free Software Foundation; either
|
||
* version 2 of the License, or (at your option) any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public
|
||
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
/*
|
||
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
|
||
* file for a list of people on the GTK+ Team. See the ChangeLog
|
||
* files for a list of changes. These files are distributed with
|
||
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
||
*/
|
||
|
||
#include "config.h"
|
||
|
||
#include "gtkscrolledwindow.h"
|
||
|
||
#include "gtkadjustment.h"
|
||
#include "gtkadjustmentprivate.h"
|
||
#include "gtkbindings.h"
|
||
#include "gtkcsscustomgadgetprivate.h"
|
||
#include "gtkdnd.h"
|
||
#include "gtkintl.h"
|
||
#include "gtkmain.h"
|
||
#include "gtkmarshalers.h"
|
||
#include "gtkprivate.h"
|
||
#include "gtkscrollable.h"
|
||
#include "gtkscrollbar.h"
|
||
#include "gtkrangeprivate.h"
|
||
#include "gtktypebuiltins.h"
|
||
#include "gtkviewport.h"
|
||
#include "gtkwidgetprivate.h"
|
||
#include "gtkwindow.h"
|
||
#include "gtkkineticscrolling.h"
|
||
#include "a11y/gtkscrolledwindowaccessible.h"
|
||
#include "gtkstylecontextprivate.h"
|
||
#include "gtkprogresstrackerprivate.h"
|
||
|
||
#include <math.h>
|
||
|
||
/**
|
||
* SECTION:gtkscrolledwindow
|
||
* @Short_description: Adds scrollbars to its child widget
|
||
* @Title: GtkScrolledWindow
|
||
* @See_also: #GtkScrollable, #GtkViewport, #GtkAdjustment
|
||
*
|
||
* GtkScrolledWindow is a #GtkBin subclass: it’s a container
|
||
* the accepts a single child widget. GtkScrolledWindow adds scrollbars
|
||
* to the child widget and optionally draws a beveled frame around the
|
||
* child widget.
|
||
*
|
||
* The scrolled window can work in two ways. Some widgets have native
|
||
* scrolling support; these widgets implement the #GtkScrollable interface.
|
||
* Widgets with native scroll support include #GtkTreeView, #GtkTextView,
|
||
* and #GtkLayout.
|
||
*
|
||
* For widgets that lack native scrolling support, the #GtkViewport
|
||
* widget acts as an adaptor class, implementing scrollability for child
|
||
* widgets that lack their own scrolling capabilities. Use #GtkViewport
|
||
* to scroll child widgets such as #GtkGrid, #GtkBox, and so on.
|
||
*
|
||
* If a widget has native scrolling abilities, it can be added to the
|
||
* GtkScrolledWindow with gtk_container_add(). If a widget does not, you
|
||
* must first add the widget to a #GtkViewport, then add the #GtkViewport
|
||
* to the scrolled window. gtk_container_add() will do this for you for
|
||
* widgets that don’t implement #GtkScrollable natively, so you can
|
||
* ignore the presence of the viewport.
|
||
*
|
||
* The position of the scrollbars is controlled by the scroll adjustments.
|
||
* See #GtkAdjustment for the fields in an adjustment — for
|
||
* #GtkScrollbar, used by GtkScrolledWindow, the “value” field
|
||
* represents the position of the scrollbar, which must be between the
|
||
* “lower” field and “upper - page_size.” The “page_size” field
|
||
* represents the size of the visible scrollable area. The
|
||
* “step_increment” and “page_increment” fields are used when the user
|
||
* asks to step down (using the small stepper arrows) or page down (using
|
||
* for example the PageDown key).
|
||
*
|
||
* If a GtkScrolledWindow doesn’t behave quite as you would like, or
|
||
* doesn’t have exactly the right layout, it’s very possible to set up
|
||
* your own scrolling with #GtkScrollbar and for example a #GtkGrid.
|
||
*
|
||
* # Touch support
|
||
*
|
||
* GtkScrolledWindow has built-in support for touch devices. When a
|
||
* touchscreen is used, swiping will move the scrolled window, and will
|
||
* expose 'kinetic' behavior. This can be turned off with the
|
||
* #GtkScrolledWindow:kinetic-scrolling property if it is undesired.
|
||
*
|
||
* GtkScrolledWindow also displays visual 'overshoot' indication when
|
||
* the content is pulled beyond the end, and this situation can be
|
||
* captured with the #GtkScrolledWindow::edge-overshot signal.
|
||
*
|
||
* If no mouse device is present, the scrollbars will overlayed as
|
||
* narrow, auto-hiding indicators over the content. If traditional
|
||
* scrollbars are desired although no mouse is present, this behaviour
|
||
* can be turned off with the #GtkScrolledWindow:overlay-scrolling
|
||
* property.
|
||
*
|
||
* # CSS nodes
|
||
*
|
||
* GtkScrolledWindow has a main CSS node with name scrolledwindow.
|
||
*
|
||
* It uses subnodes with names overshoot and undershoot to
|
||
* draw the overflow and underflow indications. These nodes get
|
||
* the .left, .right, .top or .bottom style class added depending
|
||
* on where the indication is drawn.
|
||
*
|
||
* GtkScrolledWindow also sets the positional style classes (.left,
|
||
* .right, .top, .bottom) and style classes related to overlay
|
||
* scrolling (.overlay-indicator, .dragging, .hovering) on its scrollbars.
|
||
*
|
||
* If both scrollbars are visible, the area where they meet is drawn
|
||
* with a subnode named junction.
|
||
*/
|
||
|
||
|
||
/* scrolled window policy and size requisition handling:
|
||
*
|
||
* gtk size requisition works as follows:
|
||
* a widget upon size-request reports the width and height that it finds
|
||
* to be best suited to display its contents, including children.
|
||
* the width and/or height reported from a widget upon size requisition
|
||
* may be overidden by the user by specifying a width and/or height
|
||
* other than 0 through gtk_widget_set_size_request().
|
||
*
|
||
* a scrolled window needs (for implementing all three policy types) to
|
||
* request its width and height based on two different rationales.
|
||
* 1) the user wants the scrolled window to just fit into the space
|
||
* that it gets allocated for a specifc dimension.
|
||
* 1.1) this does not apply if the user specified a concrete value
|
||
* value for that specific dimension by either specifying usize for the
|
||
* scrolled window or for its child.
|
||
* 2) the user wants the scrolled window to take as much space up as
|
||
* is desired by the child for a specifc dimension (i.e. POLICY_NEVER).
|
||
*
|
||
* also, kinda obvious:
|
||
* 3) a user would certainly not have choosen a scrolled window as a container
|
||
* for the child, if the resulting allocation takes up more space than the
|
||
* child would have allocated without the scrolled window.
|
||
*
|
||
* conclusions:
|
||
* A) from 1) follows: the scrolled window shouldn’t request more space for a
|
||
* specifc dimension than is required at minimum.
|
||
* B) from 1.1) follows: the requisition may be overidden by usize of the scrolled
|
||
* window (done automatically) or by usize of the child (needs to be checked).
|
||
* C) from 2) follows: for POLICY_NEVER, the scrolled window simply reports the
|
||
* child’s dimension.
|
||
* D) from 3) follows: the scrolled window child’s minimum width and minimum height
|
||
* under A) at least correspond to the space taken up by its scrollbars.
|
||
*/
|
||
|
||
#define DEFAULT_SCROLLBAR_SPACING 3
|
||
#define TOUCH_BYPASS_CAPTURED_THRESHOLD 30
|
||
|
||
/* Kinetic scrolling */
|
||
#define MAX_OVERSHOOT_DISTANCE 100
|
||
#define DECELERATION_FRICTION 4
|
||
#define OVERSHOOT_FRICTION 20
|
||
#define SCROLL_CAPTURE_THRESHOLD_MS 150
|
||
|
||
/* Animated scrolling */
|
||
#define ANIMATION_DURATION 200
|
||
|
||
/* Overlay scrollbars */
|
||
#define INDICATOR_FADE_OUT_DELAY 2000
|
||
#define INDICATOR_FADE_OUT_DURATION 1000
|
||
#define INDICATOR_FADE_OUT_TIME 500
|
||
#define INDICATOR_CLOSE_DISTANCE 5
|
||
#define INDICATOR_FAR_DISTANCE 10
|
||
|
||
/* Scrolled off indication */
|
||
#define UNDERSHOOT_SIZE 40
|
||
|
||
typedef struct
|
||
{
|
||
GtkWidget *scrollbar;
|
||
GdkWindow *window;
|
||
gboolean over; /* either mouse over, or while dragging */
|
||
gint64 last_scroll_time;
|
||
guint conceil_timer;
|
||
|
||
gdouble current_pos;
|
||
gdouble source_pos;
|
||
gdouble target_pos;
|
||
GtkProgressTracker tracker;
|
||
guint tick_id;
|
||
guint over_timeout_id;
|
||
} Indicator;
|
||
|
||
typedef struct
|
||
{
|
||
gdouble dx;
|
||
gdouble dy;
|
||
guint32 evtime;
|
||
} ScrollHistoryElem;
|
||
|
||
struct _GtkScrolledWindowPrivate
|
||
{
|
||
GtkWidget *hscrollbar;
|
||
GtkWidget *vscrollbar;
|
||
|
||
GtkCssGadget *gadget;
|
||
GtkCssNode *overshoot_node[4];
|
||
GtkCssNode *undershoot_node[4];
|
||
|
||
Indicator hindicator;
|
||
Indicator vindicator;
|
||
|
||
GtkCornerType window_placement;
|
||
guint16 shadow_type;
|
||
|
||
guint hscrollbar_policy : 2;
|
||
guint vscrollbar_policy : 2;
|
||
guint hscrollbar_visible : 1;
|
||
guint vscrollbar_visible : 1;
|
||
guint focus_out : 1; /* used by ::move-focus-out implementation */
|
||
guint overlay_scrolling : 1;
|
||
guint use_indicators : 1;
|
||
|
||
gint min_content_width;
|
||
gint min_content_height;
|
||
|
||
guint scroll_events_overshoot_id;
|
||
|
||
/* Kinetic scrolling */
|
||
GtkGesture *long_press_gesture;
|
||
GtkGesture *swipe_gesture;
|
||
|
||
GArray *scroll_history;
|
||
GdkDevice *scroll_device;
|
||
|
||
/* These two gestures are mutually exclusive */
|
||
GtkGesture *drag_gesture;
|
||
GtkGesture *pan_gesture;
|
||
|
||
gdouble drag_start_x;
|
||
gdouble drag_start_y;
|
||
|
||
GdkDevice *drag_device;
|
||
guint kinetic_scrolling : 1;
|
||
guint capture_button_press : 1;
|
||
guint in_drag : 1;
|
||
|
||
guint deceleration_id;
|
||
|
||
gdouble x_velocity;
|
||
gdouble y_velocity;
|
||
|
||
gdouble unclamped_hadj_value;
|
||
gdouble unclamped_vadj_value;
|
||
};
|
||
|
||
typedef struct
|
||
{
|
||
GtkScrolledWindow *scrolled_window;
|
||
gint64 last_deceleration_time;
|
||
|
||
GtkKineticScrolling *hscrolling;
|
||
GtkKineticScrolling *vscrolling;
|
||
} KineticScrollData;
|
||
|
||
enum {
|
||
PROP_0,
|
||
PROP_HADJUSTMENT,
|
||
PROP_VADJUSTMENT,
|
||
PROP_HSCROLLBAR_POLICY,
|
||
PROP_VSCROLLBAR_POLICY,
|
||
PROP_WINDOW_PLACEMENT,
|
||
PROP_WINDOW_PLACEMENT_SET,
|
||
PROP_SHADOW_TYPE,
|
||
PROP_MIN_CONTENT_WIDTH,
|
||
PROP_MIN_CONTENT_HEIGHT,
|
||
PROP_KINETIC_SCROLLING,
|
||
PROP_OVERLAY_SCROLLING,
|
||
NUM_PROPERTIES
|
||
};
|
||
|
||
/* Signals */
|
||
enum
|
||
{
|
||
SCROLL_CHILD,
|
||
MOVE_FOCUS_OUT,
|
||
EDGE_OVERSHOT,
|
||
EDGE_REACHED,
|
||
LAST_SIGNAL
|
||
};
|
||
|
||
static void gtk_scrolled_window_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec);
|
||
static void gtk_scrolled_window_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec);
|
||
|
||
static void gtk_scrolled_window_destroy (GtkWidget *widget);
|
||
static gboolean gtk_scrolled_window_draw (GtkWidget *widget,
|
||
cairo_t *cr);
|
||
static void gtk_scrolled_window_size_allocate (GtkWidget *widget,
|
||
GtkAllocation *allocation);
|
||
static gboolean gtk_scrolled_window_scroll_event (GtkWidget *widget,
|
||
GdkEventScroll *event);
|
||
static gboolean gtk_scrolled_window_focus (GtkWidget *widget,
|
||
GtkDirectionType direction);
|
||
static void gtk_scrolled_window_add (GtkContainer *container,
|
||
GtkWidget *widget);
|
||
static void gtk_scrolled_window_remove (GtkContainer *container,
|
||
GtkWidget *widget);
|
||
static void gtk_scrolled_window_forall (GtkContainer *container,
|
||
gboolean include_internals,
|
||
GtkCallback callback,
|
||
gpointer callback_data);
|
||
static gboolean gtk_scrolled_window_scroll_child (GtkScrolledWindow *scrolled_window,
|
||
GtkScrollType scroll,
|
||
gboolean horizontal);
|
||
static void gtk_scrolled_window_move_focus_out (GtkScrolledWindow *scrolled_window,
|
||
GtkDirectionType direction_type);
|
||
|
||
static void gtk_scrolled_window_relative_allocation(GtkWidget *widget,
|
||
GtkAllocation *allocation);
|
||
static void gtk_scrolled_window_inner_allocation (GtkWidget *widget,
|
||
GtkAllocation *rect);
|
||
static void gtk_scrolled_window_allocate_scrollbar (GtkScrolledWindow *scrolled_window,
|
||
GtkWidget *scrollbar,
|
||
GtkAllocation *allocation);
|
||
static void gtk_scrolled_window_allocate_child (GtkScrolledWindow *swindow,
|
||
GtkAllocation *relative_allocation);
|
||
static void gtk_scrolled_window_adjustment_changed (GtkAdjustment *adjustment,
|
||
gpointer data);
|
||
static void gtk_scrolled_window_adjustment_value_changed (GtkAdjustment *adjustment,
|
||
gpointer data);
|
||
static gboolean gtk_scrolled_window_should_animate (GtkScrolledWindow *sw);
|
||
|
||
static void gtk_scrolled_window_get_preferred_width (GtkWidget *widget,
|
||
gint *minimum_size,
|
||
gint *natural_size);
|
||
static void gtk_scrolled_window_get_preferred_height (GtkWidget *widget,
|
||
gint *minimum_size,
|
||
gint *natural_size);
|
||
static void gtk_scrolled_window_get_preferred_height_for_width (GtkWidget *layout,
|
||
gint width,
|
||
gint *minimum_height,
|
||
gint *natural_height);
|
||
static void gtk_scrolled_window_get_preferred_width_for_height (GtkWidget *layout,
|
||
gint width,
|
||
gint *minimum_height,
|
||
gint *natural_height);
|
||
|
||
static void gtk_scrolled_window_map (GtkWidget *widget);
|
||
static void gtk_scrolled_window_unmap (GtkWidget *widget);
|
||
static void gtk_scrolled_window_realize (GtkWidget *widget);
|
||
static void gtk_scrolled_window_unrealize (GtkWidget *widget);
|
||
|
||
static void gtk_scrolled_window_grab_notify (GtkWidget *widget,
|
||
gboolean was_grabbed);
|
||
|
||
static void _gtk_scrolled_window_set_adjustment_value (GtkScrolledWindow *scrolled_window,
|
||
GtkAdjustment *adjustment,
|
||
gdouble value);
|
||
|
||
static void gtk_scrolled_window_cancel_deceleration (GtkScrolledWindow *scrolled_window);
|
||
|
||
static gboolean _gtk_scrolled_window_get_overshoot (GtkScrolledWindow *scrolled_window,
|
||
gint *overshoot_x,
|
||
gint *overshoot_y);
|
||
|
||
static void gtk_scrolled_window_start_deceleration (GtkScrolledWindow *scrolled_window);
|
||
static gint _gtk_scrolled_window_get_scrollbar_spacing (GtkScrolledWindow *scrolled_window);
|
||
|
||
static void remove_indicator (GtkScrolledWindow *sw,
|
||
Indicator *indicator);
|
||
static void indicator_stop_fade (Indicator *indicator);
|
||
static gboolean maybe_hide_indicator (gpointer data);
|
||
|
||
static void indicator_start_fade (Indicator *indicator,
|
||
gdouble pos);
|
||
static void indicator_set_over (Indicator *indicator,
|
||
gboolean over);
|
||
|
||
|
||
static guint signals[LAST_SIGNAL] = {0};
|
||
static GParamSpec *properties[NUM_PROPERTIES];
|
||
|
||
G_DEFINE_TYPE_WITH_PRIVATE (GtkScrolledWindow, gtk_scrolled_window, GTK_TYPE_BIN)
|
||
|
||
static void
|
||
add_scroll_binding (GtkBindingSet *binding_set,
|
||
guint keyval,
|
||
GdkModifierType mask,
|
||
GtkScrollType scroll,
|
||
gboolean horizontal)
|
||
{
|
||
guint keypad_keyval = keyval - GDK_KEY_Left + GDK_KEY_KP_Left;
|
||
|
||
gtk_binding_entry_add_signal (binding_set, keyval, mask,
|
||
"scroll-child", 2,
|
||
GTK_TYPE_SCROLL_TYPE, scroll,
|
||
G_TYPE_BOOLEAN, horizontal);
|
||
gtk_binding_entry_add_signal (binding_set, keypad_keyval, mask,
|
||
"scroll-child", 2,
|
||
GTK_TYPE_SCROLL_TYPE, scroll,
|
||
G_TYPE_BOOLEAN, horizontal);
|
||
}
|
||
|
||
static void
|
||
add_tab_bindings (GtkBindingSet *binding_set,
|
||
GdkModifierType modifiers,
|
||
GtkDirectionType direction)
|
||
{
|
||
gtk_binding_entry_add_signal (binding_set, GDK_KEY_Tab, modifiers,
|
||
"move-focus-out", 1,
|
||
GTK_TYPE_DIRECTION_TYPE, direction);
|
||
gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Tab, modifiers,
|
||
"move-focus-out", 1,
|
||
GTK_TYPE_DIRECTION_TYPE, direction);
|
||
}
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_leave_notify (GtkWidget *widget,
|
||
GdkEventCrossing *event)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = GTK_SCROLLED_WINDOW (widget)->priv;
|
||
|
||
if (priv->use_indicators && event->detail != GDK_NOTIFY_INFERIOR)
|
||
{
|
||
indicator_set_over (&priv->hindicator, FALSE);
|
||
indicator_set_over (&priv->vindicator, FALSE);
|
||
}
|
||
|
||
return GDK_EVENT_PROPAGATE;
|
||
}
|
||
|
||
static void
|
||
update_scrollbar_positions (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkStyleContext *context;
|
||
gboolean is_rtl;
|
||
|
||
if (priv->hscrollbar != NULL)
|
||
{
|
||
context = gtk_widget_get_style_context (priv->hscrollbar);
|
||
if (priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_TOP_RIGHT)
|
||
{
|
||
gtk_style_context_add_class (context, GTK_STYLE_CLASS_BOTTOM);
|
||
gtk_style_context_remove_class (context, GTK_STYLE_CLASS_TOP);
|
||
}
|
||
else
|
||
{
|
||
gtk_style_context_remove_class (context, GTK_STYLE_CLASS_BOTTOM);
|
||
gtk_style_context_add_class (context, GTK_STYLE_CLASS_TOP);
|
||
}
|
||
}
|
||
|
||
if (priv->vscrollbar != NULL)
|
||
{
|
||
context = gtk_widget_get_style_context (priv->vscrollbar);
|
||
is_rtl = gtk_widget_get_direction (GTK_WIDGET (scrolled_window)) == GTK_TEXT_DIR_RTL;
|
||
if ((is_rtl &&
|
||
(priv->window_placement == GTK_CORNER_TOP_RIGHT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_RIGHT)) ||
|
||
(!is_rtl &&
|
||
(priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_LEFT)))
|
||
{
|
||
gtk_style_context_add_class (context, GTK_STYLE_CLASS_RIGHT);
|
||
gtk_style_context_remove_class (context, GTK_STYLE_CLASS_LEFT);
|
||
}
|
||
else
|
||
{
|
||
gtk_style_context_remove_class (context, GTK_STYLE_CLASS_RIGHT);
|
||
gtk_style_context_add_class (context, GTK_STYLE_CLASS_LEFT);
|
||
}
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_direction_changed (GtkWidget *widget,
|
||
GtkTextDirection previous_dir)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
|
||
update_scrollbar_positions (scrolled_window);
|
||
|
||
GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->direction_changed (widget, previous_dir);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_class_init (GtkScrolledWindowClass *class)
|
||
{
|
||
GObjectClass *gobject_class = G_OBJECT_CLASS (class);
|
||
GtkWidgetClass *widget_class;
|
||
GtkContainerClass *container_class;
|
||
GtkBindingSet *binding_set;
|
||
|
||
widget_class = (GtkWidgetClass*) class;
|
||
container_class = (GtkContainerClass*) class;
|
||
|
||
gobject_class->set_property = gtk_scrolled_window_set_property;
|
||
gobject_class->get_property = gtk_scrolled_window_get_property;
|
||
|
||
widget_class->destroy = gtk_scrolled_window_destroy;
|
||
widget_class->draw = gtk_scrolled_window_draw;
|
||
widget_class->size_allocate = gtk_scrolled_window_size_allocate;
|
||
widget_class->scroll_event = gtk_scrolled_window_scroll_event;
|
||
widget_class->focus = gtk_scrolled_window_focus;
|
||
widget_class->get_preferred_width = gtk_scrolled_window_get_preferred_width;
|
||
widget_class->get_preferred_height = gtk_scrolled_window_get_preferred_height;
|
||
widget_class->get_preferred_height_for_width = gtk_scrolled_window_get_preferred_height_for_width;
|
||
widget_class->get_preferred_width_for_height = gtk_scrolled_window_get_preferred_width_for_height;
|
||
widget_class->map = gtk_scrolled_window_map;
|
||
widget_class->unmap = gtk_scrolled_window_unmap;
|
||
widget_class->grab_notify = gtk_scrolled_window_grab_notify;
|
||
widget_class->realize = gtk_scrolled_window_realize;
|
||
widget_class->unrealize = gtk_scrolled_window_unrealize;
|
||
widget_class->leave_notify_event = gtk_scrolled_window_leave_notify;
|
||
widget_class->direction_changed = gtk_scrolled_window_direction_changed;
|
||
|
||
container_class->add = gtk_scrolled_window_add;
|
||
container_class->remove = gtk_scrolled_window_remove;
|
||
container_class->forall = gtk_scrolled_window_forall;
|
||
gtk_container_class_handle_border_width (container_class);
|
||
|
||
class->scrollbar_spacing = -1;
|
||
|
||
class->scroll_child = gtk_scrolled_window_scroll_child;
|
||
class->move_focus_out = gtk_scrolled_window_move_focus_out;
|
||
|
||
properties[PROP_HADJUSTMENT] =
|
||
g_param_spec_object ("hadjustment",
|
||
P_("Horizontal Adjustment"),
|
||
P_("The GtkAdjustment for the horizontal position"),
|
||
GTK_TYPE_ADJUSTMENT,
|
||
GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT);
|
||
|
||
properties[PROP_VADJUSTMENT] =
|
||
g_param_spec_object ("vadjustment",
|
||
P_("Vertical Adjustment"),
|
||
P_("The GtkAdjustment for the vertical position"),
|
||
GTK_TYPE_ADJUSTMENT,
|
||
GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT);
|
||
|
||
properties[PROP_HSCROLLBAR_POLICY] =
|
||
g_param_spec_enum ("hscrollbar-policy",
|
||
P_("Horizontal Scrollbar Policy"),
|
||
P_("When the horizontal scrollbar is displayed"),
|
||
GTK_TYPE_POLICY_TYPE,
|
||
GTK_POLICY_AUTOMATIC,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
properties[PROP_VSCROLLBAR_POLICY] =
|
||
g_param_spec_enum ("vscrollbar-policy",
|
||
P_("Vertical Scrollbar Policy"),
|
||
P_("When the vertical scrollbar is displayed"),
|
||
GTK_TYPE_POLICY_TYPE,
|
||
GTK_POLICY_AUTOMATIC,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
properties[PROP_WINDOW_PLACEMENT] =
|
||
g_param_spec_enum ("window-placement",
|
||
P_("Window Placement"),
|
||
P_("Where the contents are located with respect to the scrollbars."),
|
||
GTK_TYPE_CORNER_TYPE,
|
||
GTK_CORNER_TOP_LEFT,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkScrolledWindow:window-placement-set:
|
||
*
|
||
* Whether "window-placement" should be used to determine the location
|
||
* of the contents with respect to the scrollbars.
|
||
*
|
||
* Since: 2.10
|
||
*
|
||
* Deprecated: 3.10: This value is ignored and
|
||
* #GtkScrolledWindow:window-placement value is always honored.
|
||
*/
|
||
properties[PROP_WINDOW_PLACEMENT_SET] =
|
||
g_param_spec_boolean ("window-placement-set",
|
||
P_("Window Placement Set"),
|
||
P_("Whether \"window-placement\" should be used to determine the location of the contents with respect to the scrollbars."),
|
||
TRUE,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
properties[PROP_SHADOW_TYPE] =
|
||
g_param_spec_enum ("shadow-type",
|
||
P_("Shadow Type"),
|
||
P_("Style of bevel around the contents"),
|
||
GTK_TYPE_SHADOW_TYPE,
|
||
GTK_SHADOW_NONE,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkScrolledWindow:scrollbars-within-bevel:
|
||
*
|
||
* Whether to place scrollbars within the scrolled window's bevel.
|
||
*
|
||
* Since: 2.12
|
||
*
|
||
* Deprecated: 3.20: the value of this style property is ignored.
|
||
*/
|
||
gtk_widget_class_install_style_property (widget_class,
|
||
g_param_spec_boolean ("scrollbars-within-bevel",
|
||
P_("Scrollbars within bevel"),
|
||
P_("Place scrollbars within the scrolled window's bevel"),
|
||
FALSE,
|
||
GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
|
||
|
||
gtk_widget_class_install_style_property (widget_class,
|
||
g_param_spec_int ("scrollbar-spacing",
|
||
P_("Scrollbar spacing"),
|
||
P_("Number of pixels between the scrollbars and the scrolled window"),
|
||
0,
|
||
G_MAXINT,
|
||
DEFAULT_SCROLLBAR_SPACING,
|
||
GTK_PARAM_READABLE));
|
||
|
||
/**
|
||
* GtkScrolledWindow:min-content-width:
|
||
*
|
||
* The minimum content width of @scrolled_window, or -1 if not set.
|
||
*
|
||
* Since: 3.0
|
||
*/
|
||
properties[PROP_MIN_CONTENT_WIDTH] =
|
||
g_param_spec_int ("min-content-width",
|
||
P_("Minimum Content Width"),
|
||
P_("The minimum width that the scrolled window will allocate to its content"),
|
||
-1, G_MAXINT, -1,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkScrolledWindow:min-content-height:
|
||
*
|
||
* The minimum content height of @scrolled_window, or -1 if not set.
|
||
*
|
||
* Since: 3.0
|
||
*/
|
||
properties[PROP_MIN_CONTENT_HEIGHT] =
|
||
g_param_spec_int ("min-content-height",
|
||
P_("Minimum Content Height"),
|
||
P_("The minimum height that the scrolled window will allocate to its content"),
|
||
-1, G_MAXINT, -1,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkScrolledWindow:kinetic-scrolling:
|
||
*
|
||
* Whether kinetic scrolling is enabled or not. Kinetic scrolling
|
||
* only applies to devices with source %GDK_SOURCE_TOUCHSCREEN.
|
||
*
|
||
* Since: 3.4
|
||
*/
|
||
properties[PROP_KINETIC_SCROLLING] =
|
||
g_param_spec_boolean ("kinetic-scrolling",
|
||
P_("Kinetic Scrolling"),
|
||
P_("Kinetic scrolling mode."),
|
||
TRUE,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkScrolledWindow:overlay-scrolling:
|
||
*
|
||
* Whether overlay scrolling is enabled or not. If it is, the
|
||
* scrollbars are only added as traditional widgets when a mouse
|
||
* is present. Otherwise, they are overlayed on top of the content,
|
||
* as narrow indicators.
|
||
*
|
||
* Since: 3.16
|
||
*/
|
||
properties[PROP_OVERLAY_SCROLLING] =
|
||
g_param_spec_boolean ("overlay-scrolling",
|
||
P_("Overlay Scrolling"),
|
||
P_("Overlay scrolling mode"),
|
||
TRUE,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
g_object_class_install_properties (gobject_class, NUM_PROPERTIES, properties);
|
||
|
||
/**
|
||
* GtkScrolledWindow::scroll-child:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @scroll: a #GtkScrollType describing how much to scroll
|
||
* @horizontal: whether the keybinding scrolls the child
|
||
* horizontally or not
|
||
*
|
||
* The ::scroll-child signal is a
|
||
* [keybinding signal][GtkBindingSignal]
|
||
* which gets emitted when a keybinding that scrolls is pressed.
|
||
* The horizontal or vertical adjustment is updated which triggers a
|
||
* signal that the scrolled windows child may listen to and scroll itself.
|
||
*/
|
||
signals[SCROLL_CHILD] =
|
||
g_signal_new (I_("scroll-child"),
|
||
G_TYPE_FROM_CLASS (gobject_class),
|
||
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
|
||
G_STRUCT_OFFSET (GtkScrolledWindowClass, scroll_child),
|
||
NULL, NULL,
|
||
_gtk_marshal_BOOLEAN__ENUM_BOOLEAN,
|
||
G_TYPE_BOOLEAN, 2,
|
||
GTK_TYPE_SCROLL_TYPE,
|
||
G_TYPE_BOOLEAN);
|
||
|
||
/**
|
||
* GtkScrolledWindow::move-focus-out:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @direction_type: either %GTK_DIR_TAB_FORWARD or
|
||
* %GTK_DIR_TAB_BACKWARD
|
||
*
|
||
* The ::move-focus-out signal is a
|
||
* [keybinding signal][GtkBindingSignal] which gets
|
||
* emitted when focus is moved away from the scrolled window by a
|
||
* keybinding. The #GtkWidget::move-focus signal is emitted with
|
||
* @direction_type on this scrolled windows toplevel parent in the
|
||
* container hierarchy. The default bindings for this signal are
|
||
* `Tab + Ctrl` and `Tab + Ctrl + Shift`.
|
||
*/
|
||
signals[MOVE_FOCUS_OUT] =
|
||
g_signal_new (I_("move-focus-out"),
|
||
G_TYPE_FROM_CLASS (gobject_class),
|
||
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
|
||
G_STRUCT_OFFSET (GtkScrolledWindowClass, move_focus_out),
|
||
NULL, NULL,
|
||
_gtk_marshal_VOID__ENUM,
|
||
G_TYPE_NONE, 1,
|
||
GTK_TYPE_DIRECTION_TYPE);
|
||
|
||
/**
|
||
* GtkScrolledWindow::edge-overshot:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @pos: edge side that was hit
|
||
*
|
||
* The ::edge-overshot signal is emitted whenever user initiated scrolling
|
||
* makes the scrolledwindow firmly surpass (ie. with some edge resistance)
|
||
* the lower or upper limits defined by the adjustment in that orientation.
|
||
*
|
||
* A similar behavior without edge resistance is provided by the
|
||
* #GtkScrolledWindow::edge-reached signal.
|
||
*
|
||
* Note: The @pos argument is LTR/RTL aware, so callers should be aware too
|
||
* if intending to provide behavior on horizontal edges.
|
||
*
|
||
* Since: 3.16
|
||
*/
|
||
signals[EDGE_OVERSHOT] =
|
||
g_signal_new (I_("edge-overshot"),
|
||
G_TYPE_FROM_CLASS (gobject_class),
|
||
G_SIGNAL_RUN_LAST, 0,
|
||
NULL, NULL,
|
||
g_cclosure_marshal_generic,
|
||
G_TYPE_NONE, 1, GTK_TYPE_POSITION_TYPE);
|
||
|
||
/**
|
||
* GtkScrolledWindow::edge-reached:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @pos: edge side that was reached
|
||
*
|
||
* The ::edge-reached signal is emitted whenever user-initiated scrolling
|
||
* makes the scrolledwindow exactly reaches the lower or upper limits
|
||
* defined by the adjustment in that orientation.
|
||
*
|
||
* A similar behavior with edge resistance is provided by the
|
||
* #GtkScrolledWindow::edge-overshot signal.
|
||
*
|
||
* Note: The @pos argument is LTR/RTL aware, so callers should be aware too
|
||
* if intending to provide behavior on horizontal edges.
|
||
*
|
||
* Since: 3.16
|
||
*/
|
||
signals[EDGE_REACHED] =
|
||
g_signal_new (I_("edge-reached"),
|
||
G_TYPE_FROM_CLASS (gobject_class),
|
||
G_SIGNAL_RUN_LAST, 0,
|
||
NULL, NULL,
|
||
g_cclosure_marshal_generic,
|
||
G_TYPE_NONE, 1, GTK_TYPE_POSITION_TYPE);
|
||
|
||
binding_set = gtk_binding_set_by_class (class);
|
||
|
||
add_scroll_binding (binding_set, GDK_KEY_Left, GDK_CONTROL_MASK, GTK_SCROLL_STEP_BACKWARD, TRUE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Right, GDK_CONTROL_MASK, GTK_SCROLL_STEP_FORWARD, TRUE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Up, GDK_CONTROL_MASK, GTK_SCROLL_STEP_BACKWARD, FALSE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Down, GDK_CONTROL_MASK, GTK_SCROLL_STEP_FORWARD, FALSE);
|
||
|
||
add_scroll_binding (binding_set, GDK_KEY_Page_Up, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_BACKWARD, TRUE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Page_Down, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_FORWARD, TRUE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Page_Up, 0, GTK_SCROLL_PAGE_BACKWARD, FALSE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Page_Down, 0, GTK_SCROLL_PAGE_FORWARD, FALSE);
|
||
|
||
add_scroll_binding (binding_set, GDK_KEY_Home, GDK_CONTROL_MASK, GTK_SCROLL_START, TRUE);
|
||
add_scroll_binding (binding_set, GDK_KEY_End, GDK_CONTROL_MASK, GTK_SCROLL_END, TRUE);
|
||
add_scroll_binding (binding_set, GDK_KEY_Home, 0, GTK_SCROLL_START, FALSE);
|
||
add_scroll_binding (binding_set, GDK_KEY_End, 0, GTK_SCROLL_END, FALSE);
|
||
|
||
add_tab_bindings (binding_set, GDK_CONTROL_MASK, GTK_DIR_TAB_FORWARD);
|
||
add_tab_bindings (binding_set, GDK_CONTROL_MASK | GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD);
|
||
|
||
gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_SCROLLED_WINDOW_ACCESSIBLE);
|
||
gtk_widget_class_set_css_name (widget_class, "scrolledwindow");
|
||
}
|
||
|
||
static gboolean
|
||
may_hscroll (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
return priv->hscrollbar_visible || priv->hscrollbar_policy == GTK_POLICY_EXTERNAL;
|
||
}
|
||
|
||
static gboolean
|
||
may_vscroll (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
return priv->vscrollbar_visible || priv->vscrollbar_policy == GTK_POLICY_EXTERNAL;
|
||
}
|
||
|
||
static inline gboolean
|
||
policy_may_be_visible (GtkPolicyType policy)
|
||
{
|
||
return policy == GTK_POLICY_ALWAYS || policy == GTK_POLICY_AUTOMATIC;
|
||
}
|
||
|
||
static void
|
||
scrolled_window_drag_begin_cb (GtkScrolledWindow *scrolled_window,
|
||
gdouble start_x,
|
||
gdouble start_y,
|
||
GtkGesture *gesture)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkEventSequenceState state;
|
||
GdkEventSequence *sequence;
|
||
GtkWidget *event_widget;
|
||
const GdkEvent *event;
|
||
|
||
priv->in_drag = FALSE;
|
||
priv->drag_start_x = priv->unclamped_hadj_value;
|
||
priv->drag_start_y = priv->unclamped_vadj_value;
|
||
gtk_scrolled_window_cancel_deceleration (scrolled_window);
|
||
sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture));
|
||
event = gtk_gesture_get_last_event (gesture, sequence);
|
||
event_widget = gtk_get_event_widget ((GdkEvent *) event);
|
||
|
||
if (event_widget == priv->vscrollbar || event_widget == priv->hscrollbar ||
|
||
(!may_hscroll (scrolled_window) && !may_vscroll (scrolled_window)))
|
||
state = GTK_EVENT_SEQUENCE_DENIED;
|
||
else if (priv->capture_button_press)
|
||
state = GTK_EVENT_SEQUENCE_CLAIMED;
|
||
else
|
||
return;
|
||
|
||
gtk_gesture_set_sequence_state (gesture, sequence, state);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_invalidate_overshoot (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkAllocation child_allocation;
|
||
gint overshoot_x, overshoot_y;
|
||
GdkRectangle rect;
|
||
|
||
if (!_gtk_scrolled_window_get_overshoot (scrolled_window, &overshoot_x, &overshoot_y))
|
||
return;
|
||
|
||
gtk_scrolled_window_relative_allocation (GTK_WIDGET (scrolled_window),
|
||
&child_allocation);
|
||
if (overshoot_x != 0)
|
||
{
|
||
if (overshoot_x < 0)
|
||
rect.x = child_allocation.x;
|
||
else
|
||
rect.x = child_allocation.x + child_allocation.width - MAX_OVERSHOOT_DISTANCE;
|
||
|
||
rect.y = child_allocation.y;
|
||
rect.width = MAX_OVERSHOOT_DISTANCE;
|
||
rect.height = child_allocation.height;
|
||
|
||
gdk_window_invalidate_rect (gtk_widget_get_window (GTK_WIDGET (scrolled_window)),
|
||
&rect, TRUE);
|
||
}
|
||
|
||
if (overshoot_y != 0)
|
||
{
|
||
if (overshoot_y < 0)
|
||
rect.y = child_allocation.y;
|
||
else
|
||
rect.y = child_allocation.y + child_allocation.height - MAX_OVERSHOOT_DISTANCE;
|
||
|
||
rect.x = child_allocation.x;
|
||
rect.width = child_allocation.width;
|
||
rect.height = MAX_OVERSHOOT_DISTANCE;
|
||
|
||
gdk_window_invalidate_rect (gtk_widget_get_window (GTK_WIDGET (scrolled_window)),
|
||
&rect, TRUE);
|
||
}
|
||
}
|
||
|
||
static void
|
||
scrolled_window_drag_update_cb (GtkScrolledWindow *scrolled_window,
|
||
gdouble offset_x,
|
||
gdouble offset_y,
|
||
GtkGesture *gesture)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkAdjustment *hadjustment;
|
||
GtkAdjustment *vadjustment;
|
||
gdouble dx, dy;
|
||
|
||
gtk_scrolled_window_invalidate_overshoot (scrolled_window);
|
||
|
||
if (!priv->capture_button_press)
|
||
{
|
||
GdkEventSequence *sequence;
|
||
|
||
sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture));
|
||
gtk_gesture_set_sequence_state (gesture, sequence,
|
||
GTK_EVENT_SEQUENCE_CLAIMED);
|
||
}
|
||
|
||
hadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
if (hadjustment && may_hscroll (scrolled_window))
|
||
{
|
||
dx = priv->drag_start_x - offset_x;
|
||
_gtk_scrolled_window_set_adjustment_value (scrolled_window,
|
||
hadjustment, dx);
|
||
}
|
||
|
||
vadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
if (vadjustment && may_vscroll (scrolled_window))
|
||
{
|
||
dy = priv->drag_start_y - offset_y;
|
||
_gtk_scrolled_window_set_adjustment_value (scrolled_window,
|
||
vadjustment, dy);
|
||
}
|
||
|
||
gtk_scrolled_window_invalidate_overshoot (scrolled_window);
|
||
}
|
||
|
||
static void
|
||
scrolled_window_drag_end_cb (GtkScrolledWindow *scrolled_window,
|
||
GdkEventSequence *sequence,
|
||
GtkGesture *gesture)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
if (!priv->in_drag || !gtk_gesture_handles_sequence (gesture, sequence))
|
||
gtk_gesture_set_state (gesture, GTK_EVENT_SEQUENCE_DENIED);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_decelerate (GtkScrolledWindow *scrolled_window,
|
||
gdouble x_velocity,
|
||
gdouble y_velocity)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
gboolean overshoot;
|
||
|
||
overshoot = _gtk_scrolled_window_get_overshoot (scrolled_window, NULL, NULL);
|
||
priv->x_velocity = x_velocity;
|
||
priv->y_velocity = y_velocity;
|
||
|
||
/* Zero out vector components for which we don't scroll */
|
||
if (!may_hscroll (scrolled_window))
|
||
priv->x_velocity = 0;
|
||
if (!may_vscroll (scrolled_window))
|
||
priv->y_velocity = 0;
|
||
|
||
if (priv->x_velocity != 0 || priv->y_velocity != 0 || overshoot)
|
||
{
|
||
gtk_scrolled_window_start_deceleration (scrolled_window);
|
||
priv->x_velocity = priv->y_velocity = 0;
|
||
}
|
||
}
|
||
|
||
static void
|
||
scrolled_window_swipe_cb (GtkScrolledWindow *scrolled_window,
|
||
gdouble x_velocity,
|
||
gdouble y_velocity)
|
||
{
|
||
gtk_scrolled_window_decelerate (scrolled_window, -x_velocity, -y_velocity);
|
||
}
|
||
|
||
static void
|
||
scrolled_window_long_press_cb (GtkScrolledWindow *scrolled_window,
|
||
gdouble x,
|
||
gdouble y,
|
||
GtkGesture *gesture)
|
||
{
|
||
GdkEventSequence *sequence;
|
||
|
||
sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture));
|
||
gtk_gesture_set_sequence_state (gesture, sequence,
|
||
GTK_EVENT_SEQUENCE_DENIED);
|
||
}
|
||
|
||
static void
|
||
scrolled_window_long_press_cancelled_cb (GtkScrolledWindow *scrolled_window,
|
||
GtkGesture *gesture)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GdkEventSequence *sequence;
|
||
const GdkEvent *event;
|
||
|
||
sequence = gtk_gesture_get_last_updated_sequence (gesture);
|
||
event = gtk_gesture_get_last_event (gesture, sequence);
|
||
|
||
if (event->type == GDK_TOUCH_BEGIN ||
|
||
event->type == GDK_BUTTON_PRESS)
|
||
gtk_gesture_set_sequence_state (gesture, sequence,
|
||
GTK_EVENT_SEQUENCE_DENIED);
|
||
else if (event->type != GDK_TOUCH_END &&
|
||
event->type != GDK_BUTTON_RELEASE)
|
||
priv->in_drag = TRUE;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_check_attach_pan_gesture (GtkScrolledWindow *sw)
|
||
{
|
||
GtkPropagationPhase phase = GTK_PHASE_NONE;
|
||
GtkScrolledWindowPrivate *priv = sw->priv;
|
||
|
||
if (priv->kinetic_scrolling &&
|
||
((may_hscroll (sw) && !may_vscroll (sw)) ||
|
||
(!may_hscroll (sw) && may_vscroll (sw))))
|
||
{
|
||
GtkOrientation orientation;
|
||
|
||
if (may_hscroll (sw))
|
||
orientation = GTK_ORIENTATION_HORIZONTAL;
|
||
else
|
||
orientation = GTK_ORIENTATION_VERTICAL;
|
||
|
||
gtk_gesture_pan_set_orientation (GTK_GESTURE_PAN (priv->pan_gesture),
|
||
orientation);
|
||
phase = GTK_PHASE_CAPTURE;
|
||
}
|
||
|
||
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->pan_gesture), phase);
|
||
}
|
||
|
||
static void
|
||
indicator_set_over (Indicator *indicator,
|
||
gboolean over)
|
||
{
|
||
GtkStyleContext *context;
|
||
|
||
if (indicator->over_timeout_id)
|
||
{
|
||
g_source_remove (indicator->over_timeout_id);
|
||
indicator->over_timeout_id = 0;
|
||
}
|
||
|
||
if (indicator->over == over)
|
||
return;
|
||
|
||
context = gtk_widget_get_style_context (indicator->scrollbar);
|
||
indicator->over = over;
|
||
|
||
if (indicator->over)
|
||
gtk_style_context_add_class (context, "hovering");
|
||
else
|
||
gtk_style_context_remove_class (context, "hovering");
|
||
|
||
gtk_widget_queue_resize (indicator->scrollbar);
|
||
}
|
||
|
||
static void
|
||
translate_to_widget (GtkWidget *widget,
|
||
GdkEvent *event,
|
||
gint *x,
|
||
gint *y)
|
||
{
|
||
GtkWidget *event_widget;
|
||
GdkWindow *event_widget_window;
|
||
GdkWindow *window;
|
||
gdouble event_x, event_y;
|
||
gint wx, wy;
|
||
GtkAllocation allocation;
|
||
|
||
event_widget = gtk_get_event_widget (event);
|
||
event_widget_window = gtk_widget_get_window (event_widget);
|
||
gdk_event_get_coords (event, &event_x, &event_y);
|
||
window = event->any.window;
|
||
while (window && window != event_widget_window)
|
||
{
|
||
gdk_window_get_position (window, &wx, &wy);
|
||
event_x += wx;
|
||
event_y += wy;
|
||
window = gdk_window_get_effective_parent (window);
|
||
}
|
||
|
||
if (!gtk_widget_get_has_window (event_widget))
|
||
{
|
||
gtk_widget_get_allocation (event_widget, &allocation);
|
||
event_x -= allocation.x;
|
||
event_y -= allocation.y;
|
||
}
|
||
|
||
gtk_widget_translate_coordinates (event_widget, widget,
|
||
(gint)event_x, (gint)event_y,
|
||
x, y);
|
||
}
|
||
|
||
static gboolean
|
||
event_close_to_indicator (GtkScrolledWindow *sw,
|
||
Indicator *indicator,
|
||
GdkEvent *event)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkAllocation indicator_alloc;
|
||
gint x, y;
|
||
gint distance;
|
||
gint win_x, win_y;
|
||
|
||
priv = sw->priv;
|
||
|
||
gtk_widget_get_allocation (indicator->scrollbar, &indicator_alloc);
|
||
gdk_window_get_position (indicator->window, &win_x, &win_y);
|
||
translate_to_widget (GTK_WIDGET (sw), event, &x, &y);
|
||
|
||
if (indicator->over)
|
||
distance = INDICATOR_FAR_DISTANCE;
|
||
else
|
||
distance = INDICATOR_CLOSE_DISTANCE;
|
||
|
||
if (indicator == &priv->hindicator)
|
||
{
|
||
if (y >= win_y - distance &&
|
||
y < win_y + indicator_alloc.height + distance)
|
||
return TRUE;
|
||
}
|
||
else if (indicator == &priv->vindicator)
|
||
{
|
||
if (x >= win_x - distance &&
|
||
x < win_x + indicator_alloc.width + distance)
|
||
return TRUE;
|
||
}
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static gboolean
|
||
enable_over_timeout_cb (gpointer user_data)
|
||
{
|
||
Indicator *indicator = user_data;
|
||
|
||
indicator_set_over (indicator, TRUE);
|
||
return G_SOURCE_REMOVE;
|
||
}
|
||
|
||
static gboolean
|
||
check_update_scrollbar_proximity (GtkScrolledWindow *sw,
|
||
Indicator *indicator,
|
||
GdkEvent *event)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = sw->priv;
|
||
gboolean indicator_close, on_scrollbar, on_other_scrollbar;
|
||
GtkWidget *event_widget;
|
||
|
||
event_widget = gtk_get_event_widget (event);
|
||
|
||
indicator_close = event_close_to_indicator (sw, indicator, event);
|
||
on_scrollbar = (event_widget == indicator->scrollbar &&
|
||
event->type != GDK_LEAVE_NOTIFY);
|
||
on_other_scrollbar = (!on_scrollbar &&
|
||
event->type != GDK_LEAVE_NOTIFY &&
|
||
(event_widget == priv->hindicator.scrollbar ||
|
||
event_widget == priv->vindicator.scrollbar));
|
||
|
||
if (indicator->over_timeout_id)
|
||
{
|
||
g_source_remove (indicator->over_timeout_id);
|
||
indicator->over_timeout_id = 0;
|
||
}
|
||
|
||
if (on_scrollbar)
|
||
indicator_set_over (indicator, TRUE);
|
||
else if (indicator_close && !on_other_scrollbar)
|
||
indicator->over_timeout_id = gdk_threads_add_timeout (30, enable_over_timeout_cb, indicator);
|
||
else
|
||
indicator_set_over (indicator, FALSE);
|
||
|
||
return indicator_close;
|
||
}
|
||
|
||
static gdouble
|
||
get_scroll_unit (GtkScrolledWindow *sw,
|
||
GtkOrientation orientation)
|
||
{
|
||
gdouble scroll_unit;
|
||
|
||
#ifndef GDK_WINDOWING_QUARTZ
|
||
GtkScrolledWindowPrivate *priv = sw->priv;
|
||
GtkRange *scrollbar;
|
||
GtkAdjustment *adj;
|
||
gdouble page_size;
|
||
|
||
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
||
scrollbar = GTK_RANGE (priv->hscrollbar);
|
||
else
|
||
scrollbar = GTK_RANGE (priv->vscrollbar);
|
||
|
||
if (!scrollbar)
|
||
return 0;
|
||
|
||
adj = gtk_range_get_adjustment (scrollbar);
|
||
page_size = gtk_adjustment_get_page_size (adj);
|
||
scroll_unit = pow (page_size, 2.0 / 3.0);
|
||
#else
|
||
scroll_unit = 1;
|
||
#endif
|
||
|
||
return scroll_unit;
|
||
}
|
||
|
||
static void
|
||
scroll_history_push (GtkScrolledWindow *sw,
|
||
GdkEventScroll *event)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = sw->priv;
|
||
ScrollHistoryElem new_item;
|
||
guint i;
|
||
|
||
if (event->direction != GDK_SCROLL_SMOOTH)
|
||
return;
|
||
|
||
for (i = 0; i < priv->scroll_history->len; i++)
|
||
{
|
||
ScrollHistoryElem *elem;
|
||
|
||
elem = &g_array_index (priv->scroll_history, ScrollHistoryElem, i);
|
||
|
||
if (elem->evtime >= event->time - SCROLL_CAPTURE_THRESHOLD_MS)
|
||
break;
|
||
}
|
||
|
||
if (i > 0)
|
||
g_array_remove_range (priv->scroll_history, 0, i);
|
||
|
||
new_item.dx = event->delta_x;
|
||
new_item.dy = event->delta_y;
|
||
new_item.evtime = event->time;
|
||
g_array_append_val (priv->scroll_history, new_item);
|
||
}
|
||
|
||
static void
|
||
scroll_history_reset (GtkScrolledWindow *sw)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = sw->priv;
|
||
|
||
if (priv->scroll_history->len == 0)
|
||
return;
|
||
|
||
g_array_remove_range (priv->scroll_history, 0,
|
||
priv->scroll_history->len);
|
||
}
|
||
|
||
static gboolean
|
||
scroll_history_finish (GtkScrolledWindow *sw,
|
||
gdouble *velocity_x,
|
||
gdouble *velocity_y)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = sw->priv;
|
||
gdouble accum_dx = 0, accum_dy = 0;
|
||
guint32 first = 0, last = 0;
|
||
gdouble xunit, yunit;
|
||
guint i;
|
||
|
||
if (priv->scroll_history->len == 0)
|
||
return FALSE;
|
||
|
||
for (i = 0; i < priv->scroll_history->len; i++)
|
||
{
|
||
ScrollHistoryElem *elem;
|
||
|
||
elem = &g_array_index (priv->scroll_history, ScrollHistoryElem, i);
|
||
accum_dx += elem->dx;
|
||
accum_dy += elem->dy;
|
||
last = elem->evtime;
|
||
|
||
if (i == 0)
|
||
first = elem->evtime;
|
||
}
|
||
|
||
if (last == first)
|
||
return FALSE;
|
||
|
||
xunit = get_scroll_unit (sw, GTK_ORIENTATION_HORIZONTAL);
|
||
yunit = get_scroll_unit (sw, GTK_ORIENTATION_VERTICAL);
|
||
*velocity_x = (accum_dx * 1000 * xunit) / (last - first);
|
||
*velocity_y = (accum_dy * 1000 * yunit) / (last - first);
|
||
scroll_history_reset (sw);
|
||
|
||
return TRUE;
|
||
}
|
||
|
||
static gboolean
|
||
captured_event_cb (GtkWidget *widget,
|
||
GdkEvent *event)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkScrolledWindow *sw;
|
||
GdkInputSource input_source;
|
||
GdkDevice *source_device;
|
||
GtkWidget *event_widget;
|
||
gboolean on_scrollbar;
|
||
const gchar *device_name;
|
||
|
||
sw = GTK_SCROLLED_WINDOW (widget);
|
||
priv = sw->priv;
|
||
source_device = gdk_event_get_source_device (event);
|
||
|
||
if (event->type == GDK_SCROLL)
|
||
{
|
||
gtk_scrolled_window_cancel_deceleration (sw);
|
||
return GDK_EVENT_PROPAGATE;
|
||
}
|
||
|
||
if (!priv->use_indicators)
|
||
return GDK_EVENT_PROPAGATE;
|
||
|
||
if (event->type != GDK_MOTION_NOTIFY &&
|
||
event->type != GDK_LEAVE_NOTIFY)
|
||
return GDK_EVENT_PROPAGATE;
|
||
|
||
input_source = gdk_device_get_source (source_device);
|
||
device_name = gdk_device_get_name (source_device);
|
||
|
||
if (input_source == GDK_SOURCE_KEYBOARD ||
|
||
input_source == GDK_SOURCE_TOUCHSCREEN)
|
||
return GDK_EVENT_PROPAGATE;
|
||
|
||
event_widget = gtk_get_event_widget (event);
|
||
on_scrollbar = (event_widget == priv->hindicator.scrollbar ||
|
||
event_widget == priv->vindicator.scrollbar);
|
||
|
||
if (event->type == GDK_MOTION_NOTIFY)
|
||
{
|
||
if (priv->hscrollbar_visible)
|
||
indicator_start_fade (&priv->hindicator, 1.0);
|
||
if (priv->vscrollbar_visible)
|
||
indicator_start_fade (&priv->vindicator, 1.0);
|
||
|
||
if (!on_scrollbar &&
|
||
(event->motion.state &
|
||
(GDK_BUTTON1_MASK | GDK_BUTTON2_MASK | GDK_BUTTON3_MASK)) != 0)
|
||
{
|
||
indicator_set_over (&priv->hindicator, FALSE);
|
||
indicator_set_over (&priv->vindicator, FALSE);
|
||
}
|
||
else if (input_source == GDK_SOURCE_PEN ||
|
||
input_source == GDK_SOURCE_ERASER ||
|
||
(device_name != NULL && strstr (device_name, "TrackPoint")) ||
|
||
(device_name != NULL && strstr (device_name, "DualPoint Stick")))
|
||
{
|
||
indicator_set_over (&priv->hindicator, TRUE);
|
||
indicator_set_over (&priv->vindicator, TRUE);
|
||
}
|
||
else
|
||
{
|
||
if (!check_update_scrollbar_proximity (sw, &priv->vindicator, event))
|
||
check_update_scrollbar_proximity (sw, &priv->hindicator, event);
|
||
else
|
||
indicator_set_over (&priv->hindicator, FALSE);
|
||
}
|
||
}
|
||
else if (event->type == GDK_LEAVE_NOTIFY && on_scrollbar &&
|
||
event->crossing.mode == GDK_CROSSING_UNGRAB)
|
||
{
|
||
check_update_scrollbar_proximity (sw, &priv->vindicator, event);
|
||
check_update_scrollbar_proximity (sw, &priv->hindicator, event);
|
||
}
|
||
|
||
return GDK_EVENT_PROPAGATE;
|
||
}
|
||
|
||
/*
|
||
* _gtk_scrolled_window_get_spacing:
|
||
* @scrolled_window: a scrolled window
|
||
*
|
||
* Gets the spacing between the scrolled window’s scrollbars and
|
||
* the scrolled widget. Used by GtkCombo
|
||
*
|
||
* Returns: the spacing, in pixels.
|
||
*/
|
||
static gint
|
||
_gtk_scrolled_window_get_scrollbar_spacing (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowClass *class;
|
||
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), 0);
|
||
|
||
class = GTK_SCROLLED_WINDOW_GET_CLASS (scrolled_window);
|
||
|
||
if (class->scrollbar_spacing >= 0)
|
||
return class->scrollbar_spacing;
|
||
else
|
||
{
|
||
gint scrollbar_spacing;
|
||
|
||
gtk_widget_style_get (GTK_WIDGET (scrolled_window),
|
||
"scrollbar-spacing", &scrollbar_spacing,
|
||
NULL);
|
||
|
||
return scrollbar_spacing;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_allocate (GtkCssGadget *gadget,
|
||
const GtkAllocation *allocation,
|
||
int baseline,
|
||
GtkAllocation *out_clip,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkBin *bin;
|
||
GtkAllocation relative_allocation;
|
||
GtkAllocation child_allocation;
|
||
GtkWidget *child;
|
||
gint sb_spacing;
|
||
gint sb_width;
|
||
gint sb_height;
|
||
|
||
bin = GTK_BIN (scrolled_window);
|
||
|
||
/* Get possible scrollbar dimensions */
|
||
sb_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
|
||
gtk_widget_get_preferred_height (priv->hscrollbar, &sb_height, NULL);
|
||
gtk_widget_get_preferred_width (priv->vscrollbar, &sb_width, NULL);
|
||
|
||
if (priv->hscrollbar_policy == GTK_POLICY_ALWAYS)
|
||
priv->hscrollbar_visible = TRUE;
|
||
else if (priv->hscrollbar_policy == GTK_POLICY_NEVER ||
|
||
priv->hscrollbar_policy == GTK_POLICY_EXTERNAL)
|
||
priv->hscrollbar_visible = FALSE;
|
||
|
||
if (priv->vscrollbar_policy == GTK_POLICY_ALWAYS)
|
||
priv->vscrollbar_visible = TRUE;
|
||
else if (priv->vscrollbar_policy == GTK_POLICY_NEVER ||
|
||
priv->vscrollbar_policy == GTK_POLICY_EXTERNAL)
|
||
priv->vscrollbar_visible = FALSE;
|
||
|
||
child = gtk_bin_get_child (bin);
|
||
if (child && gtk_widget_get_visible (child))
|
||
{
|
||
gint child_scroll_width;
|
||
gint child_scroll_height;
|
||
GtkScrollablePolicy hscroll_policy;
|
||
GtkScrollablePolicy vscroll_policy;
|
||
gboolean previous_hvis;
|
||
gboolean previous_vvis;
|
||
guint count = 0;
|
||
|
||
hscroll_policy = GTK_IS_SCROLLABLE (child)
|
||
? gtk_scrollable_get_hscroll_policy (GTK_SCROLLABLE (child))
|
||
: GTK_SCROLL_MINIMUM;
|
||
vscroll_policy = GTK_IS_SCROLLABLE (child)
|
||
? gtk_scrollable_get_vscroll_policy (GTK_SCROLLABLE (child))
|
||
: GTK_SCROLL_MINIMUM;
|
||
|
||
/* Determine scrollbar visibility first via hfw apis */
|
||
if (gtk_widget_get_request_mode (child) == GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH)
|
||
{
|
||
if (hscroll_policy == GTK_SCROLL_MINIMUM)
|
||
gtk_widget_get_preferred_width (child, &child_scroll_width, NULL);
|
||
else
|
||
gtk_widget_get_preferred_width (child, NULL, &child_scroll_width);
|
||
|
||
if (priv->vscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
{
|
||
/* First try without a vertical scrollbar if the content will fit the height
|
||
* given the extra width of the scrollbar */
|
||
if (vscroll_policy == GTK_SCROLL_MINIMUM)
|
||
gtk_widget_get_preferred_height_for_width (child,
|
||
MAX (allocation->width, child_scroll_width),
|
||
&child_scroll_height, NULL);
|
||
else
|
||
gtk_widget_get_preferred_height_for_width (child,
|
||
MAX (allocation->width, child_scroll_width),
|
||
NULL, &child_scroll_height);
|
||
|
||
if (priv->hscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
{
|
||
/* Does the content height fit the allocation height ? */
|
||
priv->vscrollbar_visible = child_scroll_height > allocation->height;
|
||
|
||
/* Does the content width fit the allocation with minus a possible scrollbar ? */
|
||
priv->hscrollbar_visible =
|
||
child_scroll_width > allocation->width -
|
||
(priv->vscrollbar_visible && !priv->use_indicators ? sb_width + sb_spacing : 0);
|
||
|
||
/* Now that we've guessed the hscrollbar, does the content height fit
|
||
* the possible new allocation height ?
|
||
*/
|
||
priv->vscrollbar_visible =
|
||
child_scroll_height > allocation->height -
|
||
(priv->hscrollbar_visible && !priv->use_indicators ? sb_height + sb_spacing : 0);
|
||
|
||
/* Now that we've guessed the vscrollbar, does the content width fit
|
||
* the possible new allocation width ?
|
||
*/
|
||
priv->hscrollbar_visible =
|
||
child_scroll_width > allocation->width -
|
||
(priv->vscrollbar_visible && !priv->use_indicators ? sb_width + sb_spacing : 0);
|
||
}
|
||
else /* priv->hscrollbar_policy != GTK_POLICY_AUTOMATIC */
|
||
{
|
||
priv->hscrollbar_visible = policy_may_be_visible (priv->hscrollbar_policy);
|
||
priv->vscrollbar_visible = child_scroll_height > allocation->height -
|
||
(priv->hscrollbar_visible && !priv->use_indicators ? sb_height + sb_spacing : 0);
|
||
}
|
||
}
|
||
else /* priv->vscrollbar_policy != GTK_POLICY_AUTOMATIC */
|
||
{
|
||
priv->vscrollbar_visible = policy_may_be_visible (priv->vscrollbar_policy);
|
||
|
||
if (priv->hscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
priv->hscrollbar_visible =
|
||
child_scroll_width > allocation->width -
|
||
(priv->vscrollbar_visible && !priv->use_indicators ? 0 : sb_width + sb_spacing);
|
||
else
|
||
priv->hscrollbar_visible = policy_may_be_visible (priv->hscrollbar_policy);
|
||
}
|
||
}
|
||
else /* GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT */
|
||
{
|
||
if (vscroll_policy == GTK_SCROLL_MINIMUM)
|
||
gtk_widget_get_preferred_height (child, &child_scroll_height, NULL);
|
||
else
|
||
gtk_widget_get_preferred_height (child, NULL, &child_scroll_height);
|
||
|
||
if (priv->hscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
{
|
||
/* First try without a horizontal scrollbar if the content will fit the width
|
||
* given the extra height of the scrollbar */
|
||
if (hscroll_policy == GTK_SCROLL_MINIMUM)
|
||
gtk_widget_get_preferred_width_for_height (child,
|
||
MAX (allocation->height, child_scroll_height),
|
||
&child_scroll_width, NULL);
|
||
else
|
||
gtk_widget_get_preferred_width_for_height (child,
|
||
MAX (allocation->height, child_scroll_height),
|
||
NULL, &child_scroll_width);
|
||
|
||
if (priv->vscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
{
|
||
/* Does the content width fit the allocation width ? */
|
||
priv->hscrollbar_visible = child_scroll_width > allocation->width;
|
||
|
||
/* Does the content height fit the allocation with minus a possible scrollbar ? */
|
||
priv->vscrollbar_visible =
|
||
child_scroll_height > allocation->height -
|
||
(priv->hscrollbar_visible && !priv->use_indicators ? sb_height + sb_spacing : 0);
|
||
|
||
/* Now that we've guessed the vscrollbar, does the content width fit
|
||
* the possible new allocation width ?
|
||
*/
|
||
priv->hscrollbar_visible =
|
||
child_scroll_width > allocation->width -
|
||
(priv->vscrollbar_visible && !priv->use_indicators ? sb_width + sb_spacing : 0);
|
||
|
||
/* Now that we've guessed the hscrollbar, does the content height fit
|
||
* the possible new allocation height ?
|
||
*/
|
||
priv->vscrollbar_visible =
|
||
child_scroll_height > allocation->height -
|
||
(priv->hscrollbar_visible && !priv->use_indicators ? sb_height + sb_spacing : 0);
|
||
}
|
||
else /* priv->vscrollbar_policy != GTK_POLICY_AUTOMATIC */
|
||
{
|
||
priv->vscrollbar_visible = policy_may_be_visible (priv->vscrollbar_policy);
|
||
priv->hscrollbar_visible = child_scroll_width > allocation->width -
|
||
(priv->vscrollbar_visible && !priv->use_indicators ? sb_width + sb_spacing : 0);
|
||
}
|
||
}
|
||
else /* priv->hscrollbar_policy != GTK_POLICY_AUTOMATIC */
|
||
{
|
||
priv->hscrollbar_visible = policy_may_be_visible (priv->hscrollbar_policy);
|
||
|
||
if (priv->vscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
priv->vscrollbar_visible =
|
||
child_scroll_height > allocation->height -
|
||
(priv->hscrollbar_visible && !priv->use_indicators ? sb_height + sb_spacing : 0);
|
||
else
|
||
priv->vscrollbar_visible = policy_may_be_visible (priv->vscrollbar_policy);
|
||
}
|
||
}
|
||
|
||
/* Now after guessing scrollbar visibility; fall back on the allocation loop which
|
||
* observes the adjustments to detect scrollbar visibility and also avoids
|
||
* infinite recursion
|
||
*/
|
||
do
|
||
{
|
||
previous_hvis = priv->hscrollbar_visible;
|
||
previous_vvis = priv->vscrollbar_visible;
|
||
gtk_scrolled_window_allocate_child (scrolled_window, &relative_allocation);
|
||
|
||
/* Explicitly force scrollbar visibility checks.
|
||
*
|
||
* Since we make a guess above, the child might not decide to update the adjustments
|
||
* if they logically did not change since the last configuration
|
||
*/
|
||
if (priv->hscrollbar)
|
||
gtk_scrolled_window_adjustment_changed
|
||
(gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar)), scrolled_window);
|
||
|
||
if (priv->vscrollbar)
|
||
gtk_scrolled_window_adjustment_changed
|
||
(gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar)), scrolled_window);
|
||
|
||
/* If, after the first iteration, the hscrollbar and the
|
||
* vscrollbar flip visiblity... or if one of the scrollbars flip
|
||
* on each itteration indefinitly/infinitely, then we just need both
|
||
* at this size.
|
||
*/
|
||
if ((count &&
|
||
previous_hvis != priv->hscrollbar_visible &&
|
||
previous_vvis != priv->vscrollbar_visible) || count > 3)
|
||
{
|
||
priv->hscrollbar_visible = TRUE;
|
||
priv->vscrollbar_visible = TRUE;
|
||
|
||
gtk_scrolled_window_allocate_child (scrolled_window, &relative_allocation);
|
||
|
||
break;
|
||
}
|
||
|
||
count++;
|
||
}
|
||
while (previous_hvis != priv->hscrollbar_visible ||
|
||
previous_vvis != priv->vscrollbar_visible);
|
||
}
|
||
else
|
||
{
|
||
priv->hscrollbar_visible = priv->hscrollbar_policy == GTK_POLICY_ALWAYS;
|
||
priv->vscrollbar_visible = priv->vscrollbar_policy == GTK_POLICY_ALWAYS;
|
||
gtk_scrolled_window_relative_allocation (widget, &relative_allocation);
|
||
}
|
||
|
||
gtk_widget_set_child_visible (priv->hscrollbar, priv->hscrollbar_visible);
|
||
if (priv->hscrollbar_visible)
|
||
{
|
||
gtk_scrolled_window_allocate_scrollbar (scrolled_window,
|
||
priv->hscrollbar,
|
||
&child_allocation);
|
||
if (priv->use_indicators)
|
||
{
|
||
gdk_window_move_resize (priv->hindicator.window,
|
||
child_allocation.x,
|
||
child_allocation.y,
|
||
child_allocation.width,
|
||
child_allocation.height);
|
||
child_allocation.x = 0;
|
||
child_allocation.y = 0;
|
||
}
|
||
gtk_widget_size_allocate (priv->hscrollbar, &child_allocation);
|
||
}
|
||
|
||
gtk_widget_set_child_visible (priv->vscrollbar, priv->vscrollbar_visible);
|
||
if (priv->vscrollbar_visible)
|
||
{
|
||
gtk_scrolled_window_allocate_scrollbar (scrolled_window,
|
||
priv->vscrollbar,
|
||
&child_allocation);
|
||
if (priv->use_indicators)
|
||
{
|
||
gdk_window_move_resize (priv->vindicator.window,
|
||
child_allocation.x,
|
||
child_allocation.y,
|
||
child_allocation.width,
|
||
child_allocation.height);
|
||
child_allocation.x = 0;
|
||
child_allocation.y = 0;
|
||
}
|
||
gtk_widget_size_allocate (priv->vscrollbar, &child_allocation);
|
||
}
|
||
|
||
gtk_scrolled_window_check_attach_pan_gesture (scrolled_window);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_measure (GtkCssGadget *gadget,
|
||
GtkOrientation orientation,
|
||
int for_size,
|
||
int *minimum_size,
|
||
int *natural_size,
|
||
int *minimum_baseline,
|
||
int *natural_baseline,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkBin *bin = GTK_BIN (scrolled_window);
|
||
gint extra_width;
|
||
gint extra_height;
|
||
gint scrollbar_spacing;
|
||
GtkRequisition hscrollbar_requisition;
|
||
GtkRequisition vscrollbar_requisition;
|
||
GtkRequisition minimum_req, natural_req;
|
||
GtkWidget *child;
|
||
gint min_child_size, nat_child_size;
|
||
GtkBorder border = { 0 };
|
||
|
||
scrollbar_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
|
||
|
||
extra_width = 0;
|
||
extra_height = 0;
|
||
minimum_req.width = 0;
|
||
minimum_req.height = 0;
|
||
natural_req.width = 0;
|
||
natural_req.height = 0;
|
||
|
||
gtk_widget_get_preferred_size (priv->hscrollbar,
|
||
&hscrollbar_requisition, NULL);
|
||
gtk_widget_get_preferred_size (priv->vscrollbar,
|
||
&vscrollbar_requisition, NULL);
|
||
|
||
child = gtk_bin_get_child (bin);
|
||
|
||
if (GTK_IS_SCROLLABLE (child))
|
||
gtk_scrollable_get_border (GTK_SCROLLABLE (child), &border);
|
||
|
||
if (child && gtk_widget_get_visible (child))
|
||
{
|
||
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
||
{
|
||
gtk_widget_get_preferred_width (child,
|
||
&min_child_size,
|
||
&nat_child_size);
|
||
|
||
if (priv->hscrollbar_policy == GTK_POLICY_NEVER)
|
||
{
|
||
minimum_req.width += min_child_size;
|
||
natural_req.width += nat_child_size;
|
||
}
|
||
else
|
||
{
|
||
if (priv->min_content_width >= 0)
|
||
{
|
||
minimum_req.width = MAX (minimum_req.width, priv->min_content_width);
|
||
natural_req.width = MAX (natural_req.width, priv->min_content_width);
|
||
extra_width = -1;
|
||
}
|
||
else if (policy_may_be_visible (priv->vscrollbar_policy) && !priv->use_indicators)
|
||
{
|
||
minimum_req.width += vscrollbar_requisition.width;
|
||
natural_req.width += vscrollbar_requisition.width;
|
||
}
|
||
}
|
||
}
|
||
else /* GTK_ORIENTATION_VERTICAL */
|
||
{
|
||
gtk_widget_get_preferred_height (child,
|
||
&min_child_size,
|
||
&nat_child_size);
|
||
|
||
if (priv->vscrollbar_policy == GTK_POLICY_NEVER)
|
||
{
|
||
minimum_req.height += min_child_size;
|
||
natural_req.height += nat_child_size;
|
||
}
|
||
else
|
||
{
|
||
if (priv->min_content_height >= 0)
|
||
{
|
||
minimum_req.height = MAX (minimum_req.height, priv->min_content_height);
|
||
natural_req.height = MAX (natural_req.height, priv->min_content_height);
|
||
extra_height = -1;
|
||
}
|
||
else if (policy_may_be_visible (priv->vscrollbar_policy) && !priv->use_indicators)
|
||
{
|
||
minimum_req.height += vscrollbar_requisition.height;
|
||
natural_req.height += vscrollbar_requisition.height;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
if (policy_may_be_visible (priv->hscrollbar_policy))
|
||
{
|
||
minimum_req.width = MAX (minimum_req.width, hscrollbar_requisition.width + border.left + border.right);
|
||
natural_req.width = MAX (natural_req.width, hscrollbar_requisition.width + border.left + border.right);
|
||
if (!priv->use_indicators &&
|
||
(!extra_height || priv->hscrollbar_policy == GTK_POLICY_ALWAYS))
|
||
extra_height = scrollbar_spacing + hscrollbar_requisition.height;
|
||
}
|
||
|
||
if (policy_may_be_visible (priv->vscrollbar_policy))
|
||
{
|
||
minimum_req.height = MAX (minimum_req.height, vscrollbar_requisition.height + border.top + border.bottom);
|
||
natural_req.height = MAX (natural_req.height, vscrollbar_requisition.height + border.top + border.bottom);
|
||
if (!priv->use_indicators &&
|
||
(!extra_width || priv->vscrollbar_policy == GTK_POLICY_ALWAYS))
|
||
extra_width = scrollbar_spacing + vscrollbar_requisition.width;
|
||
}
|
||
|
||
minimum_req.width += MAX (0, extra_width);
|
||
minimum_req.height += MAX (0, extra_height);
|
||
natural_req.width += MAX (0, extra_width);
|
||
natural_req.height += MAX (0, extra_height);
|
||
|
||
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
||
{
|
||
*minimum_size = minimum_req.width;
|
||
*natural_size = natural_req.width;
|
||
}
|
||
else
|
||
{
|
||
*minimum_size = minimum_req.height;
|
||
*natural_size = natural_req.height;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_draw_scrollbars_junction (GtkScrolledWindow *scrolled_window,
|
||
cairo_t *cr)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkWidget *widget = GTK_WIDGET (scrolled_window);
|
||
GtkAllocation content_allocation, hscr_allocation, vscr_allocation;
|
||
GtkStyleContext *context;
|
||
GdkRectangle junction_rect;
|
||
gboolean is_rtl;
|
||
|
||
is_rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
|
||
gtk_widget_get_allocation (GTK_WIDGET (priv->hscrollbar), &hscr_allocation);
|
||
gtk_widget_get_allocation (GTK_WIDGET (priv->vscrollbar), &vscr_allocation);
|
||
gtk_css_gadget_get_content_allocation (priv->gadget, &content_allocation,
|
||
NULL);
|
||
|
||
junction_rect.x = content_allocation.x;
|
||
junction_rect.y = content_allocation.y;
|
||
junction_rect.width = vscr_allocation.width;
|
||
junction_rect.height = hscr_allocation.height;
|
||
|
||
if ((is_rtl &&
|
||
(priv->window_placement == GTK_CORNER_TOP_RIGHT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_RIGHT)) ||
|
||
(!is_rtl &&
|
||
(priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_LEFT)))
|
||
junction_rect.x += hscr_allocation.width;
|
||
|
||
if (priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_TOP_RIGHT)
|
||
junction_rect.y += vscr_allocation.height;
|
||
|
||
context = gtk_widget_get_style_context (widget);
|
||
gtk_style_context_save_named (context, "junction");
|
||
|
||
gtk_render_background (context, cr,
|
||
junction_rect.x, junction_rect.y,
|
||
junction_rect.width, junction_rect.height);
|
||
gtk_render_frame (context, cr,
|
||
junction_rect.x, junction_rect.y,
|
||
junction_rect.width, junction_rect.height);
|
||
|
||
gtk_style_context_restore (context);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_draw_overshoot (GtkScrolledWindow *scrolled_window,
|
||
cairo_t *cr)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkWidget *widget = GTK_WIDGET (scrolled_window);
|
||
gint overshoot_x, overshoot_y;
|
||
GtkStyleContext *context;
|
||
GdkRectangle rect;
|
||
|
||
if (!_gtk_scrolled_window_get_overshoot (scrolled_window, &overshoot_x, &overshoot_y))
|
||
return;
|
||
|
||
context = gtk_widget_get_style_context (widget);
|
||
gtk_scrolled_window_inner_allocation (widget, &rect);
|
||
|
||
overshoot_x = CLAMP (overshoot_x, - MAX_OVERSHOOT_DISTANCE, MAX_OVERSHOOT_DISTANCE);
|
||
overshoot_y = CLAMP (overshoot_y, - MAX_OVERSHOOT_DISTANCE, MAX_OVERSHOOT_DISTANCE);
|
||
|
||
if (overshoot_x > 0)
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->overshoot_node[GTK_POS_RIGHT]);
|
||
gtk_render_background (context, cr, rect.x + rect.width - overshoot_x, rect.y, overshoot_x, rect.height);
|
||
gtk_render_frame (context, cr, rect.x + rect.width - overshoot_x, rect.y, overshoot_x, rect.height);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
else if (overshoot_x < 0)
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->overshoot_node[GTK_POS_LEFT]);
|
||
gtk_render_background (context, cr, rect.x, rect.y, -overshoot_x, rect.height);
|
||
gtk_render_frame (context, cr, rect.x, rect.y, -overshoot_x, rect.height);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
|
||
if (overshoot_y > 0)
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->overshoot_node[GTK_POS_BOTTOM]);
|
||
gtk_render_background (context, cr, rect.x, rect.y + rect.height - overshoot_y, rect.width, overshoot_y);
|
||
gtk_render_frame (context, cr, rect.x, rect.y + rect.height - overshoot_y, rect.width, overshoot_y);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
else if (overshoot_y < 0)
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->overshoot_node[GTK_POS_TOP]);
|
||
gtk_render_background (context, cr, rect.x, rect.y, rect.width, -overshoot_y);
|
||
gtk_render_frame (context, cr, rect.x, rect.y, rect.width, -overshoot_y);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_draw_undershoot (GtkScrolledWindow *scrolled_window,
|
||
cairo_t *cr)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkWidget *widget = GTK_WIDGET (scrolled_window);
|
||
GtkStyleContext *context;
|
||
GdkRectangle rect;
|
||
GtkAdjustment *adj;
|
||
|
||
context = gtk_widget_get_style_context (widget);
|
||
gtk_scrolled_window_inner_allocation (widget, &rect);
|
||
|
||
adj = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
if (gtk_adjustment_get_value (adj) < gtk_adjustment_get_upper (adj) - gtk_adjustment_get_page_size (adj))
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->undershoot_node[GTK_POS_RIGHT]);
|
||
gtk_render_background (context, cr, rect.x + rect.width - UNDERSHOOT_SIZE, rect.y, UNDERSHOOT_SIZE, rect.height);
|
||
gtk_render_frame (context, cr, rect.x + rect.width - UNDERSHOOT_SIZE, rect.y, UNDERSHOOT_SIZE, rect.height);
|
||
|
||
gtk_style_context_restore (context);
|
||
}
|
||
if (gtk_adjustment_get_value (adj) > gtk_adjustment_get_lower (adj))
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->undershoot_node[GTK_POS_LEFT]);
|
||
gtk_render_background (context, cr, rect.x, rect.y, UNDERSHOOT_SIZE, rect.height);
|
||
gtk_render_frame (context, cr, rect.x, rect.y, UNDERSHOOT_SIZE, rect.height);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
|
||
adj = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
if (gtk_adjustment_get_value (adj) < gtk_adjustment_get_upper (adj) - gtk_adjustment_get_page_size (adj))
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->undershoot_node[GTK_POS_BOTTOM]);
|
||
gtk_render_background (context, cr, rect.x, rect.y + rect.height - UNDERSHOOT_SIZE, rect.width, UNDERSHOOT_SIZE);
|
||
gtk_render_frame (context, cr, rect.x, rect.y + rect.height - UNDERSHOOT_SIZE, rect.width, UNDERSHOOT_SIZE);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
if (gtk_adjustment_get_value (adj) > gtk_adjustment_get_lower (adj))
|
||
{
|
||
gtk_style_context_save_to_node (context, priv->undershoot_node[GTK_POS_TOP]);
|
||
gtk_render_background (context, cr, rect.x, rect.y, rect.width, UNDERSHOOT_SIZE);
|
||
gtk_render_frame (context, cr, rect.x, rect.y, rect.width, UNDERSHOOT_SIZE);
|
||
gtk_style_context_restore (context);
|
||
}
|
||
}
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_render (GtkCssGadget *gadget,
|
||
cairo_t *cr,
|
||
int x,
|
||
int y,
|
||
int width,
|
||
int height,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
if (gtk_cairo_should_draw_window (cr, gtk_widget_get_window (widget)))
|
||
{
|
||
if (priv->hscrollbar_visible &&
|
||
priv->vscrollbar_visible)
|
||
gtk_scrolled_window_draw_scrollbars_junction (scrolled_window, cr);
|
||
}
|
||
|
||
GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->draw (widget, cr);
|
||
|
||
if (gtk_cairo_should_draw_window (cr, gtk_widget_get_window (widget)))
|
||
{
|
||
gtk_scrolled_window_draw_undershoot (scrolled_window, cr);
|
||
gtk_scrolled_window_draw_overshoot (scrolled_window, cr);
|
||
}
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_init (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkWidget *widget = GTK_WIDGET (scrolled_window);
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkCssNode *widget_node;
|
||
GQuark classes[4] = {
|
||
g_quark_from_static_string (GTK_STYLE_CLASS_LEFT),
|
||
g_quark_from_static_string (GTK_STYLE_CLASS_RIGHT),
|
||
g_quark_from_static_string (GTK_STYLE_CLASS_TOP),
|
||
g_quark_from_static_string (GTK_STYLE_CLASS_BOTTOM),
|
||
};
|
||
gint i;
|
||
|
||
scrolled_window->priv = priv =
|
||
gtk_scrolled_window_get_instance_private (scrolled_window);
|
||
|
||
gtk_widget_set_has_window (widget, TRUE);
|
||
gtk_widget_set_can_focus (widget, TRUE);
|
||
|
||
/* Instantiated by gtk_scrolled_window_set_[hv]adjustment
|
||
* which are both construct properties
|
||
*/
|
||
priv->hscrollbar = NULL;
|
||
priv->vscrollbar = NULL;
|
||
priv->hscrollbar_policy = GTK_POLICY_AUTOMATIC;
|
||
priv->vscrollbar_policy = GTK_POLICY_AUTOMATIC;
|
||
priv->hscrollbar_visible = FALSE;
|
||
priv->vscrollbar_visible = FALSE;
|
||
priv->focus_out = FALSE;
|
||
priv->window_placement = GTK_CORNER_TOP_LEFT;
|
||
priv->min_content_width = -1;
|
||
priv->min_content_height = -1;
|
||
|
||
priv->overlay_scrolling = TRUE;
|
||
|
||
priv->drag_gesture = gtk_gesture_drag_new (widget);
|
||
gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (priv->drag_gesture), TRUE);
|
||
g_signal_connect_swapped (priv->drag_gesture, "drag-begin",
|
||
G_CALLBACK (scrolled_window_drag_begin_cb),
|
||
scrolled_window);
|
||
g_signal_connect_swapped (priv->drag_gesture, "drag-update",
|
||
G_CALLBACK (scrolled_window_drag_update_cb),
|
||
scrolled_window);
|
||
g_signal_connect_swapped (priv->drag_gesture, "end",
|
||
G_CALLBACK (scrolled_window_drag_end_cb),
|
||
scrolled_window);
|
||
|
||
priv->pan_gesture = gtk_gesture_pan_new (widget, GTK_ORIENTATION_VERTICAL);
|
||
gtk_gesture_group (priv->pan_gesture, priv->drag_gesture);
|
||
gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (priv->pan_gesture), TRUE);
|
||
|
||
priv->swipe_gesture = gtk_gesture_swipe_new (widget);
|
||
gtk_gesture_group (priv->swipe_gesture, priv->drag_gesture);
|
||
gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (priv->swipe_gesture), TRUE);
|
||
g_signal_connect_swapped (priv->swipe_gesture, "swipe",
|
||
G_CALLBACK (scrolled_window_swipe_cb),
|
||
scrolled_window);
|
||
priv->long_press_gesture = gtk_gesture_long_press_new (widget);
|
||
gtk_gesture_group (priv->long_press_gesture, priv->drag_gesture);
|
||
gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (priv->long_press_gesture), TRUE);
|
||
g_signal_connect_swapped (priv->long_press_gesture, "pressed",
|
||
G_CALLBACK (scrolled_window_long_press_cb),
|
||
scrolled_window);
|
||
g_signal_connect_swapped (priv->long_press_gesture, "cancelled",
|
||
G_CALLBACK (scrolled_window_long_press_cancelled_cb),
|
||
scrolled_window);
|
||
|
||
priv->scroll_history = g_array_new (FALSE, FALSE, sizeof (ScrollHistoryElem));
|
||
|
||
gtk_scrolled_window_set_kinetic_scrolling (scrolled_window, TRUE);
|
||
gtk_scrolled_window_set_capture_button_press (scrolled_window, TRUE);
|
||
|
||
_gtk_widget_set_captured_event_handler (widget, captured_event_cb);
|
||
|
||
widget_node = gtk_widget_get_css_node (widget);
|
||
priv->gadget = gtk_css_custom_gadget_new_for_node (widget_node,
|
||
widget,
|
||
gtk_scrolled_window_measure,
|
||
gtk_scrolled_window_allocate,
|
||
gtk_scrolled_window_render,
|
||
NULL, NULL);
|
||
for (i = 0; i < 4; i++)
|
||
{
|
||
priv->overshoot_node[i] = gtk_css_node_new ();
|
||
gtk_css_node_set_name (priv->overshoot_node[i], I_("overshoot"));
|
||
gtk_css_node_add_class (priv->overshoot_node[i], classes[i]);
|
||
gtk_css_node_set_parent (priv->overshoot_node[i], widget_node);
|
||
gtk_css_node_set_state (priv->overshoot_node[i], gtk_css_node_get_state (widget_node));
|
||
g_object_unref (priv->overshoot_node[i]);
|
||
|
||
priv->undershoot_node[i] = gtk_css_node_new ();
|
||
gtk_css_node_set_name (priv->undershoot_node[i], I_("undershoot"));
|
||
gtk_css_node_add_class (priv->undershoot_node[i], classes[i]);
|
||
gtk_css_node_set_parent (priv->undershoot_node[i], widget_node);
|
||
gtk_css_node_set_state (priv->undershoot_node[i], gtk_css_node_get_state (widget_node));
|
||
g_object_unref (priv->undershoot_node[i]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_new:
|
||
* @hadjustment: (allow-none): horizontal adjustment
|
||
* @vadjustment: (allow-none): vertical adjustment
|
||
*
|
||
* Creates a new scrolled window.
|
||
*
|
||
* The two arguments are the scrolled window’s adjustments; these will be
|
||
* shared with the scrollbars and the child widget to keep the bars in sync
|
||
* with the child. Usually you want to pass %NULL for the adjustments, which
|
||
* will cause the scrolled window to create them for you.
|
||
*
|
||
* Returns: a new scrolled window
|
||
*/
|
||
GtkWidget*
|
||
gtk_scrolled_window_new (GtkAdjustment *hadjustment,
|
||
GtkAdjustment *vadjustment)
|
||
{
|
||
GtkWidget *scrolled_window;
|
||
|
||
if (hadjustment)
|
||
g_return_val_if_fail (GTK_IS_ADJUSTMENT (hadjustment), NULL);
|
||
|
||
if (vadjustment)
|
||
g_return_val_if_fail (GTK_IS_ADJUSTMENT (vadjustment), NULL);
|
||
|
||
scrolled_window = g_object_new (GTK_TYPE_SCROLLED_WINDOW,
|
||
"hadjustment", hadjustment,
|
||
"vadjustment", vadjustment,
|
||
NULL);
|
||
|
||
return scrolled_window;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_hadjustment:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @hadjustment: horizontal scroll adjustment
|
||
*
|
||
* Sets the #GtkAdjustment for the horizontal scrollbar.
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_hadjustment (GtkScrolledWindow *scrolled_window,
|
||
GtkAdjustment *hadjustment)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkBin *bin;
|
||
GtkWidget *child;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
if (hadjustment)
|
||
g_return_if_fail (GTK_IS_ADJUSTMENT (hadjustment));
|
||
else
|
||
hadjustment = (GtkAdjustment*) g_object_new (GTK_TYPE_ADJUSTMENT, NULL);
|
||
|
||
bin = GTK_BIN (scrolled_window);
|
||
priv = scrolled_window->priv;
|
||
|
||
if (!priv->hscrollbar)
|
||
{
|
||
priv->hscrollbar = gtk_scrollbar_new (GTK_ORIENTATION_HORIZONTAL, hadjustment);
|
||
|
||
gtk_widget_set_parent (priv->hscrollbar, GTK_WIDGET (scrolled_window));
|
||
g_object_ref (priv->hscrollbar);
|
||
gtk_widget_show (priv->hscrollbar);
|
||
update_scrollbar_positions (scrolled_window);
|
||
}
|
||
else
|
||
{
|
||
GtkAdjustment *old_adjustment;
|
||
|
||
old_adjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
if (old_adjustment == hadjustment)
|
||
return;
|
||
|
||
g_signal_handlers_disconnect_by_func (old_adjustment,
|
||
gtk_scrolled_window_adjustment_changed,
|
||
scrolled_window);
|
||
gtk_adjustment_enable_animation (old_adjustment, NULL, 0);
|
||
gtk_range_set_adjustment (GTK_RANGE (priv->hscrollbar), hadjustment);
|
||
}
|
||
hadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
g_signal_connect (hadjustment,
|
||
"changed",
|
||
G_CALLBACK (gtk_scrolled_window_adjustment_changed),
|
||
scrolled_window);
|
||
g_signal_connect (hadjustment,
|
||
"value-changed",
|
||
G_CALLBACK (gtk_scrolled_window_adjustment_value_changed),
|
||
scrolled_window);
|
||
gtk_scrolled_window_adjustment_changed (hadjustment, scrolled_window);
|
||
gtk_scrolled_window_adjustment_value_changed (hadjustment, scrolled_window);
|
||
|
||
child = gtk_bin_get_child (bin);
|
||
if (GTK_IS_SCROLLABLE (child))
|
||
gtk_scrollable_set_hadjustment (GTK_SCROLLABLE (child), hadjustment);
|
||
|
||
if (gtk_scrolled_window_should_animate (scrolled_window))
|
||
gtk_adjustment_enable_animation (hadjustment, gtk_widget_get_frame_clock (GTK_WIDGET (scrolled_window)), ANIMATION_DURATION);
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_HADJUSTMENT]);
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_vadjustment:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @vadjustment: vertical scroll adjustment
|
||
*
|
||
* Sets the #GtkAdjustment for the vertical scrollbar.
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_vadjustment (GtkScrolledWindow *scrolled_window,
|
||
GtkAdjustment *vadjustment)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkBin *bin;
|
||
GtkWidget *child;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
if (vadjustment)
|
||
g_return_if_fail (GTK_IS_ADJUSTMENT (vadjustment));
|
||
else
|
||
vadjustment = (GtkAdjustment*) g_object_new (GTK_TYPE_ADJUSTMENT, NULL);
|
||
|
||
bin = GTK_BIN (scrolled_window);
|
||
priv = scrolled_window->priv;
|
||
|
||
if (!priv->vscrollbar)
|
||
{
|
||
priv->vscrollbar = gtk_scrollbar_new (GTK_ORIENTATION_VERTICAL, vadjustment);
|
||
|
||
gtk_widget_set_parent (priv->vscrollbar, GTK_WIDGET (scrolled_window));
|
||
g_object_ref (priv->vscrollbar);
|
||
gtk_widget_show (priv->vscrollbar);
|
||
update_scrollbar_positions (scrolled_window);
|
||
}
|
||
else
|
||
{
|
||
GtkAdjustment *old_adjustment;
|
||
|
||
old_adjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
if (old_adjustment == vadjustment)
|
||
return;
|
||
|
||
g_signal_handlers_disconnect_by_func (old_adjustment,
|
||
gtk_scrolled_window_adjustment_changed,
|
||
scrolled_window);
|
||
gtk_adjustment_enable_animation (old_adjustment, NULL, 0);
|
||
gtk_range_set_adjustment (GTK_RANGE (priv->vscrollbar), vadjustment);
|
||
}
|
||
vadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
g_signal_connect (vadjustment,
|
||
"changed",
|
||
G_CALLBACK (gtk_scrolled_window_adjustment_changed),
|
||
scrolled_window);
|
||
g_signal_connect (vadjustment,
|
||
"value-changed",
|
||
G_CALLBACK (gtk_scrolled_window_adjustment_value_changed),
|
||
scrolled_window);
|
||
gtk_scrolled_window_adjustment_changed (vadjustment, scrolled_window);
|
||
gtk_scrolled_window_adjustment_value_changed (vadjustment, scrolled_window);
|
||
|
||
child = gtk_bin_get_child (bin);
|
||
if (GTK_IS_SCROLLABLE (child))
|
||
gtk_scrollable_set_vadjustment (GTK_SCROLLABLE (child), vadjustment);
|
||
|
||
if (gtk_scrolled_window_should_animate (scrolled_window))
|
||
gtk_adjustment_enable_animation (vadjustment, gtk_widget_get_frame_clock (GTK_WIDGET (scrolled_window)), ANIMATION_DURATION);
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_VADJUSTMENT]);
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_hadjustment:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Returns the horizontal scrollbar’s adjustment, used to connect the
|
||
* horizontal scrollbar to the child widget’s horizontal scroll
|
||
* functionality.
|
||
*
|
||
* Returns: (transfer none): the horizontal #GtkAdjustment
|
||
*/
|
||
GtkAdjustment*
|
||
gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
return gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_vadjustment:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Returns the vertical scrollbar’s adjustment, used to connect the
|
||
* vertical scrollbar to the child widget’s vertical scroll functionality.
|
||
*
|
||
* Returns: (transfer none): the vertical #GtkAdjustment
|
||
*/
|
||
GtkAdjustment*
|
||
gtk_scrolled_window_get_vadjustment (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
return gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_hscrollbar:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Returns the horizontal scrollbar of @scrolled_window.
|
||
*
|
||
* Returns: (transfer none): the horizontal scrollbar of the scrolled window.
|
||
*
|
||
* Since: 2.8
|
||
*/
|
||
GtkWidget*
|
||
gtk_scrolled_window_get_hscrollbar (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
|
||
|
||
return scrolled_window->priv->hscrollbar;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_vscrollbar:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Returns the vertical scrollbar of @scrolled_window.
|
||
*
|
||
* Returns: (transfer none): the vertical scrollbar of the scrolled window.
|
||
*
|
||
* Since: 2.8
|
||
*/
|
||
GtkWidget*
|
||
gtk_scrolled_window_get_vscrollbar (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
|
||
|
||
return scrolled_window->priv->vscrollbar;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_policy:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @hscrollbar_policy: policy for horizontal bar
|
||
* @vscrollbar_policy: policy for vertical bar
|
||
*
|
||
* Sets the scrollbar policy for the horizontal and vertical scrollbars.
|
||
*
|
||
* The policy determines when the scrollbar should appear; it is a value
|
||
* from the #GtkPolicyType enumeration. If %GTK_POLICY_ALWAYS, the
|
||
* scrollbar is always present; if %GTK_POLICY_NEVER, the scrollbar is
|
||
* never present; if %GTK_POLICY_AUTOMATIC, the scrollbar is present only
|
||
* if needed (that is, if the slider part of the bar would be smaller
|
||
* than the trough — the display is larger than the page size).
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_policy (GtkScrolledWindow *scrolled_window,
|
||
GtkPolicyType hscrollbar_policy,
|
||
GtkPolicyType vscrollbar_policy)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GObject *object = G_OBJECT (scrolled_window);
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
if ((priv->hscrollbar_policy != hscrollbar_policy) ||
|
||
(priv->vscrollbar_policy != vscrollbar_policy))
|
||
{
|
||
priv->hscrollbar_policy = hscrollbar_policy;
|
||
priv->vscrollbar_policy = vscrollbar_policy;
|
||
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
|
||
g_object_notify_by_pspec (object, properties[PROP_HSCROLLBAR_POLICY]);
|
||
g_object_notify_by_pspec (object, properties[PROP_VSCROLLBAR_POLICY]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_policy:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @hscrollbar_policy: (out) (allow-none): location to store the policy
|
||
* for the horizontal scrollbar, or %NULL
|
||
* @vscrollbar_policy: (out) (allow-none): location to store the policy
|
||
* for the vertical scrollbar, or %NULL
|
||
*
|
||
* Retrieves the current policy values for the horizontal and vertical
|
||
* scrollbars. See gtk_scrolled_window_set_policy().
|
||
*/
|
||
void
|
||
gtk_scrolled_window_get_policy (GtkScrolledWindow *scrolled_window,
|
||
GtkPolicyType *hscrollbar_policy,
|
||
GtkPolicyType *vscrollbar_policy)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
if (hscrollbar_policy)
|
||
*hscrollbar_policy = priv->hscrollbar_policy;
|
||
if (vscrollbar_policy)
|
||
*vscrollbar_policy = priv->vscrollbar_policy;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_set_placement_internal (GtkScrolledWindow *scrolled_window,
|
||
GtkCornerType window_placement)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
if (priv->window_placement != window_placement)
|
||
{
|
||
priv->window_placement = window_placement;
|
||
update_scrollbar_positions (scrolled_window);
|
||
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_WINDOW_PLACEMENT]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_placement:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @window_placement: position of the child window
|
||
*
|
||
* Sets the placement of the contents with respect to the scrollbars
|
||
* for the scrolled window.
|
||
*
|
||
* The default is %GTK_CORNER_TOP_LEFT, meaning the child is
|
||
* in the top left, with the scrollbars underneath and to the right.
|
||
* Other values in #GtkCornerType are %GTK_CORNER_TOP_RIGHT,
|
||
* %GTK_CORNER_BOTTOM_LEFT, and %GTK_CORNER_BOTTOM_RIGHT.
|
||
*
|
||
* See also gtk_scrolled_window_get_placement() and
|
||
* gtk_scrolled_window_unset_placement().
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_placement (GtkScrolledWindow *scrolled_window,
|
||
GtkCornerType window_placement)
|
||
{
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
gtk_scrolled_window_set_placement_internal (scrolled_window, window_placement);
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_placement:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Gets the placement of the contents with respect to the scrollbars
|
||
* for the scrolled window. See gtk_scrolled_window_set_placement().
|
||
*
|
||
* Returns: the current placement value.
|
||
*
|
||
* See also gtk_scrolled_window_set_placement() and
|
||
* gtk_scrolled_window_unset_placement().
|
||
**/
|
||
GtkCornerType
|
||
gtk_scrolled_window_get_placement (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), GTK_CORNER_TOP_LEFT);
|
||
|
||
return scrolled_window->priv->window_placement;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_unset_placement:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Unsets the placement of the contents with respect to the scrollbars
|
||
* for the scrolled window. If no window placement is set for a scrolled
|
||
* window, it defaults to %GTK_CORNER_TOP_LEFT.
|
||
*
|
||
* See also gtk_scrolled_window_set_placement() and
|
||
* gtk_scrolled_window_get_placement().
|
||
*
|
||
* Since: 2.10
|
||
**/
|
||
void
|
||
gtk_scrolled_window_unset_placement (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
gtk_scrolled_window_set_placement_internal (scrolled_window, GTK_CORNER_TOP_LEFT);
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_shadow_type:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @type: kind of shadow to draw around scrolled window contents
|
||
*
|
||
* Changes the type of shadow drawn around the contents of
|
||
* @scrolled_window.
|
||
**/
|
||
void
|
||
gtk_scrolled_window_set_shadow_type (GtkScrolledWindow *scrolled_window,
|
||
GtkShadowType type)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkStyleContext *context;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
g_return_if_fail (type >= GTK_SHADOW_NONE && type <= GTK_SHADOW_ETCHED_OUT);
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
if (priv->shadow_type != type)
|
||
{
|
||
priv->shadow_type = type;
|
||
|
||
context = gtk_widget_get_style_context (GTK_WIDGET (scrolled_window));
|
||
if (type != GTK_SHADOW_NONE)
|
||
gtk_style_context_add_class (context, GTK_STYLE_CLASS_FRAME);
|
||
else
|
||
gtk_style_context_remove_class (context, GTK_STYLE_CLASS_FRAME);
|
||
|
||
if (gtk_widget_is_drawable (GTK_WIDGET (scrolled_window)))
|
||
gtk_widget_queue_draw (GTK_WIDGET (scrolled_window));
|
||
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_SHADOW_TYPE]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_shadow_type:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Gets the shadow type of the scrolled window. See
|
||
* gtk_scrolled_window_set_shadow_type().
|
||
*
|
||
* Returns: the current shadow type
|
||
**/
|
||
GtkShadowType
|
||
gtk_scrolled_window_get_shadow_type (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), GTK_SHADOW_NONE);
|
||
|
||
return scrolled_window->priv->shadow_type;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_kinetic_scrolling:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @kinetic_scrolling: %TRUE to enable kinetic scrolling
|
||
*
|
||
* Turns kinetic scrolling on or off.
|
||
* Kinetic scrolling only applies to devices with source
|
||
* %GDK_SOURCE_TOUCHSCREEN.
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
void
|
||
gtk_scrolled_window_set_kinetic_scrolling (GtkScrolledWindow *scrolled_window,
|
||
gboolean kinetic_scrolling)
|
||
{
|
||
GtkPropagationPhase phase = GTK_PHASE_NONE;
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
priv = scrolled_window->priv;
|
||
if (priv->kinetic_scrolling == kinetic_scrolling)
|
||
return;
|
||
|
||
priv->kinetic_scrolling = kinetic_scrolling;
|
||
gtk_scrolled_window_check_attach_pan_gesture (scrolled_window);
|
||
|
||
if (priv->kinetic_scrolling)
|
||
phase = GTK_PHASE_CAPTURE;
|
||
else
|
||
gtk_scrolled_window_cancel_deceleration (scrolled_window);
|
||
|
||
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->drag_gesture), phase);
|
||
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->swipe_gesture), phase);
|
||
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->long_press_gesture), phase);
|
||
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->pan_gesture), phase);
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_KINETIC_SCROLLING]);
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_kinetic_scrolling:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Returns the specified kinetic scrolling behavior.
|
||
*
|
||
* Returns: the scrolling behavior flags.
|
||
*
|
||
* Since: 3.4
|
||
*/
|
||
gboolean
|
||
gtk_scrolled_window_get_kinetic_scrolling (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), FALSE);
|
||
|
||
return scrolled_window->priv->kinetic_scrolling;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_capture_button_press:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @capture_button_press: %TRUE to capture button presses
|
||
*
|
||
* Changes the behaviour of @scrolled_window wrt. to the initial
|
||
* event that possibly starts kinetic scrolling. When @capture_button_press
|
||
* is set to %TRUE, the event is captured by the scrolled window, and
|
||
* then later replayed if it is meant to go to the child widget.
|
||
*
|
||
* This should be enabled if any child widgets perform non-reversible
|
||
* actions on #GtkWidget::button-press-event. If they don't, and handle
|
||
* additionally handle #GtkWidget::grab-broken-event, it might be better
|
||
* to set @capture_button_press to %FALSE.
|
||
*
|
||
* This setting only has an effect if kinetic scrolling is enabled.
|
||
*
|
||
* Since: 3.4
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_capture_button_press (GtkScrolledWindow *scrolled_window,
|
||
gboolean capture_button_press)
|
||
{
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
scrolled_window->priv->capture_button_press = capture_button_press;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_capture_button_press:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Return whether button presses are captured during kinetic
|
||
* scrolling. See gtk_scrolled_window_set_capture_button_press().
|
||
*
|
||
* Returns: %TRUE if button presses are captured during kinetic scrolling
|
||
*
|
||
* Since: 3.4
|
||
*/
|
||
gboolean
|
||
gtk_scrolled_window_get_capture_button_press (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), FALSE);
|
||
|
||
return scrolled_window->priv->capture_button_press;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_destroy (GtkWidget *widget)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
remove_indicator (scrolled_window, &priv->hindicator);
|
||
remove_indicator (scrolled_window, &priv->vindicator);
|
||
|
||
if (priv->hscrollbar)
|
||
{
|
||
g_signal_handlers_disconnect_by_func (gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar)),
|
||
gtk_scrolled_window_adjustment_changed,
|
||
scrolled_window);
|
||
gtk_widget_unparent (priv->hscrollbar);
|
||
gtk_widget_destroy (priv->hscrollbar);
|
||
g_object_unref (priv->hscrollbar);
|
||
priv->hscrollbar = NULL;
|
||
}
|
||
if (priv->vscrollbar)
|
||
{
|
||
g_signal_handlers_disconnect_by_func (gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar)),
|
||
gtk_scrolled_window_adjustment_changed,
|
||
scrolled_window);
|
||
gtk_widget_unparent (priv->vscrollbar);
|
||
gtk_widget_destroy (priv->vscrollbar);
|
||
g_object_unref (priv->vscrollbar);
|
||
priv->vscrollbar = NULL;
|
||
}
|
||
|
||
if (priv->deceleration_id)
|
||
{
|
||
gtk_widget_remove_tick_callback (widget, priv->deceleration_id);
|
||
priv->deceleration_id = 0;
|
||
}
|
||
|
||
if (priv->scroll_events_overshoot_id)
|
||
{
|
||
g_source_remove (priv->scroll_events_overshoot_id);
|
||
priv->scroll_events_overshoot_id = 0;
|
||
}
|
||
|
||
g_clear_object (&priv->drag_gesture);
|
||
g_clear_object (&priv->swipe_gesture);
|
||
g_clear_object (&priv->long_press_gesture);
|
||
g_clear_object (&priv->gadget);
|
||
g_clear_pointer (&priv->scroll_history, (GDestroyNotify) g_array_unref);
|
||
|
||
GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->destroy (widget);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (object);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_HADJUSTMENT:
|
||
gtk_scrolled_window_set_hadjustment (scrolled_window,
|
||
g_value_get_object (value));
|
||
break;
|
||
case PROP_VADJUSTMENT:
|
||
gtk_scrolled_window_set_vadjustment (scrolled_window,
|
||
g_value_get_object (value));
|
||
break;
|
||
case PROP_HSCROLLBAR_POLICY:
|
||
gtk_scrolled_window_set_policy (scrolled_window,
|
||
g_value_get_enum (value),
|
||
priv->vscrollbar_policy);
|
||
break;
|
||
case PROP_VSCROLLBAR_POLICY:
|
||
gtk_scrolled_window_set_policy (scrolled_window,
|
||
priv->hscrollbar_policy,
|
||
g_value_get_enum (value));
|
||
break;
|
||
case PROP_WINDOW_PLACEMENT:
|
||
gtk_scrolled_window_set_placement_internal (scrolled_window,
|
||
g_value_get_enum (value));
|
||
break;
|
||
case PROP_WINDOW_PLACEMENT_SET:
|
||
/* noop */
|
||
break;
|
||
case PROP_SHADOW_TYPE:
|
||
gtk_scrolled_window_set_shadow_type (scrolled_window,
|
||
g_value_get_enum (value));
|
||
break;
|
||
case PROP_MIN_CONTENT_WIDTH:
|
||
gtk_scrolled_window_set_min_content_width (scrolled_window,
|
||
g_value_get_int (value));
|
||
break;
|
||
case PROP_MIN_CONTENT_HEIGHT:
|
||
gtk_scrolled_window_set_min_content_height (scrolled_window,
|
||
g_value_get_int (value));
|
||
break;
|
||
case PROP_KINETIC_SCROLLING:
|
||
gtk_scrolled_window_set_kinetic_scrolling (scrolled_window,
|
||
g_value_get_boolean (value));
|
||
break;
|
||
case PROP_OVERLAY_SCROLLING:
|
||
gtk_scrolled_window_set_overlay_scrolling (scrolled_window,
|
||
g_value_get_boolean (value));
|
||
break;
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (object);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_HADJUSTMENT:
|
||
g_value_set_object (value,
|
||
G_OBJECT (gtk_scrolled_window_get_hadjustment (scrolled_window)));
|
||
break;
|
||
case PROP_VADJUSTMENT:
|
||
g_value_set_object (value,
|
||
G_OBJECT (gtk_scrolled_window_get_vadjustment (scrolled_window)));
|
||
break;
|
||
case PROP_WINDOW_PLACEMENT:
|
||
g_value_set_enum (value, priv->window_placement);
|
||
break;
|
||
case PROP_WINDOW_PLACEMENT_SET:
|
||
g_value_set_boolean (value, TRUE);
|
||
break;
|
||
case PROP_SHADOW_TYPE:
|
||
g_value_set_enum (value, priv->shadow_type);
|
||
break;
|
||
case PROP_HSCROLLBAR_POLICY:
|
||
g_value_set_enum (value, priv->hscrollbar_policy);
|
||
break;
|
||
case PROP_VSCROLLBAR_POLICY:
|
||
g_value_set_enum (value, priv->vscrollbar_policy);
|
||
break;
|
||
case PROP_MIN_CONTENT_WIDTH:
|
||
g_value_set_int (value, priv->min_content_width);
|
||
break;
|
||
case PROP_MIN_CONTENT_HEIGHT:
|
||
g_value_set_int (value, priv->min_content_height);
|
||
break;
|
||
case PROP_KINETIC_SCROLLING:
|
||
g_value_set_boolean (value, priv->kinetic_scrolling);
|
||
break;
|
||
case PROP_OVERLAY_SCROLLING:
|
||
g_value_set_boolean (value, priv->overlay_scrolling);
|
||
break;
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_inner_allocation (GtkWidget *widget,
|
||
GtkAllocation *rect)
|
||
{
|
||
GtkWidget *child;
|
||
GtkBorder border = { 0 };
|
||
|
||
gtk_scrolled_window_relative_allocation (widget, rect);
|
||
child = gtk_bin_get_child (GTK_BIN (widget));
|
||
if (GTK_IS_SCROLLABLE (child) &&
|
||
gtk_scrollable_get_border (GTK_SCROLLABLE (child), &border))
|
||
{
|
||
rect->x += border.left;
|
||
rect->y += border.top;
|
||
rect->width -= border.left + border.right;
|
||
rect->height -= border.top + border.bottom;
|
||
}
|
||
}
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_draw (GtkWidget *widget,
|
||
cairo_t *cr)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
gtk_css_gadget_draw (priv->gadget, cr);
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_forall (GtkContainer *container,
|
||
gboolean include_internals,
|
||
GtkCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkScrolledWindow *scrolled_window;
|
||
|
||
GTK_CONTAINER_CLASS (gtk_scrolled_window_parent_class)->forall (container,
|
||
include_internals,
|
||
callback,
|
||
callback_data);
|
||
if (include_internals)
|
||
{
|
||
scrolled_window = GTK_SCROLLED_WINDOW (container);
|
||
priv = scrolled_window->priv;
|
||
|
||
if (priv->vscrollbar)
|
||
callback (priv->vscrollbar, callback_data);
|
||
if (priv->hscrollbar)
|
||
callback (priv->hscrollbar, callback_data);
|
||
}
|
||
}
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_scroll_child (GtkScrolledWindow *scrolled_window,
|
||
GtkScrollType scroll,
|
||
gboolean horizontal)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkAdjustment *adjustment = NULL;
|
||
|
||
switch (scroll)
|
||
{
|
||
case GTK_SCROLL_STEP_UP:
|
||
scroll = GTK_SCROLL_STEP_BACKWARD;
|
||
horizontal = FALSE;
|
||
break;
|
||
case GTK_SCROLL_STEP_DOWN:
|
||
scroll = GTK_SCROLL_STEP_FORWARD;
|
||
horizontal = FALSE;
|
||
break;
|
||
case GTK_SCROLL_STEP_LEFT:
|
||
scroll = GTK_SCROLL_STEP_BACKWARD;
|
||
horizontal = TRUE;
|
||
break;
|
||
case GTK_SCROLL_STEP_RIGHT:
|
||
scroll = GTK_SCROLL_STEP_FORWARD;
|
||
horizontal = TRUE;
|
||
break;
|
||
case GTK_SCROLL_PAGE_UP:
|
||
scroll = GTK_SCROLL_PAGE_BACKWARD;
|
||
horizontal = FALSE;
|
||
break;
|
||
case GTK_SCROLL_PAGE_DOWN:
|
||
scroll = GTK_SCROLL_PAGE_FORWARD;
|
||
horizontal = FALSE;
|
||
break;
|
||
case GTK_SCROLL_PAGE_LEFT:
|
||
scroll = GTK_SCROLL_STEP_BACKWARD;
|
||
horizontal = TRUE;
|
||
break;
|
||
case GTK_SCROLL_PAGE_RIGHT:
|
||
scroll = GTK_SCROLL_STEP_FORWARD;
|
||
horizontal = TRUE;
|
||
break;
|
||
case GTK_SCROLL_STEP_BACKWARD:
|
||
case GTK_SCROLL_STEP_FORWARD:
|
||
case GTK_SCROLL_PAGE_BACKWARD:
|
||
case GTK_SCROLL_PAGE_FORWARD:
|
||
case GTK_SCROLL_START:
|
||
case GTK_SCROLL_END:
|
||
break;
|
||
default:
|
||
g_warning ("Invalid scroll type %u for GtkScrolledWindow::scroll-child", scroll);
|
||
return FALSE;
|
||
}
|
||
|
||
if (horizontal)
|
||
{
|
||
if (may_hscroll (scrolled_window))
|
||
adjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
else
|
||
return FALSE;
|
||
}
|
||
else
|
||
{
|
||
if (may_vscroll (scrolled_window))
|
||
adjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
else
|
||
return FALSE;
|
||
}
|
||
|
||
if (adjustment)
|
||
{
|
||
gdouble value = gtk_adjustment_get_value (adjustment);
|
||
|
||
switch (scroll)
|
||
{
|
||
case GTK_SCROLL_STEP_FORWARD:
|
||
value += gtk_adjustment_get_step_increment (adjustment);
|
||
break;
|
||
case GTK_SCROLL_STEP_BACKWARD:
|
||
value -= gtk_adjustment_get_step_increment (adjustment);
|
||
break;
|
||
case GTK_SCROLL_PAGE_FORWARD:
|
||
value += gtk_adjustment_get_page_increment (adjustment);
|
||
break;
|
||
case GTK_SCROLL_PAGE_BACKWARD:
|
||
value -= gtk_adjustment_get_page_increment (adjustment);
|
||
break;
|
||
case GTK_SCROLL_START:
|
||
value = gtk_adjustment_get_lower (adjustment);
|
||
break;
|
||
case GTK_SCROLL_END:
|
||
value = gtk_adjustment_get_upper (adjustment);
|
||
break;
|
||
default:
|
||
g_assert_not_reached ();
|
||
break;
|
||
}
|
||
|
||
gtk_adjustment_animate_to_value (adjustment, value);
|
||
|
||
return TRUE;
|
||
}
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_move_focus_out (GtkScrolledWindow *scrolled_window,
|
||
GtkDirectionType direction_type)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkWidget *toplevel;
|
||
|
||
/* Focus out of the scrolled window entirely. We do this by setting
|
||
* a flag, then propagating the focus motion to the notebook.
|
||
*/
|
||
toplevel = gtk_widget_get_toplevel (GTK_WIDGET (scrolled_window));
|
||
if (!gtk_widget_is_toplevel (toplevel))
|
||
return;
|
||
|
||
g_object_ref (scrolled_window);
|
||
|
||
priv->focus_out = TRUE;
|
||
g_signal_emit_by_name (toplevel, "move-focus", direction_type);
|
||
priv->focus_out = FALSE;
|
||
|
||
g_object_unref (scrolled_window);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_relative_allocation (GtkWidget *widget,
|
||
GtkAllocation *allocation)
|
||
{
|
||
GtkAllocation content_allocation;
|
||
GtkScrolledWindow *scrolled_window;
|
||
GtkScrolledWindowPrivate *priv;
|
||
gint sb_spacing;
|
||
gint sb_width;
|
||
gint sb_height;
|
||
|
||
g_return_if_fail (widget != NULL);
|
||
g_return_if_fail (allocation != NULL);
|
||
|
||
scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
priv = scrolled_window->priv;
|
||
|
||
/* Get possible scrollbar dimensions */
|
||
sb_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
|
||
gtk_widget_get_preferred_height (priv->hscrollbar, &sb_height, NULL);
|
||
gtk_widget_get_preferred_width (priv->vscrollbar, &sb_width, NULL);
|
||
|
||
gtk_css_gadget_get_content_allocation (priv->gadget, &content_allocation, NULL);
|
||
|
||
allocation->x = content_allocation.x;
|
||
allocation->y = content_allocation.y;
|
||
allocation->width = content_allocation.width;
|
||
allocation->height = content_allocation.height;
|
||
|
||
/* Subtract some things from our available allocation size */
|
||
if (priv->vscrollbar_visible && !priv->use_indicators)
|
||
{
|
||
gboolean is_rtl;
|
||
|
||
is_rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
|
||
|
||
if ((!is_rtl &&
|
||
(priv->window_placement == GTK_CORNER_TOP_RIGHT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_RIGHT)) ||
|
||
(is_rtl &&
|
||
(priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_LEFT)))
|
||
allocation->x += (sb_width + sb_spacing);
|
||
|
||
allocation->width = MAX (1, allocation->width - (sb_width + sb_spacing));
|
||
}
|
||
|
||
if (priv->hscrollbar_visible && !priv->use_indicators)
|
||
{
|
||
|
||
if (priv->window_placement == GTK_CORNER_BOTTOM_LEFT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_RIGHT)
|
||
allocation->y += (sb_height + sb_spacing);
|
||
|
||
allocation->height = MAX (1, allocation->height - (sb_height + sb_spacing));
|
||
}
|
||
}
|
||
|
||
static gboolean
|
||
_gtk_scrolled_window_get_overshoot (GtkScrolledWindow *scrolled_window,
|
||
gint *overshoot_x,
|
||
gint *overshoot_y)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkAdjustment *vadjustment, *hadjustment;
|
||
gdouble lower, upper, x, y;
|
||
|
||
/* Vertical overshoot */
|
||
vadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
lower = gtk_adjustment_get_lower (vadjustment);
|
||
upper = gtk_adjustment_get_upper (vadjustment) -
|
||
gtk_adjustment_get_page_size (vadjustment);
|
||
|
||
if (priv->unclamped_vadj_value < lower)
|
||
y = priv->unclamped_vadj_value - lower;
|
||
else if (priv->unclamped_vadj_value > upper)
|
||
y = priv->unclamped_vadj_value - upper;
|
||
else
|
||
y = 0;
|
||
|
||
/* Horizontal overshoot */
|
||
hadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
lower = gtk_adjustment_get_lower (hadjustment);
|
||
upper = gtk_adjustment_get_upper (hadjustment) -
|
||
gtk_adjustment_get_page_size (hadjustment);
|
||
|
||
if (priv->unclamped_hadj_value < lower)
|
||
x = priv->unclamped_hadj_value - lower;
|
||
else if (priv->unclamped_hadj_value > upper)
|
||
x = priv->unclamped_hadj_value - upper;
|
||
else
|
||
x = 0;
|
||
|
||
if (overshoot_x)
|
||
*overshoot_x = x;
|
||
|
||
if (overshoot_y)
|
||
*overshoot_y = y;
|
||
|
||
return (x != 0 || y != 0);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_allocate_child (GtkScrolledWindow *swindow,
|
||
GtkAllocation *relative_allocation)
|
||
{
|
||
GtkWidget *widget = GTK_WIDGET (swindow), *child;
|
||
GtkAllocation child_allocation;
|
||
|
||
child = gtk_bin_get_child (GTK_BIN (widget));
|
||
|
||
gtk_scrolled_window_relative_allocation (widget, relative_allocation);
|
||
|
||
child_allocation.x = relative_allocation->x;
|
||
child_allocation.y = relative_allocation->y;
|
||
child_allocation.width = relative_allocation->width;
|
||
child_allocation.height = relative_allocation->height;
|
||
|
||
gtk_widget_size_allocate (child, &child_allocation);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_allocate_scrollbar (GtkScrolledWindow *scrolled_window,
|
||
GtkWidget *scrollbar,
|
||
GtkAllocation *allocation)
|
||
{
|
||
GtkAllocation child_allocation, content_allocation;
|
||
GtkWidget *widget = GTK_WIDGET (scrolled_window);
|
||
gint sb_spacing, sb_height, sb_width;
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
gtk_scrolled_window_inner_allocation (widget, &content_allocation);
|
||
sb_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
|
||
gtk_widget_get_preferred_height (priv->hscrollbar, &sb_height, NULL);
|
||
gtk_widget_get_preferred_width (priv->vscrollbar, &sb_width, NULL);
|
||
|
||
if (scrollbar == priv->hscrollbar)
|
||
{
|
||
child_allocation.x = content_allocation.x;
|
||
|
||
if (priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_TOP_RIGHT)
|
||
{
|
||
if (priv->use_indicators)
|
||
child_allocation.y = content_allocation.y + content_allocation.height - sb_height;
|
||
else
|
||
child_allocation.y = content_allocation.y + content_allocation.height + sb_spacing;
|
||
}
|
||
else
|
||
{
|
||
if (priv->use_indicators)
|
||
child_allocation.y = content_allocation.y;
|
||
else
|
||
child_allocation.y = content_allocation.y - sb_spacing - sb_height;
|
||
}
|
||
|
||
child_allocation.width = content_allocation.width;
|
||
child_allocation.height = sb_height;
|
||
}
|
||
else if (scrollbar == priv->vscrollbar)
|
||
{
|
||
if ((gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL &&
|
||
(priv->window_placement == GTK_CORNER_TOP_RIGHT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_RIGHT)) ||
|
||
(gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR &&
|
||
(priv->window_placement == GTK_CORNER_TOP_LEFT ||
|
||
priv->window_placement == GTK_CORNER_BOTTOM_LEFT)))
|
||
{
|
||
if (priv->use_indicators)
|
||
child_allocation.x = content_allocation.x + content_allocation.width - sb_width;
|
||
else
|
||
child_allocation.x = content_allocation.x + content_allocation.width + sb_spacing;
|
||
}
|
||
else
|
||
{
|
||
if (priv->use_indicators)
|
||
child_allocation.x = content_allocation.x;
|
||
else
|
||
child_allocation.x = content_allocation.x - sb_spacing - sb_width;
|
||
}
|
||
|
||
child_allocation.y = content_allocation.y;
|
||
child_allocation.width = sb_width;
|
||
child_allocation.height = content_allocation.height;
|
||
}
|
||
|
||
*allocation = child_allocation;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_size_allocate (GtkWidget *widget,
|
||
GtkAllocation *allocation)
|
||
{
|
||
GtkScrolledWindow *scrolled_window;
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkAllocation clip, content_allocation;
|
||
|
||
scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
priv = scrolled_window->priv;
|
||
|
||
gtk_widget_set_allocation (widget, allocation);
|
||
|
||
if (gtk_widget_get_realized (widget))
|
||
gdk_window_move_resize (gtk_widget_get_window (widget),
|
||
allocation->x, allocation->y,
|
||
allocation->width, allocation->height);
|
||
|
||
content_allocation = *allocation;
|
||
content_allocation.x = content_allocation.y = 0;
|
||
gtk_css_gadget_allocate (priv->gadget,
|
||
&content_allocation,
|
||
gtk_widget_get_allocated_baseline (widget),
|
||
&clip);
|
||
|
||
clip.x += allocation->x;
|
||
clip.y += allocation->y;
|
||
gtk_widget_set_clip (widget, &clip);
|
||
}
|
||
|
||
static gboolean
|
||
start_scroll_deceleration_cb (gpointer user_data)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = user_data;
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
priv->scroll_events_overshoot_id = 0;
|
||
|
||
if (!priv->deceleration_id)
|
||
gtk_scrolled_window_start_deceleration (scrolled_window);
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_scroll_event (GtkWidget *widget,
|
||
GdkEventScroll *event)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkScrolledWindow *scrolled_window;
|
||
gboolean handled = FALSE;
|
||
gdouble delta_x;
|
||
gdouble delta_y;
|
||
GdkScrollDirection direction;
|
||
gboolean shifted, start_deceleration = FALSE;
|
||
GdkDevice *source_device;
|
||
|
||
shifted = (event->state & GDK_SHIFT_MASK) != 0;
|
||
|
||
scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
priv = scrolled_window->priv;
|
||
|
||
gtk_scrolled_window_invalidate_overshoot (scrolled_window);
|
||
source_device = gdk_event_get_source_device ((GdkEvent *) event);
|
||
|
||
if (gdk_event_get_scroll_deltas ((GdkEvent *) event, &delta_x, &delta_y))
|
||
{
|
||
if (priv->scroll_device != source_device)
|
||
{
|
||
priv->scroll_device = source_device;
|
||
scroll_history_reset (scrolled_window);
|
||
}
|
||
|
||
scroll_history_push (scrolled_window, event);
|
||
|
||
if (shifted)
|
||
{
|
||
gdouble delta;
|
||
|
||
delta = delta_x;
|
||
delta_x = delta_y;
|
||
delta_y = delta;
|
||
}
|
||
|
||
if (delta_x != 0.0 &&
|
||
may_hscroll (scrolled_window))
|
||
{
|
||
GtkAdjustment *adj;
|
||
gdouble new_value;
|
||
gdouble scroll_unit;
|
||
|
||
adj = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
scroll_unit = get_scroll_unit (scrolled_window, GTK_ORIENTATION_HORIZONTAL);
|
||
|
||
new_value = priv->unclamped_hadj_value + delta_x * scroll_unit;
|
||
_gtk_scrolled_window_set_adjustment_value (scrolled_window, adj,
|
||
new_value);
|
||
handled = TRUE;
|
||
}
|
||
|
||
if (delta_y != 0.0 &&
|
||
may_vscroll (scrolled_window))
|
||
{
|
||
GtkAdjustment *adj;
|
||
gdouble new_value;
|
||
gdouble scroll_unit;
|
||
|
||
adj = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
scroll_unit = get_scroll_unit (scrolled_window, GTK_ORIENTATION_VERTICAL);
|
||
|
||
new_value = priv->unclamped_vadj_value + delta_y * scroll_unit;
|
||
_gtk_scrolled_window_set_adjustment_value (scrolled_window, adj,
|
||
new_value);
|
||
handled = TRUE;
|
||
}
|
||
|
||
/* The libinput driver may generate a final event with dx=dy=0
|
||
* after scrolling finished, start kinetic scrolling when this
|
||
* happens.
|
||
*/
|
||
if (gdk_event_is_scroll_stop_event ((GdkEvent *) event))
|
||
{
|
||
handled = TRUE;
|
||
start_deceleration = TRUE;
|
||
}
|
||
}
|
||
else if (gdk_event_get_scroll_direction ((GdkEvent *)event, &direction))
|
||
{
|
||
GtkWidget *range;
|
||
gboolean may_scroll;
|
||
|
||
if ((!shifted && (direction == GDK_SCROLL_UP || direction == GDK_SCROLL_DOWN)) ||
|
||
(shifted && (direction == GDK_SCROLL_LEFT || direction == GDK_SCROLL_RIGHT)))
|
||
{
|
||
range = priv->vscrollbar;
|
||
may_scroll = may_vscroll (scrolled_window);
|
||
}
|
||
else
|
||
{
|
||
range = priv->hscrollbar;
|
||
may_scroll = may_hscroll (scrolled_window);
|
||
}
|
||
|
||
if (range && may_scroll)
|
||
{
|
||
GtkAdjustment *adj = gtk_range_get_adjustment (GTK_RANGE (range));
|
||
gdouble new_value;
|
||
gdouble delta;
|
||
|
||
delta = _gtk_range_get_wheel_delta (GTK_RANGE (range), event);
|
||
|
||
new_value = CLAMP (gtk_adjustment_get_value (adj) + delta,
|
||
gtk_adjustment_get_lower (adj),
|
||
gtk_adjustment_get_upper (adj) -
|
||
gtk_adjustment_get_page_size (adj));
|
||
|
||
gtk_adjustment_set_value (adj, new_value);
|
||
|
||
handled = TRUE;
|
||
}
|
||
}
|
||
|
||
if (handled)
|
||
{
|
||
gdouble vel_x, vel_y;
|
||
|
||
gtk_scrolled_window_invalidate_overshoot (scrolled_window);
|
||
|
||
if (priv->scroll_events_overshoot_id)
|
||
{
|
||
g_source_remove (priv->scroll_events_overshoot_id);
|
||
priv->scroll_events_overshoot_id = 0;
|
||
}
|
||
|
||
if (start_deceleration &&
|
||
scroll_history_finish (scrolled_window, &vel_x, &vel_y))
|
||
gtk_scrolled_window_decelerate (scrolled_window, vel_x, vel_y);
|
||
else if (_gtk_scrolled_window_get_overshoot (scrolled_window, NULL, NULL))
|
||
{
|
||
priv->scroll_events_overshoot_id =
|
||
gdk_threads_add_timeout (50, start_scroll_deceleration_cb, scrolled_window);
|
||
g_source_set_name_by_id (priv->scroll_events_overshoot_id,
|
||
"[gtk+] start_scroll_deceleration_cb");
|
||
}
|
||
}
|
||
|
||
return handled;
|
||
}
|
||
|
||
static void
|
||
_gtk_scrolled_window_set_adjustment_value (GtkScrolledWindow *scrolled_window,
|
||
GtkAdjustment *adjustment,
|
||
gdouble value)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
gdouble lower, upper, *prev_value;
|
||
GtkPositionType edge_pos;
|
||
gboolean vertical;
|
||
|
||
lower = gtk_adjustment_get_lower (adjustment) - MAX_OVERSHOOT_DISTANCE;
|
||
upper = gtk_adjustment_get_upper (adjustment) -
|
||
gtk_adjustment_get_page_size (adjustment) + MAX_OVERSHOOT_DISTANCE;
|
||
|
||
if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar)))
|
||
vertical = FALSE;
|
||
else if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar)))
|
||
vertical = TRUE;
|
||
else
|
||
return;
|
||
|
||
if (vertical)
|
||
prev_value = &priv->unclamped_vadj_value;
|
||
else
|
||
prev_value = &priv->unclamped_hadj_value;
|
||
|
||
value = CLAMP (value, lower, upper);
|
||
|
||
if (*prev_value == value)
|
||
return;
|
||
|
||
*prev_value = value;
|
||
gtk_adjustment_set_value (adjustment, value);
|
||
|
||
if (value == lower)
|
||
edge_pos = vertical ? GTK_POS_TOP : GTK_POS_LEFT;
|
||
else if (value == upper)
|
||
edge_pos = vertical ? GTK_POS_BOTTOM : GTK_POS_RIGHT;
|
||
else
|
||
return;
|
||
|
||
/* Invert horizontal edge position on RTL */
|
||
if (!vertical &&
|
||
gtk_widget_get_direction (GTK_WIDGET (scrolled_window)) == GTK_TEXT_DIR_RTL)
|
||
edge_pos = (edge_pos == GTK_POS_LEFT) ? GTK_POS_RIGHT : GTK_POS_LEFT;
|
||
|
||
g_signal_emit (scrolled_window, signals[EDGE_OVERSHOT], 0, edge_pos);
|
||
}
|
||
|
||
static gboolean
|
||
scrolled_window_deceleration_cb (GtkWidget *widget,
|
||
GdkFrameClock *frame_clock,
|
||
gpointer user_data)
|
||
{
|
||
KineticScrollData *data = user_data;
|
||
GtkScrolledWindow *scrolled_window = data->scrolled_window;
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkAdjustment *hadjustment, *vadjustment;
|
||
gint64 current_time;
|
||
gdouble position, elapsed;
|
||
|
||
current_time = gdk_frame_clock_get_frame_time (frame_clock);
|
||
elapsed = (current_time - data->last_deceleration_time) / 1000000.0;
|
||
data->last_deceleration_time = current_time;
|
||
|
||
hadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
vadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
|
||
gtk_scrolled_window_invalidate_overshoot (scrolled_window);
|
||
|
||
if (data->hscrolling &&
|
||
gtk_kinetic_scrolling_tick (data->hscrolling, elapsed, &position))
|
||
{
|
||
priv->unclamped_hadj_value = position;
|
||
gtk_adjustment_set_value (hadjustment, position);
|
||
}
|
||
else if (data->hscrolling)
|
||
g_clear_pointer (&data->hscrolling, (GDestroyNotify) gtk_kinetic_scrolling_free);
|
||
|
||
if (data->vscrolling &&
|
||
gtk_kinetic_scrolling_tick (data->vscrolling, elapsed, &position))
|
||
{
|
||
priv->unclamped_vadj_value = position;
|
||
gtk_adjustment_set_value (vadjustment, position);
|
||
}
|
||
else if (data->vscrolling)
|
||
g_clear_pointer (&data->vscrolling, (GDestroyNotify) gtk_kinetic_scrolling_free);
|
||
|
||
if (!data->hscrolling && !data->vscrolling)
|
||
{
|
||
gtk_scrolled_window_cancel_deceleration (scrolled_window);
|
||
return G_SOURCE_REMOVE;
|
||
}
|
||
|
||
gtk_scrolled_window_invalidate_overshoot (scrolled_window);
|
||
|
||
return G_SOURCE_CONTINUE;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_cancel_deceleration (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
if (priv->deceleration_id)
|
||
{
|
||
gtk_widget_remove_tick_callback (GTK_WIDGET (scrolled_window),
|
||
priv->deceleration_id);
|
||
priv->deceleration_id = 0;
|
||
}
|
||
}
|
||
|
||
static void
|
||
kinetic_scroll_data_free (KineticScrollData *data)
|
||
{
|
||
if (data->hscrolling)
|
||
gtk_kinetic_scrolling_free (data->hscrolling);
|
||
if (data->vscrolling)
|
||
gtk_kinetic_scrolling_free (data->vscrolling);
|
||
|
||
g_free (data);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_start_deceleration (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GdkFrameClock *frame_clock;
|
||
KineticScrollData *data;
|
||
|
||
g_return_if_fail (priv->deceleration_id == 0);
|
||
|
||
frame_clock = gtk_widget_get_frame_clock (GTK_WIDGET (scrolled_window));
|
||
|
||
data = g_new0 (KineticScrollData, 1);
|
||
data->scrolled_window = scrolled_window;
|
||
data->last_deceleration_time = gdk_frame_clock_get_frame_time (frame_clock);
|
||
|
||
if (may_hscroll (scrolled_window))
|
||
{
|
||
gdouble lower,upper;
|
||
GtkAdjustment *hadjustment;
|
||
|
||
hadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
lower = gtk_adjustment_get_lower (hadjustment);
|
||
upper = gtk_adjustment_get_upper (hadjustment);
|
||
upper -= gtk_adjustment_get_page_size (hadjustment);
|
||
data->hscrolling =
|
||
gtk_kinetic_scrolling_new (lower,
|
||
upper,
|
||
MAX_OVERSHOOT_DISTANCE,
|
||
DECELERATION_FRICTION,
|
||
OVERSHOOT_FRICTION,
|
||
priv->unclamped_hadj_value,
|
||
priv->x_velocity);
|
||
}
|
||
|
||
if (may_vscroll (scrolled_window))
|
||
{
|
||
gdouble lower,upper;
|
||
GtkAdjustment *vadjustment;
|
||
|
||
vadjustment = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
lower = gtk_adjustment_get_lower(vadjustment);
|
||
upper = gtk_adjustment_get_upper(vadjustment);
|
||
upper -= gtk_adjustment_get_page_size(vadjustment);
|
||
data->vscrolling =
|
||
gtk_kinetic_scrolling_new (lower,
|
||
upper,
|
||
MAX_OVERSHOOT_DISTANCE,
|
||
DECELERATION_FRICTION,
|
||
OVERSHOOT_FRICTION,
|
||
priv->unclamped_vadj_value,
|
||
priv->y_velocity);
|
||
}
|
||
|
||
scrolled_window->priv->deceleration_id =
|
||
gtk_widget_add_tick_callback (GTK_WIDGET (scrolled_window),
|
||
scrolled_window_deceleration_cb, data,
|
||
(GDestroyNotify) kinetic_scroll_data_free);
|
||
}
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_focus (GtkWidget *widget,
|
||
GtkDirectionType direction)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GtkWidget *child;
|
||
gboolean had_focus_child;
|
||
|
||
had_focus_child = gtk_container_get_focus_child (GTK_CONTAINER (widget)) != NULL;
|
||
|
||
if (priv->focus_out)
|
||
{
|
||
priv->focus_out = FALSE; /* Clear this to catch the wrap-around case */
|
||
return FALSE;
|
||
}
|
||
|
||
if (gtk_widget_is_focus (widget))
|
||
return FALSE;
|
||
|
||
/* We only put the scrolled window itself in the focus chain if it
|
||
* isn't possible to focus any children.
|
||
*/
|
||
child = gtk_bin_get_child (GTK_BIN (widget));
|
||
if (child)
|
||
{
|
||
if (gtk_widget_child_focus (child, direction))
|
||
return TRUE;
|
||
}
|
||
|
||
if (!had_focus_child && gtk_widget_get_can_focus (widget))
|
||
{
|
||
gtk_widget_grab_focus (widget);
|
||
return TRUE;
|
||
}
|
||
else
|
||
return FALSE;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_adjustment_changed (GtkAdjustment *adjustment,
|
||
gpointer data)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkScrolledWindow *scrolled_window;
|
||
|
||
scrolled_window = GTK_SCROLLED_WINDOW (data);
|
||
priv = scrolled_window->priv;
|
||
|
||
if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar)))
|
||
{
|
||
if (priv->hscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
{
|
||
gboolean visible;
|
||
|
||
visible = priv->hscrollbar_visible;
|
||
priv->hscrollbar_visible = (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_lower (adjustment) >
|
||
gtk_adjustment_get_page_size (adjustment));
|
||
|
||
if (priv->hscrollbar_visible != visible)
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
}
|
||
}
|
||
else if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar)))
|
||
{
|
||
if (priv->vscrollbar_policy == GTK_POLICY_AUTOMATIC)
|
||
{
|
||
gboolean visible;
|
||
|
||
visible = priv->vscrollbar_visible;
|
||
priv->vscrollbar_visible = (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_lower (adjustment) >
|
||
gtk_adjustment_get_page_size (adjustment));
|
||
|
||
if (priv->vscrollbar_visible != visible)
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
}
|
||
}
|
||
}
|
||
|
||
static void
|
||
maybe_emit_edge_reached (GtkScrolledWindow *scrolled_window,
|
||
GtkAdjustment *adjustment)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
gdouble value, lower, upper, page_size;
|
||
GtkPositionType edge_pos;
|
||
gboolean vertical;
|
||
|
||
if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar)))
|
||
vertical = FALSE;
|
||
else if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar)))
|
||
vertical = TRUE;
|
||
else
|
||
return;
|
||
|
||
value = gtk_adjustment_get_value (adjustment);
|
||
lower = gtk_adjustment_get_lower (adjustment);
|
||
upper = gtk_adjustment_get_upper (adjustment);
|
||
page_size = gtk_adjustment_get_page_size (adjustment);
|
||
|
||
if (value == lower)
|
||
edge_pos = vertical ? GTK_POS_TOP: GTK_POS_LEFT;
|
||
else if (value == upper - page_size)
|
||
edge_pos = vertical ? GTK_POS_BOTTOM : GTK_POS_RIGHT;
|
||
else
|
||
return;
|
||
|
||
if (!vertical &&
|
||
gtk_widget_get_direction (GTK_WIDGET (scrolled_window)) == GTK_TEXT_DIR_RTL)
|
||
edge_pos = (edge_pos == GTK_POS_LEFT) ? GTK_POS_RIGHT : GTK_POS_LEFT;
|
||
|
||
g_signal_emit (scrolled_window, signals[EDGE_REACHED], 0, edge_pos);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_adjustment_value_changed (GtkAdjustment *adjustment,
|
||
gpointer user_data)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = user_data;
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
maybe_emit_edge_reached (scrolled_window, adjustment);
|
||
|
||
/* Allow overshooting for kinetic scrolling operations */
|
||
if (priv->drag_device || priv->deceleration_id)
|
||
return;
|
||
|
||
/* Ensure GtkAdjustment and unclamped values are in sync */
|
||
if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar)))
|
||
priv->unclamped_hadj_value = gtk_adjustment_get_value (adjustment);
|
||
else if (adjustment == gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar)))
|
||
priv->unclamped_vadj_value = gtk_adjustment_get_value (adjustment);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_add (GtkContainer *container,
|
||
GtkWidget *child)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
GtkScrolledWindow *scrolled_window;
|
||
GtkBin *bin;
|
||
GtkWidget *child_widget, *scrollable_child;
|
||
GtkAdjustment *hadj, *vadj;
|
||
|
||
bin = GTK_BIN (container);
|
||
child_widget = gtk_bin_get_child (bin);
|
||
g_return_if_fail (child_widget == NULL);
|
||
|
||
scrolled_window = GTK_SCROLLED_WINDOW (container);
|
||
priv = scrolled_window->priv;
|
||
|
||
/* gtk_scrolled_window_set_[hv]adjustment have the side-effect
|
||
* of creating the scrollbars
|
||
*/
|
||
if (!priv->hscrollbar)
|
||
gtk_scrolled_window_set_hadjustment (scrolled_window, NULL);
|
||
|
||
if (!priv->vscrollbar)
|
||
gtk_scrolled_window_set_vadjustment (scrolled_window, NULL);
|
||
|
||
hadj = gtk_range_get_adjustment (GTK_RANGE (priv->hscrollbar));
|
||
vadj = gtk_range_get_adjustment (GTK_RANGE (priv->vscrollbar));
|
||
|
||
if (GTK_IS_SCROLLABLE (child))
|
||
{
|
||
scrollable_child = child;
|
||
}
|
||
else
|
||
{
|
||
scrollable_child = gtk_viewport_new (hadj, vadj);
|
||
gtk_widget_show (scrollable_child);
|
||
gtk_container_set_focus_hadjustment (GTK_CONTAINER (scrollable_child),
|
||
gtk_scrolled_window_get_hadjustment (GTK_SCROLLED_WINDOW (scrolled_window)));
|
||
gtk_container_set_focus_vadjustment (GTK_CONTAINER (scrollable_child),
|
||
gtk_scrolled_window_get_vadjustment (GTK_SCROLLED_WINDOW (scrolled_window)));
|
||
gtk_container_add (GTK_CONTAINER (scrollable_child), child);
|
||
}
|
||
|
||
_gtk_bin_set_child (bin, scrollable_child);
|
||
gtk_widget_set_parent (scrollable_child, GTK_WIDGET (bin));
|
||
|
||
g_object_set (scrollable_child, "hadjustment", hadj, "vadjustment", vadj, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_remove (GtkContainer *container,
|
||
GtkWidget *child)
|
||
{
|
||
g_object_set (child, "hadjustment", NULL, "vadjustment", NULL, NULL);
|
||
|
||
GTK_CONTAINER_CLASS (gtk_scrolled_window_parent_class)->remove (container, child);
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_add_with_viewport:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @child: the widget you want to scroll
|
||
*
|
||
* Used to add children without native scrolling capabilities. This
|
||
* is simply a convenience function; it is equivalent to adding the
|
||
* unscrollable child to a viewport, then adding the viewport to the
|
||
* scrolled window. If a child has native scrolling, use
|
||
* gtk_container_add() instead of this function.
|
||
*
|
||
* The viewport scrolls the child by moving its #GdkWindow, and takes
|
||
* the size of the child to be the size of its toplevel #GdkWindow.
|
||
* This will be very wrong for most widgets that support native scrolling;
|
||
* for example, if you add a widget such as #GtkTreeView with a viewport,
|
||
* the whole widget will scroll, including the column headings. Thus,
|
||
* widgets with native scrolling support should not be used with the
|
||
* #GtkViewport proxy.
|
||
*
|
||
* A widget supports scrolling natively if it implements the
|
||
* #GtkScrollable interface.
|
||
*
|
||
* Deprecated: 3.8: gtk_container_add() will automatically add
|
||
* a #GtkViewport if the child doesn’t implement #GtkScrollable.
|
||
*/
|
||
void
|
||
gtk_scrolled_window_add_with_viewport (GtkScrolledWindow *scrolled_window,
|
||
GtkWidget *child)
|
||
{
|
||
GtkBin *bin;
|
||
GtkWidget *viewport;
|
||
GtkWidget *child_widget;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
g_return_if_fail (GTK_IS_WIDGET (child));
|
||
g_return_if_fail (gtk_widget_get_parent (child) == NULL);
|
||
|
||
bin = GTK_BIN (scrolled_window);
|
||
child_widget = gtk_bin_get_child (bin);
|
||
|
||
if (child_widget)
|
||
{
|
||
g_return_if_fail (GTK_IS_VIEWPORT (child_widget));
|
||
g_return_if_fail (gtk_bin_get_child (GTK_BIN (child_widget)) == NULL);
|
||
|
||
viewport = child_widget;
|
||
}
|
||
else
|
||
{
|
||
viewport =
|
||
gtk_viewport_new (gtk_scrolled_window_get_hadjustment (scrolled_window),
|
||
gtk_scrolled_window_get_vadjustment (scrolled_window));
|
||
gtk_container_set_focus_hadjustment (GTK_CONTAINER (viewport),
|
||
gtk_scrolled_window_get_hadjustment (GTK_SCROLLED_WINDOW (scrolled_window)));
|
||
gtk_container_set_focus_vadjustment (GTK_CONTAINER (viewport),
|
||
gtk_scrolled_window_get_vadjustment (GTK_SCROLLED_WINDOW (scrolled_window)));
|
||
gtk_container_add (GTK_CONTAINER (scrolled_window), viewport);
|
||
}
|
||
|
||
gtk_widget_show (viewport);
|
||
gtk_container_add (GTK_CONTAINER (viewport), child);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_get_preferred_width (GtkWidget *widget,
|
||
gint *minimum_size,
|
||
gint *natural_size)
|
||
{
|
||
gtk_css_gadget_get_preferred_size (GTK_SCROLLED_WINDOW (widget)->priv->gadget,
|
||
GTK_ORIENTATION_HORIZONTAL,
|
||
-1,
|
||
minimum_size, natural_size,
|
||
NULL, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_get_preferred_height (GtkWidget *widget,
|
||
gint *minimum_size,
|
||
gint *natural_size)
|
||
{
|
||
gtk_css_gadget_get_preferred_size (GTK_SCROLLED_WINDOW (widget)->priv->gadget,
|
||
GTK_ORIENTATION_VERTICAL,
|
||
-1,
|
||
minimum_size, natural_size,
|
||
NULL, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_get_preferred_height_for_width (GtkWidget *widget,
|
||
gint width,
|
||
gint *minimum_height,
|
||
gint *natural_height)
|
||
{
|
||
GTK_WIDGET_GET_CLASS (widget)->get_preferred_height (widget, minimum_height, natural_height);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_get_preferred_width_for_height (GtkWidget *widget,
|
||
gint height,
|
||
gint *minimum_width,
|
||
gint *natural_width)
|
||
{
|
||
GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, minimum_width, natural_width);
|
||
}
|
||
|
||
static gboolean
|
||
gtk_scrolled_window_should_animate (GtkScrolledWindow *sw)
|
||
{
|
||
gboolean animate;
|
||
|
||
if (!gtk_widget_get_mapped (GTK_WIDGET (sw)))
|
||
return FALSE;
|
||
|
||
g_object_get (gtk_widget_get_settings (GTK_WIDGET (sw)),
|
||
"gtk-enable-animations", &animate,
|
||
NULL);
|
||
|
||
return animate;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_update_animating (GtkScrolledWindow *sw)
|
||
{
|
||
GtkAdjustment *adjustment;
|
||
GdkFrameClock *clock = NULL;
|
||
guint duration = 0;
|
||
|
||
if (gtk_scrolled_window_should_animate (sw))
|
||
{
|
||
clock = gtk_widget_get_frame_clock (GTK_WIDGET (sw)),
|
||
duration = ANIMATION_DURATION;
|
||
}
|
||
|
||
adjustment = gtk_range_get_adjustment (GTK_RANGE (sw->priv->hscrollbar));
|
||
gtk_adjustment_enable_animation (adjustment, clock, duration);
|
||
|
||
adjustment = gtk_range_get_adjustment (GTK_RANGE (sw->priv->vscrollbar));
|
||
gtk_adjustment_enable_animation (adjustment, clock, duration);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_map (GtkWidget *widget)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
|
||
GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->map (widget);
|
||
|
||
gtk_scrolled_window_update_animating (scrolled_window);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_unmap (GtkWidget *widget)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
|
||
GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->unmap (widget);
|
||
|
||
gtk_scrolled_window_update_animating (scrolled_window);
|
||
|
||
indicator_stop_fade (&scrolled_window->priv->hindicator);
|
||
indicator_stop_fade (&scrolled_window->priv->vindicator);
|
||
}
|
||
|
||
static GdkWindow *
|
||
create_indicator_window (GtkScrolledWindow *scrolled_window,
|
||
GtkWidget *child)
|
||
{
|
||
GtkWidget *widget = GTK_WIDGET (scrolled_window);
|
||
GdkRGBA transparent = { 0, 0, 0, 0 };
|
||
GtkAllocation allocation;
|
||
GdkWindow *window;
|
||
GdkWindowAttr attributes;
|
||
gint attributes_mask;
|
||
|
||
gtk_scrolled_window_allocate_scrollbar (scrolled_window, child, &allocation);
|
||
|
||
attributes.window_type = GDK_WINDOW_CHILD;
|
||
attributes.wclass = GDK_INPUT_OUTPUT;
|
||
|
||
attributes.width = allocation.width;
|
||
attributes.height = allocation.height;
|
||
attributes.x = allocation.x;
|
||
attributes.y = allocation.y;
|
||
attributes.visual = gtk_widget_get_visual (widget);
|
||
attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
|
||
attributes.event_mask = gtk_widget_get_events (widget);
|
||
|
||
window = gdk_window_new (gtk_widget_get_window (widget),
|
||
&attributes, attributes_mask);
|
||
gtk_widget_register_window (widget, window);
|
||
|
||
gdk_window_set_background_rgba (window, &transparent);
|
||
|
||
if (scrolled_window->priv->use_indicators)
|
||
gtk_widget_set_parent_window (child, window);
|
||
|
||
return window;
|
||
}
|
||
|
||
static void
|
||
indicator_set_fade (Indicator *indicator,
|
||
gdouble pos)
|
||
{
|
||
gboolean visible, changed;
|
||
|
||
changed = indicator->current_pos != pos;
|
||
indicator->current_pos = pos;
|
||
|
||
visible = indicator->current_pos != 0.0 || indicator->target_pos != 0.0;
|
||
|
||
if (visible && !gdk_window_is_visible (indicator->window))
|
||
{
|
||
gdk_window_show (indicator->window);
|
||
indicator->conceil_timer = g_timeout_add (INDICATOR_FADE_OUT_TIME, maybe_hide_indicator, indicator);
|
||
}
|
||
if (!visible && gdk_window_is_visible (indicator->window))
|
||
{
|
||
gdk_window_hide (indicator->window);
|
||
g_source_remove (indicator->conceil_timer);
|
||
indicator->conceil_timer = 0;
|
||
}
|
||
|
||
if (changed)
|
||
{
|
||
gtk_widget_set_opacity (indicator->scrollbar, indicator->current_pos);
|
||
gtk_widget_queue_draw (indicator->scrollbar);
|
||
}
|
||
}
|
||
|
||
static gboolean
|
||
indicator_fade_cb (GtkWidget *widget,
|
||
GdkFrameClock *frame_clock,
|
||
gpointer user_data)
|
||
{
|
||
Indicator *indicator = user_data;
|
||
gdouble t;
|
||
|
||
gtk_progress_tracker_advance_frame (&indicator->tracker,
|
||
gdk_frame_clock_get_frame_time (frame_clock));
|
||
t = gtk_progress_tracker_get_ease_out_cubic (&indicator->tracker, FALSE);
|
||
|
||
indicator_set_fade (indicator,
|
||
indicator->source_pos + (t * (indicator->target_pos - indicator->source_pos)));
|
||
|
||
if (gtk_progress_tracker_get_state (&indicator->tracker) == GTK_PROGRESS_STATE_AFTER)
|
||
{
|
||
indicator->tick_id = 0;
|
||
return FALSE;
|
||
}
|
||
|
||
return TRUE;
|
||
}
|
||
|
||
static void
|
||
indicator_start_fade (Indicator *indicator,
|
||
gdouble target)
|
||
{
|
||
gboolean animations_enabled;
|
||
|
||
if (indicator->target_pos == target)
|
||
return;
|
||
|
||
indicator->target_pos = target;
|
||
|
||
g_object_get (gtk_widget_get_settings (indicator->scrollbar),
|
||
"gtk-enable-animations", &animations_enabled,
|
||
NULL);
|
||
|
||
if (target != 0.0)
|
||
indicator->last_scroll_time = g_get_monotonic_time ();
|
||
|
||
if (gtk_widget_get_mapped (indicator->scrollbar) && animations_enabled)
|
||
{
|
||
indicator->source_pos = indicator->current_pos;
|
||
gtk_progress_tracker_start (&indicator->tracker, INDICATOR_FADE_OUT_DURATION * 1000, 0, 1.0);
|
||
if (indicator->tick_id == 0)
|
||
indicator->tick_id = gtk_widget_add_tick_callback (indicator->scrollbar, indicator_fade_cb, indicator, NULL);
|
||
}
|
||
else
|
||
indicator_set_fade (indicator, target);
|
||
}
|
||
|
||
static void
|
||
indicator_stop_fade (Indicator *indicator)
|
||
{
|
||
if (indicator->tick_id != 0)
|
||
{
|
||
indicator_set_fade (indicator, indicator->target_pos);
|
||
gtk_widget_remove_tick_callback (indicator->scrollbar, indicator->tick_id);
|
||
indicator->tick_id = 0;
|
||
}
|
||
|
||
if (indicator->conceil_timer)
|
||
{
|
||
g_source_remove (indicator->conceil_timer);
|
||
indicator->conceil_timer = 0;
|
||
}
|
||
|
||
gdk_window_hide (indicator->window);
|
||
gtk_progress_tracker_finish (&indicator->tracker);
|
||
indicator->current_pos = indicator->source_pos = indicator->target_pos = 0;
|
||
indicator->last_scroll_time = 0;
|
||
}
|
||
|
||
static gboolean
|
||
maybe_hide_indicator (gpointer data)
|
||
{
|
||
Indicator *indicator = data;
|
||
|
||
if (g_get_monotonic_time () - indicator->last_scroll_time >= INDICATOR_FADE_OUT_DELAY * 1000 &&
|
||
!indicator->over)
|
||
indicator_start_fade (indicator, 0.0);
|
||
|
||
return G_SOURCE_CONTINUE;
|
||
}
|
||
|
||
static void
|
||
indicator_value_changed (GtkAdjustment *adjustment,
|
||
Indicator *indicator)
|
||
{
|
||
indicator->last_scroll_time = g_get_monotonic_time ();
|
||
indicator_start_fade (indicator, 1.0);
|
||
}
|
||
|
||
static void
|
||
setup_indicator (GtkScrolledWindow *scrolled_window,
|
||
Indicator *indicator,
|
||
GtkWidget *scrollbar)
|
||
{
|
||
GtkStyleContext *context;
|
||
GtkAdjustment *adjustment;
|
||
|
||
if (scrollbar == NULL)
|
||
return;
|
||
|
||
context = gtk_widget_get_style_context (scrollbar);
|
||
adjustment = gtk_range_get_adjustment (GTK_RANGE (scrollbar));
|
||
|
||
indicator->scrollbar = scrollbar;
|
||
|
||
g_object_ref (scrollbar);
|
||
gtk_widget_unparent (scrollbar);
|
||
gtk_widget_set_parent_window (scrollbar, indicator->window);
|
||
gtk_widget_set_parent (scrollbar, GTK_WIDGET (scrolled_window));
|
||
g_object_unref (scrollbar);
|
||
|
||
gtk_style_context_add_class (context, "overlay-indicator");
|
||
g_signal_connect (adjustment, "value-changed",
|
||
G_CALLBACK (indicator_value_changed), indicator);
|
||
|
||
gdk_window_hide (indicator->window);
|
||
gtk_widget_set_opacity (scrollbar, 0.0);
|
||
indicator->current_pos = 0.0;
|
||
}
|
||
|
||
static void
|
||
remove_indicator (GtkScrolledWindow *scrolled_window,
|
||
Indicator *indicator)
|
||
{
|
||
GtkWidget *scrollbar;
|
||
GtkStyleContext *context;
|
||
GtkAdjustment *adjustment;
|
||
|
||
if (indicator->scrollbar == NULL)
|
||
return;
|
||
|
||
scrollbar = indicator->scrollbar;
|
||
indicator->scrollbar = NULL;
|
||
|
||
context = gtk_widget_get_style_context (scrollbar);
|
||
adjustment = gtk_range_get_adjustment (GTK_RANGE (scrollbar));
|
||
|
||
gtk_style_context_remove_class (context, "overlay-indicator");
|
||
g_signal_handlers_disconnect_by_func (adjustment, indicator_value_changed, indicator);
|
||
if (indicator->conceil_timer)
|
||
{
|
||
g_source_remove (indicator->conceil_timer);
|
||
indicator->conceil_timer = 0;
|
||
}
|
||
|
||
if (indicator->over_timeout_id)
|
||
{
|
||
g_source_remove (indicator->over_timeout_id);
|
||
indicator->over_timeout_id = 0;
|
||
}
|
||
|
||
if (indicator->tick_id)
|
||
{
|
||
gtk_widget_remove_tick_callback (scrollbar, indicator->tick_id);
|
||
indicator->tick_id = 0;
|
||
}
|
||
|
||
g_object_ref (scrollbar);
|
||
gtk_widget_unparent (scrollbar);
|
||
gtk_widget_set_parent (scrollbar, GTK_WIDGET (scrolled_window));
|
||
g_object_unref (scrollbar);
|
||
|
||
if (indicator->window)
|
||
gdk_window_hide (indicator->window);
|
||
|
||
gtk_widget_set_opacity (scrollbar, 1.0);
|
||
indicator->current_pos = 1.0;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_update_use_indicators (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
gboolean use_indicators;
|
||
|
||
use_indicators = priv->overlay_scrolling;
|
||
|
||
if (g_strcmp0 (g_getenv ("GTK_OVERLAY_SCROLLING"), "0") == 0)
|
||
use_indicators = FALSE;
|
||
|
||
if (priv->use_indicators != use_indicators)
|
||
{
|
||
priv->use_indicators = use_indicators;
|
||
|
||
if (priv->use_indicators)
|
||
{
|
||
setup_indicator (scrolled_window, &priv->hindicator, priv->hscrollbar);
|
||
setup_indicator (scrolled_window, &priv->vindicator, priv->vscrollbar);
|
||
}
|
||
else
|
||
{
|
||
remove_indicator (scrolled_window, &priv->hindicator);
|
||
remove_indicator (scrolled_window, &priv->vindicator);
|
||
}
|
||
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_realize (GtkWidget *widget)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
GdkWindow *window;
|
||
GtkAllocation allocation;
|
||
GdkWindowAttr attributes;
|
||
gint attributes_mask;
|
||
|
||
gtk_widget_get_allocation (widget, &allocation);
|
||
|
||
attributes.window_type = GDK_WINDOW_CHILD;
|
||
attributes.wclass = GDK_INPUT_OUTPUT;
|
||
|
||
attributes.width = allocation.width;
|
||
attributes.height = allocation.height;
|
||
attributes.x = allocation.x;
|
||
attributes.y = allocation.y;
|
||
attributes.visual = gtk_widget_get_visual (widget);
|
||
attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
|
||
attributes.event_mask = gtk_widget_get_events (widget) |
|
||
GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_MASK | GDK_POINTER_MOTION_MASK;
|
||
|
||
window = gdk_window_new (gtk_widget_get_parent_window (widget),
|
||
&attributes, attributes_mask);
|
||
|
||
gtk_widget_set_window (widget, window);
|
||
gtk_widget_register_window (widget, window);
|
||
gtk_widget_set_realized (widget, TRUE);
|
||
|
||
priv->hindicator.window = create_indicator_window (scrolled_window, priv->hscrollbar);
|
||
priv->vindicator.window = create_indicator_window (scrolled_window, priv->vscrollbar);
|
||
|
||
priv->hindicator.scrollbar = priv->hscrollbar;
|
||
priv->vindicator.scrollbar = priv->vscrollbar;
|
||
|
||
gtk_scrolled_window_update_use_indicators (scrolled_window);
|
||
}
|
||
|
||
static void
|
||
indicator_reset (Indicator *indicator)
|
||
{
|
||
if (indicator->conceil_timer)
|
||
{
|
||
g_source_remove (indicator->conceil_timer);
|
||
indicator->conceil_timer = 0;
|
||
}
|
||
|
||
if (indicator->over_timeout_id)
|
||
{
|
||
g_source_remove (indicator->over_timeout_id);
|
||
indicator->over_timeout_id = 0;
|
||
}
|
||
|
||
if (indicator->scrollbar && indicator->tick_id)
|
||
{
|
||
gtk_widget_remove_tick_callback (indicator->scrollbar,
|
||
indicator->tick_id);
|
||
indicator->tick_id = 0;
|
||
}
|
||
|
||
if (indicator->window)
|
||
{
|
||
gdk_window_destroy (indicator->window);
|
||
indicator->window = NULL;
|
||
}
|
||
|
||
indicator->scrollbar = NULL;
|
||
indicator->over = FALSE;
|
||
gtk_progress_tracker_finish (&indicator->tracker);
|
||
indicator->current_pos = indicator->source_pos = indicator->target_pos = 0;
|
||
indicator->last_scroll_time = 0;
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_unrealize (GtkWidget *widget)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
gtk_widget_set_parent_window (priv->hscrollbar, NULL);
|
||
gtk_widget_unregister_window (widget, priv->hindicator.window);
|
||
indicator_reset (&priv->hindicator);
|
||
|
||
gtk_widget_set_parent_window (priv->vscrollbar, NULL);
|
||
gtk_widget_unregister_window (widget, priv->vindicator.window);
|
||
indicator_reset (&priv->hindicator);
|
||
|
||
GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->unrealize (widget);
|
||
}
|
||
|
||
static void
|
||
gtk_scrolled_window_grab_notify (GtkWidget *widget,
|
||
gboolean was_grabbed)
|
||
{
|
||
GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
|
||
GtkScrolledWindowPrivate *priv = scrolled_window->priv;
|
||
|
||
if (priv->drag_device &&
|
||
gtk_widget_device_is_shadowed (widget,
|
||
priv->drag_device))
|
||
{
|
||
if (_gtk_scrolled_window_get_overshoot (scrolled_window, NULL, NULL))
|
||
gtk_scrolled_window_start_deceleration (scrolled_window);
|
||
else
|
||
gtk_scrolled_window_cancel_deceleration (scrolled_window);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_min_content_width:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Gets the minimum content width of @scrolled_window, or -1 if not set.
|
||
*
|
||
* Returns: the minimum content width
|
||
*
|
||
* Since: 3.0
|
||
*/
|
||
gint
|
||
gtk_scrolled_window_get_min_content_width (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), 0);
|
||
|
||
return scrolled_window->priv->min_content_width;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_min_content_width:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @width: the minimal content width
|
||
*
|
||
* Sets the minimum width that @scrolled_window should keep visible.
|
||
* Note that this can and (usually will) be smaller than the minimum
|
||
* size of the content.
|
||
*
|
||
* Since: 3.0
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_min_content_width (GtkScrolledWindow *scrolled_window,
|
||
gint width)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
if (priv->min_content_width != width)
|
||
{
|
||
priv->min_content_width = width;
|
||
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_MIN_CONTENT_WIDTH]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_min_content_height:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Gets the minimal content height of @scrolled_window, or -1 if not set.
|
||
*
|
||
* Returns: the minimal content height
|
||
*
|
||
* Since: 3.0
|
||
*/
|
||
gint
|
||
gtk_scrolled_window_get_min_content_height (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), 0);
|
||
|
||
return scrolled_window->priv->min_content_height;
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_min_content_height:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @height: the minimal content height
|
||
*
|
||
* Sets the minimum height that @scrolled_window should keep visible.
|
||
* Note that this can and (usually will) be smaller than the minimum
|
||
* size of the content.
|
||
*
|
||
* Since: 3.0
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_min_content_height (GtkScrolledWindow *scrolled_window,
|
||
gint height)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
if (priv->min_content_height != height)
|
||
{
|
||
priv->min_content_height = height;
|
||
|
||
gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_MIN_CONTENT_HEIGHT]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_set_overlay_scrolling:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
* @overlay_scrolling: whether to enable overlay scrolling
|
||
*
|
||
* Enables or disables overlay scrolling for this scrolled window.
|
||
*
|
||
* Since: 3.16
|
||
*/
|
||
void
|
||
gtk_scrolled_window_set_overlay_scrolling (GtkScrolledWindow *scrolled_window,
|
||
gboolean overlay_scrolling)
|
||
{
|
||
GtkScrolledWindowPrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
|
||
|
||
priv = scrolled_window->priv;
|
||
|
||
if (priv->overlay_scrolling != overlay_scrolling)
|
||
{
|
||
priv->overlay_scrolling = overlay_scrolling;
|
||
|
||
if (gtk_widget_get_realized (GTK_WIDGET (scrolled_window)))
|
||
gtk_scrolled_window_update_use_indicators (scrolled_window);
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (scrolled_window), properties[PROP_OVERLAY_SCROLLING]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_scrolled_window_get_overlay_scrolling:
|
||
* @scrolled_window: a #GtkScrolledWindow
|
||
*
|
||
* Returns whether overlay scrolling is enabled for this scrolled window.
|
||
*
|
||
* Returns: %TRUE if overlay scrolling is enabled
|
||
*
|
||
* Since: 3.16
|
||
*/
|
||
gboolean
|
||
gtk_scrolled_window_get_overlay_scrolling (GtkScrolledWindow *scrolled_window)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), TRUE);
|
||
|
||
return scrolled_window->priv->overlay_scrolling;
|
||
}
|