/usr/share/gtk-doc/html/libgwydgets/libgwydgets-gwygrainvaluemenu.html is in libgwyddion20-doc 2.34-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Gwyddion Widgets Library Reference Manual: gwygrainvaluemenu</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Gwyddion Widgets Library Reference Manual">
<link rel="up" href="WidgetUtilities.html" title="Widget Utilities">
<link rel="prev" href="libgwydgets-gwyoptionmenus.html" title="gwyoptionmenus">
<link rel="next" href="libgwydgets-gwycombobox.html" title="gwycombobox">
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
<td width="100%" align="left">
<a href="#" class="shortcut">Top</a>
|
<a href="#libgwydgets-gwygrainvaluemenu.description" class="shortcut">Description</a>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="WidgetUtilities.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="libgwydgets-gwyoptionmenus.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="libgwydgets-gwycombobox.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="libgwydgets-gwygrainvaluemenu"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgwydgets-gwygrainvaluemenu.top_of_page"></a>gwygrainvaluemenu</span></h2>
<p>gwygrainvaluemenu — Grain value display/selector</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="libgwydgets-gwygrainvaluemenu.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include <libgwydgets/gwydgets.h>
enum <a class="link" href="libgwydgets-gwygrainvaluemenu.html#GwyGrainValueStoreColumn" title="enum GwyGrainValueStoreColumn">GwyGrainValueStoreColumn</a>;
<a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-new" title="gwy_grain_value_tree_view_new ()">gwy_grain_value_tree_view_new</a> (<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_id</code></em>,
<em class="parameter"><code>const <a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_column</code></em>,
<em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span> <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-set-expanded-groups" title="gwy_grain_value_tree_view_set_expanded_groups ()">gwy_grain_value_tree_view_set_expanded_groups</a>
(<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> expanded_bits</code></em>);
<a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-get-expanded-groups" title="gwy_grain_value_tree_view_get_expanded_groups ()">gwy_grain_value_tree_view_get_expanded_groups</a>
(<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>);
<a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-n-enabled" title="gwy_grain_value_tree_view_n_enabled ()">gwy_grain_value_tree_view_n_enabled</a> (<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>);
const <a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-get-enabled" title="gwy_grain_value_tree_view_get_enabled ()">gwy_grain_value_tree_view_get_enabled</a>
(<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>);
<span class="returnvalue">void</span> <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-set-enabled" title="gwy_grain_value_tree_view_set_enabled ()">gwy_grain_value_tree_view_set_enabled</a>
(<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **names</code></em>);
<span class="returnvalue">void</span> <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-select" title="gwy_grain_value_tree_view_select ()">gwy_grain_value_tree_view_select</a> (<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="../libgwyprocess/GwyGrainValue.html"><span class="type">GwyGrainValue</span></a> *gvalue</code></em>);
<span class="returnvalue">void</span> <a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-set-same-units" title="gwy_grain_value_tree_view_set_same_units ()">gwy_grain_value_tree_view_set_same_units</a>
(<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="http://developer.gnome.org/doc/API/2.0/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> same_units</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="libgwydgets-gwygrainvaluemenu.description"></a><h2>Description</h2>
</div>
<div class="refsect1">
<a name="libgwydgets-gwygrainvaluemenu.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GwyGrainValueStoreColumn"></a><h3>enum GwyGrainValueStoreColumn</h3>
<pre class="programlisting">typedef enum {
GWY_GRAIN_VALUE_STORE_COLUMN_ITEM,
GWY_GRAIN_VALUE_STORE_COLUMN_GROUP,
GWY_GRAIN_VALUE_STORE_COLUMN_ENABLED
} GwyGrainValueStoreColumn;
</pre>
<p>
Columns of the grain value tree view <a href="/usr/share/gtk-doc/html/gtk3/GtkTreeStore.html"><span class="type">GtkTreeStore</span></a> model.
</p>
<p>
It must not be assumed these are the only columns in the tree store.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><a name="GWY-GRAIN-VALUE-STORE-COLUMN-ITEM:CAPS"></a><span class="term"><code class="literal">GWY_GRAIN_VALUE_STORE_COLUMN_ITEM</code></span></p></td>
<td>Grain value itself (<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for
non-leaves), the column type is
<a href="../libgwyprocess/GwyGrainValue.html"><span class="type">GwyGrainValue</span></a>.
</td>
</tr>
<tr>
<td><p><a name="GWY-GRAIN-VALUE-STORE-COLUMN-GROUP:CAPS"></a><span class="term"><code class="literal">GWY_GRAIN_VALUE_STORE_COLUMN_GROUP</code></span></p></td>
<td>Grain value group, useful namely for
non-leaves (identical to the value
group for leaves), the column type is
<a href="../libgwyprocess/GwyGrainValue.html#GwyGrainValueGroup"><span class="type">GwyGrainValueGroup</span></a>.
</td>
</tr>
<tr>
<td><p><a name="GWY-GRAIN-VALUE-STORE-COLUMN-ENABLED:CAPS"></a><span class="term"><code class="literal">GWY_GRAIN_VALUE_STORE_COLUMN_ENABLED</code></span></p></td>
<td>Enabled/disabled state (meaning is
undefined for non-leaves and
reserved for future use), the column
type is <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-new"></a><h3>gwy_grain_value_tree_view_new ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * gwy_grain_value_tree_view_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_id</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_column</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>
Creates a new tree view selector of grain values.
</p>
<p>
Possible column names are <code class="literal">"name"</code> for the grain value
name, <code class="literal">"symbol_markup"</code> for the rich text symbol,
<code class="literal">"symbol"</code> for identifier-style symbol and
<code class="literal">"enabled"</code> for a checkbox column.
</p>
<p>
The tree view selection is set to <a href="/usr/share/gtk-doc/html/gtk3/gtk3-Standard-Enumerations.html#GTK-SELECTION-BROWSE:CAPS"><code class="literal">GTK_SELECTION_BROWSE</code></a> mode and it is
allowed only on leaves.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>show_id</code></em> :</span></p></td>
<td>
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to include grain id number among the values, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to
exclude it.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_column</code></em> :</span></p></td>
<td>The first column to show (may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for no columns).</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
<td>
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of columns to show.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A new tree view with grain values.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-set-expanded-groups"></a><h3>gwy_grain_value_tree_view_set_expanded_groups ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> gwy_grain_value_tree_view_set_expanded_groups
(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> expanded_bits</code></em>);</pre>
<p>
Restores a grain value tree view group expansion state.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>expanded_bits</code></em> :</span></p></td>
<td>Integer with bits of <a href="../libgwyprocess/GwyGrainValue.html#GwyGrainValueGroup"><span class="type">GwyGrainValueGroup</span></a> set if the
corresponding group should be expanded. Typically this
is either zero or a value previously obtained from
<a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-get-expanded-groups" title="gwy_grain_value_tree_view_get_expanded_groups ()"><code class="function">gwy_grain_value_tree_view_get_expanded_groups()</code></a>.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-get-expanded-groups"></a><h3>gwy_grain_value_tree_view_get_expanded_groups ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gwy_grain_value_tree_view_get_expanded_groups
(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>);</pre>
<p>
Obtains the group expansion state of a grain value tree view.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The expansion state, see
<a class="link" href="libgwydgets-gwygrainvaluemenu.html#gwy-grain-value-tree-view-set-expanded-groups" title="gwy_grain_value_tree_view_set_expanded_groups ()"><code class="function">gwy_grain_value_tree_view_set_expanded_groups()</code></a> for details.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-n-enabled"></a><h3>gwy_grain_value_tree_view_n_enabled ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gwy_grain_value_tree_view_n_enabled (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>);</pre>
<p>
Gets the number of enabled values in a grain value tree view.
</p>
<p>
Enabled values are those with <a class="link" href="libgwydgets-gwygrainvaluemenu.html#GWY-GRAIN-VALUE-STORE-COLUMN-ENABLED:CAPS"><code class="literal">GWY_GRAIN_VALUE_STORE_COLUMN_ENABLED</code></a> column
set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> in the model.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The number of enabled values.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-get-enabled"></a><h3>gwy_grain_value_tree_view_get_enabled ()</h3>
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gwy_grain_value_tree_view_get_enabled
(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>);</pre>
<p>
Obtains the list of enabled values in a grain value tree view.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The list of grain value names. The list must be freed by the
caller, the strings are however owned by the individual grain
values and must not be freed.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-set-enabled"></a><h3>gwy_grain_value_tree_view_set_enabled ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> gwy_grain_value_tree_view_set_enabled
(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **names</code></em>);</pre>
<p>
Sets the set of enabled values in a grain value tree view.
</p>
<p>
The tree is possibly expanded so that all enabled values are visible.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
<td>Array of grain value names to enables. All grain values not present
here are disabled.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-select"></a><h3>gwy_grain_value_tree_view_select ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> gwy_grain_value_tree_view_select (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="../libgwyprocess/GwyGrainValue.html"><span class="type">GwyGrainValue</span></a> *gvalue</code></em>);</pre>
<p>
Selects a particular grain value in a grain value tree view.
</p>
<p>
If the <em class="parameter"><code>gvalue</code></em> group is currently unexpanded, it will be expanded to
show it, and the tree view may scroll to make it visible.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>gvalue</code></em> :</span></p></td>
<td>The grain value to select.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gwy-grain-value-tree-view-set-same-units"></a><h3>gwy_grain_value_tree_view_set_same_units ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> gwy_grain_value_tree_view_set_same_units
(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeView.html"><span class="type">GtkTreeView</span></a> *treeview</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> same_units</code></em>);</pre>
<p>
Sets the availability of grain values that require the same lateral and
value units.
</p>
<p>
This <em class="parameter"><code>same_units</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, grain values requiring matching units will be
disabled. This means they will not be selectable, names and symbols will
be displayed greyed out, checkboxes will be made non-activatable (if they
are currently checked, they will not be unchecked but they will be displayed
as inconsistent).
</p>
<p>
By default <em class="parameter"><code>same_units</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>treeview</code></em> :</span></p></td>
<td>A tree view with grain values.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>same_units</code></em> :</span></p></td>
<td>
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lateral and value units match and therefore all
grain values are calculable, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if they don't match and
values that require same units are disabled.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.19</div>
</body>
</html>
|