docs/reference/gtk/html/GtkScrolledWindow.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GtkScrolledWindow</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
   8 <link rel="up" href="ScrollingWidgets.html" title="Scrolling">
   9 <link rel="prev" href="GtkVScrollbar.html" title="GtkVScrollbar">
  10 <link rel="next" href="GtkScrollable.html" title="GtkScrollable">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="GtkVScrollbar.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ScrollingWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GTK+ 3 Reference Manual</th>
  21 <td><a accesskey="n" href="GtkScrollable.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#GtkScrolledWindow.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GtkScrolledWindow.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GtkScrolledWindow.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GtkScrolledWindow.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#GtkScrolledWindow.properties" class="shortcut">Properties</a>
  33                    |
  34                   <a href="#GtkScrolledWindow.style-properties" class="shortcut">Style Properties</a>
  35                    |
  36                   <a href="#GtkScrolledWindow.signals" class="shortcut">Signals</a>
  37 </td></tr>
  38 </table>
  39 <div class="refentry">
  40 <a name="GtkScrolledWindow"></a><div class="titlepage"></div>
  41 <div class="refnamediv"><table width="100%"><tr>
  42 <td valign="top">
  43 <h2><span class="refentrytitle"><a name="GtkScrolledWindow.top_of_page"></a>GtkScrolledWindow</span></h2>
  44 <p>GtkScrolledWindow — Adds scrollbars to its child widget</p>
  45 </td>
  46 <td valign="top" align="right"><img src="scrolledwindow.png"></td>
  47 </tr></table></div>
  48 <div class="refsynopsisdiv">
  49 <a name="GtkScrolledWindow.synopsis"></a><h2>Synopsis</h2>
  50 <pre class="synopsis">
  51 #include &lt;gtk/gtk.h&gt;
  52
  53 struct              <a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow-struct" title="struct GtkScrolledWindow">GtkScrolledWindow</a>;
  54 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-new" title="gtk_scrolled_window_new ()">gtk_scrolled_window_new</a>             (<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadjustment</code></em>,
  55                                                          <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadjustment</code></em>);
  56 <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-hadjustment" title="gtk_scrolled_window_get_hadjustment ()">gtk_scrolled_window_get_hadjustment</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  57 <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-vadjustment" title="gtk_scrolled_window_get_vadjustment ()">gtk_scrolled_window_get_vadjustment</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  58 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-hscrollbar" title="gtk_scrolled_window_get_hscrollbar ()">gtk_scrolled_window_get_hscrollbar</a>  (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  59 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-vscrollbar" title="gtk_scrolled_window_get_vscrollbar ()">gtk_scrolled_window_get_vscrollbar</a>  (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  60 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-policy" title="gtk_scrolled_window_set_policy ()">gtk_scrolled_window_set_policy</a>      (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  61                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> hscrollbar_policy</code></em>,
  62                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> vscrollbar_policy</code></em>);
  63 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-add-with-viewport" title="gtk_scrolled_window_add_with_viewport ()">gtk_scrolled_window_add_with_viewport</a>
  64                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  65                                                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);
  66 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-placement" title="gtk_scrolled_window_set_placement ()">gtk_scrolled_window_set_placement</a>   (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  67                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a> window_placement</code></em>);
  68 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-unset-placement" title="gtk_scrolled_window_unset_placement ()">gtk_scrolled_window_unset_placement</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  69 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-shadow-type" title="gtk_scrolled_window_set_shadow_type ()">gtk_scrolled_window_set_shadow_type</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  70                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a> type</code></em>);
  71 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-hadjustment" title="gtk_scrolled_window_set_hadjustment ()">gtk_scrolled_window_set_hadjustment</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  72                                                          <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadjustment</code></em>);
  73 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-vadjustment" title="gtk_scrolled_window_set_vadjustment ()">gtk_scrolled_window_set_vadjustment</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  74                                                          <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadjustment</code></em>);
  75 <a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="returnvalue">GtkCornerType</span></a>       <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-placement" title="gtk_scrolled_window_get_placement ()">gtk_scrolled_window_get_placement</a>   (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  76 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-policy" title="gtk_scrolled_window_get_policy ()">gtk_scrolled_window_get_policy</a>      (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  77                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> *hscrollbar_policy</code></em>,
  78                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> *vscrollbar_policy</code></em>);
  79 <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="returnvalue">GtkShadowType</span></a>       <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-shadow-type" title="gtk_scrolled_window_get_shadow_type ()">gtk_scrolled_window_get_shadow_type</a> (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  80 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-min-content-width" title="gtk_scrolled_window_get_min_content_width ()">gtk_scrolled_window_get_min_content_width</a>
  81                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  82 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-min-content-width" title="gtk_scrolled_window_set_min_content_width ()">gtk_scrolled_window_set_min_content_width</a>
  83                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  84                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>);
  85 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-min-content-height" title="gtk_scrolled_window_get_min_content_height ()">gtk_scrolled_window_get_min_content_height</a>
  86                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  87 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-min-content-height" title="gtk_scrolled_window_set_min_content_height ()">gtk_scrolled_window_set_min_content_height</a>
  88                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  89                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>);
  90 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-kinetic-scrolling" title="gtk_scrolled_window_set_kinetic_scrolling ()">gtk_scrolled_window_set_kinetic_scrolling</a>
  91                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  92                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> kinetic_scrolling</code></em>);
  93 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-kinetic-scrolling" title="gtk_scrolled_window_get_kinetic_scrolling ()">gtk_scrolled_window_get_kinetic_scrolling</a>
  94                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
  95 <span class="returnvalue">void</span>                <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-capture-button-press" title="gtk_scrolled_window_set_capture_button_press ()">gtk_scrolled_window_set_capture_button_press</a>
  96                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
  97                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> capture_button_press</code></em>);
  98 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-capture-button-press" title="gtk_scrolled_window_get_capture_button_press ()">gtk_scrolled_window_get_capture_button_press</a>
  99                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);
 100 </pre>
 101 </div>
 102 <div class="refsect1">
 103 <a name="GtkScrolledWindow.object-hierarchy"></a><h2>Object Hierarchy</h2>
 104 <pre class="synopsis">
 105   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 106    +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 107          +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
 108                +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
 109                      +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
 110                            +----GtkScrolledWindow
 111 </pre>
 112 </div>
 113 <div class="refsect1">
 114 <a name="GtkScrolledWindow.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 115 <p>
 116 GtkScrolledWindow implements
 117  AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
 118 </div>
 119 <div class="refsect1">
 120 <a name="GtkScrolledWindow.properties"></a><h2>Properties</h2>
 121 <pre class="synopsis">
 122   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--hadjustment" title='The "hadjustment" property'>hadjustment</a>"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write / Construct
 123   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--hscrollbar-policy" title='The "hscrollbar-policy" property'>hscrollbar-policy</a>"        <a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a>         : Read / Write
 124   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--kinetic-scrolling" title='The "kinetic-scrolling" property'>kinetic-scrolling</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 125   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--min-content-height" title='The "min-content-height" property'>min-content-height</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 126   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--min-content-width" title='The "min-content-width" property'>min-content-width</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 127   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--shadow-type" title='The "shadow-type" property'>shadow-type</a>"              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read / Write
 128   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--vadjustment" title='The "vadjustment" property'>vadjustment</a>"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write / Construct
 129   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--vscrollbar-policy" title='The "vscrollbar-policy" property'>vscrollbar-policy</a>"        <a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a>         : Read / Write
 130   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--window-placement" title='The "window-placement" property'>window-placement</a>"         <a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a>         : Read / Write
 131   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--window-placement-set" title='The "window-placement-set" property'>window-placement-set</a>"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 132 </pre>
 133 </div>
 134 <div class="refsect1">
 135 <a name="GtkScrolledWindow.style-properties"></a><h2>Style Properties</h2>
 136 <pre class="synopsis">
 137   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--s-scrollbar-spacing" title='The "scrollbar-spacing" style property'>scrollbar-spacing</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 138   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow--s-scrollbars-within-bevel" title='The "scrollbars-within-bevel" style property'>scrollbars-within-bevel</a>"  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
 139 </pre>
 140 </div>
 141 <div class="refsect1">
 142 <a name="GtkScrolledWindow.signals"></a><h2>Signals</h2>
 143 <pre class="synopsis">
 144   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow-move-focus-out" title='The "move-focus-out" signal'>move-focus-out</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
 145   "<a class="link" href="GtkScrolledWindow.html#GtkScrolledWindow-scroll-child" title='The "scroll-child" signal'>scroll-child</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
 146 </pre>
 147 </div>
 148 <div class="refsect1">
 149 <a name="GtkScrolledWindow.description"></a><h2>Description</h2>
 150 <p>
 151 <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> is a <a class="link" href="GtkBin.html" title="GtkBin"><span class="type">GtkBin</span></a> subclass: it's a container
 152 the accepts a single child widget. <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> adds scrollbars
 153 to the child widget and optionally draws a beveled frame around the
 154 child widget.
 155 </p>
 156 <p>
 157 The scrolled window can work in two ways. Some widgets have native
 158 scrolling support; these widgets implement the <a class="link" href="GtkScrollable.html" title="GtkScrollable"><span class="type">GtkScrollable</span></a> interface.
 159 Widgets with native scroll support include <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>, <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>,
 160 and <a class="link" href="GtkLayout.html" title="GtkLayout"><span class="type">GtkLayout</span></a>.
 161 </p>
 162 <p>
 163 For widgets that lack native scrolling support, the <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>
 164 widget acts as an adaptor class, implementing scrollability for child
 165 widgets that lack their own scrolling capabilities. Use <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>
 166 to scroll child widgets such as <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a>, <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>, and so on.
 167 </p>
 168 <p>
 169 If a widget has native scrolling abilities, it can be added to the
 170 <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> with <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a>. If a widget does not, you
 171 must first add the widget to a <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>, then add the <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>
 172 to the scrolled window. The convenience function
 173 <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-add-with-viewport" title="gtk_scrolled_window_add_with_viewport ()"><code class="function">gtk_scrolled_window_add_with_viewport()</code></a> does exactly this, so you can
 174 ignore the presence of the viewport.
 175 </p>
 176 <p>
 177 The position of the scrollbars is controlled by the scroll
 178 adjustments. See <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> for the fields in an adjustment - for
 179 <a class="link" href="GtkScrollbar.html" title="GtkScrollbar"><span class="type">GtkScrollbar</span></a>, used by <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>, the "value" field
 180 represents the position of the scrollbar, which must be between the
 181 "lower" field and "upper - page_size." The "page_size" field
 182 represents the size of the visible scrollable area. The
 183 "step_increment" and "page_increment" fields are used when the user
 184 asks to step down (using the small stepper arrows) or page down (using
 185 for example the PageDown key).
 186 </p>
 187 <p>
 188 If a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> doesn't behave quite as you would like, or
 189 doesn't have exactly the right layout, it's very possible to set up
 190 your own scrolling with <a class="link" href="GtkScrollbar.html" title="GtkScrollbar"><span class="type">GtkScrollbar</span></a> and for example a <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a>.
 191 </p>
 192 </div>
 193 <div class="refsect1">
 194 <a name="GtkScrolledWindow.details"></a><h2>Details</h2>
 195 <div class="refsect2">
 196 <a name="GtkScrolledWindow-struct"></a><h3>struct GtkScrolledWindow</h3>
 197 <pre class="programlisting">struct GtkScrolledWindow;</pre>
 198 </div>
 199 <hr>
 200 <div class="refsect2">
 201 <a name="gtk-scrolled-window-new"></a><h3>gtk_scrolled_window_new ()</h3>
 202 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_scrolled_window_new             (<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadjustment</code></em>,
 203                                                          <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadjustment</code></em>);</pre>
 204 <p>
 205 Creates a new scrolled window.
 206 </p>
 207 <p>
 208 The two arguments are the scrolled window's adjustments; these will be
 209 shared with the scrollbars and the child widget to keep the bars in sync
 210 with the child. Usually you want to pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the adjustments, which
 211 will cause the scrolled window to create them for you.
 212 </p>
 213 <div class="variablelist"><table border="0">
 214 <col align="left" valign="top">
 215 <tbody>
 216 <tr>
 217 <td><p><span class="term"><em class="parameter"><code>hadjustment</code></em> :</span></p></td>
 218 <td>horizontal adjustment. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 219 </td>
 220 </tr>
 221 <tr>
 222 <td><p><span class="term"><em class="parameter"><code>vadjustment</code></em> :</span></p></td>
 223 <td>vertical adjustment. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 224 </td>
 225 </tr>
 226 <tr>
 227 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 228 <td>a new scrolled window</td>
 229 </tr>
 230 </tbody>
 231 </table></div>
 232 </div>
 233 <hr>
 234 <div class="refsect2">
 235 <a name="gtk-scrolled-window-get-hadjustment"></a><h3>gtk_scrolled_window_get_hadjustment ()</h3>
 236 <pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     gtk_scrolled_window_get_hadjustment (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 237 <p>
 238 Returns the horizontal scrollbar's adjustment, used to connect the
 239 horizontal scrollbar to the child widget's horizontal scroll
 240 functionality.
 241 </p>
 242 <div class="variablelist"><table border="0">
 243 <col align="left" valign="top">
 244 <tbody>
 245 <tr>
 246 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 247 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 248 </td>
 249 </tr>
 250 <tr>
 251 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 252 <td>the horizontal <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 253 </td>
 254 </tr>
 255 </tbody>
 256 </table></div>
 257 </div>
 258 <hr>
 259 <div class="refsect2">
 260 <a name="gtk-scrolled-window-get-vadjustment"></a><h3>gtk_scrolled_window_get_vadjustment ()</h3>
 261 <pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     gtk_scrolled_window_get_vadjustment (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 262 <p>
 263 Returns the vertical scrollbar's adjustment, used to connect the
 264 vertical scrollbar to the child widget's vertical scroll functionality.
 265 </p>
 266 <div class="variablelist"><table border="0">
 267 <col align="left" valign="top">
 268 <tbody>
 269 <tr>
 270 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 271 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 272 </td>
 273 </tr>
 274 <tr>
 275 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 276 <td>the vertical <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 277 </td>
 278 </tr>
 279 </tbody>
 280 </table></div>
 281 </div>
 282 <hr>
 283 <div class="refsect2">
 284 <a name="gtk-scrolled-window-get-hscrollbar"></a><h3>gtk_scrolled_window_get_hscrollbar ()</h3>
 285 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_scrolled_window_get_hscrollbar  (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 286 <p>
 287 Returns the horizontal scrollbar of <em class="parameter"><code>scrolled_window</code></em>.
 288 </p>
 289 <div class="variablelist"><table border="0">
 290 <col align="left" valign="top">
 291 <tbody>
 292 <tr>
 293 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 294 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 295 </td>
 296 </tr>
 297 <tr>
 298 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 299 <td>the horizontal scrollbar of the scrolled window,
 300 or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it does not have one. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 301 </td>
 302 </tr>
 303 </tbody>
 304 </table></div>
 305 <p class="since">Since 2.8</p>
 306 </div>
 307 <hr>
 308 <div class="refsect2">
 309 <a name="gtk-scrolled-window-get-vscrollbar"></a><h3>gtk_scrolled_window_get_vscrollbar ()</h3>
 310 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_scrolled_window_get_vscrollbar  (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 311 <p>
 312 Returns the vertical scrollbar of <em class="parameter"><code>scrolled_window</code></em>.
 313 </p>
 314 <div class="variablelist"><table border="0">
 315 <col align="left" valign="top">
 316 <tbody>
 317 <tr>
 318 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 319 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 320 </td>
 321 </tr>
 322 <tr>
 323 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 324 <td>the vertical scrollbar of the scrolled window,
 325 or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it does not have one. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 326 </td>
 327 </tr>
 328 </tbody>
 329 </table></div>
 330 <p class="since">Since 2.8</p>
 331 </div>
 332 <hr>
 333 <div class="refsect2">
 334 <a name="gtk-scrolled-window-set-policy"></a><h3>gtk_scrolled_window_set_policy ()</h3>
 335 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_policy      (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 336                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> hscrollbar_policy</code></em>,
 337                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> vscrollbar_policy</code></em>);</pre>
 338 <p>
 339 Sets the scrollbar policy for the horizontal and vertical scrollbars.
 340 </p>
 341 <p>
 342 The policy determines when the scrollbar should appear; it is a value
 343 from the <a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> enumeration. If <a class="link" href="gtk3-Standard-Enumerations.html#GTK-POLICY-ALWAYS:CAPS"><code class="literal">GTK_POLICY_ALWAYS</code></a>, the
 344 scrollbar is always present; if <a class="link" href="gtk3-Standard-Enumerations.html#GTK-POLICY-NEVER:CAPS"><code class="literal">GTK_POLICY_NEVER</code></a>, the scrollbar is
 345 never present; if <a class="link" href="gtk3-Standard-Enumerations.html#GTK-POLICY-AUTOMATIC:CAPS"><code class="literal">GTK_POLICY_AUTOMATIC</code></a>, the scrollbar is present only
 346 if needed (that is, if the slider part of the bar would be smaller
 347 than the trough - the display is larger than the page size).
 348 </p>
 349 <div class="variablelist"><table border="0">
 350 <col align="left" valign="top">
 351 <tbody>
 352 <tr>
 353 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 354 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 355 </td>
 356 </tr>
 357 <tr>
 358 <td><p><span class="term"><em class="parameter"><code>hscrollbar_policy</code></em> :</span></p></td>
 359 <td>policy for horizontal bar</td>
 360 </tr>
 361 <tr>
 362 <td><p><span class="term"><em class="parameter"><code>vscrollbar_policy</code></em> :</span></p></td>
 363 <td>policy for vertical bar</td>
 364 </tr>
 365 </tbody>
 366 </table></div>
 367 </div>
 368 <hr>
 369 <div class="refsect2">
 370 <a name="gtk-scrolled-window-add-with-viewport"></a><h3>gtk_scrolled_window_add_with_viewport ()</h3>
 371 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_add_with_viewport
 372                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 373                                                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
 374 <p>
 375 Used to add children without native scrolling capabilities. This
 376 is simply a convenience function; it is equivalent to adding the
 377 unscrollable child to a viewport, then adding the viewport to the
 378 scrolled window. If a child has native scrolling, use
 379 <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> instead of this function.
 380 </p>
 381 <p>
 382 The viewport scrolls the child by moving its <a href="http://developer.gnome.org/devel/gdk/gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, and takes
 383 the size of the child to be the size of its toplevel <a href="http://developer.gnome.org/devel/gdk/gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.
 384 This will be very wrong for most widgets that support native scrolling;
 385 for example, if you add a widget such as <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> with a viewport,
 386 the whole widget will scroll, including the column headings. Thus,
 387 widgets with native scrolling support should not be used with the
 388 <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a> proxy.
 389 </p>
 390 <p>
 391 A widget supports scrolling natively if it implements the
 392 <a class="link" href="GtkScrollable.html" title="GtkScrollable"><span class="type">GtkScrollable</span></a> interface.
 393 </p>
 394 <div class="variablelist"><table border="0">
 395 <col align="left" valign="top">
 396 <tbody>
 397 <tr>
 398 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 399 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 400 </td>
 401 </tr>
 402 <tr>
 403 <td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
 404 <td>the widget you want to scroll</td>
 405 </tr>
 406 </tbody>
 407 </table></div>
 408 </div>
 409 <hr>
 410 <div class="refsect2">
 411 <a name="gtk-scrolled-window-set-placement"></a><h3>gtk_scrolled_window_set_placement ()</h3>
 412 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_placement   (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 413                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a> window_placement</code></em>);</pre>
 414 <p>
 415 Sets the placement of the contents with respect to the scrollbars
 416 for the scrolled window.
 417 </p>
 418 <p>
 419 The default is <a class="link" href="gtk3-Standard-Enumerations.html#GTK-CORNER-TOP-LEFT:CAPS"><code class="literal">GTK_CORNER_TOP_LEFT</code></a>, meaning the child is
 420 in the top left, with the scrollbars underneath and to the right.
 421 Other values in <a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a> are <a class="link" href="gtk3-Standard-Enumerations.html#GTK-CORNER-TOP-RIGHT:CAPS"><code class="literal">GTK_CORNER_TOP_RIGHT</code></a>,
 422 <a class="link" href="gtk3-Standard-Enumerations.html#GTK-CORNER-BOTTOM-LEFT:CAPS"><code class="literal">GTK_CORNER_BOTTOM_LEFT</code></a>, and <a class="link" href="gtk3-Standard-Enumerations.html#GTK-CORNER-BOTTOM-RIGHT:CAPS"><code class="literal">GTK_CORNER_BOTTOM_RIGHT</code></a>.
 423 </p>
 424 <p>
 425 See also <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-placement" title="gtk_scrolled_window_get_placement ()"><code class="function">gtk_scrolled_window_get_placement()</code></a> and
 426 <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-unset-placement" title="gtk_scrolled_window_unset_placement ()"><code class="function">gtk_scrolled_window_unset_placement()</code></a>.
 427 </p>
 428 <div class="variablelist"><table border="0">
 429 <col align="left" valign="top">
 430 <tbody>
 431 <tr>
 432 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 433 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 434 </td>
 435 </tr>
 436 <tr>
 437 <td><p><span class="term"><em class="parameter"><code>window_placement</code></em> :</span></p></td>
 438 <td>position of the child window</td>
 439 </tr>
 440 </tbody>
 441 </table></div>
 442 </div>
 443 <hr>
 444 <div class="refsect2">
 445 <a name="gtk-scrolled-window-unset-placement"></a><h3>gtk_scrolled_window_unset_placement ()</h3>
 446 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_unset_placement (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 447 <p>
 448 Unsets the placement of the contents with respect to the scrollbars
 449 for the scrolled window. If no window placement is set for a scrolled
 450 window, it obeys the "gtk-scrolled-window-placement" XSETTING.
 451 </p>
 452 <p>
 453 See also <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-placement" title="gtk_scrolled_window_set_placement ()"><code class="function">gtk_scrolled_window_set_placement()</code></a> and
 454 <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-placement" title="gtk_scrolled_window_get_placement ()"><code class="function">gtk_scrolled_window_get_placement()</code></a>.
 455 </p>
 456 <div class="variablelist"><table border="0">
 457 <col align="left" valign="top">
 458 <tbody><tr>
 459 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 460 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 461 </td>
 462 </tr></tbody>
 463 </table></div>
 464 <p class="since">Since 2.10</p>
 465 </div>
 466 <hr>
 467 <div class="refsect2">
 468 <a name="gtk-scrolled-window-set-shadow-type"></a><h3>gtk_scrolled_window_set_shadow_type ()</h3>
 469 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_shadow_type (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 470                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a> type</code></em>);</pre>
 471 <p>
 472 Changes the type of shadow drawn around the contents of
 473 <em class="parameter"><code>scrolled_window</code></em>.
 474 </p>
 475 <div class="variablelist"><table border="0">
 476 <col align="left" valign="top">
 477 <tbody>
 478 <tr>
 479 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 480 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 481 </td>
 482 </tr>
 483 <tr>
 484 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
 485 <td>kind of shadow to draw around scrolled window contents</td>
 486 </tr>
 487 </tbody>
 488 </table></div>
 489 </div>
 490 <hr>
 491 <div class="refsect2">
 492 <a name="gtk-scrolled-window-set-hadjustment"></a><h3>gtk_scrolled_window_set_hadjustment ()</h3>
 493 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_hadjustment (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 494                                                          <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadjustment</code></em>);</pre>
 495 <p>
 496 Sets the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> for the horizontal scrollbar.
 497 </p>
 498 <div class="variablelist"><table border="0">
 499 <col align="left" valign="top">
 500 <tbody>
 501 <tr>
 502 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 503 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 504 </td>
 505 </tr>
 506 <tr>
 507 <td><p><span class="term"><em class="parameter"><code>hadjustment</code></em> :</span></p></td>
 508 <td>horizontal scroll adjustment</td>
 509 </tr>
 510 </tbody>
 511 </table></div>
 512 </div>
 513 <hr>
 514 <div class="refsect2">
 515 <a name="gtk-scrolled-window-set-vadjustment"></a><h3>gtk_scrolled_window_set_vadjustment ()</h3>
 516 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_vadjustment (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 517                                                          <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadjustment</code></em>);</pre>
 518 <p>
 519 Sets the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> for the vertical scrollbar.
 520 </p>
 521 <div class="variablelist"><table border="0">
 522 <col align="left" valign="top">
 523 <tbody>
 524 <tr>
 525 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 526 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 527 </td>
 528 </tr>
 529 <tr>
 530 <td><p><span class="term"><em class="parameter"><code>vadjustment</code></em> :</span></p></td>
 531 <td>vertical scroll adjustment</td>
 532 </tr>
 533 </tbody>
 534 </table></div>
 535 </div>
 536 <hr>
 537 <div class="refsect2">
 538 <a name="gtk-scrolled-window-get-placement"></a><h3>gtk_scrolled_window_get_placement ()</h3>
 539 <pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="returnvalue">GtkCornerType</span></a>       gtk_scrolled_window_get_placement   (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 540 <p>
 541 Gets the placement of the contents with respect to the scrollbars
 542 for the scrolled window. See <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-placement" title="gtk_scrolled_window_set_placement ()"><code class="function">gtk_scrolled_window_set_placement()</code></a>.
 543 </p>
 544 <div class="variablelist"><table border="0">
 545 <col align="left" valign="top">
 546 <tbody>
 547 <tr>
 548 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 549 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 550 </td>
 551 </tr>
 552 <tr>
 553 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 554 <td>the current placement value.
 555 See also <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-placement" title="gtk_scrolled_window_set_placement ()"><code class="function">gtk_scrolled_window_set_placement()</code></a> and
 556 <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-unset-placement" title="gtk_scrolled_window_unset_placement ()"><code class="function">gtk_scrolled_window_unset_placement()</code></a>.</td>
 557 </tr>
 558 </tbody>
 559 </table></div>
 560 </div>
 561 <hr>
 562 <div class="refsect2">
 563 <a name="gtk-scrolled-window-get-policy"></a><h3>gtk_scrolled_window_get_policy ()</h3>
 564 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_get_policy      (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 565                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> *hscrollbar_policy</code></em>,
 566                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a> *vscrollbar_policy</code></em>);</pre>
 567 <p>
 568 Retrieves the current policy values for the horizontal and vertical
 569 scrollbars. See <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-policy" title="gtk_scrolled_window_set_policy ()"><code class="function">gtk_scrolled_window_set_policy()</code></a>.
 570 </p>
 571 <div class="variablelist"><table border="0">
 572 <col align="left" valign="top">
 573 <tbody>
 574 <tr>
 575 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 576 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 577 </td>
 578 </tr>
 579 <tr>
 580 <td><p><span class="term"><em class="parameter"><code>hscrollbar_policy</code></em> :</span></p></td>
 581 <td>location to store the policy
 582 for the horizontal scrollbar, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 583 </td>
 584 </tr>
 585 <tr>
 586 <td><p><span class="term"><em class="parameter"><code>vscrollbar_policy</code></em> :</span></p></td>
 587 <td>location to store the policy
 588 for the vertical scrollbar, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 589 </td>
 590 </tr>
 591 </tbody>
 592 </table></div>
 593 </div>
 594 <hr>
 595 <div class="refsect2">
 596 <a name="gtk-scrolled-window-get-shadow-type"></a><h3>gtk_scrolled_window_get_shadow_type ()</h3>
 597 <pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="returnvalue">GtkShadowType</span></a>       gtk_scrolled_window_get_shadow_type (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 598 <p>
 599 Gets the shadow type of the scrolled window. See
 600 <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-shadow-type" title="gtk_scrolled_window_set_shadow_type ()"><code class="function">gtk_scrolled_window_set_shadow_type()</code></a>.
 601 </p>
 602 <div class="variablelist"><table border="0">
 603 <col align="left" valign="top">
 604 <tbody>
 605 <tr>
 606 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 607 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 608 </td>
 609 </tr>
 610 <tr>
 611 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 612 <td>the current shadow type</td>
 613 </tr>
 614 </tbody>
 615 </table></div>
 616 </div>
 617 <hr>
 618 <div class="refsect2">
 619 <a name="gtk-scrolled-window-get-min-content-width"></a><h3>gtk_scrolled_window_get_min_content_width ()</h3>
 620 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_scrolled_window_get_min_content_width
 621                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 622 <p>
 623 Gets the minimum content width of <em class="parameter"><code>scrolled_window</code></em>, or -1 if not set.
 624 </p>
 625 <div class="variablelist"><table border="0">
 626 <col align="left" valign="top">
 627 <tbody>
 628 <tr>
 629 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 630 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 631 </td>
 632 </tr>
 633 <tr>
 634 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 635 <td>the minimum content width</td>
 636 </tr>
 637 </tbody>
 638 </table></div>
 639 <p class="since">Since 3.0</p>
 640 </div>
 641 <hr>
 642 <div class="refsect2">
 643 <a name="gtk-scrolled-window-set-min-content-width"></a><h3>gtk_scrolled_window_set_min_content_width ()</h3>
 644 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_min_content_width
 645                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 646                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>);</pre>
 647 <p>
 648 Sets the minimum width that <em class="parameter"><code>scrolled_window</code></em> should keep visible.
 649 Note that this can and (usually will) be smaller than the minimum
 650 size of the content.
 651 </p>
 652 <div class="variablelist"><table border="0">
 653 <col align="left" valign="top">
 654 <tbody>
 655 <tr>
 656 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 657 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 658 </td>
 659 </tr>
 660 <tr>
 661 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
 662 <td>the minimal content width</td>
 663 </tr>
 664 </tbody>
 665 </table></div>
 666 <p class="since">Since 3.0</p>
 667 </div>
 668 <hr>
 669 <div class="refsect2">
 670 <a name="gtk-scrolled-window-get-min-content-height"></a><h3>gtk_scrolled_window_get_min_content_height ()</h3>
 671 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_scrolled_window_get_min_content_height
 672                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 673 <p>
 674 Gets the minimal content height of <em class="parameter"><code>scrolled_window</code></em>, or -1 if not set.
 675 </p>
 676 <div class="variablelist"><table border="0">
 677 <col align="left" valign="top">
 678 <tbody>
 679 <tr>
 680 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 681 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 682 </td>
 683 </tr>
 684 <tr>
 685 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 686 <td>the minimal content height</td>
 687 </tr>
 688 </tbody>
 689 </table></div>
 690 <p class="since">Since 3.0</p>
 691 </div>
 692 <hr>
 693 <div class="refsect2">
 694 <a name="gtk-scrolled-window-set-min-content-height"></a><h3>gtk_scrolled_window_set_min_content_height ()</h3>
 695 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_min_content_height
 696                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 697                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>);</pre>
 698 <p>
 699 Sets the minimum height that <em class="parameter"><code>scrolled_window</code></em> should keep visible.
 700 Note that this can and (usually will) be smaller than the minimum
 701 size of the content.
 702 </p>
 703 <div class="variablelist"><table border="0">
 704 <col align="left" valign="top">
 705 <tbody>
 706 <tr>
 707 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 708 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 709 </td>
 710 </tr>
 711 <tr>
 712 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
 713 <td>the minimal content height</td>
 714 </tr>
 715 </tbody>
 716 </table></div>
 717 <p class="since">Since 3.0</p>
 718 </div>
 719 <hr>
 720 <div class="refsect2">
 721 <a name="gtk-scrolled-window-set-kinetic-scrolling"></a><h3>gtk_scrolled_window_set_kinetic_scrolling ()</h3>
 722 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_kinetic_scrolling
 723                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 724                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> kinetic_scrolling</code></em>);</pre>
 725 <p>
 726 Turns kinetic scrolling on or off.
 727 Kinetic scrolling only applies to devices with source
 728 <a href="http://developer.gnome.org/devel/gdk/GdkDevice.html#GDK-SOURCE-TOUCHSCREEN:CAPS"><code class="literal">GDK_SOURCE_TOUCHSCREEN</code></a>.
 729 </p>
 730 <div class="variablelist"><table border="0">
 731 <col align="left" valign="top">
 732 <tbody>
 733 <tr>
 734 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 735 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 736 </td>
 737 </tr>
 738 <tr>
 739 <td><p><span class="term"><em class="parameter"><code>kinetic_scrolling</code></em> :</span></p></td>
 740 <td>
 741 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable kinetic scrolling</td>
 742 </tr>
 743 </tbody>
 744 </table></div>
 745 <p class="since">Since 3.4</p>
 746 </div>
 747 <hr>
 748 <div class="refsect2">
 749 <a name="gtk-scrolled-window-get-kinetic-scrolling"></a><h3>gtk_scrolled_window_get_kinetic_scrolling ()</h3>
 750 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_scrolled_window_get_kinetic_scrolling
 751                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 752 <p>
 753 Returns the specified kinetic scrolling behavior.
 754 </p>
 755 <div class="variablelist"><table border="0">
 756 <col align="left" valign="top">
 757 <tbody>
 758 <tr>
 759 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 760 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 761 </td>
 762 </tr>
 763 <tr>
 764 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 765 <td>the scrolling behavior flags.</td>
 766 </tr>
 767 </tbody>
 768 </table></div>
 769 <p class="since">Since 3.4</p>
 770 </div>
 771 <hr>
 772 <div class="refsect2">
 773 <a name="gtk-scrolled-window-set-capture-button-press"></a><h3>gtk_scrolled_window_set_capture_button_press ()</h3>
 774 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_scrolled_window_set_capture_button_press
 775                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>,
 776                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> capture_button_press</code></em>);</pre>
 777 <p>
 778 Changes the behaviour of <em class="parameter"><code>scrolled_window</code></em> wrt. to the initial
 779 event that possibly starts kinetic scrolling. When <em class="parameter"><code>capture_button_press</code></em>
 780 is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the event is captured by the scrolled window, and
 781 then later replayed if it is meant to go to the child widget.
 782 </p>
 783 <p>
 784 This should be enabled if any child widgets perform non-reversible
 785 actions on <a class="link" href="GtkWidget.html#GtkWidget-button-press-event" title='The "button-press-event" signal'><span class="type">"button-press-event"</span></a>. If they don't, and handle
 786 additionally handle <a class="link" href="GtkWidget.html#GtkWidget-grab-broken-event" title='The "grab-broken-event" signal'><span class="type">"grab-broken-event"</span></a>, it might be better
 787 to set <em class="parameter"><code>capture_button_press</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
 788 </p>
 789 <p>
 790 This setting only has an effect if kinetic scrolling is enabled.
 791 </p>
 792 <div class="variablelist"><table border="0">
 793 <col align="left" valign="top">
 794 <tbody>
 795 <tr>
 796 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 797 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 798 </td>
 799 </tr>
 800 <tr>
 801 <td><p><span class="term"><em class="parameter"><code>capture_button_press</code></em> :</span></p></td>
 802 <td>
 803 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to capture button presses</td>
 804 </tr>
 805 </tbody>
 806 </table></div>
 807 <p class="since">Since 3.4</p>
 808 </div>
 809 <hr>
 810 <div class="refsect2">
 811 <a name="gtk-scrolled-window-get-capture-button-press"></a><h3>gtk_scrolled_window_get_capture_button_press ()</h3>
 812 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_scrolled_window_get_capture_button_press
 813                                                         (<em class="parameter"><code><a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window</code></em>);</pre>
 814 <p>
 815 Return whether button presses are captured during kinetic
 816 scrolling. See <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-set-capture-button-press" title="gtk_scrolled_window_set_capture_button_press ()"><code class="function">gtk_scrolled_window_set_capture_button_press()</code></a>.
 817 </p>
 818 <div class="variablelist"><table border="0">
 819 <col align="left" valign="top">
 820 <tbody>
 821 <tr>
 822 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 823 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 824 </td>
 825 </tr>
 826 <tr>
 827 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 828 <td>
 829 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if button presses are captured during kinetic scrolling</td>
 830 </tr>
 831 </tbody>
 832 </table></div>
 833 <p class="since">Since 3.4</p>
 834 </div>
 835 </div>
 836 <div class="refsect1">
 837 <a name="GtkScrolledWindow.property-details"></a><h2>Property Details</h2>
 838 <div class="refsect2">
 839 <a name="GtkScrolledWindow--hadjustment"></a><h3>The <code class="literal">"hadjustment"</code> property</h3>
 840 <pre class="programlisting">  "hadjustment"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write / Construct</pre>
 841 <p>The GtkAdjustment for the horizontal position.</p>
 842 </div>
 843 <hr>
 844 <div class="refsect2">
 845 <a name="GtkScrolledWindow--hscrollbar-policy"></a><h3>The <code class="literal">"hscrollbar-policy"</code> property</h3>
 846 <pre class="programlisting">  "hscrollbar-policy"        <a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a>         : Read / Write</pre>
 847 <p>When the horizontal scrollbar is displayed.</p>
 848 <p>Default value: GTK_POLICY_AUTOMATIC</p>
 849 </div>
 850 <hr>
 851 <div class="refsect2">
 852 <a name="GtkScrolledWindow--kinetic-scrolling"></a><h3>The <code class="literal">"kinetic-scrolling"</code> property</h3>
 853 <pre class="programlisting">  "kinetic-scrolling"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 854 <p>
 855 The kinetic scrolling behavior flags. Kinetic scrolling
 856 only applies to devices with source <a href="http://developer.gnome.org/devel/gdk/GdkDevice.html#GDK-SOURCE-TOUCHSCREEN:CAPS"><code class="literal">GDK_SOURCE_TOUCHSCREEN</code></a>
 857 </p>
 858 <p>Default value: TRUE</p>
 859 <p class="since">Since 3.4</p>
 860 </div>
 861 <hr>
 862 <div class="refsect2">
 863 <a name="GtkScrolledWindow--min-content-height"></a><h3>The <code class="literal">"min-content-height"</code> property</h3>
 864 <pre class="programlisting">  "min-content-height"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 865 <p>
 866 The minimum content height of <em class="parameter"><code>scrolled_window</code></em>, or -1 if not set.
 867 </p>
 868 <p>Allowed values: &gt;= G_MAXULONG</p>
 869 <p>Default value: -1</p>
 870 <p class="since">Since 3.0</p>
 871 </div>
 872 <hr>
 873 <div class="refsect2">
 874 <a name="GtkScrolledWindow--min-content-width"></a><h3>The <code class="literal">"min-content-width"</code> property</h3>
 875 <pre class="programlisting">  "min-content-width"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 876 <p>
 877 The minimum content width of <em class="parameter"><code>scrolled_window</code></em>, or -1 if not set.
 878 </p>
 879 <p>Allowed values: &gt;= G_MAXULONG</p>
 880 <p>Default value: -1</p>
 881 <p class="since">Since 3.0</p>
 882 </div>
 883 <hr>
 884 <div class="refsect2">
 885 <a name="GtkScrolledWindow--shadow-type"></a><h3>The <code class="literal">"shadow-type"</code> property</h3>
 886 <pre class="programlisting">  "shadow-type"              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read / Write</pre>
 887 <p>Style of bevel around the contents.</p>
 888 <p>Default value: GTK_SHADOW_NONE</p>
 889 </div>
 890 <hr>
 891 <div class="refsect2">
 892 <a name="GtkScrolledWindow--vadjustment"></a><h3>The <code class="literal">"vadjustment"</code> property</h3>
 893 <pre class="programlisting">  "vadjustment"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write / Construct</pre>
 894 <p>The GtkAdjustment for the vertical position.</p>
 895 </div>
 896 <hr>
 897 <div class="refsect2">
 898 <a name="GtkScrolledWindow--vscrollbar-policy"></a><h3>The <code class="literal">"vscrollbar-policy"</code> property</h3>
 899 <pre class="programlisting">  "vscrollbar-policy"        <a class="link" href="gtk3-Standard-Enumerations.html#GtkPolicyType" title="enum GtkPolicyType"><span class="type">GtkPolicyType</span></a>         : Read / Write</pre>
 900 <p>When the vertical scrollbar is displayed.</p>
 901 <p>Default value: GTK_POLICY_AUTOMATIC</p>
 902 </div>
 903 <hr>
 904 <div class="refsect2">
 905 <a name="GtkScrolledWindow--window-placement"></a><h3>The <code class="literal">"window-placement"</code> property</h3>
 906 <pre class="programlisting">  "window-placement"         <a class="link" href="gtk3-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a>         : Read / Write</pre>
 907 <p>Where the contents are located with respect to the scrollbars. This property only takes effect if "window-placement-set" is TRUE.</p>
 908 <p>Default value: GTK_CORNER_TOP_LEFT</p>
 909 </div>
 910 <hr>
 911 <div class="refsect2">
 912 <a name="GtkScrolledWindow--window-placement-set"></a><h3>The <code class="literal">"window-placement-set"</code> property</h3>
 913 <pre class="programlisting">  "window-placement-set"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 914 <p>
 915 Whether "window-placement" should be used to determine the location
 916 of the contents with respect to the scrollbars. Otherwise, the
 917 "gtk-scrolled-window-placement" setting is used.
 918 </p>
 919 <p>Default value: FALSE</p>
 920 <p class="since">Since 2.10</p>
 921 </div>
 922 </div>
 923 <div class="refsect1">
 924 <a name="GtkScrolledWindow.style-property-details"></a><h2>Style Property Details</h2>
 925 <div class="refsect2">
 926 <a name="GtkScrolledWindow--s-scrollbar-spacing"></a><h3>The <code class="literal">"scrollbar-spacing"</code> style property</h3>
 927 <pre class="programlisting">  "scrollbar-spacing"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 928 <p>Number of pixels between the scrollbars and the scrolled window.</p>
 929 <p>Allowed values: &gt;= 0</p>
 930 <p>Default value: 3</p>
 931 </div>
 932 <hr>
 933 <div class="refsect2">
 934 <a name="GtkScrolledWindow--s-scrollbars-within-bevel"></a><h3>The <code class="literal">"scrollbars-within-bevel"</code> style property</h3>
 935 <pre class="programlisting">  "scrollbars-within-bevel"  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
 936 <p>
 937 Whether to place scrollbars within the scrolled window's bevel.
 938 </p>
 939 <p>Default value: FALSE</p>
 940 <p class="since">Since 2.12</p>
 941 </div>
 942 </div>
 943 <div class="refsect1">
 944 <a name="GtkScrolledWindow.signal-details"></a><h2>Signal Details</h2>
 945 <div class="refsect2">
 946 <a name="GtkScrolledWindow-move-focus-out"></a><h3>The <code class="literal">"move-focus-out"</code> signal</h3>
 947 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window,
 948                                                         <a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a>   direction_type,
 949                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 950 <p>
 951 The ::move-focus-out signal is a
 952 <a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a>
 953 which gets emitted when focus is moved away from the scrolled
 954 window by a keybinding.
 955 The <a class="link" href="GtkWidget.html#GtkWidget-move-focus" title='The "move-focus" signal'><span class="type">"move-focus"</span></a> signal is emitted with <em class="parameter"><code>direction_type</code></em>
 956 on this scrolled windows toplevel parent in the container hierarchy.
 957 The default bindings for this signal are
 958 <span class="keycap"><strong>Tab</strong></span>+<span class="keycap"><strong>Ctrl</strong></span>
 959 and
 960 <span class="keycap"><strong>Tab</strong></span>+<span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>Shift</strong></span>.
 961 </p>
 962 <div class="variablelist"><table border="0">
 963 <col align="left" valign="top">
 964 <tbody>
 965 <tr>
 966 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
 967 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
 968 </td>
 969 </tr>
 970 <tr>
 971 <td><p><span class="term"><em class="parameter"><code>direction_type</code></em> :</span></p></td>
 972 <td>either <code class="literal">GTK_DIR_TAB_FORWARD</code> or
 973 <code class="literal">GTK_DIR_TAB_BACKWARD</code>
 974 </td>
 975 </tr>
 976 <tr>
 977 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 978 <td>user data set when the signal handler was connected.</td>
 979 </tr>
 980 </tbody>
 981 </table></div>
 982 </div>
 983 <hr>
 984 <div class="refsect2">
 985 <a name="GtkScrolledWindow-scroll-child"></a><h3>The <code class="literal">"scroll-child"</code> signal</h3>
 986 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a> *scrolled_window,
 987                                                         <a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a>      scroll,
 988                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>           horizontal,
 989                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 990 <p>
 991 The ::scroll-child signal is a
 992 <a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a>
 993 which gets emitted when a keybinding that scrolls is pressed.
 994 The horizontal or vertical adjustment is updated which triggers a
 995 signal that the scrolled windows child may listen to and scroll itself.
 996 </p>
 997 <div class="variablelist"><table border="0">
 998 <col align="left" valign="top">
 999 <tbody>
1000 <tr>
1001 <td><p><span class="term"><em class="parameter"><code>scrolled_window</code></em> :</span></p></td>
1002 <td>a <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow"><span class="type">GtkScrolledWindow</span></a>
1003 </td>
1004 </tr>
1005 <tr>
1006 <td><p><span class="term"><em class="parameter"><code>scroll</code></em> :</span></p></td>
1007 <td>a <a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a> describing how much to scroll</td>
1008 </tr>
1009 <tr>
1010 <td><p><span class="term"><em class="parameter"><code>horizontal</code></em> :</span></p></td>
1011 <td>whether the keybinding scrolls the child
1012 horizontally or not</td>
1013 </tr>
1014 <tr>
1015 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1016 <td>user data set when the signal handler was connected.</td>
1017 </tr>
1018 </tbody>
1019 </table></div>
1020 </div>
1021 </div>
1022 <div class="refsect1">
1023 <a name="GtkScrolledWindow.see-also"></a><h2>See Also</h2>
1024 <a class="link" href="GtkScrollable.html" title="GtkScrollable"><span class="type">GtkScrollable</span></a>, <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>, <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>
1025 </div>
1026 </div>
1027 <div class="footer">
1028 <hr>
1029           Generated by GTK-Doc V1.18</div>
1030 </body>
1031 </html>