forked from AuroraMiddleware/gtk
3fe0fb4ed9
This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
1027 lines
32 KiB
C
1027 lines
32 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, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/*
|
|
* 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"
|
|
|
|
#undef GTK_DISABLE_DEPRECATED
|
|
#include "gtkviewport.h"
|
|
#define GTK_DISABLE_DEPRECATED
|
|
#include "gtkintl.h"
|
|
#include "gtkmarshalers.h"
|
|
#include "gtktypeutils.h"
|
|
#include "gtkscrollable.h"
|
|
#include "gtkprivate.h"
|
|
|
|
|
|
/**
|
|
* SECTION:gtkviewport
|
|
* @Short_description: An adapter which makes widgets scrollable
|
|
* @Title: GtkViewport
|
|
* @See_also:#GtkScrolledWindow, #GtkAdjustment
|
|
*
|
|
* 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
|
|
* #GtkTable, #GtkBox, and so on.
|
|
*
|
|
* If a widget has native scrolling abilities, such as #GtkTextView,
|
|
* #GtkTreeView or #GtkIconview, it can be added to a #GtkScrolledWindow
|
|
* with gtk_container_add(). If a widget does not, you must first add the
|
|
* widget to a #GtkViewport, then add the viewport to the scrolled window.
|
|
* The convenience function gtk_scrolled_window_add_with_viewport() does
|
|
* exactly this, so you can ignore the presence of the viewport.
|
|
*
|
|
* The #GtkViewport will start scrolling content only if allocated less
|
|
* than the child widget's minimum size in a given orientation.
|
|
*/
|
|
|
|
struct _GtkViewportPrivate
|
|
{
|
|
GtkAdjustment *hadjustment;
|
|
GtkAdjustment *vadjustment;
|
|
GtkShadowType shadow_type;
|
|
|
|
GdkWindow *bin_window;
|
|
GdkWindow *view_window;
|
|
|
|
/* GtkScrollablePolicy needs to be checked when
|
|
* driving the scrollable adjustment values */
|
|
guint hscroll_policy : 1;
|
|
guint vscroll_policy : 1;
|
|
};
|
|
|
|
enum {
|
|
PROP_0,
|
|
PROP_HADJUSTMENT,
|
|
PROP_VADJUSTMENT,
|
|
PROP_HSCROLL_POLICY,
|
|
PROP_VSCROLL_POLICY,
|
|
PROP_SHADOW_TYPE
|
|
};
|
|
|
|
|
|
static void gtk_viewport_finalize (GObject *object);
|
|
static void gtk_viewport_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_viewport_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_viewport_destroy (GtkWidget *widget);
|
|
static void gtk_viewport_realize (GtkWidget *widget);
|
|
static void gtk_viewport_unrealize (GtkWidget *widget);
|
|
static gint gtk_viewport_draw (GtkWidget *widget,
|
|
cairo_t *cr);
|
|
static void gtk_viewport_add (GtkContainer *container,
|
|
GtkWidget *widget);
|
|
static void gtk_viewport_size_allocate (GtkWidget *widget,
|
|
GtkAllocation *allocation);
|
|
static void gtk_viewport_adjustment_value_changed (GtkAdjustment *adjustment,
|
|
gpointer data);
|
|
static void gtk_viewport_style_set (GtkWidget *widget,
|
|
GtkStyle *previous_style);
|
|
|
|
static void gtk_viewport_get_preferred_width (GtkWidget *widget,
|
|
gint *minimum_size,
|
|
gint *natural_size);
|
|
static void gtk_viewport_get_preferred_height (GtkWidget *widget,
|
|
gint *minimum_size,
|
|
gint *natural_size);
|
|
|
|
|
|
G_DEFINE_TYPE_WITH_CODE (GtkViewport, gtk_viewport, GTK_TYPE_BIN,
|
|
G_IMPLEMENT_INTERFACE (GTK_TYPE_SCROLLABLE, NULL))
|
|
|
|
static void
|
|
gtk_viewport_class_init (GtkViewportClass *class)
|
|
{
|
|
GObjectClass *gobject_class;
|
|
GtkWidgetClass *widget_class;
|
|
GtkContainerClass *container_class;
|
|
|
|
gobject_class = G_OBJECT_CLASS (class);
|
|
widget_class = (GtkWidgetClass*) class;
|
|
container_class = (GtkContainerClass*) class;
|
|
|
|
gobject_class->finalize = gtk_viewport_finalize;
|
|
gobject_class->set_property = gtk_viewport_set_property;
|
|
gobject_class->get_property = gtk_viewport_get_property;
|
|
|
|
widget_class->destroy = gtk_viewport_destroy;
|
|
widget_class->realize = gtk_viewport_realize;
|
|
widget_class->unrealize = gtk_viewport_unrealize;
|
|
widget_class->draw = gtk_viewport_draw;
|
|
widget_class->size_allocate = gtk_viewport_size_allocate;
|
|
widget_class->style_set = gtk_viewport_style_set;
|
|
widget_class->get_preferred_width = gtk_viewport_get_preferred_width;
|
|
widget_class->get_preferred_height = gtk_viewport_get_preferred_height;
|
|
|
|
container_class->add = gtk_viewport_add;
|
|
|
|
/* GtkScrollable implementation */
|
|
g_object_class_override_property (gobject_class, PROP_HADJUSTMENT, "hadjustment");
|
|
g_object_class_override_property (gobject_class, PROP_VADJUSTMENT, "vadjustment");
|
|
g_object_class_override_property (gobject_class, PROP_HSCROLL_POLICY, "hscroll-policy");
|
|
g_object_class_override_property (gobject_class, PROP_VSCROLL_POLICY, "vscroll-policy");
|
|
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_SHADOW_TYPE,
|
|
g_param_spec_enum ("shadow-type",
|
|
P_("Shadow type"),
|
|
P_("Determines how the shadowed box around the viewport is drawn"),
|
|
GTK_TYPE_SHADOW_TYPE,
|
|
GTK_SHADOW_IN,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
g_type_class_add_private (class, sizeof (GtkViewportPrivate));
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkViewport *viewport;
|
|
|
|
viewport = GTK_VIEWPORT (object);
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_HADJUSTMENT:
|
|
gtk_viewport_set_hadjustment (viewport, g_value_get_object (value));
|
|
break;
|
|
case PROP_VADJUSTMENT:
|
|
gtk_viewport_set_vadjustment (viewport, g_value_get_object (value));
|
|
break;
|
|
case PROP_HSCROLL_POLICY:
|
|
viewport->priv->hscroll_policy = g_value_get_enum (value);
|
|
gtk_widget_queue_resize (GTK_WIDGET (viewport));
|
|
break;
|
|
case PROP_VSCROLL_POLICY:
|
|
viewport->priv->vscroll_policy = g_value_get_enum (value);
|
|
gtk_widget_queue_resize (GTK_WIDGET (viewport));
|
|
break;
|
|
case PROP_SHADOW_TYPE:
|
|
gtk_viewport_set_shadow_type (viewport, g_value_get_enum (value));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (object);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_HADJUSTMENT:
|
|
g_value_set_object (value, priv->hadjustment);
|
|
break;
|
|
case PROP_VADJUSTMENT:
|
|
g_value_set_object (value, priv->vadjustment);
|
|
break;
|
|
case PROP_HSCROLL_POLICY:
|
|
g_value_set_enum (value, priv->hscroll_policy);
|
|
break;
|
|
case PROP_VSCROLL_POLICY:
|
|
g_value_set_enum (value, priv->vscroll_policy);
|
|
break;
|
|
case PROP_SHADOW_TYPE:
|
|
g_value_set_enum (value, priv->shadow_type);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_init (GtkViewport *viewport)
|
|
{
|
|
GtkViewportPrivate *priv;
|
|
|
|
viewport->priv = G_TYPE_INSTANCE_GET_PRIVATE (viewport,
|
|
GTK_TYPE_VIEWPORT,
|
|
GtkViewportPrivate);
|
|
priv = viewport->priv;
|
|
|
|
gtk_widget_set_has_window (GTK_WIDGET (viewport), TRUE);
|
|
|
|
gtk_widget_set_redraw_on_allocate (GTK_WIDGET (viewport), FALSE);
|
|
gtk_container_set_resize_mode (GTK_CONTAINER (viewport), GTK_RESIZE_QUEUE);
|
|
|
|
priv->shadow_type = GTK_SHADOW_IN;
|
|
priv->view_window = NULL;
|
|
priv->bin_window = NULL;
|
|
priv->hadjustment = NULL;
|
|
priv->vadjustment = NULL;
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_new:
|
|
* @hadjustment: horizontal adjustment.
|
|
* @vadjustment: vertical adjustment.
|
|
* @returns: a new #GtkViewport.
|
|
*
|
|
* Creates a new #GtkViewport with the given adjustments.
|
|
*
|
|
**/
|
|
GtkWidget*
|
|
gtk_viewport_new (GtkAdjustment *hadjustment,
|
|
GtkAdjustment *vadjustment)
|
|
{
|
|
GtkWidget *viewport;
|
|
|
|
viewport = g_object_new (GTK_TYPE_VIEWPORT,
|
|
"hadjustment", hadjustment,
|
|
"vadjustment", vadjustment,
|
|
NULL);
|
|
|
|
return viewport;
|
|
}
|
|
|
|
#define ADJUSTMENT_POINTER(viewport, orientation) \
|
|
(((orientation) == GTK_ORIENTATION_HORIZONTAL) ? \
|
|
&(viewport)->priv->hadjustment : &(viewport)->priv->vadjustment)
|
|
|
|
static void
|
|
viewport_disconnect_adjustment (GtkViewport *viewport,
|
|
GtkOrientation orientation)
|
|
{
|
|
GtkAdjustment **adjustmentp = ADJUSTMENT_POINTER (viewport, orientation);
|
|
|
|
if (*adjustmentp)
|
|
{
|
|
g_signal_handlers_disconnect_by_func (*adjustmentp,
|
|
gtk_viewport_adjustment_value_changed,
|
|
viewport);
|
|
g_object_unref (*adjustmentp);
|
|
*adjustmentp = NULL;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_finalize (GObject *object)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (object);
|
|
|
|
viewport_disconnect_adjustment (viewport, GTK_ORIENTATION_HORIZONTAL);
|
|
viewport_disconnect_adjustment (viewport, GTK_ORIENTATION_VERTICAL);
|
|
|
|
G_OBJECT_CLASS (gtk_viewport_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_destroy (GtkWidget *widget)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
|
|
viewport_disconnect_adjustment (viewport, GTK_ORIENTATION_HORIZONTAL);
|
|
viewport_disconnect_adjustment (viewport, GTK_ORIENTATION_VERTICAL);
|
|
|
|
GTK_WIDGET_CLASS (gtk_viewport_parent_class)->destroy (widget);
|
|
}
|
|
|
|
static void
|
|
viewport_get_view_allocation (GtkViewport *viewport,
|
|
GtkAllocation *view_allocation)
|
|
{
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
GtkStyle *style;
|
|
GtkWidget *widget = GTK_WIDGET (viewport);
|
|
GtkAllocation allocation;
|
|
guint border_width;
|
|
|
|
gtk_widget_get_allocation (widget, &allocation);
|
|
border_width = gtk_container_get_border_width (GTK_CONTAINER (viewport));
|
|
|
|
view_allocation->x = 0;
|
|
view_allocation->y = 0;
|
|
|
|
if (priv->shadow_type != GTK_SHADOW_NONE)
|
|
{
|
|
style = gtk_widget_get_style (widget);
|
|
view_allocation->x = style->xthickness;
|
|
view_allocation->y = style->ythickness;
|
|
}
|
|
|
|
view_allocation->width = MAX (1, allocation.width - view_allocation->x * 2 - border_width * 2);
|
|
view_allocation->height = MAX (1, allocation.height - view_allocation->y * 2 - border_width * 2);
|
|
}
|
|
|
|
static void
|
|
viewport_reclamp_adjustment (GtkAdjustment *adjustment,
|
|
gboolean *value_changed)
|
|
{
|
|
gdouble value = adjustment->value;
|
|
|
|
value = CLAMP (value, 0, adjustment->upper - adjustment->page_size);
|
|
if (value != adjustment->value)
|
|
{
|
|
adjustment->value = value;
|
|
if (value_changed)
|
|
*value_changed = TRUE;
|
|
}
|
|
else if (value_changed)
|
|
*value_changed = FALSE;
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_get_hadjustment:
|
|
* @viewport: a #GtkViewport.
|
|
*
|
|
* Returns the horizontal adjustment of the viewport.
|
|
*
|
|
* Return value: (transfer none): the horizontal adjustment of @viewport.
|
|
*
|
|
* Deprecated: 3.0: Use gtk_scrollable_get_hadjustment()
|
|
**/
|
|
GtkAdjustment*
|
|
gtk_viewport_get_hadjustment (GtkViewport *viewport)
|
|
{
|
|
GtkViewportPrivate *priv;
|
|
|
|
g_return_val_if_fail (GTK_IS_VIEWPORT (viewport), NULL);
|
|
|
|
priv = viewport->priv;
|
|
|
|
if (!priv->hadjustment)
|
|
gtk_viewport_set_hadjustment (viewport, NULL);
|
|
|
|
return priv->hadjustment;
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_get_vadjustment:
|
|
* @viewport: a #GtkViewport.
|
|
*
|
|
* Returns the vertical adjustment of the viewport.
|
|
*
|
|
* Return value: (transfer none): the vertical adjustment of @viewport.
|
|
*
|
|
* Deprecated: 3.0: Use gtk_scrollable_get_vadjustment()
|
|
**/
|
|
GtkAdjustment*
|
|
gtk_viewport_get_vadjustment (GtkViewport *viewport)
|
|
{
|
|
GtkViewportPrivate *priv;
|
|
|
|
g_return_val_if_fail (GTK_IS_VIEWPORT (viewport), NULL);
|
|
|
|
priv = viewport->priv;
|
|
|
|
if (!priv->vadjustment)
|
|
gtk_viewport_set_vadjustment (viewport, NULL);
|
|
|
|
return priv->vadjustment;
|
|
}
|
|
|
|
static void
|
|
viewport_set_hadjustment_values (GtkViewport *viewport,
|
|
gboolean *value_changed)
|
|
{
|
|
GtkBin *bin = GTK_BIN (viewport);
|
|
GtkAllocation view_allocation;
|
|
GtkAdjustment *hadjustment = gtk_viewport_get_hadjustment (viewport);
|
|
GtkWidget *child;
|
|
gdouble old_page_size;
|
|
gdouble old_upper;
|
|
gdouble old_value;
|
|
|
|
viewport_get_view_allocation (viewport, &view_allocation);
|
|
|
|
old_page_size = hadjustment->page_size;
|
|
old_upper = hadjustment->upper;
|
|
old_value = hadjustment->value;
|
|
hadjustment->page_size = view_allocation.width;
|
|
hadjustment->step_increment = view_allocation.width * 0.1;
|
|
hadjustment->page_increment = view_allocation.width * 0.9;
|
|
|
|
hadjustment->lower = 0;
|
|
|
|
child = gtk_bin_get_child (bin);
|
|
if (child && gtk_widget_get_visible (child))
|
|
{
|
|
gint minimum_width, natural_width;
|
|
gint scroll_height;
|
|
|
|
if (viewport->priv->vscroll_policy == GTK_SCROLL_MINIMUM)
|
|
gtk_widget_get_preferred_height (child, &scroll_height, NULL);
|
|
else
|
|
gtk_widget_get_preferred_height (child, NULL, &scroll_height);
|
|
|
|
gtk_widget_get_preferred_width_for_height (child,
|
|
MAX (view_allocation.height, scroll_height),
|
|
&minimum_width,
|
|
&natural_width);
|
|
|
|
if (viewport->priv->hscroll_policy == GTK_SCROLL_MINIMUM)
|
|
hadjustment->upper = MAX (minimum_width, view_allocation.width);
|
|
else
|
|
hadjustment->upper = MAX (natural_width, view_allocation.width);
|
|
}
|
|
else
|
|
hadjustment->upper = view_allocation.width;
|
|
|
|
if (gtk_widget_get_direction (GTK_WIDGET (viewport)) == GTK_TEXT_DIR_RTL)
|
|
{
|
|
gdouble dist = old_upper - (old_value + old_page_size);
|
|
hadjustment->value = hadjustment->upper - dist - hadjustment->page_size;
|
|
viewport_reclamp_adjustment (hadjustment, value_changed);
|
|
*value_changed = (old_value != hadjustment->value);
|
|
}
|
|
else
|
|
viewport_reclamp_adjustment (hadjustment, value_changed);
|
|
}
|
|
|
|
static void
|
|
viewport_set_vadjustment_values (GtkViewport *viewport,
|
|
gboolean *value_changed)
|
|
{
|
|
GtkBin *bin = GTK_BIN (viewport);
|
|
GtkAllocation view_allocation;
|
|
GtkAdjustment *vadjustment = gtk_viewport_get_vadjustment (viewport);
|
|
GtkWidget *child;
|
|
|
|
viewport_get_view_allocation (viewport, &view_allocation);
|
|
|
|
vadjustment->page_size = view_allocation.height;
|
|
vadjustment->step_increment = view_allocation.height * 0.1;
|
|
vadjustment->page_increment = view_allocation.height * 0.9;
|
|
|
|
vadjustment->lower = 0;
|
|
|
|
child = gtk_bin_get_child (bin);
|
|
if (child && gtk_widget_get_visible (child))
|
|
{
|
|
gint minimum_height, natural_height;
|
|
gint scroll_width;
|
|
|
|
if (viewport->priv->hscroll_policy == GTK_SCROLL_MINIMUM)
|
|
gtk_widget_get_preferred_width (child, &scroll_width, NULL);
|
|
else
|
|
gtk_widget_get_preferred_width (child, NULL, &scroll_width);
|
|
|
|
gtk_widget_get_preferred_height_for_width (child,
|
|
MAX (view_allocation.width, scroll_width),
|
|
&minimum_height,
|
|
&natural_height);
|
|
|
|
if (viewport->priv->vscroll_policy == GTK_SCROLL_MINIMUM)
|
|
vadjustment->upper = MAX (minimum_height, view_allocation.height);
|
|
else
|
|
vadjustment->upper = MAX (natural_height, view_allocation.height);
|
|
}
|
|
else
|
|
vadjustment->upper = view_allocation.height;
|
|
|
|
viewport_reclamp_adjustment (vadjustment, value_changed);
|
|
}
|
|
|
|
static void
|
|
viewport_set_adjustment (GtkViewport *viewport,
|
|
GtkOrientation orientation,
|
|
GtkAdjustment *adjustment)
|
|
{
|
|
GtkAdjustment **adjustmentp = ADJUSTMENT_POINTER (viewport, orientation);
|
|
gboolean value_changed;
|
|
|
|
if (adjustment && adjustment == *adjustmentp)
|
|
return;
|
|
|
|
if (!adjustment)
|
|
adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
|
|
viewport_disconnect_adjustment (viewport, orientation);
|
|
*adjustmentp = adjustment;
|
|
g_object_ref_sink (adjustment);
|
|
|
|
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
|
viewport_set_hadjustment_values (viewport, &value_changed);
|
|
else
|
|
viewport_set_vadjustment_values (viewport, &value_changed);
|
|
|
|
g_signal_connect (adjustment, "value-changed",
|
|
G_CALLBACK (gtk_viewport_adjustment_value_changed),
|
|
viewport);
|
|
|
|
gtk_adjustment_changed (adjustment);
|
|
|
|
if (value_changed)
|
|
gtk_adjustment_value_changed (adjustment);
|
|
else
|
|
gtk_viewport_adjustment_value_changed (adjustment, viewport);
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_set_hadjustment:
|
|
* @viewport: a #GtkViewport.
|
|
* @adjustment: (allow-none): a #GtkAdjustment.
|
|
*
|
|
* Sets the horizontal adjustment of the viewport.
|
|
*
|
|
* Deprecated: 3.0: Use gtk_scrollable_set_hadjustment()
|
|
**/
|
|
void
|
|
gtk_viewport_set_hadjustment (GtkViewport *viewport,
|
|
GtkAdjustment *adjustment)
|
|
{
|
|
g_return_if_fail (GTK_IS_VIEWPORT (viewport));
|
|
if (adjustment)
|
|
g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
|
|
|
|
viewport_set_adjustment (viewport, GTK_ORIENTATION_HORIZONTAL, adjustment);
|
|
|
|
g_object_notify (G_OBJECT (viewport), "hadjustment");
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_set_vadjustment:
|
|
* @viewport: a #GtkViewport.
|
|
* @adjustment: (allow-none): a #GtkAdjustment.
|
|
*
|
|
* Sets the vertical adjustment of the viewport.
|
|
*
|
|
* Deprecated: 3.0: Use gtk_scrollable_set_vadjustment()
|
|
**/
|
|
void
|
|
gtk_viewport_set_vadjustment (GtkViewport *viewport,
|
|
GtkAdjustment *adjustment)
|
|
{
|
|
g_return_if_fail (GTK_IS_VIEWPORT (viewport));
|
|
if (adjustment)
|
|
g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
|
|
|
|
viewport_set_adjustment (viewport, GTK_ORIENTATION_VERTICAL, adjustment);
|
|
|
|
g_object_notify (G_OBJECT (viewport), "vadjustment");
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_set_shadow_type:
|
|
* @viewport: a #GtkViewport.
|
|
* @type: the new shadow type.
|
|
*
|
|
* Sets the shadow type of the viewport.
|
|
**/
|
|
void
|
|
gtk_viewport_set_shadow_type (GtkViewport *viewport,
|
|
GtkShadowType type)
|
|
{
|
|
GtkViewportPrivate *priv;
|
|
GtkAllocation allocation;
|
|
GtkWidget *widget;
|
|
|
|
g_return_if_fail (GTK_IS_VIEWPORT (viewport));
|
|
|
|
widget = GTK_WIDGET (viewport);
|
|
priv = viewport->priv;
|
|
|
|
if ((GtkShadowType) priv->shadow_type != type)
|
|
{
|
|
priv->shadow_type = type;
|
|
|
|
if (gtk_widget_get_visible (widget))
|
|
{
|
|
gtk_widget_get_allocation (widget, &allocation);
|
|
gtk_widget_size_allocate (widget, &allocation);
|
|
gtk_widget_set_allocation (widget, &allocation);
|
|
gtk_widget_queue_draw (widget);
|
|
}
|
|
|
|
g_object_notify (G_OBJECT (viewport), "shadow-type");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_get_shadow_type:
|
|
* @viewport: a #GtkViewport
|
|
*
|
|
* Gets the shadow type of the #GtkViewport. See
|
|
* gtk_viewport_set_shadow_type().
|
|
*
|
|
* Return value: the shadow type
|
|
**/
|
|
GtkShadowType
|
|
gtk_viewport_get_shadow_type (GtkViewport *viewport)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_VIEWPORT (viewport), GTK_SHADOW_NONE);
|
|
|
|
return viewport->priv->shadow_type;
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_get_bin_window:
|
|
* @viewport: a #GtkViewport
|
|
*
|
|
* Gets the bin window of the #GtkViewport.
|
|
*
|
|
* Return value: (transfer none): a #GdkWindow
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
GdkWindow*
|
|
gtk_viewport_get_bin_window (GtkViewport *viewport)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_VIEWPORT (viewport), NULL);
|
|
|
|
return viewport->priv->bin_window;
|
|
}
|
|
|
|
/**
|
|
* gtk_viewport_get_view_window:
|
|
* @viewport: a #GtkViewport
|
|
*
|
|
* Gets the view window of the #GtkViewport.
|
|
*
|
|
* Return value: (transfer none): a #GdkWindow
|
|
*
|
|
* Since: 2.22
|
|
**/
|
|
GdkWindow*
|
|
gtk_viewport_get_view_window (GtkViewport *viewport)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_VIEWPORT (viewport), NULL);
|
|
|
|
return viewport->priv->view_window;
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_realize (GtkWidget *widget)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
GtkBin *bin = GTK_BIN (widget);
|
|
GtkAdjustment *hadjustment = gtk_viewport_get_hadjustment (viewport);
|
|
GtkAdjustment *vadjustment = gtk_viewport_get_vadjustment (viewport);
|
|
GtkAllocation allocation;
|
|
GtkAllocation view_allocation;
|
|
GtkStyle *style;
|
|
GtkWidget *child;
|
|
GdkWindow *window;
|
|
GdkWindowAttr attributes;
|
|
gint attributes_mask;
|
|
gint event_mask;
|
|
guint border_width;
|
|
|
|
border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
|
|
|
|
gtk_widget_set_realized (widget, TRUE);
|
|
|
|
gtk_widget_get_allocation (widget, &allocation);
|
|
|
|
attributes.x = allocation.x + border_width;
|
|
attributes.y = allocation.y + border_width;
|
|
attributes.width = allocation.width - border_width * 2;
|
|
attributes.height = allocation.height - border_width * 2;
|
|
attributes.window_type = GDK_WINDOW_CHILD;
|
|
attributes.wclass = GDK_INPUT_OUTPUT;
|
|
attributes.visual = gtk_widget_get_visual (widget);
|
|
|
|
event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK;
|
|
/* We select on button_press_mask so that button 4-5 scrolls are trapped.
|
|
*/
|
|
attributes.event_mask = event_mask | GDK_BUTTON_PRESS_MASK;
|
|
|
|
attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
|
|
|
|
window = gdk_window_new (gtk_widget_get_parent_window (widget),
|
|
&attributes, attributes_mask);
|
|
gtk_widget_set_window (widget, window);
|
|
gdk_window_set_user_data (window, viewport);
|
|
|
|
viewport_get_view_allocation (viewport, &view_allocation);
|
|
|
|
attributes.x = view_allocation.x;
|
|
attributes.y = view_allocation.y;
|
|
attributes.width = view_allocation.width;
|
|
attributes.height = view_allocation.height;
|
|
attributes.event_mask = 0;
|
|
|
|
priv->view_window = gdk_window_new (window,
|
|
&attributes, attributes_mask);
|
|
gdk_window_set_user_data (priv->view_window, viewport);
|
|
|
|
attributes.x = - hadjustment->value;
|
|
attributes.y = - vadjustment->value;
|
|
attributes.width = hadjustment->upper;
|
|
attributes.height = vadjustment->upper;
|
|
|
|
attributes.event_mask = event_mask;
|
|
|
|
priv->bin_window = gdk_window_new (priv->view_window, &attributes, attributes_mask);
|
|
gdk_window_set_user_data (priv->bin_window, viewport);
|
|
|
|
child = gtk_bin_get_child (bin);
|
|
if (child)
|
|
gtk_widget_set_parent_window (child, priv->bin_window);
|
|
|
|
gtk_widget_style_attach (widget);
|
|
style = gtk_widget_get_style (widget);
|
|
gtk_style_set_background (style, window, GTK_STATE_NORMAL);
|
|
gtk_style_set_background (style, priv->bin_window, GTK_STATE_NORMAL);
|
|
|
|
gdk_window_show (priv->bin_window);
|
|
gdk_window_show (priv->view_window);
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_unrealize (GtkWidget *widget)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
|
|
gdk_window_set_user_data (priv->view_window, NULL);
|
|
gdk_window_destroy (priv->view_window);
|
|
priv->view_window = NULL;
|
|
|
|
gdk_window_set_user_data (priv->bin_window, NULL);
|
|
gdk_window_destroy (priv->bin_window);
|
|
priv->bin_window = NULL;
|
|
|
|
GTK_WIDGET_CLASS (gtk_viewport_parent_class)->unrealize (widget);
|
|
}
|
|
|
|
static gint
|
|
gtk_viewport_draw (GtkWidget *widget,
|
|
cairo_t *cr)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
int x, y;
|
|
|
|
if (gtk_cairo_should_draw_window (cr, gtk_widget_get_window (widget)))
|
|
{
|
|
gtk_paint_shadow (gtk_widget_get_style (widget),
|
|
cr,
|
|
GTK_STATE_NORMAL, priv->shadow_type,
|
|
widget, "viewport",
|
|
0, 0,
|
|
gdk_window_get_width (gtk_widget_get_window (widget)),
|
|
gdk_window_get_height (gtk_widget_get_window (widget)));
|
|
}
|
|
|
|
if (gtk_cairo_should_draw_window (cr, priv->view_window))
|
|
{
|
|
/* This is a cute hack to ensure the contents of bin_window are
|
|
* restricted to where they are visible. We only need to do this
|
|
* clipping when called via gtk_widget_draw() and not in expose
|
|
* events. And when that happens every window (including this one)
|
|
* should be drawn.
|
|
*/
|
|
gdk_window_get_position (priv->view_window, &x, &y);
|
|
cairo_rectangle (cr, x, y,
|
|
gdk_window_get_width (priv->view_window),
|
|
gdk_window_get_height (priv->view_window));
|
|
cairo_clip (cr);
|
|
}
|
|
|
|
if (gtk_cairo_should_draw_window (cr, priv->bin_window))
|
|
{
|
|
gdk_window_get_position (priv->bin_window, &x, &y);
|
|
gtk_paint_flat_box (gtk_widget_get_style (widget), cr,
|
|
GTK_STATE_NORMAL, GTK_SHADOW_NONE,
|
|
widget, "viewportbin",
|
|
x, y,
|
|
gdk_window_get_width (priv->bin_window),
|
|
gdk_window_get_height (priv->bin_window));
|
|
|
|
GTK_WIDGET_CLASS (gtk_viewport_parent_class)->draw (widget, cr);
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_add (GtkContainer *container,
|
|
GtkWidget *child)
|
|
{
|
|
GtkBin *bin = GTK_BIN (container);
|
|
GtkViewport *viewport = GTK_VIEWPORT (bin);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
|
|
g_return_if_fail (gtk_bin_get_child (bin) == NULL);
|
|
|
|
gtk_widget_set_parent_window (child, priv->bin_window);
|
|
|
|
GTK_CONTAINER_CLASS (gtk_viewport_parent_class)->add (container, child);
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_size_allocate (GtkWidget *widget,
|
|
GtkAllocation *allocation)
|
|
{
|
|
GtkAllocation widget_allocation;
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
GtkBin *bin = GTK_BIN (widget);
|
|
guint border_width;
|
|
gboolean hadjustment_value_changed, vadjustment_value_changed;
|
|
GtkAdjustment *hadjustment = gtk_viewport_get_hadjustment (viewport);
|
|
GtkAdjustment *vadjustment = gtk_viewport_get_vadjustment (viewport);
|
|
GtkAllocation child_allocation;
|
|
GtkWidget *child;
|
|
|
|
border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
|
|
|
|
/* If our size changed, and we have a shadow, queue a redraw on widget->window to
|
|
* redraw the shadow correctly.
|
|
*/
|
|
gtk_widget_get_allocation (widget, &widget_allocation);
|
|
if (gtk_widget_get_mapped (widget) &&
|
|
priv->shadow_type != GTK_SHADOW_NONE &&
|
|
(widget_allocation.width != allocation->width ||
|
|
widget_allocation.height != allocation->height))
|
|
gdk_window_invalidate_rect (gtk_widget_get_window (widget), NULL, FALSE);
|
|
|
|
gtk_widget_set_allocation (widget, allocation);
|
|
|
|
viewport_set_hadjustment_values (viewport, &hadjustment_value_changed);
|
|
viewport_set_vadjustment_values (viewport, &vadjustment_value_changed);
|
|
|
|
child_allocation.x = 0;
|
|
child_allocation.y = 0;
|
|
child_allocation.width = hadjustment->upper;
|
|
child_allocation.height = vadjustment->upper;
|
|
if (gtk_widget_get_realized (widget))
|
|
{
|
|
GtkAllocation view_allocation;
|
|
|
|
gdk_window_move_resize (gtk_widget_get_window (widget),
|
|
allocation->x + border_width,
|
|
allocation->y + border_width,
|
|
allocation->width - border_width * 2,
|
|
allocation->height - border_width * 2);
|
|
|
|
viewport_get_view_allocation (viewport, &view_allocation);
|
|
gdk_window_move_resize (priv->view_window,
|
|
view_allocation.x,
|
|
view_allocation.y,
|
|
view_allocation.width,
|
|
view_allocation.height);
|
|
gdk_window_move_resize (priv->bin_window,
|
|
- hadjustment->value,
|
|
- vadjustment->value,
|
|
child_allocation.width,
|
|
child_allocation.height);
|
|
}
|
|
|
|
child = gtk_bin_get_child (bin);
|
|
if (child && gtk_widget_get_visible (child))
|
|
gtk_widget_size_allocate (child, &child_allocation);
|
|
|
|
gtk_adjustment_changed (hadjustment);
|
|
gtk_adjustment_changed (vadjustment);
|
|
if (hadjustment_value_changed)
|
|
gtk_adjustment_value_changed (hadjustment);
|
|
if (vadjustment_value_changed)
|
|
gtk_adjustment_value_changed (vadjustment);
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_adjustment_value_changed (GtkAdjustment *adjustment,
|
|
gpointer data)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (data);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
GtkBin *bin = GTK_BIN (data);
|
|
GtkWidget *child;
|
|
|
|
child = gtk_bin_get_child (bin);
|
|
if (child && gtk_widget_get_visible (child) &&
|
|
gtk_widget_get_realized (GTK_WIDGET (viewport)))
|
|
{
|
|
GtkAdjustment *hadjustment = gtk_viewport_get_hadjustment (viewport);
|
|
GtkAdjustment *vadjustment = gtk_viewport_get_vadjustment (viewport);
|
|
gint old_x, old_y;
|
|
gint new_x, new_y;
|
|
|
|
gdk_window_get_position (priv->bin_window, &old_x, &old_y);
|
|
new_x = - hadjustment->value;
|
|
new_y = - vadjustment->value;
|
|
|
|
if (new_x != old_x || new_y != old_y)
|
|
{
|
|
gdk_window_move (priv->bin_window, new_x, new_y);
|
|
gdk_window_process_updates (priv->bin_window, TRUE);
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_style_set (GtkWidget *widget,
|
|
GtkStyle *previous_style)
|
|
{
|
|
if (gtk_widget_get_realized (widget) &&
|
|
gtk_widget_get_has_window (widget))
|
|
{
|
|
GtkStyle *style;
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
|
|
style = gtk_widget_get_style (widget);
|
|
gtk_style_set_background (style, priv->bin_window, GTK_STATE_NORMAL);
|
|
gtk_style_set_background (style,
|
|
gtk_widget_get_window (widget),
|
|
gtk_widget_get_state (widget));
|
|
}
|
|
}
|
|
|
|
|
|
static void
|
|
gtk_viewport_get_preferred_size (GtkWidget *widget,
|
|
GtkOrientation orientation,
|
|
gint *minimum_size,
|
|
gint *natural_size)
|
|
{
|
|
GtkViewport *viewport = GTK_VIEWPORT (widget);
|
|
GtkViewportPrivate *priv = viewport->priv;
|
|
GtkStyle *style;
|
|
GtkWidget *child;
|
|
gint child_min, child_nat;
|
|
gint minimum, natural;
|
|
|
|
child = gtk_bin_get_child (GTK_BIN (widget));
|
|
|
|
/* XXX This should probably be (border_width * 2); but GTK+ has
|
|
* been doing this with a single border for a while now...
|
|
*/
|
|
minimum = gtk_container_get_border_width (GTK_CONTAINER (widget));
|
|
|
|
if (priv->shadow_type != GTK_SHADOW_NONE)
|
|
{
|
|
style = gtk_widget_get_style (GTK_WIDGET (widget));
|
|
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
|
minimum += 2 * style->xthickness;
|
|
else
|
|
minimum += 2 * style->ythickness;
|
|
}
|
|
|
|
natural = minimum;
|
|
|
|
if (child && gtk_widget_get_visible (child))
|
|
{
|
|
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
|
gtk_widget_get_preferred_width (child, &child_min, &child_nat);
|
|
else
|
|
gtk_widget_get_preferred_height (child, &child_min, &child_nat);
|
|
|
|
minimum += child_min;
|
|
natural += child_nat;
|
|
}
|
|
|
|
if (minimum_size)
|
|
*minimum_size = minimum;
|
|
|
|
if (natural_size)
|
|
*natural_size = natural;
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_get_preferred_width (GtkWidget *widget,
|
|
gint *minimum_size,
|
|
gint *natural_size)
|
|
{
|
|
gtk_viewport_get_preferred_size (widget, GTK_ORIENTATION_HORIZONTAL, minimum_size, natural_size);
|
|
}
|
|
|
|
static void
|
|
gtk_viewport_get_preferred_height (GtkWidget *widget,
|
|
gint *minimum_size,
|
|
gint *natural_size)
|
|
{
|
|
gtk_viewport_get_preferred_size (widget, GTK_ORIENTATION_VERTICAL, minimum_size, natural_size);
|
|
}
|