docs/reference/gtk/html/GtkCellAreaContext.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>GtkCellAreaContext</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="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
   9 <link rel="prev" href="GtkCellAreaBox.html" title="GtkCellAreaBox">
  10 <link rel="next" href="GtkCellRenderer.html" title="GtkCellRenderer">
  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="GtkCellAreaBox.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="TreeWidgetObjects.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="GtkCellRenderer.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="#GtkCellAreaContext.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GtkCellAreaContext.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GtkCellAreaContext.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GtkCellAreaContext.properties" class="shortcut">Properties</a>
  31 </td></tr>
  32 </table>
  33 <div class="refentry">
  34 <a name="GtkCellAreaContext"></a><div class="titlepage"></div>
  35 <div class="refnamediv"><table width="100%"><tr>
  36 <td valign="top">
  37 <h2><span class="refentrytitle"><a name="GtkCellAreaContext.top_of_page"></a>GtkCellAreaContext</span></h2>
  38 <p>GtkCellAreaContext — Stores geometrical information for a series of rows in a GtkCellArea</p>
  39 </td>
  40 <td valign="top" align="right"></td>
  41 </tr></table></div>
  42 <div class="refsynopsisdiv">
  43 <a name="GtkCellAreaContext.synopsis"></a><h2>Synopsis</h2>
  44 <pre class="synopsis">
  45 #include &lt;gtk/gtk.h&gt;
  46
  47 struct              <a class="link" href="GtkCellAreaContext.html#GtkCellAreaContextClass" title="struct GtkCellAreaContextClass">GtkCellAreaContextClass</a>;
  48                     <a class="link" href="GtkCellAreaContext.html#GtkCellAreaContext-struct" title="GtkCellAreaContext">GtkCellAreaContext</a>;
  49 <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="returnvalue">GtkCellArea</span></a> *       <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-area" title="gtk_cell_area_context_get_area ()">gtk_cell_area_context_get_area</a>      (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>);
  50 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-allocate" title="gtk_cell_area_context_allocate ()">gtk_cell_area_context_allocate</a>      (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  51                                                          <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>,
  52                                                          <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>);
  53 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-reset" title="gtk_cell_area_context_reset ()">gtk_cell_area_context_reset</a>         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>);
  54 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-width" title="gtk_cell_area_context_get_preferred_width ()">gtk_cell_area_context_get_preferred_width</a>
  55                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  56                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>,
  57                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>);
  58 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-height" title="gtk_cell_area_context_get_preferred_height ()">gtk_cell_area_context_get_preferred_height</a>
  59                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  60                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>,
  61                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>);
  62 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-height-for-width" title="gtk_cell_area_context_get_preferred_height_for_width ()">gtk_cell_area_context_get_preferred_height_for_width</a>
  63                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  64                                                          <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>,
  65                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>,
  66                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>);
  67 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-width-for-height" title="gtk_cell_area_context_get_preferred_width_for_height ()">gtk_cell_area_context_get_preferred_width_for_height</a>
  68                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  69                                                          <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>,
  70                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>,
  71                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>);
  72 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-allocation" title="gtk_cell_area_context_get_allocation ()">gtk_cell_area_context_get_allocation</a>
  73                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  74                                                          <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>,
  75                                                          <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>);
  76 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-push-preferred-width" title="gtk_cell_area_context_push_preferred_width ()">gtk_cell_area_context_push_preferred_width</a>
  77                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  78                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> minimum_width</code></em>,
  79                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> natural_width</code></em>);
  80 <span class="returnvalue">void</span>                <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-push-preferred-height" title="gtk_cell_area_context_push_preferred_height ()">gtk_cell_area_context_push_preferred_height</a>
  81                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
  82                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> minimum_height</code></em>,
  83                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> natural_height</code></em>);
  84 </pre>
  85 </div>
  86 <div class="refsect1">
  87 <a name="GtkCellAreaContext.object-hierarchy"></a><h2>Object Hierarchy</h2>
  88 <pre class="synopsis">
  89   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  90    +----GtkCellAreaContext
  91 </pre>
  92 </div>
  93 <div class="refsect1">
  94 <a name="GtkCellAreaContext.properties"></a><h2>Properties</h2>
  95 <pre class="synopsis">
  96   "<a class="link" href="GtkCellAreaContext.html#GtkCellAreaContext--area" title='The "area" property'>area</a>"                     <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>*          : Read / Write / Construct Only
  97   "<a class="link" href="GtkCellAreaContext.html#GtkCellAreaContext--minimum-height" title='The "minimum-height" property'>minimum-height</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
  98   "<a class="link" href="GtkCellAreaContext.html#GtkCellAreaContext--minimum-width" title='The "minimum-width" property'>minimum-width</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
  99   "<a class="link" href="GtkCellAreaContext.html#GtkCellAreaContext--natural-height" title='The "natural-height" property'>natural-height</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 100   "<a class="link" href="GtkCellAreaContext.html#GtkCellAreaContext--natural-width" title='The "natural-width" property'>natural-width</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 101 </pre>
 102 </div>
 103 <div class="refsect1">
 104 <a name="GtkCellAreaContext.description"></a><h2>Description</h2>
 105 <p>
 106 The <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> object is created by a given <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>
 107 implementation via its <a class="link" href="GtkCellArea.html#GtkCellAreaClass.create-context"><code class="function">GtkCellAreaClass.create_context()</code></a> virtual
 108 method and is used to store cell sizes and alignments for a series of
 109 <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows that are requested and rendered in the same context.
 110 </p>
 111 <p>
 112 <a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> widgets can create any number of contexts in which to
 113 request and render groups of data rows. However its important that the
 114 same context which was used to request sizes for a given <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>
 115 row also be used for the same row when calling other <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> APIs
 116 such as <a class="link" href="GtkCellArea.html#gtk-cell-area-render" title="gtk_cell_area_render ()"><code class="function">gtk_cell_area_render()</code></a> and <a class="link" href="GtkCellArea.html#gtk-cell-area-event" title="gtk_cell_area_event ()"><code class="function">gtk_cell_area_event()</code></a>.
 117 </p>
 118 </div>
 119 <div class="refsect1">
 120 <a name="GtkCellAreaContext.details"></a><h2>Details</h2>
 121 <div class="refsect2">
 122 <a name="GtkCellAreaContextClass"></a><h3>struct GtkCellAreaContextClass</h3>
 123 <pre class="programlisting">struct GtkCellAreaContextClass {
 124   void    (* allocate)                       (GtkCellAreaContext *context,
 125                                               gint                width,
 126                                               gint                height);
 127   void    (* reset)                          (GtkCellAreaContext *context);
 128   void    (* get_preferred_height_for_width) (GtkCellAreaContext *context,
 129                                               gint                width,
 130                                               gint               *minimum_height,
 131                                               gint               *natural_height);
 132   void    (* get_preferred_width_for_height) (GtkCellAreaContext *context,
 133                                               gint                height,
 134                                               gint               *minimum_width,
 135                                               gint               *natural_width);
 136 };
 137 </pre>
 138 <div class="variablelist"><table border="0">
 139 <col align="left" valign="top">
 140 <tbody>
 141 <tr>
 142 <td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaContextClass.allocate"></a>allocate</code></em> ()</span></p></td>
 143 <td>This tells the context that an allocation width or height
 144 (or both) have been decided for a group of rows. The context should
 145 store any allocations for internally aligned cells at this point so
 146 that they dont need to be recalculated at <a class="link" href="GtkCellArea.html#gtk-cell-area-render" title="gtk_cell_area_render ()"><code class="function">gtk_cell_area_render()</code></a> time.</td>
 147 </tr>
 148 <tr>
 149 <td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaContextClass.reset"></a>reset</code></em> ()</span></p></td>
 150 <td>Clear any previously stored information about requested and
 151 allocated sizes for the context.</td>
 152 </tr>
 153 <tr>
 154 <td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaContextClass.get-preferred-height-for-width"></a>get_preferred_height_for_width</code></em> ()</span></p></td>
 155 <td>Returns the aligned height for the given
 156 width that context must store while collecting sizes for it's rows.</td>
 157 </tr>
 158 <tr>
 159 <td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaContextClass.get-preferred-width-for-height"></a>get_preferred_width_for_height</code></em> ()</span></p></td>
 160 <td>Returns the aligned width for the given
 161 height that context must store while collecting sizes for it's rows.</td>
 162 </tr>
 163 </tbody>
 164 </table></div>
 165 </div>
 166 <hr>
 167 <div class="refsect2">
 168 <a name="GtkCellAreaContext-struct"></a><h3>GtkCellAreaContext</h3>
 169 <pre class="programlisting">typedef struct _GtkCellAreaContext GtkCellAreaContext;</pre>
 170 </div>
 171 <hr>
 172 <div class="refsect2">
 173 <a name="gtk-cell-area-context-get-area"></a><h3>gtk_cell_area_context_get_area ()</h3>
 174 <pre class="programlisting"><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="returnvalue">GtkCellArea</span></a> *       gtk_cell_area_context_get_area      (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>);</pre>
 175 <p>
 176 Fetches the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> this <em class="parameter"><code>context</code></em> was created by.
 177 </p>
 178 <p>
 179 This is generally unneeded by layouting widgets; however
 180 it is important for the context implementation itself to
 181 fetch information about the area it is being used for.
 182 </p>
 183 <p>
 184 For instance at <a class="link" href="GtkCellAreaContext.html#GtkCellAreaContextClass.allocate"><code class="function">GtkCellAreaContextClass.allocate()</code></a> time
 185 its important to know details about any cell spacing
 186 that the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> is configured with in order to
 187 compute a proper allocation.
 188 </p>
 189 <div class="variablelist"><table border="0">
 190 <col align="left" valign="top">
 191 <tbody>
 192 <tr>
 193 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 194 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 195 </td>
 196 </tr>
 197 <tr>
 198 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 199 <td>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> this context was created by. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 200 </td>
 201 </tr>
 202 </tbody>
 203 </table></div>
 204 <p class="since">Since 3.0</p>
 205 </div>
 206 <hr>
 207 <div class="refsect2">
 208 <a name="gtk-cell-area-context-allocate"></a><h3>gtk_cell_area_context_allocate ()</h3>
 209 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_allocate      (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 210                                                          <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>,
 211                                                          <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>
 212 <p>
 213 Allocates a width and/or a height for all rows which are to be
 214 rendered with <em class="parameter"><code>context</code></em>.
 215 </p>
 216 <p>
 217 Usually allocation is performed only horizontally or sometimes
 218 vertically since a group of rows are usually rendered side by
 219 side vertically or horizontally and share either the same width
 220 or the same height. Sometimes they are allocated in both horizontal
 221 and vertical orientations producing a homogeneous effect of the
 222 rows. This is generally the case for <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> when
 223 <a class="link" href="GtkTreeView.html#GtkTreeView--fixed-height-mode" title='The "fixed-height-mode" property'><span class="type">"fixed-height-mode"</span></a> is enabled.
 224 </p>
 225 <p>
 226 Since 3.0
 227 </p>
 228 <div class="variablelist"><table border="0">
 229 <col align="left" valign="top">
 230 <tbody>
 231 <tr>
 232 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 233 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 234 </td>
 235 </tr>
 236 <tr>
 237 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
 238 <td>the allocated width for all <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows rendered
 239 with <em class="parameter"><code>context</code></em>, or -1.</td>
 240 </tr>
 241 <tr>
 242 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
 243 <td>the allocated height for all <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows rendered
 244 with <em class="parameter"><code>context</code></em>, or -1.</td>
 245 </tr>
 246 </tbody>
 247 </table></div>
 248 </div>
 249 <hr>
 250 <div class="refsect2">
 251 <a name="gtk-cell-area-context-reset"></a><h3>gtk_cell_area_context_reset ()</h3>
 252 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_reset         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>);</pre>
 253 <p>
 254 Resets any previously cached request and allocation
 255 data.
 256 </p>
 257 <p>
 258 When underlying <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> data changes its
 259 important to reset the context if the content
 260 size is allowed to shrink. If the content size
 261 is only allowed to grow (this is usually an option
 262 for views rendering large data stores as a measure
 263 of optimization), then only the row that changed
 264 or was inserted needs to be (re)requested with
 265 <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a>.
 266 </p>
 267 <p>
 268 When the new overall size of the context requires
 269 that the allocated size changes (or whenever this
 270 allocation changes at all), the variable row
 271 sizes need to be re-requested for every row.
 272 </p>
 273 <p>
 274 For instance, if the rows are displayed all with
 275 the same width from top to bottom then a change
 276 in the allocated width necessitates a recalculation
 277 of all the displayed row heights using
 278 <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height-for-width" title="gtk_cell_area_get_preferred_height_for_width ()"><code class="function">gtk_cell_area_get_preferred_height_for_width()</code></a>.
 279 </p>
 280 <p>
 281 Since 3.0
 282 </p>
 283 <div class="variablelist"><table border="0">
 284 <col align="left" valign="top">
 285 <tbody><tr>
 286 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 287 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 288 </td>
 289 </tr></tbody>
 290 </table></div>
 291 </div>
 292 <hr>
 293 <div class="refsect2">
 294 <a name="gtk-cell-area-context-get-preferred-width"></a><h3>gtk_cell_area_context_get_preferred_width ()</h3>
 295 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_get_preferred_width
 296                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 297                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>,
 298                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>);</pre>
 299 <p>
 300 Gets the accumulative preferred width for all rows which have been
 301 requested with this context.
 302 </p>
 303 <p>
 304 After <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-reset" title="gtk_cell_area_context_reset ()"><code class="function">gtk_cell_area_context_reset()</code></a> is called and/or before ever
 305 requesting the size of a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>, the returned values are 0.
 306 </p>
 307 <div class="variablelist"><table border="0">
 308 <col align="left" valign="top">
 309 <tbody>
 310 <tr>
 311 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 312 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 313 </td>
 314 </tr>
 315 <tr>
 316 <td><p><span class="term"><em class="parameter"><code>minimum_width</code></em> :</span></p></td>
 317 <td>location to store the minimum width,
 318 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>
 319 </td>
 320 </tr>
 321 <tr>
 322 <td><p><span class="term"><em class="parameter"><code>natural_width</code></em> :</span></p></td>
 323 <td>location to store the natural width,
 324 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>
 325 </td>
 326 </tr>
 327 </tbody>
 328 </table></div>
 329 <p class="since">Since 3.0</p>
 330 </div>
 331 <hr>
 332 <div class="refsect2">
 333 <a name="gtk-cell-area-context-get-preferred-height"></a><h3>gtk_cell_area_context_get_preferred_height ()</h3>
 334 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_get_preferred_height
 335                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 336                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>,
 337                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>);</pre>
 338 <p>
 339 Gets the accumulative preferred height for all rows which have been
 340 requested with this context.
 341 </p>
 342 <p>
 343 After <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-reset" title="gtk_cell_area_context_reset ()"><code class="function">gtk_cell_area_context_reset()</code></a> is called and/or before ever
 344 requesting the size of a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>, the returned values are 0.
 345 </p>
 346 <div class="variablelist"><table border="0">
 347 <col align="left" valign="top">
 348 <tbody>
 349 <tr>
 350 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 351 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 352 </td>
 353 </tr>
 354 <tr>
 355 <td><p><span class="term"><em class="parameter"><code>minimum_height</code></em> :</span></p></td>
 356 <td>location to store the minimum height,
 357 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>
 358 </td>
 359 </tr>
 360 <tr>
 361 <td><p><span class="term"><em class="parameter"><code>natural_height</code></em> :</span></p></td>
 362 <td>location to store the natural height,
 363 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>
 364 </td>
 365 </tr>
 366 </tbody>
 367 </table></div>
 368 <p class="since">Since 3.0</p>
 369 </div>
 370 <hr>
 371 <div class="refsect2">
 372 <a name="gtk-cell-area-context-get-preferred-height-for-width"></a><h3>gtk_cell_area_context_get_preferred_height_for_width ()</h3>
 373 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_get_preferred_height_for_width
 374                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 375                                                          <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>,
 376                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>,
 377                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>);</pre>
 378 <p>
 379 Gets the accumulative preferred height for <em class="parameter"><code>width</code></em> for all rows
 380 which have been requested for the same said <em class="parameter"><code>width</code></em> with this context.
 381 </p>
 382 <p>
 383 After <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-reset" title="gtk_cell_area_context_reset ()"><code class="function">gtk_cell_area_context_reset()</code></a> is called and/or before ever
 384 requesting the size of a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>, the returned values are -1.
 385 </p>
 386 <div class="variablelist"><table border="0">
 387 <col align="left" valign="top">
 388 <tbody>
 389 <tr>
 390 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 391 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 392 </td>
 393 </tr>
 394 <tr>
 395 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
 396 <td>a proposed width for allocation</td>
 397 </tr>
 398 <tr>
 399 <td><p><span class="term"><em class="parameter"><code>minimum_height</code></em> :</span></p></td>
 400 <td>location to store the minimum height,
 401 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>
 402 </td>
 403 </tr>
 404 <tr>
 405 <td><p><span class="term"><em class="parameter"><code>natural_height</code></em> :</span></p></td>
 406 <td>location to store the natural height,
 407 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>
 408 </td>
 409 </tr>
 410 </tbody>
 411 </table></div>
 412 <p class="since">Since 3.0</p>
 413 </div>
 414 <hr>
 415 <div class="refsect2">
 416 <a name="gtk-cell-area-context-get-preferred-width-for-height"></a><h3>gtk_cell_area_context_get_preferred_width_for_height ()</h3>
 417 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_get_preferred_width_for_height
 418                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 419                                                          <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>,
 420                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>,
 421                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>);</pre>
 422 <p>
 423 Gets the accumulative preferred width for <em class="parameter"><code>height</code></em> for all rows which
 424 have been requested for the same said <em class="parameter"><code>height</code></em> with this context.
 425 </p>
 426 <p>
 427 After <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-reset" title="gtk_cell_area_context_reset ()"><code class="function">gtk_cell_area_context_reset()</code></a> is called and/or before ever
 428 requesting the size of a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>, the returned values are -1.
 429 </p>
 430 <div class="variablelist"><table border="0">
 431 <col align="left" valign="top">
 432 <tbody>
 433 <tr>
 434 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 435 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 436 </td>
 437 </tr>
 438 <tr>
 439 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
 440 <td>a proposed height for allocation</td>
 441 </tr>
 442 <tr>
 443 <td><p><span class="term"><em class="parameter"><code>minimum_width</code></em> :</span></p></td>
 444 <td>location to store the minimum width,
 445 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>
 446 </td>
 447 </tr>
 448 <tr>
 449 <td><p><span class="term"><em class="parameter"><code>natural_width</code></em> :</span></p></td>
 450 <td>location to store the natural width,
 451 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>
 452 </td>
 453 </tr>
 454 </tbody>
 455 </table></div>
 456 <p class="since">Since 3.0</p>
 457 </div>
 458 <hr>
 459 <div class="refsect2">
 460 <a name="gtk-cell-area-context-get-allocation"></a><h3>gtk_cell_area_context_get_allocation ()</h3>
 461 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_get_allocation
 462                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 463                                                          <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>,
 464                                                          <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>
 465 <p>
 466 Fetches the current allocation size for <em class="parameter"><code>context</code></em>.
 467 </p>
 468 <p>
 469 If the context was not allocated in width or height, or if the
 470 context was recently reset with <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-reset" title="gtk_cell_area_context_reset ()"><code class="function">gtk_cell_area_context_reset()</code></a>,
 471 the returned value will be -1.
 472 </p>
 473 <div class="variablelist"><table border="0">
 474 <col align="left" valign="top">
 475 <tbody>
 476 <tr>
 477 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 478 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 479 </td>
 480 </tr>
 481 <tr>
 482 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
 483 <td>location to store the allocated width, 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>
 484 </td>
 485 </tr>
 486 <tr>
 487 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
 488 <td>location to store the allocated height, 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>
 489 </td>
 490 </tr>
 491 </tbody>
 492 </table></div>
 493 <p class="since">Since 3.0</p>
 494 </div>
 495 <hr>
 496 <div class="refsect2">
 497 <a name="gtk-cell-area-context-push-preferred-width"></a><h3>gtk_cell_area_context_push_preferred_width ()</h3>
 498 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_push_preferred_width
 499                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 500                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> minimum_width</code></em>,
 501                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> natural_width</code></em>);</pre>
 502 <p>
 503 Causes the minimum and/or natural width to grow if the new
 504 proposed sizes exceed the current minimum and natural width.
 505 </p>
 506 <p>
 507 This is used by <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> implementations during
 508 the request process over a series of <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows to
 509 progressively push the requested width over a series of
 510 <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a> requests.
 511 </p>
 512 <div class="variablelist"><table border="0">
 513 <col align="left" valign="top">
 514 <tbody>
 515 <tr>
 516 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 517 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 518 </td>
 519 </tr>
 520 <tr>
 521 <td><p><span class="term"><em class="parameter"><code>minimum_width</code></em> :</span></p></td>
 522 <td>the proposed new minimum width for <em class="parameter"><code>context</code></em>
 523 </td>
 524 </tr>
 525 <tr>
 526 <td><p><span class="term"><em class="parameter"><code>natural_width</code></em> :</span></p></td>
 527 <td>the proposed new natural width for <em class="parameter"><code>context</code></em>
 528 </td>
 529 </tr>
 530 </tbody>
 531 </table></div>
 532 <p class="since">Since 3.0</p>
 533 </div>
 534 <hr>
 535 <div class="refsect2">
 536 <a name="gtk-cell-area-context-push-preferred-height"></a><h3>gtk_cell_area_context_push_preferred_height ()</h3>
 537 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_cell_area_context_push_preferred_height
 538                                                         (<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
 539                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> minimum_height</code></em>,
 540                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> natural_height</code></em>);</pre>
 541 <p>
 542 Causes the minimum and/or natural height to grow if the new
 543 proposed sizes exceed the current minimum and natural height.
 544 </p>
 545 <p>
 546 This is used by <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> implementations during
 547 the request process over a series of <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows to
 548 progressively push the requested height over a series of
 549 <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()"><code class="function">gtk_cell_area_get_preferred_height()</code></a> requests.
 550 </p>
 551 <div class="variablelist"><table border="0">
 552 <col align="left" valign="top">
 553 <tbody>
 554 <tr>
 555 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 556 <td>a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>
 557 </td>
 558 </tr>
 559 <tr>
 560 <td><p><span class="term"><em class="parameter"><code>minimum_height</code></em> :</span></p></td>
 561 <td>the proposed new minimum height for <em class="parameter"><code>context</code></em>
 562 </td>
 563 </tr>
 564 <tr>
 565 <td><p><span class="term"><em class="parameter"><code>natural_height</code></em> :</span></p></td>
 566 <td>the proposed new natural height for <em class="parameter"><code>context</code></em>
 567 </td>
 568 </tr>
 569 </tbody>
 570 </table></div>
 571 <p class="since">Since 3.0</p>
 572 </div>
 573 </div>
 574 <div class="refsect1">
 575 <a name="GtkCellAreaContext.property-details"></a><h2>Property Details</h2>
 576 <div class="refsect2">
 577 <a name="GtkCellAreaContext--area"></a><h3>The <code class="literal">"area"</code> property</h3>
 578 <pre class="programlisting">  "area"                     <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>*          : Read / Write / Construct Only</pre>
 579 <p>
 580 The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> this context was created by
 581 </p>
 582 <p class="since">Since 3.0</p>
 583 </div>
 584 <hr>
 585 <div class="refsect2">
 586 <a name="GtkCellAreaContext--minimum-height"></a><h3>The <code class="literal">"minimum-height"</code> property</h3>
 587 <pre class="programlisting">  "minimum-height"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 588 <p>
 589 The minimum height for the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> in this context
 590 for all <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows that this context was requested
 591 for using <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()"><code class="function">gtk_cell_area_get_preferred_height()</code></a>.
 592 </p>
 593 <p>Allowed values: &gt;= G_MAXULONG</p>
 594 <p>Default value: -1</p>
 595 <p class="since">Since 3.0</p>
 596 </div>
 597 <hr>
 598 <div class="refsect2">
 599 <a name="GtkCellAreaContext--minimum-width"></a><h3>The <code class="literal">"minimum-width"</code> property</h3>
 600 <pre class="programlisting">  "minimum-width"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 601 <p>
 602 The minimum width for the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> in this context
 603 for all <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows that this context was requested
 604 for using <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a>.
 605 </p>
 606 <p>Allowed values: &gt;= G_MAXULONG</p>
 607 <p>Default value: -1</p>
 608 <p class="since">Since 3.0</p>
 609 </div>
 610 <hr>
 611 <div class="refsect2">
 612 <a name="GtkCellAreaContext--natural-height"></a><h3>The <code class="literal">"natural-height"</code> property</h3>
 613 <pre class="programlisting">  "natural-height"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 614 <p>
 615 The natural height for the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> in this context
 616 for all <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows that this context was requested
 617 for using <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()"><code class="function">gtk_cell_area_get_preferred_height()</code></a>.
 618 </p>
 619 <p>Allowed values: &gt;= G_MAXULONG</p>
 620 <p>Default value: -1</p>
 621 <p class="since">Since 3.0</p>
 622 </div>
 623 <hr>
 624 <div class="refsect2">
 625 <a name="GtkCellAreaContext--natural-width"></a><h3>The <code class="literal">"natural-width"</code> property</h3>
 626 <pre class="programlisting">  "natural-width"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 627 <p>
 628 The natural width for the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> in this context
 629 for all <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows that this context was requested
 630 for using <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a>.
 631 </p>
 632 <p>Allowed values: &gt;= G_MAXULONG</p>
 633 <p>Default value: -1</p>
 634 <p class="since">Since 3.0</p>
 635 </div>
 636 </div>
 637 </div>
 638 <div class="footer">
 639 <hr>
 640           Generated by GTK-Doc V1.18</div>
 641 </body>
 642 </html>