]> Pileus Git - ~andy/gtk/blob - gtk/gtkscrolledwindow.c
gtk/gtkcellview.c gtk/gtklabel.c gtk/gtklayout.c gtk/gtklist.c
[~andy/gtk] / gtk / gtkscrolledwindow.c
1 /* GTK - The GIMP Toolkit
2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the
16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17  * Boston, MA 02111-1307, USA.
18  */
19
20 /*
21  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
22  * file for a list of people on the GTK+ Team.  See the ChangeLog
23  * files for a list of changes.  These files are distributed with
24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
25  */
26
27 #include <config.h>
28 #include <math.h>
29 #include <gdk/gdkkeysyms.h>
30 #include "gtkbindings.h"
31 #include "gtkmarshalers.h"
32 #include "gtkscrolledwindow.h"
33 #include "gtkwindow.h"
34 #include "gtkprivate.h"
35 #include "gtkintl.h"
36 #include "gtkalias.h"
37
38
39 /* scrolled window policy and size requisition handling:
40  *
41  * gtk size requisition works as follows:
42  *   a widget upon size-request reports the width and height that it finds
43  *   to be best suited to display its contents, including children.
44  *   the width and/or height reported from a widget upon size requisition
45  *   may be overidden by the user by specifying a width and/or height
46  *   other than 0 through gtk_widget_set_size_request().
47  *
48  * a scrolled window needs (for implementing all three policy types) to
49  * request its width and height based on two different rationales.
50  * 1)   the user wants the scrolled window to just fit into the space
51  *      that it gets allocated for a specifc dimension.
52  * 1.1) this does not apply if the user specified a concrete value
53  *      value for that specific dimension by either specifying usize for the
54  *      scrolled window or for its child.
55  * 2)   the user wants the scrolled window to take as much space up as
56  *      is desired by the child for a specifc dimension (i.e. POLICY_NEVER).
57  *
58  * also, kinda obvious:
59  * 3)   a user would certainly not have choosen a scrolled window as a container
60  *      for the child, if the resulting allocation takes up more space than the
61  *      child would have allocated without the scrolled window.
62  *
63  * conclusions:
64  * A) from 1) follows: the scrolled window shouldn't request more space for a
65  *    specifc dimension than is required at minimum.
66  * B) from 1.1) follows: the requisition may be overidden by usize of the scrolled
67  *    window (done automatically) or by usize of the child (needs to be checked).
68  * C) from 2) follows: for POLICY_NEVER, the scrolled window simply reports the
69  *    child's dimension.
70  * D) from 3) follows: the scrolled window child's minimum width and minimum height
71  *    under A) at least correspond to the space taken up by its scrollbars.
72  */
73
74 #define DEFAULT_SCROLLBAR_SPACING  3
75
76 typedef struct {
77         gboolean window_placement_set;
78         GtkCornerType real_window_placement;
79 } GtkScrolledWindowPrivate;
80
81 #define GTK_SCROLLED_WINDOW_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_SCROLLED_WINDOW, GtkScrolledWindowPrivate))
82
83 enum {
84   PROP_0,
85   PROP_HADJUSTMENT,
86   PROP_VADJUSTMENT,
87   PROP_HSCROLLBAR_POLICY,
88   PROP_VSCROLLBAR_POLICY,
89   PROP_WINDOW_PLACEMENT,
90   PROP_WINDOW_PLACEMENT_SET,
91   PROP_SHADOW_TYPE,
92   PROP_LAST
93 };
94
95 /* Signals */
96 enum
97 {
98   SCROLL_CHILD,
99   MOVE_FOCUS_OUT,
100   LAST_SIGNAL
101 };
102
103 static void gtk_scrolled_window_destroy            (GtkObject              *object);
104 static void gtk_scrolled_window_finalize           (GObject                *object);
105 static void gtk_scrolled_window_set_property       (GObject                *object,
106                                                     guint                   prop_id,
107                                                     const GValue           *value,
108                                                     GParamSpec             *pspec);
109 static void gtk_scrolled_window_get_property       (GObject                *object,
110                                                     guint                   prop_id,
111                                                     GValue                 *value,
112                                                     GParamSpec             *pspec);
113
114 static void gtk_scrolled_window_screen_changed     (GtkWidget              *widget,
115                                                     GdkScreen              *previous_screen);
116 static gint gtk_scrolled_window_expose             (GtkWidget              *widget,
117                                                     GdkEventExpose         *event);
118 static void gtk_scrolled_window_size_request       (GtkWidget              *widget,
119                                                     GtkRequisition         *requisition);
120 static void gtk_scrolled_window_size_allocate      (GtkWidget              *widget,
121                                                     GtkAllocation          *allocation);
122 static gint gtk_scrolled_window_scroll_event       (GtkWidget              *widget,
123                                                     GdkEventScroll         *event);
124 static gint gtk_scrolled_window_focus              (GtkWidget              *widget,
125                                                     GtkDirectionType        direction);
126 static void gtk_scrolled_window_add                (GtkContainer           *container,
127                                                     GtkWidget              *widget);
128 static void gtk_scrolled_window_remove             (GtkContainer           *container,
129                                                     GtkWidget              *widget);
130 static void gtk_scrolled_window_forall             (GtkContainer           *container,
131                                                     gboolean                include_internals,
132                                                     GtkCallback             callback,
133                                                     gpointer                callback_data);
134 static gboolean gtk_scrolled_window_scroll_child   (GtkScrolledWindow      *scrolled_window,
135                                                     GtkScrollType           scroll,
136                                                     gboolean                horizontal);
137 static void gtk_scrolled_window_move_focus_out     (GtkScrolledWindow      *scrolled_window,
138                                                     GtkDirectionType        direction_type);
139
140 static void gtk_scrolled_window_relative_allocation(GtkWidget              *widget,
141                                                     GtkAllocation          *allocation);
142 static void gtk_scrolled_window_adjustment_changed (GtkAdjustment          *adjustment,
143                                                     gpointer                data);
144
145 static void gtk_scrolled_window_update_real_placement (GtkScrolledWindow   *scrolled_window);
146
147 static guint signals[LAST_SIGNAL] = {0};
148
149 G_DEFINE_TYPE (GtkScrolledWindow, gtk_scrolled_window, GTK_TYPE_BIN)
150
151 static void
152 add_scroll_binding (GtkBindingSet  *binding_set,
153                     guint           keyval,
154                     GdkModifierType mask,
155                     GtkScrollType   scroll,
156                     gboolean        horizontal)
157 {
158   guint keypad_keyval = keyval - GDK_Left + GDK_KP_Left;
159   
160   gtk_binding_entry_add_signal (binding_set, keyval, mask,
161                                 "scroll_child", 2,
162                                 GTK_TYPE_SCROLL_TYPE, scroll,
163                                 G_TYPE_BOOLEAN, horizontal);
164   gtk_binding_entry_add_signal (binding_set, keypad_keyval, mask,
165                                 "scroll_child", 2,
166                                 GTK_TYPE_SCROLL_TYPE, scroll,
167                                 G_TYPE_BOOLEAN, horizontal);
168 }
169
170 static void
171 add_tab_bindings (GtkBindingSet    *binding_set,
172                   GdkModifierType   modifiers,
173                   GtkDirectionType  direction)
174 {
175   gtk_binding_entry_add_signal (binding_set, GDK_Tab, modifiers,
176                                 "move_focus_out", 1,
177                                 GTK_TYPE_DIRECTION_TYPE, direction);
178   gtk_binding_entry_add_signal (binding_set, GDK_KP_Tab, modifiers,
179                                 "move_focus_out", 1,
180                                 GTK_TYPE_DIRECTION_TYPE, direction);
181 }
182
183 static void
184 gtk_scrolled_window_class_init (GtkScrolledWindowClass *class)
185 {
186   GObjectClass *gobject_class = G_OBJECT_CLASS (class);
187   GtkObjectClass *object_class;
188   GtkWidgetClass *widget_class;
189   GtkContainerClass *container_class;
190   GtkBindingSet *binding_set;
191
192   object_class = (GtkObjectClass*) class;
193   widget_class = (GtkWidgetClass*) class;
194   container_class = (GtkContainerClass*) class;
195
196   gobject_class->finalize = gtk_scrolled_window_finalize;
197   gobject_class->set_property = gtk_scrolled_window_set_property;
198   gobject_class->get_property = gtk_scrolled_window_get_property;
199
200   object_class->destroy = gtk_scrolled_window_destroy;
201
202   widget_class->screen_changed = gtk_scrolled_window_screen_changed;
203   widget_class->expose_event = gtk_scrolled_window_expose;
204   widget_class->size_request = gtk_scrolled_window_size_request;
205   widget_class->size_allocate = gtk_scrolled_window_size_allocate;
206   widget_class->scroll_event = gtk_scrolled_window_scroll_event;
207   widget_class->focus = gtk_scrolled_window_focus;
208
209   container_class->add = gtk_scrolled_window_add;
210   container_class->remove = gtk_scrolled_window_remove;
211   container_class->forall = gtk_scrolled_window_forall;
212
213   class->scrollbar_spacing = -1;
214
215   class->scroll_child = gtk_scrolled_window_scroll_child;
216   class->move_focus_out = gtk_scrolled_window_move_focus_out;
217   
218   g_object_class_install_property (gobject_class,
219                                    PROP_HADJUSTMENT,
220                                    g_param_spec_object ("hadjustment",
221                                                         P_("Horizontal Adjustment"),
222                                                         P_("The GtkAdjustment for the horizontal position"),
223                                                         GTK_TYPE_ADJUSTMENT,
224                                                         GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT));
225   g_object_class_install_property (gobject_class,
226                                    PROP_VADJUSTMENT,
227                                    g_param_spec_object ("vadjustment",
228                                                         P_("Vertical Adjustment"),
229                                                         P_("The GtkAdjustment for the vertical position"),
230                                                         GTK_TYPE_ADJUSTMENT,
231                                                         GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT));
232   g_object_class_install_property (gobject_class,
233                                    PROP_HSCROLLBAR_POLICY,
234                                    g_param_spec_enum ("hscrollbar-policy",
235                                                       P_("Horizontal Scrollbar Policy"),
236                                                       P_("When the horizontal scrollbar is displayed"),
237                                                       GTK_TYPE_POLICY_TYPE,
238                                                       GTK_POLICY_ALWAYS,
239                                                       GTK_PARAM_READABLE | GTK_PARAM_WRITABLE));
240   g_object_class_install_property (gobject_class,
241                                    PROP_VSCROLLBAR_POLICY,
242                                    g_param_spec_enum ("vscrollbar-policy",
243                                                       P_("Vertical Scrollbar Policy"),
244                                                       P_("When the vertical scrollbar is displayed"),
245                                                       GTK_TYPE_POLICY_TYPE,
246                                                       GTK_POLICY_ALWAYS,
247                                                       GTK_PARAM_READABLE | GTK_PARAM_WRITABLE));
248
249   g_object_class_install_property (gobject_class,
250                                    PROP_WINDOW_PLACEMENT,
251                                    g_param_spec_enum ("window-placement",
252                                                       P_("Window Placement"),
253                                                       P_("Where the contents are located with respect to the scrollbars. This property only takes effect if \"window-placement-set\" is TRUE."),
254                                                       GTK_TYPE_CORNER_TYPE,
255                                                       GTK_CORNER_TOP_LEFT,
256                                                       GTK_PARAM_READABLE | GTK_PARAM_WRITABLE));
257   
258   /**
259    * GtkScrolledWindow:window-placement-set:
260    *
261    * Whether "window-placement" should be used to determine the location 
262    * of the contents with respect to the scrollbars. Otherwise, the 
263    * "gtk-scrolled-window-placement" setting is used.
264    *
265    * Since: 2.10
266    */
267   g_object_class_install_property (gobject_class,
268                                    PROP_WINDOW_PLACEMENT_SET,
269                                    g_param_spec_boolean ("window-placement-set",
270                                                          P_("Window Placement Set"),
271                                                          P_("Whether \"window-placement\" should be used to determine the location of the contents with respect to the scrollbars."),
272                                                          FALSE,
273                                                          GTK_PARAM_READABLE | GTK_PARAM_WRITABLE));
274   g_object_class_install_property (gobject_class,
275                                    PROP_SHADOW_TYPE,
276                                    g_param_spec_enum ("shadow-type",
277                                                       P_("Shadow Type"),
278                                                       P_("Style of bevel around the contents"),
279                                                       GTK_TYPE_SHADOW_TYPE,
280                                                       GTK_SHADOW_NONE,
281                                                       GTK_PARAM_READABLE | GTK_PARAM_WRITABLE));
282
283   /**
284    * GtkScrolledWindow:scrollbars-within-bevel:
285    *
286    * Whether to place scrollbars within the scrolled window's bevel.
287    *
288    * Since: 2.12
289    */
290   gtk_widget_class_install_style_property (widget_class,
291                                            g_param_spec_boolean ("scrollbars-within-bevel",
292                                                                  P_("Scrollbars within bevel"),
293                                                                  P_("Place scrollbars within the scrolled window's bevel"),
294                                                                  FALSE,
295                                                                  GTK_PARAM_READABLE));
296
297   gtk_widget_class_install_style_property (widget_class,
298                                            g_param_spec_int ("scrollbar-spacing",
299                                                              P_("Scrollbar spacing"),
300                                                              P_("Number of pixels between the scrollbars and the scrolled window"),
301                                                              0,
302                                                              G_MAXINT,
303                                                              DEFAULT_SCROLLBAR_SPACING,
304                                                              GTK_PARAM_READABLE));
305
306   /**
307    * GtkSettings:gtk-scrolled-window-placement:
308    *
309    * Where the contents of scrolled windows are located with respect to the 
310    * scrollbars, if not overridden by the scrolled window's own placement.
311    *
312    * Since: 2.10
313    */
314   gtk_settings_install_property (g_param_spec_enum ("gtk-scrolled-window-placement",
315                                                     P_("Scrolled Window Placement"),
316                                                     P_("Where the contents of scrolled windows are located with respect to the scrollbars, if not overridden by the scrolled window's own placement."),
317                                                     GTK_TYPE_CORNER_TYPE,
318                                                     GTK_CORNER_TOP_LEFT,
319                                                     G_PARAM_READABLE | G_PARAM_WRITABLE));
320
321
322   signals[SCROLL_CHILD] =
323     g_signal_new (I_("scroll_child"),
324                   G_TYPE_FROM_CLASS (object_class),
325                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
326                   G_STRUCT_OFFSET (GtkScrolledWindowClass, scroll_child),
327                   NULL, NULL,
328                   _gtk_marshal_BOOLEAN__ENUM_BOOLEAN,
329                   G_TYPE_BOOLEAN, 2,
330                   GTK_TYPE_SCROLL_TYPE,
331                   G_TYPE_BOOLEAN);
332   signals[MOVE_FOCUS_OUT] =
333     g_signal_new (I_("move_focus_out"),
334                   G_TYPE_FROM_CLASS (object_class),
335                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
336                   G_STRUCT_OFFSET (GtkScrolledWindowClass, move_focus_out),
337                   NULL, NULL,
338                   _gtk_marshal_VOID__ENUM,
339                   G_TYPE_NONE, 1,
340                   GTK_TYPE_DIRECTION_TYPE);
341   
342   binding_set = gtk_binding_set_by_class (class);
343
344   add_scroll_binding (binding_set, GDK_Left,  GDK_CONTROL_MASK, GTK_SCROLL_STEP_BACKWARD, TRUE);
345   add_scroll_binding (binding_set, GDK_Right, GDK_CONTROL_MASK, GTK_SCROLL_STEP_FORWARD,  TRUE);
346   add_scroll_binding (binding_set, GDK_Up,    GDK_CONTROL_MASK, GTK_SCROLL_STEP_BACKWARD, FALSE);
347   add_scroll_binding (binding_set, GDK_Down,  GDK_CONTROL_MASK, GTK_SCROLL_STEP_FORWARD,  FALSE);
348
349   add_scroll_binding (binding_set, GDK_Page_Up,   GDK_CONTROL_MASK, GTK_SCROLL_PAGE_BACKWARD, TRUE);
350   add_scroll_binding (binding_set, GDK_Page_Down, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_FORWARD,  TRUE);
351   add_scroll_binding (binding_set, GDK_Page_Up,   0,                GTK_SCROLL_PAGE_BACKWARD, FALSE);
352   add_scroll_binding (binding_set, GDK_Page_Down, 0,                GTK_SCROLL_PAGE_FORWARD,  FALSE);
353
354   add_scroll_binding (binding_set, GDK_Home, GDK_CONTROL_MASK, GTK_SCROLL_START, TRUE);
355   add_scroll_binding (binding_set, GDK_End,  GDK_CONTROL_MASK, GTK_SCROLL_END,   TRUE);
356   add_scroll_binding (binding_set, GDK_Home, 0,                GTK_SCROLL_START, FALSE);
357   add_scroll_binding (binding_set, GDK_End,  0,                GTK_SCROLL_END,   FALSE);
358
359   add_tab_bindings (binding_set, GDK_CONTROL_MASK, GTK_DIR_TAB_FORWARD);
360   add_tab_bindings (binding_set, GDK_CONTROL_MASK | GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD);
361
362   g_type_class_add_private (class, sizeof (GtkScrolledWindowPrivate));
363 }
364
365 static void
366 gtk_scrolled_window_init (GtkScrolledWindow *scrolled_window)
367 {
368   GTK_WIDGET_SET_FLAGS (scrolled_window, GTK_NO_WINDOW | GTK_CAN_FOCUS);
369
370   scrolled_window->hscrollbar = NULL;
371   scrolled_window->vscrollbar = NULL;
372   scrolled_window->hscrollbar_policy = GTK_POLICY_ALWAYS;
373   scrolled_window->vscrollbar_policy = GTK_POLICY_ALWAYS;
374   scrolled_window->hscrollbar_visible = FALSE;
375   scrolled_window->vscrollbar_visible = FALSE;
376   scrolled_window->focus_out = FALSE;
377   scrolled_window->window_placement = GTK_CORNER_TOP_LEFT;
378   gtk_scrolled_window_update_real_placement (scrolled_window);
379 }
380
381 GtkWidget*
382 gtk_scrolled_window_new (GtkAdjustment *hadjustment,
383                          GtkAdjustment *vadjustment)
384 {
385   GtkWidget *scrolled_window;
386
387   if (hadjustment)
388     g_return_val_if_fail (GTK_IS_ADJUSTMENT (hadjustment), NULL);
389
390   if (vadjustment)
391     g_return_val_if_fail (GTK_IS_ADJUSTMENT (vadjustment), NULL);
392
393   scrolled_window = gtk_widget_new (GTK_TYPE_SCROLLED_WINDOW,
394                                     "hadjustment", hadjustment,
395                                     "vadjustment", vadjustment,
396                                     NULL);
397
398   return scrolled_window;
399 }
400
401 void
402 gtk_scrolled_window_set_hadjustment (GtkScrolledWindow *scrolled_window,
403                                      GtkAdjustment     *hadjustment)
404 {
405   GtkBin *bin;
406
407   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
408   if (hadjustment)
409     g_return_if_fail (GTK_IS_ADJUSTMENT (hadjustment));
410   else
411     hadjustment = (GtkAdjustment*) g_object_new (GTK_TYPE_ADJUSTMENT, NULL);
412
413   bin = GTK_BIN (scrolled_window);
414
415   if (!scrolled_window->hscrollbar)
416     {
417       gtk_widget_push_composite_child ();
418       scrolled_window->hscrollbar = gtk_hscrollbar_new (hadjustment);
419       gtk_widget_set_composite_name (scrolled_window->hscrollbar, "hscrollbar");
420       gtk_widget_pop_composite_child ();
421
422       gtk_widget_set_parent (scrolled_window->hscrollbar, GTK_WIDGET (scrolled_window));
423       g_object_ref (scrolled_window->hscrollbar);
424       gtk_widget_show (scrolled_window->hscrollbar);
425     }
426   else
427     {
428       GtkAdjustment *old_adjustment;
429       
430       old_adjustment = gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar));
431       if (old_adjustment == hadjustment)
432         return;
433
434       g_signal_handlers_disconnect_by_func (old_adjustment,
435                                             gtk_scrolled_window_adjustment_changed,
436                                             scrolled_window);
437       gtk_range_set_adjustment (GTK_RANGE (scrolled_window->hscrollbar),
438                                 hadjustment);
439     }
440   hadjustment = gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar));
441   g_signal_connect (hadjustment,
442                     "changed",
443                     G_CALLBACK (gtk_scrolled_window_adjustment_changed),
444                     scrolled_window);
445   gtk_scrolled_window_adjustment_changed (hadjustment, scrolled_window);
446   
447   if (bin->child)
448     gtk_widget_set_scroll_adjustments (bin->child,
449                                        gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar)),
450                                        gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar)));
451
452   g_object_notify (G_OBJECT (scrolled_window), "hadjustment");
453 }
454
455 void
456 gtk_scrolled_window_set_vadjustment (GtkScrolledWindow *scrolled_window,
457                                      GtkAdjustment     *vadjustment)
458 {
459   GtkBin *bin;
460
461   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
462   if (vadjustment)
463     g_return_if_fail (GTK_IS_ADJUSTMENT (vadjustment));
464   else
465     vadjustment = (GtkAdjustment*) g_object_new (GTK_TYPE_ADJUSTMENT, NULL);
466
467   bin = GTK_BIN (scrolled_window);
468
469   if (!scrolled_window->vscrollbar)
470     {
471       gtk_widget_push_composite_child ();
472       scrolled_window->vscrollbar = gtk_vscrollbar_new (vadjustment);
473       gtk_widget_set_composite_name (scrolled_window->vscrollbar, "vscrollbar");
474       gtk_widget_pop_composite_child ();
475
476       gtk_widget_set_parent (scrolled_window->vscrollbar, GTK_WIDGET (scrolled_window));
477       g_object_ref (scrolled_window->vscrollbar);
478       gtk_widget_show (scrolled_window->vscrollbar);
479     }
480   else
481     {
482       GtkAdjustment *old_adjustment;
483       
484       old_adjustment = gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar));
485       if (old_adjustment == vadjustment)
486         return;
487
488       g_signal_handlers_disconnect_by_func (old_adjustment,
489                                             gtk_scrolled_window_adjustment_changed,
490                                             scrolled_window);
491       gtk_range_set_adjustment (GTK_RANGE (scrolled_window->vscrollbar),
492                                 vadjustment);
493     }
494   vadjustment = gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar));
495   g_signal_connect (vadjustment,
496                     "changed",
497                     G_CALLBACK (gtk_scrolled_window_adjustment_changed),
498                     scrolled_window);
499   gtk_scrolled_window_adjustment_changed (vadjustment, scrolled_window);
500
501   if (bin->child)
502     gtk_widget_set_scroll_adjustments (bin->child,
503                                        gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar)),
504                                        gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar)));
505
506   g_object_notify (G_OBJECT (scrolled_window), "vadjustment");
507 }
508
509 GtkAdjustment*
510 gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window)
511 {
512   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
513
514   return (scrolled_window->hscrollbar ?
515           gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar)) :
516           NULL);
517 }
518
519 GtkAdjustment*
520 gtk_scrolled_window_get_vadjustment (GtkScrolledWindow *scrolled_window)
521 {
522   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
523
524   return (scrolled_window->vscrollbar ?
525           gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar)) :
526           NULL);
527 }
528
529 /**
530  * gtk_scrolled_window_get_hscrollbar:
531  * @scrolled_window: a #GtkScrolledWindow
532  * 
533  * Returns the horizontal scrollbar of @scrolled_window.
534  *
535  * Returns: the horizontal scrollbar of the scrolled window, or 
536  *  %NULL if it does not have one.
537  *
538  * Since: 2.8
539  */
540 GtkWidget*
541 gtk_scrolled_window_get_hscrollbar (GtkScrolledWindow *scrolled_window)
542 {
543   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
544   
545   return scrolled_window->hscrollbar;
546 }
547
548 /**
549  * gtk_scrolled_window_get_vscrollbar:
550  * @scrolled_window: a #GtkScrolledWindow
551  * 
552  * Returns the vertical scrollbar of @scrolled_window.
553  *
554  * Returns: the vertical scrollbar of the scrolled window, or
555  *  %NULL if it does not have one.
556  *
557  * Since: 2.8
558  */
559 GtkWidget*
560 gtk_scrolled_window_get_vscrollbar (GtkScrolledWindow *scrolled_window)
561 {
562   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), NULL);
563
564   return scrolled_window->vscrollbar;
565 }
566
567 void
568 gtk_scrolled_window_set_policy (GtkScrolledWindow *scrolled_window,
569                                 GtkPolicyType      hscrollbar_policy,
570                                 GtkPolicyType      vscrollbar_policy)
571 {
572   GObject *object = G_OBJECT (scrolled_window);
573   
574   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
575
576   if ((scrolled_window->hscrollbar_policy != hscrollbar_policy) ||
577       (scrolled_window->vscrollbar_policy != vscrollbar_policy))
578     {
579       scrolled_window->hscrollbar_policy = hscrollbar_policy;
580       scrolled_window->vscrollbar_policy = vscrollbar_policy;
581
582       gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
583
584       g_object_freeze_notify (object);
585       g_object_notify (object, "hscrollbar-policy");
586       g_object_notify (object, "vscrollbar-policy");
587       g_object_thaw_notify (object);
588     }
589 }
590
591 /**
592  * gtk_scrolled_window_get_policy:
593  * @scrolled_window: a #GtkScrolledWindow
594  * @hscrollbar_policy: location to store the policy for the horizontal scrollbar, or %NULL.
595  * @vscrollbar_policy: location to store the policy for the horizontal scrollbar, or %NULL.
596  * 
597  * Retrieves the current policy values for the horizontal and vertical
598  * scrollbars. See gtk_scrolled_window_set_policy().
599  **/
600 void
601 gtk_scrolled_window_get_policy (GtkScrolledWindow *scrolled_window,
602                                 GtkPolicyType     *hscrollbar_policy,
603                                 GtkPolicyType     *vscrollbar_policy)
604 {
605   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
606
607   if (hscrollbar_policy)
608     *hscrollbar_policy = scrolled_window->hscrollbar_policy;
609   if (vscrollbar_policy)
610     *vscrollbar_policy = scrolled_window->vscrollbar_policy;
611 }
612
613 static void
614 gtk_scrolled_window_update_real_placement (GtkScrolledWindow *scrolled_window)
615 {
616   GtkScrolledWindowPrivate *priv = GTK_SCROLLED_WINDOW_GET_PRIVATE (scrolled_window);
617   GtkSettings *settings;
618
619   settings = gtk_widget_get_settings (GTK_WIDGET (scrolled_window));
620
621   if (priv->window_placement_set || settings == NULL)
622     priv->real_window_placement = scrolled_window->window_placement;
623   else
624     g_object_get (settings,
625                   "gtk-scrolled-window-placement",
626                   &priv->real_window_placement,
627                   NULL);
628 }
629
630 static void
631 gtk_scrolled_window_set_placement_internal (GtkScrolledWindow *scrolled_window,
632                                             GtkCornerType      window_placement)
633 {
634   if (scrolled_window->window_placement != window_placement)
635     {
636       scrolled_window->window_placement = window_placement;
637
638       gtk_scrolled_window_update_real_placement (scrolled_window);
639       gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
640       
641       g_object_notify (G_OBJECT (scrolled_window), "window-placement");
642     }
643 }
644
645 static void
646 gtk_scrolled_window_set_placement_set (GtkScrolledWindow *scrolled_window,
647                                        gboolean           placement_set,
648                                        gboolean           emit_resize)
649 {
650   GtkScrolledWindowPrivate *priv = GTK_SCROLLED_WINDOW_GET_PRIVATE (scrolled_window);
651
652   if (priv->window_placement_set != placement_set)
653     {
654       priv->window_placement_set = placement_set;
655
656       gtk_scrolled_window_update_real_placement (scrolled_window);
657       if (emit_resize)
658         gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
659
660       g_object_notify (G_OBJECT (scrolled_window), "window-placement-set");
661     }
662 }
663
664 /**
665  * gtk_scrolled_window_set_placement:
666  * @scrolled_window: a #GtkScrolledWindow
667  * @window_placement: position of the child window
668  *
669  * Sets the placement of the contents with respect to the scrollbars
670  * for the scrolled window.
671  * The default is %GTK_CORNER_TOP_LEFT, meaning the child is
672  * in the top left, with the scrollbars underneath and to the right.
673  * Other values in #GtkCornerType are %GTK_CORNER_TOP_RIGHT,
674  * %GTK_CORNER_BOTTOM_LEFT, and %GTK_CORNER_BOTTOM_RIGHT.
675  *
676  * See also gtk_scrolled_window_get_placement() and
677  * gtk_scrolled_window_unset_placement().
678  **/
679 void
680 gtk_scrolled_window_set_placement (GtkScrolledWindow *scrolled_window,
681                                    GtkCornerType      window_placement)
682 {
683   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
684
685   gtk_scrolled_window_set_placement_set (scrolled_window, TRUE, FALSE);
686   gtk_scrolled_window_set_placement_internal (scrolled_window, window_placement);
687 }
688
689 /**
690  * gtk_scrolled_window_get_placement:
691  * @scrolled_window: a #GtkScrolledWindow
692  *
693  * Gets the placement of the contents with respect to the scrollbars
694  * for the scrolled window. See gtk_scrolled_window_set_placement().
695  *
696  * Return value: the current placement value.
697  *
698  * See also gtk_scrolled_window_set_placement() and
699  * gtk_scrolled_window_unset_placement().
700  **/
701 GtkCornerType
702 gtk_scrolled_window_get_placement (GtkScrolledWindow *scrolled_window)
703 {
704   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), GTK_CORNER_TOP_LEFT);
705
706   return scrolled_window->window_placement;
707 }
708
709 /**
710  * gtk_scrolled_window_unset_placement:
711  * @scrolled_window: a #GtkScrolledWindow
712  *
713  * Unsets the placement of the contents with respect to the scrollbars
714  * for the scrolled window. If no window placement is set for a scrolled
715  * window, it obeys the "gtk-scrolled-window-placement" XSETTING.
716  *
717  * See also gtk_scrolled_window_set_placement() and
718  * gtk_scrolled_window_get_placement().
719  *
720  * Since: 2.10
721  **/
722 void
723 gtk_scrolled_window_unset_placement (GtkScrolledWindow *scrolled_window)
724 {
725   GtkScrolledWindowPrivate *priv = GTK_SCROLLED_WINDOW_GET_PRIVATE (scrolled_window);
726
727   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
728
729   if (priv->window_placement_set)
730     {
731       priv->window_placement_set = FALSE;
732
733       gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
734
735       g_object_notify (G_OBJECT (scrolled_window), "window-placement-set");
736     }
737 }
738
739 /**
740  * gtk_scrolled_window_set_shadow_type:
741  * @scrolled_window: a #GtkScrolledWindow
742  * @type: kind of shadow to draw around scrolled window contents
743  *
744  * Changes the type of shadow drawn around the contents of
745  * @scrolled_window.
746  * 
747  **/
748 void
749 gtk_scrolled_window_set_shadow_type (GtkScrolledWindow *scrolled_window,
750                                      GtkShadowType      type)
751 {
752   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
753   g_return_if_fail (type >= GTK_SHADOW_NONE && type <= GTK_SHADOW_ETCHED_OUT);
754   
755   if (scrolled_window->shadow_type != type)
756     {
757       scrolled_window->shadow_type = type;
758
759       if (GTK_WIDGET_DRAWABLE (scrolled_window))
760         gtk_widget_queue_draw (GTK_WIDGET (scrolled_window));
761
762       gtk_widget_queue_resize (GTK_WIDGET (scrolled_window));
763
764       g_object_notify (G_OBJECT (scrolled_window), "shadow-type");
765     }
766 }
767
768 /**
769  * gtk_scrolled_window_get_shadow_type:
770  * @scrolled_window: a #GtkScrolledWindow
771  *
772  * Gets the shadow type of the scrolled window. See 
773  * gtk_scrolled_window_set_shadow_type().
774  *
775  * Return value: the current shadow type
776  **/
777 GtkShadowType
778 gtk_scrolled_window_get_shadow_type (GtkScrolledWindow *scrolled_window)
779 {
780   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), GTK_SHADOW_NONE);
781
782   return scrolled_window->shadow_type;
783 }
784
785 static void
786 gtk_scrolled_window_destroy (GtkObject *object)
787 {
788   GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (object);
789
790   gtk_widget_unparent (scrolled_window->hscrollbar);
791   gtk_widget_unparent (scrolled_window->vscrollbar);
792   gtk_widget_destroy (scrolled_window->hscrollbar);
793   gtk_widget_destroy (scrolled_window->vscrollbar);
794
795   GTK_OBJECT_CLASS (gtk_scrolled_window_parent_class)->destroy (object);
796 }
797
798 static void
799 gtk_scrolled_window_finalize (GObject *object)
800 {
801   GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (object);
802
803   g_object_unref (scrolled_window->hscrollbar);
804   g_object_unref (scrolled_window->vscrollbar);
805
806   G_OBJECT_CLASS (gtk_scrolled_window_parent_class)->finalize (object);
807 }
808
809 static void
810 gtk_scrolled_window_set_property (GObject      *object,
811                                   guint         prop_id,
812                                   const GValue *value,
813                                   GParamSpec   *pspec)
814 {
815   GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (object);
816   
817   switch (prop_id)
818     {
819     case PROP_HADJUSTMENT:
820       gtk_scrolled_window_set_hadjustment (scrolled_window,
821                                            g_value_get_object (value));
822       break;
823     case PROP_VADJUSTMENT:
824       gtk_scrolled_window_set_vadjustment (scrolled_window,
825                                            g_value_get_object (value));
826       break;
827     case PROP_HSCROLLBAR_POLICY:
828       gtk_scrolled_window_set_policy (scrolled_window,
829                                       g_value_get_enum (value),
830                                       scrolled_window->vscrollbar_policy);
831       break;
832     case PROP_VSCROLLBAR_POLICY:
833       gtk_scrolled_window_set_policy (scrolled_window,
834                                       scrolled_window->hscrollbar_policy,
835                                       g_value_get_enum (value));
836       break;
837     case PROP_WINDOW_PLACEMENT:
838       gtk_scrolled_window_set_placement_internal (scrolled_window,
839                                                   g_value_get_enum (value));
840       break;
841     case PROP_WINDOW_PLACEMENT_SET:
842       gtk_scrolled_window_set_placement_set (scrolled_window,
843                                              g_value_get_boolean (value),
844                                              TRUE);
845       break;
846     case PROP_SHADOW_TYPE:
847       gtk_scrolled_window_set_shadow_type (scrolled_window,
848                                            g_value_get_enum (value));
849       break;
850     default:
851       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
852       break;
853     }
854 }
855
856 static void
857 gtk_scrolled_window_get_property (GObject    *object,
858                                   guint       prop_id,
859                                   GValue     *value,
860                                   GParamSpec *pspec)
861 {
862   GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (object);
863   GtkScrolledWindowPrivate *priv = GTK_SCROLLED_WINDOW_GET_PRIVATE (scrolled_window);
864   
865   switch (prop_id)
866     {
867     case PROP_HADJUSTMENT:
868       g_value_set_object (value,
869                           G_OBJECT (gtk_scrolled_window_get_hadjustment (scrolled_window)));
870       break;
871     case PROP_VADJUSTMENT:
872       g_value_set_object (value,
873                           G_OBJECT (gtk_scrolled_window_get_vadjustment (scrolled_window)));
874       break;
875     case PROP_HSCROLLBAR_POLICY:
876       g_value_set_enum (value, scrolled_window->hscrollbar_policy);
877       break;
878     case PROP_VSCROLLBAR_POLICY:
879       g_value_set_enum (value, scrolled_window->vscrollbar_policy);
880       break;
881     case PROP_WINDOW_PLACEMENT:
882       g_value_set_enum (value, scrolled_window->window_placement);
883       break;
884     case PROP_WINDOW_PLACEMENT_SET:
885       g_value_set_boolean (value, priv->window_placement_set);
886       break;
887     case PROP_SHADOW_TYPE:
888       g_value_set_enum (value, scrolled_window->shadow_type);
889       break;
890     default:
891       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
892       break;
893     }
894 }
895
896 static void
897 traverse_container (GtkWidget *widget,
898                     gpointer   data)
899 {
900   if (GTK_IS_SCROLLED_WINDOW (widget))
901     {
902       gtk_scrolled_window_update_real_placement (GTK_SCROLLED_WINDOW (widget));
903       gtk_widget_queue_resize (widget);
904     }
905   else if (GTK_IS_CONTAINER (widget))
906     gtk_container_forall (GTK_CONTAINER (widget), traverse_container, NULL);
907 }
908
909 static void
910 gtk_scrolled_window_settings_changed (GtkSettings *settings)
911 {
912   GList *list, *l;
913
914   list = gtk_window_list_toplevels ();
915
916   for (l = list; l; l = l->next)
917     gtk_container_forall (GTK_CONTAINER (l->data), 
918                           traverse_container, NULL);
919
920   g_list_free (list);
921 }
922
923 static void
924 gtk_scrolled_window_screen_changed (GtkWidget *widget,
925                                     GdkScreen *previous_screen)
926 {
927   GtkSettings *settings;
928   guint window_placement_connection;
929
930   gtk_scrolled_window_update_real_placement (GTK_SCROLLED_WINDOW (widget));
931
932   if (!gtk_widget_has_screen (widget))
933     return;
934
935   settings = gtk_widget_get_settings (widget);
936
937   window_placement_connection = 
938     GPOINTER_TO_UINT (g_object_get_data (G_OBJECT (settings), 
939                                          "gtk-scrolled-window-connection"));
940   
941   if (window_placement_connection)
942     return;
943
944   window_placement_connection =
945     g_signal_connect (settings, "notify::gtk-scrolled-window-placement",
946                       G_CALLBACK (gtk_scrolled_window_settings_changed), NULL);
947   g_object_set_data (G_OBJECT (settings), 
948                      I_("gtk-scrolled-window-connection"),
949                      GUINT_TO_POINTER (window_placement_connection));
950 }
951
952 static void
953 gtk_scrolled_window_paint (GtkWidget    *widget,
954                            GdkRectangle *area)
955 {
956   GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
957
958   if (scrolled_window->shadow_type != GTK_SHADOW_NONE)
959     {
960       GtkAllocation relative_allocation;
961       gboolean scrollbars_within_bevel;
962
963       gtk_widget_style_get (widget, "scrollbars-within-bevel", &scrollbars_within_bevel, NULL);
964       
965       if (!scrollbars_within_bevel)
966         {
967           gtk_scrolled_window_relative_allocation (widget, &relative_allocation);
968
969           relative_allocation.x -= widget->style->xthickness;
970           relative_allocation.y -= widget->style->ythickness;
971           relative_allocation.width += 2 * widget->style->xthickness;
972           relative_allocation.height += 2 * widget->style->ythickness;
973         }
974       else
975         {
976           GtkContainer *container = GTK_CONTAINER (widget);
977
978           relative_allocation.x = container->border_width;
979           relative_allocation.y = container->border_width;
980           relative_allocation.width = widget->allocation.width - 2 * container->border_width;
981           relative_allocation.height = widget->allocation.height - 2 * container->border_width;
982         }
983
984       gtk_paint_shadow (widget->style, widget->window,
985                         GTK_STATE_NORMAL, scrolled_window->shadow_type,
986                         area, widget, "scrolled_window",
987                         widget->allocation.x + relative_allocation.x,
988                         widget->allocation.y + relative_allocation.y,
989                         relative_allocation.width,
990                         relative_allocation.height);
991     }
992 }
993
994 static gint
995 gtk_scrolled_window_expose (GtkWidget      *widget,
996                             GdkEventExpose *event)
997 {
998   if (GTK_WIDGET_DRAWABLE (widget))
999     {
1000       gtk_scrolled_window_paint (widget, &event->area);
1001
1002       (* GTK_WIDGET_CLASS (gtk_scrolled_window_parent_class)->expose_event) (widget, event);
1003     }
1004
1005   return FALSE;
1006 }
1007
1008 static void
1009 gtk_scrolled_window_forall (GtkContainer *container,
1010                             gboolean      include_internals,
1011                             GtkCallback   callback,
1012                             gpointer      callback_data)
1013 {
1014   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (container));
1015   g_return_if_fail (callback != NULL);
1016
1017   GTK_CONTAINER_CLASS (gtk_scrolled_window_parent_class)->forall (container,
1018                                               include_internals,
1019                                               callback,
1020                                               callback_data);
1021   if (include_internals)
1022     {
1023       GtkScrolledWindow *scrolled_window;
1024
1025       scrolled_window = GTK_SCROLLED_WINDOW (container);
1026       
1027       if (scrolled_window->vscrollbar)
1028         callback (scrolled_window->vscrollbar, callback_data);
1029       if (scrolled_window->hscrollbar)
1030         callback (scrolled_window->hscrollbar, callback_data);
1031     }
1032 }
1033
1034 static gboolean
1035 gtk_scrolled_window_scroll_child (GtkScrolledWindow *scrolled_window,
1036                                   GtkScrollType      scroll,
1037                                   gboolean           horizontal)
1038 {
1039   GtkAdjustment *adjustment = NULL;
1040   
1041   switch (scroll)
1042     {
1043     case GTK_SCROLL_STEP_UP:
1044       scroll = GTK_SCROLL_STEP_BACKWARD;
1045       horizontal = FALSE;
1046       break;
1047     case GTK_SCROLL_STEP_DOWN:
1048       scroll = GTK_SCROLL_STEP_FORWARD;
1049       horizontal = FALSE;
1050       break;
1051     case GTK_SCROLL_STEP_LEFT:
1052       scroll = GTK_SCROLL_STEP_BACKWARD;
1053       horizontal = TRUE;
1054       break;
1055     case GTK_SCROLL_STEP_RIGHT:
1056       scroll = GTK_SCROLL_STEP_FORWARD;
1057       horizontal = TRUE;
1058       break;
1059     case GTK_SCROLL_PAGE_UP:
1060       scroll = GTK_SCROLL_PAGE_BACKWARD;
1061       horizontal = FALSE;
1062       break;
1063     case GTK_SCROLL_PAGE_DOWN:
1064       scroll = GTK_SCROLL_PAGE_FORWARD;
1065       horizontal = FALSE;
1066       break;
1067     case GTK_SCROLL_PAGE_LEFT:
1068       scroll = GTK_SCROLL_STEP_BACKWARD;
1069       horizontal = TRUE;
1070       break;
1071     case GTK_SCROLL_PAGE_RIGHT:
1072       scroll = GTK_SCROLL_STEP_FORWARD;
1073       horizontal = TRUE;
1074       break;
1075     case GTK_SCROLL_STEP_BACKWARD:
1076     case GTK_SCROLL_STEP_FORWARD:
1077     case GTK_SCROLL_PAGE_BACKWARD:
1078     case GTK_SCROLL_PAGE_FORWARD:
1079     case GTK_SCROLL_START:
1080     case GTK_SCROLL_END:
1081       break;
1082     default:
1083       g_warning ("Invalid scroll type %u for GtkScrolledWindow::scroll-child", scroll);
1084       return FALSE;
1085     }
1086
1087   if ((horizontal && (!scrolled_window->hscrollbar || !scrolled_window->hscrollbar_visible)) ||
1088       (!horizontal && (!scrolled_window->vscrollbar || !scrolled_window->vscrollbar_visible)))
1089     return FALSE;
1090
1091   if (horizontal)
1092     {
1093       if (scrolled_window->hscrollbar)
1094         adjustment = gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar));
1095     }
1096   else
1097     {
1098       if (scrolled_window->vscrollbar)
1099         adjustment = gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar));
1100     }
1101
1102   if (adjustment)
1103     {
1104       gdouble value = adjustment->value;
1105       
1106       switch (scroll)
1107         {
1108         case GTK_SCROLL_STEP_FORWARD:
1109           value += adjustment->step_increment;
1110           break;
1111         case GTK_SCROLL_STEP_BACKWARD:
1112           value -= adjustment->step_increment;
1113           break;
1114         case GTK_SCROLL_PAGE_FORWARD:
1115           value += adjustment->page_increment;
1116           break;
1117         case GTK_SCROLL_PAGE_BACKWARD:
1118           value -= adjustment->page_increment;
1119           break;
1120         case GTK_SCROLL_START:
1121           value = adjustment->lower;
1122           break;
1123         case GTK_SCROLL_END:
1124           value = adjustment->upper;
1125           break;
1126         default:
1127           g_assert_not_reached ();
1128           break;
1129         }
1130
1131       value = CLAMP (value, adjustment->lower, adjustment->upper - adjustment->page_size);
1132       
1133       gtk_adjustment_set_value (adjustment, value);
1134
1135       return TRUE;
1136     }
1137
1138   return FALSE;
1139 }
1140
1141 static void
1142 gtk_scrolled_window_move_focus_out (GtkScrolledWindow *scrolled_window,
1143                                     GtkDirectionType   direction_type)
1144 {
1145   GtkWidget *toplevel;
1146   
1147   /* Focus out of the scrolled window entirely. We do this by setting
1148    * a flag, then propagating the focus motion to the notebook.
1149    */
1150   toplevel = gtk_widget_get_toplevel (GTK_WIDGET (scrolled_window));
1151   if (!GTK_WIDGET_TOPLEVEL (toplevel))
1152     return;
1153
1154   g_object_ref (scrolled_window);
1155   
1156   scrolled_window->focus_out = TRUE;
1157   g_signal_emit_by_name (toplevel, "move_focus", direction_type);
1158   scrolled_window->focus_out = FALSE;
1159   
1160   g_object_unref (scrolled_window);
1161 }
1162
1163 static void
1164 gtk_scrolled_window_size_request (GtkWidget      *widget,
1165                                   GtkRequisition *requisition)
1166 {
1167   GtkScrolledWindow *scrolled_window;
1168   GtkBin *bin;
1169   gint extra_width;
1170   gint extra_height;
1171   gint scrollbar_spacing;
1172   GtkRequisition hscrollbar_requisition;
1173   GtkRequisition vscrollbar_requisition;
1174   GtkRequisition child_requisition;
1175
1176   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (widget));
1177   g_return_if_fail (requisition != NULL);
1178
1179   scrolled_window = GTK_SCROLLED_WINDOW (widget);
1180   bin = GTK_BIN (scrolled_window);
1181
1182   scrollbar_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
1183
1184   extra_width = 0;
1185   extra_height = 0;
1186   requisition->width = 0;
1187   requisition->height = 0;
1188   
1189   gtk_widget_size_request (scrolled_window->hscrollbar,
1190                            &hscrollbar_requisition);
1191   gtk_widget_size_request (scrolled_window->vscrollbar,
1192                            &vscrollbar_requisition);
1193   
1194   if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
1195     {
1196       gtk_widget_size_request (bin->child, &child_requisition);
1197
1198       if (scrolled_window->hscrollbar_policy == GTK_POLICY_NEVER)
1199         requisition->width += child_requisition.width;
1200       else
1201         {
1202           GtkWidgetAuxInfo *aux_info = _gtk_widget_get_aux_info (bin->child, FALSE);
1203
1204           if (aux_info && aux_info->width > 0)
1205             {
1206               requisition->width += aux_info->width;
1207               extra_width = -1;
1208             }
1209           else
1210             requisition->width += vscrollbar_requisition.width;
1211         }
1212
1213       if (scrolled_window->vscrollbar_policy == GTK_POLICY_NEVER)
1214         requisition->height += child_requisition.height;
1215       else
1216         {
1217           GtkWidgetAuxInfo *aux_info = _gtk_widget_get_aux_info (bin->child, FALSE);
1218
1219           if (aux_info && aux_info->height > 0)
1220             {
1221               requisition->height += aux_info->height;
1222               extra_height = -1;
1223             }
1224           else
1225             requisition->height += hscrollbar_requisition.height;
1226         }
1227     }
1228
1229   if (scrolled_window->hscrollbar_policy == GTK_POLICY_AUTOMATIC ||
1230       scrolled_window->hscrollbar_policy == GTK_POLICY_ALWAYS)
1231     {
1232       requisition->width = MAX (requisition->width, hscrollbar_requisition.width);
1233       if (!extra_height || scrolled_window->hscrollbar_policy == GTK_POLICY_ALWAYS)
1234         extra_height = scrollbar_spacing + hscrollbar_requisition.height;
1235     }
1236
1237   if (scrolled_window->vscrollbar_policy == GTK_POLICY_AUTOMATIC ||
1238       scrolled_window->vscrollbar_policy == GTK_POLICY_ALWAYS)
1239     {
1240       requisition->height = MAX (requisition->height, vscrollbar_requisition.height);
1241       if (!extra_height || scrolled_window->vscrollbar_policy == GTK_POLICY_ALWAYS)
1242         extra_width = scrollbar_spacing + vscrollbar_requisition.width;
1243     }
1244
1245   requisition->width += GTK_CONTAINER (widget)->border_width * 2 + MAX (0, extra_width);
1246   requisition->height += GTK_CONTAINER (widget)->border_width * 2 + MAX (0, extra_height);
1247
1248   if (scrolled_window->shadow_type != GTK_SHADOW_NONE)
1249     {
1250       requisition->width += 2 * widget->style->xthickness;
1251       requisition->height += 2 * widget->style->ythickness;
1252     }
1253 }
1254
1255 static void
1256 gtk_scrolled_window_relative_allocation (GtkWidget     *widget,
1257                                          GtkAllocation *allocation)
1258 {
1259   GtkScrolledWindow *scrolled_window;
1260   GtkScrolledWindowPrivate *priv;
1261   gint scrollbar_spacing;
1262
1263   g_return_if_fail (widget != NULL);
1264   g_return_if_fail (allocation != NULL);
1265
1266   scrolled_window = GTK_SCROLLED_WINDOW (widget);
1267   scrollbar_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
1268
1269   priv = GTK_SCROLLED_WINDOW_GET_PRIVATE (scrolled_window);
1270
1271   allocation->x = GTK_CONTAINER (widget)->border_width;
1272   allocation->y = GTK_CONTAINER (widget)->border_width;
1273
1274   if (scrolled_window->shadow_type != GTK_SHADOW_NONE)
1275     {
1276       allocation->x += widget->style->xthickness;
1277       allocation->y += widget->style->ythickness;
1278     }
1279   
1280   allocation->width = MAX (1, (gint)widget->allocation.width - allocation->x * 2);
1281   allocation->height = MAX (1, (gint)widget->allocation.height - allocation->y * 2);
1282
1283   if (scrolled_window->vscrollbar_visible)
1284     {
1285       GtkRequisition vscrollbar_requisition;
1286       gboolean is_rtl;
1287
1288       gtk_widget_get_child_requisition (scrolled_window->vscrollbar,
1289                                         &vscrollbar_requisition);
1290       is_rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
1291   
1292       if ((!is_rtl && 
1293            (priv->real_window_placement == GTK_CORNER_TOP_RIGHT ||
1294             priv->real_window_placement == GTK_CORNER_BOTTOM_RIGHT)) ||
1295           (is_rtl && 
1296            (priv->real_window_placement == GTK_CORNER_TOP_LEFT ||
1297             priv->real_window_placement == GTK_CORNER_BOTTOM_LEFT)))
1298         allocation->x += (vscrollbar_requisition.width +  scrollbar_spacing);
1299
1300       allocation->width = MAX (1, allocation->width - (vscrollbar_requisition.width + scrollbar_spacing));
1301     }
1302   if (scrolled_window->hscrollbar_visible)
1303     {
1304       GtkRequisition hscrollbar_requisition;
1305       gtk_widget_get_child_requisition (scrolled_window->hscrollbar,
1306                                         &hscrollbar_requisition);
1307   
1308       if (priv->real_window_placement == GTK_CORNER_BOTTOM_LEFT ||
1309           priv->real_window_placement == GTK_CORNER_BOTTOM_RIGHT)
1310         allocation->y += (hscrollbar_requisition.height + scrollbar_spacing);
1311
1312       allocation->height = MAX (1, allocation->height - (hscrollbar_requisition.height + scrollbar_spacing));
1313     }
1314 }
1315
1316 static void
1317 gtk_scrolled_window_size_allocate (GtkWidget     *widget,
1318                                    GtkAllocation *allocation)
1319 {
1320   GtkScrolledWindow *scrolled_window;
1321   GtkScrolledWindowPrivate *priv;
1322   GtkBin *bin;
1323   GtkAllocation relative_allocation;
1324   GtkAllocation child_allocation;
1325   gboolean scrollbars_within_bevel;
1326   gint scrollbar_spacing;
1327   
1328   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (widget));
1329   g_return_if_fail (allocation != NULL);
1330
1331   scrolled_window = GTK_SCROLLED_WINDOW (widget);
1332   bin = GTK_BIN (scrolled_window);
1333
1334   scrollbar_spacing = _gtk_scrolled_window_get_scrollbar_spacing (scrolled_window);
1335   gtk_widget_style_get (widget, "scrollbars-within-bevel", &scrollbars_within_bevel, NULL);
1336
1337   priv = GTK_SCROLLED_WINDOW_GET_PRIVATE (scrolled_window);
1338
1339   widget->allocation = *allocation;
1340
1341   if (scrolled_window->hscrollbar_policy == GTK_POLICY_ALWAYS)
1342     scrolled_window->hscrollbar_visible = TRUE;
1343   else if (scrolled_window->hscrollbar_policy == GTK_POLICY_NEVER)
1344     scrolled_window->hscrollbar_visible = FALSE;
1345   if (scrolled_window->vscrollbar_policy == GTK_POLICY_ALWAYS)
1346     scrolled_window->vscrollbar_visible = TRUE;
1347   else if (scrolled_window->vscrollbar_policy == GTK_POLICY_NEVER)
1348     scrolled_window->vscrollbar_visible = FALSE;
1349
1350   if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
1351     {
1352       gboolean previous_hvis;
1353       gboolean previous_vvis;
1354       guint count = 0;
1355       
1356       do
1357         {
1358           gtk_scrolled_window_relative_allocation (widget, &relative_allocation);
1359           
1360           child_allocation.x = relative_allocation.x + allocation->x;
1361           child_allocation.y = relative_allocation.y + allocation->y;
1362           child_allocation.width = relative_allocation.width;
1363           child_allocation.height = relative_allocation.height;
1364           
1365           previous_hvis = scrolled_window->hscrollbar_visible;
1366           previous_vvis = scrolled_window->vscrollbar_visible;
1367           
1368           gtk_widget_size_allocate (bin->child, &child_allocation);
1369
1370           /* If, after the first iteration, the hscrollbar and the
1371            * vscrollbar flip visiblity, then we need both.
1372            */
1373           if (count &&
1374               previous_hvis != scrolled_window->hscrollbar_visible &&
1375               previous_vvis != scrolled_window->vscrollbar_visible)
1376             {
1377               scrolled_window->hscrollbar_visible = TRUE;
1378               scrolled_window->vscrollbar_visible = TRUE;
1379
1380               /* a new resize is already queued at this point,
1381                * so we will immediatedly get reinvoked
1382                */
1383               return;
1384             }
1385           
1386           count++;
1387         }
1388       while (previous_hvis != scrolled_window->hscrollbar_visible ||
1389              previous_vvis != scrolled_window->vscrollbar_visible);
1390     }
1391   else
1392     {
1393       scrolled_window->hscrollbar_visible = scrolled_window->hscrollbar_policy == GTK_POLICY_ALWAYS;
1394       scrolled_window->vscrollbar_visible = scrolled_window->vscrollbar_policy == GTK_POLICY_ALWAYS;
1395       gtk_scrolled_window_relative_allocation (widget, &relative_allocation);
1396     }
1397   
1398   if (scrolled_window->hscrollbar_visible)
1399     {
1400       GtkRequisition hscrollbar_requisition;
1401       gtk_widget_get_child_requisition (scrolled_window->hscrollbar,
1402                                         &hscrollbar_requisition);
1403   
1404       if (!GTK_WIDGET_VISIBLE (scrolled_window->hscrollbar))
1405         gtk_widget_show (scrolled_window->hscrollbar);
1406
1407       child_allocation.x = relative_allocation.x;
1408       if (priv->real_window_placement == GTK_CORNER_TOP_LEFT ||
1409           priv->real_window_placement == GTK_CORNER_TOP_RIGHT)
1410         child_allocation.y = (relative_allocation.y +
1411                               relative_allocation.height +
1412                               scrollbar_spacing +
1413                               (scrolled_window->shadow_type == GTK_SHADOW_NONE ?
1414                                0 : widget->style->ythickness));
1415       else
1416         child_allocation.y = GTK_CONTAINER (scrolled_window)->border_width;
1417
1418       child_allocation.width = relative_allocation.width;
1419       child_allocation.height = hscrollbar_requisition.height;
1420       child_allocation.x += allocation->x;
1421       child_allocation.y += allocation->y;
1422
1423       if (scrolled_window->shadow_type != GTK_SHADOW_NONE)
1424         {
1425           if (!scrollbars_within_bevel)
1426             {
1427               child_allocation.x -= widget->style->xthickness;
1428               child_allocation.width += 2 * widget->style->xthickness;
1429             }
1430           else if (GTK_CORNER_TOP_RIGHT == priv->real_window_placement ||
1431                    GTK_CORNER_TOP_LEFT == priv->real_window_placement)
1432             {
1433               child_allocation.y -= widget->style->ythickness;
1434             }
1435           else
1436             {
1437               child_allocation.y += widget->style->ythickness;
1438             }
1439         }
1440
1441       gtk_widget_size_allocate (scrolled_window->hscrollbar, &child_allocation);
1442     }
1443   else if (GTK_WIDGET_VISIBLE (scrolled_window->hscrollbar))
1444     gtk_widget_hide (scrolled_window->hscrollbar);
1445
1446   if (scrolled_window->vscrollbar_visible)
1447     {
1448       GtkRequisition vscrollbar_requisition;
1449       if (!GTK_WIDGET_VISIBLE (scrolled_window->vscrollbar))
1450         gtk_widget_show (scrolled_window->vscrollbar);
1451
1452       gtk_widget_get_child_requisition (scrolled_window->vscrollbar,
1453                                         &vscrollbar_requisition);
1454
1455       if ((gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL && 
1456            (priv->real_window_placement == GTK_CORNER_TOP_RIGHT ||
1457             priv->real_window_placement == GTK_CORNER_BOTTOM_RIGHT)) ||
1458           (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR && 
1459            (priv->real_window_placement == GTK_CORNER_TOP_LEFT ||
1460             priv->real_window_placement == GTK_CORNER_BOTTOM_LEFT)))
1461         child_allocation.x = (relative_allocation.x +
1462                               relative_allocation.width +
1463                               scrollbar_spacing +
1464                               (scrolled_window->shadow_type == GTK_SHADOW_NONE ?
1465                                0 : widget->style->xthickness));
1466       else
1467         child_allocation.x = GTK_CONTAINER (scrolled_window)->border_width;
1468
1469       child_allocation.y = relative_allocation.y;
1470       child_allocation.width = vscrollbar_requisition.width;
1471       child_allocation.height = relative_allocation.height;
1472       child_allocation.x += allocation->x;
1473       child_allocation.y += allocation->y;
1474
1475       if (scrolled_window->shadow_type != GTK_SHADOW_NONE)
1476         {
1477           if (!scrollbars_within_bevel)
1478             {
1479               child_allocation.y -= widget->style->ythickness;
1480               child_allocation.height += 2 * widget->style->ythickness;
1481             }
1482           else if (GTK_CORNER_BOTTOM_LEFT == priv->real_window_placement ||
1483                    GTK_CORNER_TOP_LEFT == priv->real_window_placement)
1484             {
1485               child_allocation.x -= widget->style->xthickness;
1486             }
1487           else
1488             {
1489               child_allocation.x += widget->style->xthickness;
1490             }
1491         }
1492
1493       gtk_widget_size_allocate (scrolled_window->vscrollbar, &child_allocation);
1494     }
1495   else if (GTK_WIDGET_VISIBLE (scrolled_window->vscrollbar))
1496     gtk_widget_hide (scrolled_window->vscrollbar);
1497 }
1498
1499 static gint
1500 gtk_scrolled_window_scroll_event (GtkWidget *widget,
1501                                   GdkEventScroll *event)
1502 {
1503   GtkWidget *range;
1504
1505   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (widget), FALSE);
1506   g_return_val_if_fail (event != NULL, FALSE);  
1507
1508   if (event->direction == GDK_SCROLL_UP || event->direction == GDK_SCROLL_DOWN)
1509     range = GTK_SCROLLED_WINDOW (widget)->vscrollbar;
1510   else
1511     range = GTK_SCROLLED_WINDOW (widget)->hscrollbar;
1512
1513   if (range && GTK_WIDGET_VISIBLE (range))
1514     {
1515       GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
1516       gdouble delta, new_value;
1517
1518       delta = _gtk_range_get_wheel_delta (GTK_RANGE (range), event->direction);
1519
1520       new_value = CLAMP (adj->value + delta, adj->lower, adj->upper - adj->page_size);
1521       
1522       gtk_adjustment_set_value (adj, new_value);
1523
1524       return TRUE;
1525     }
1526
1527   return FALSE;
1528 }
1529
1530 static gint
1531 gtk_scrolled_window_focus (GtkWidget        *widget,
1532                            GtkDirectionType  direction)
1533 {
1534   GtkScrolledWindow *scrolled_window = GTK_SCROLLED_WINDOW (widget);
1535   gboolean had_focus_child = GTK_CONTAINER (widget)->focus_child != NULL;
1536   
1537   if (scrolled_window->focus_out)
1538     {
1539       scrolled_window->focus_out = FALSE; /* Clear this to catch the wrap-around case */
1540       return FALSE;
1541     }
1542   
1543   if (gtk_widget_is_focus (widget))
1544     return FALSE;
1545
1546   /* We only put the scrolled window itself in the focus chain if it
1547    * isn't possible to focus any children.
1548    */
1549   if (GTK_BIN (widget)->child)
1550     {
1551       if (gtk_widget_child_focus (GTK_BIN (widget)->child, direction))
1552         return TRUE;
1553     }
1554
1555   if (!had_focus_child)
1556     {
1557       gtk_widget_grab_focus (widget);
1558       return TRUE;
1559     }
1560   else
1561     return FALSE;
1562 }
1563
1564 static void
1565 gtk_scrolled_window_adjustment_changed (GtkAdjustment *adjustment,
1566                                         gpointer       data)
1567 {
1568   GtkScrolledWindow *scrolled_win;
1569
1570   g_return_if_fail (adjustment != NULL);
1571   g_return_if_fail (data != NULL);
1572
1573   scrolled_win = GTK_SCROLLED_WINDOW (data);
1574
1575   if (scrolled_win->hscrollbar &&
1576       adjustment == gtk_range_get_adjustment (GTK_RANGE (scrolled_win->hscrollbar)))
1577     {
1578       if (scrolled_win->hscrollbar_policy == GTK_POLICY_AUTOMATIC)
1579         {
1580           gboolean visible;
1581           
1582           visible = scrolled_win->hscrollbar_visible;
1583           scrolled_win->hscrollbar_visible = (adjustment->upper - adjustment->lower >
1584                                               adjustment->page_size);
1585           if (scrolled_win->hscrollbar_visible != visible)
1586             gtk_widget_queue_resize (GTK_WIDGET (scrolled_win));
1587         }
1588     }
1589   else if (scrolled_win->vscrollbar &&
1590            adjustment == gtk_range_get_adjustment (GTK_RANGE (scrolled_win->vscrollbar)))
1591     {
1592       if (scrolled_win->vscrollbar_policy == GTK_POLICY_AUTOMATIC)
1593         {
1594           gboolean visible;
1595
1596           visible = scrolled_win->vscrollbar_visible;
1597           scrolled_win->vscrollbar_visible = (adjustment->upper - adjustment->lower >
1598                                               adjustment->page_size);
1599           if (scrolled_win->vscrollbar_visible != visible)
1600             gtk_widget_queue_resize (GTK_WIDGET (scrolled_win));
1601         }
1602     }
1603 }
1604
1605 static void
1606 gtk_scrolled_window_add (GtkContainer *container,
1607                          GtkWidget    *child)
1608 {
1609   GtkScrolledWindow *scrolled_window;
1610   GtkBin *bin;
1611
1612   bin = GTK_BIN (container);
1613   g_return_if_fail (bin->child == NULL);
1614
1615   scrolled_window = GTK_SCROLLED_WINDOW (container);
1616
1617   bin->child = child;
1618   gtk_widget_set_parent (child, GTK_WIDGET (bin));
1619
1620   /* this is a temporary message */
1621   if (!gtk_widget_set_scroll_adjustments (child,
1622                                           gtk_range_get_adjustment (GTK_RANGE (scrolled_window->hscrollbar)),
1623                                           gtk_range_get_adjustment (GTK_RANGE (scrolled_window->vscrollbar))))
1624     g_warning ("gtk_scrolled_window_add(): cannot add non scrollable widget "
1625                "use gtk_scrolled_window_add_with_viewport() instead");
1626 }
1627
1628 static void
1629 gtk_scrolled_window_remove (GtkContainer *container,
1630                             GtkWidget    *child)
1631 {
1632   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (container));
1633   g_return_if_fail (child != NULL);
1634   g_return_if_fail (GTK_BIN (container)->child == child);
1635   
1636   gtk_widget_set_scroll_adjustments (child, NULL, NULL);
1637
1638   /* chain parent class handler to remove child */
1639   GTK_CONTAINER_CLASS (gtk_scrolled_window_parent_class)->remove (container, child);
1640 }
1641
1642 void
1643 gtk_scrolled_window_add_with_viewport (GtkScrolledWindow *scrolled_window,
1644                                        GtkWidget         *child)
1645 {
1646   GtkBin *bin;
1647   GtkWidget *viewport;
1648
1649   g_return_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window));
1650   g_return_if_fail (GTK_IS_WIDGET (child));
1651   g_return_if_fail (child->parent == NULL);
1652
1653   bin = GTK_BIN (scrolled_window);
1654
1655   if (bin->child != NULL)
1656     {
1657       g_return_if_fail (GTK_IS_VIEWPORT (bin->child));
1658       g_return_if_fail (GTK_BIN (bin->child)->child == NULL);
1659
1660       viewport = bin->child;
1661     }
1662   else
1663     {
1664       viewport =
1665         gtk_viewport_new (gtk_scrolled_window_get_hadjustment (scrolled_window),
1666                           gtk_scrolled_window_get_vadjustment (scrolled_window));
1667       gtk_container_add (GTK_CONTAINER (scrolled_window), viewport);
1668     }
1669
1670   gtk_widget_show (viewport);
1671   gtk_container_add (GTK_CONTAINER (viewport), child);
1672 }
1673
1674 /**
1675  * _gtk_scrolled_window_get_spacing:
1676  * @scrolled_window: a scrolled window
1677  * 
1678  * Gets the spacing between the scrolled window's scrollbars and
1679  * the scrolled widget. Used by GtkCombo
1680  * 
1681  * Return value: the spacing, in pixels.
1682  **/
1683 gint
1684 _gtk_scrolled_window_get_scrollbar_spacing (GtkScrolledWindow *scrolled_window)
1685 {
1686   GtkScrolledWindowClass *class;
1687     
1688   g_return_val_if_fail (GTK_IS_SCROLLED_WINDOW (scrolled_window), 0);
1689
1690   class = GTK_SCROLLED_WINDOW_GET_CLASS (scrolled_window);
1691
1692   if (class->scrollbar_spacing >= 0)
1693     return class->scrollbar_spacing;
1694   else
1695     {
1696       gint scrollbar_spacing;
1697       
1698       gtk_widget_style_get (GTK_WIDGET (scrolled_window),
1699                             "scrollbar-spacing", &scrollbar_spacing,
1700                             NULL);
1701
1702       return scrollbar_spacing;
1703     }
1704 }
1705
1706 #define __GTK_SCROLLED_WINDOW_C__
1707 #include "gtkaliasdef.c"