RubyGems - gtk3 - Versions diffs - 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32 - Mend

gtk3 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

Files changed (1213) hide show

data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-label-links.html DELETED Viewed

@@ -1,45 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Migrating from SexyUrlLabel to GtkLabel</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
-<link rel="up" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
-<link rel="prev" href="gtk-migrating-entry-icons.html" title="Migrating from SexyIconEntry to GtkEntry">
-<link rel="next" href="gtk-migrating-ClientSideWindows.html" title="Migrating to client-side windows">
-<meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
-<td><a accesskey="p" href="gtk-migrating-entry-icons.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="migrating.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 2 Reference Manual</th>
-<td><a accesskey="n" href="gtk-migrating-ClientSideWindows.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="chapter">
-<div class="titlepage"><div><div><h2 class="title">
-<a name="gtk-migrating-label-links"></a>Migrating from SexyUrlLabel to GtkLabel</h2></div></div></div>
-<p>
-    GTK+ 2.18 supports showing links inside a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, similar to
-    SexyUrlLabel. Porting from SexyUrlLabel to GtkLabel is relatively
-    straightforward. GtkLabel accepts links in the markup using the
-    same HTML <code class="sgmltag-element">a</code> notation that SexyUrlLabel uses. In addition
-    to the href attribute, GtkLabel accepts a title attribute that
-    is displayed as a tooltip on the link. Instead of
-    <code class="function">sexy_url_label_set_markup()</code>, just call <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>.
-  </p>
-<p>
-    One difference between the two APIs is that the ::url-activated signal
-    from SexyUrlLabel has been replaced by the <a class="link" href="GtkLabel.html#GtkLabel-activate-link" title='The "activate-link" signal'><span class="type">"activate-link"</span></a>
-    signal. The need for connecting to this signal is greatly reduced,
-    since GtkLabel has a default handler that calls <a class="link" href="gtk-Filesystem-utilities.html#gtk-show-uri" title="gtk_show_uri ()"><code class="function">gtk_show_uri()</code></a>.
-  </p>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.18</div>
-</body>
-</html>

data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-tooltips.html DELETED Viewed

@@ -1,124 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Migrating from GtkTooltips to GtkTooltip</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
-<link rel="up" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
-<link rel="prev" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
-<link rel="next" href="gtk-migrating-entry-icons.html" title="Migrating from SexyIconEntry to GtkEntry">
-<meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
-<td><a accesskey="p" href="gtk-migrating-GtkBuilder.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="migrating.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 2 Reference Manual</th>
-<td><a accesskey="n" href="gtk-migrating-entry-icons.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="chapter">
-<div class="titlepage"><div><div><h2 class="title">
-<a name="gtk-migrating-tooltips"></a>Migrating from GtkTooltips to GtkTooltip</h2></div></div></div>
-<p>
-    GTK+ 2.12 brings a completely new tooltip implementation which
-    allows many things that were not possible with the old
-    <a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> interface. The new possibilities are explained
-    in more detail in the section about <a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a>.
-  </p>
-<p>
-    A number of complications of the old API have been removed:
-    </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-        Tooltips can not be grouped anymore. The old tooltips
-        API allowed this by using multiple <a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> objects.
-        We believe that the timeout behaviour of the new tooltips
-        implementation is better and makes it unnecessary to use
-        grouping as a way to overcome shortcomings of the
-        fast-tooltips mode.
-      </p></li>
-<li class="listitem"><p>
-        Timeouts can not be set individually anymore. Instead
-        there are settings <a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-timeout" title='The "gtk-tooltip-timeout" property'><span class="type">"gtk-tooltip-timeout"</span></a>,
-        <a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-browse-timeout" title='The "gtk-tooltip-browse-timeout" property'><span class="type">"gtk-tooltip-browse-timeout"</span></a> and
-        <a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-browse-mode-timeout" title='The "gtk-tooltip-browse-mode-timeout" property'><span class="type">"gtk-tooltip-browse-mode-timeout"</span></a> to influence
-        the behaviour of tooltips globally.
-      </p></li>
-</ul></div>
-<p>
-  </p>
-<p>
-    Here is an example of setting a tooltip on a widget with the old API:
-    </p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkTooltips</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tooltips </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTooltips.html#gtk-tooltips-new">gtk_tooltips_new</a></span><span class="normal"> </span><span class="symbol">();</span><span class="normal">     </span>
-<span class="function"><a href="GtkTooltips.html#gtk-tooltips-set-tip">gtk_tooltips_set_tip</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tooltips</span><span class="symbol">,</span><span class="normal"> widget</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Some tips"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-  </p>
-<p>
-    Using the new tooltips API, it is no longer necessary to create
-    an object:
-    </p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkWidget.html#gtk-widget-set-tooltip-text">gtk_widget_set_tooltip_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Some tips"</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-  </p>
-<p>
-    Similarly, setting a tooltip on a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> gets
-    simplified from
-    </p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkToolItem.html#gtk-tool-item-set-tooltip">gtk_tool_item_set_tooltip</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">toolitem</span><span class="symbol">,</span><span class="normal"> toolbar</span><span class="symbol">-&gt;</span><span class="normal">tooltips</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"tool tip"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-    to
-    </p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkToolItem.html#gtk-tool-item-set-tooltip-text">gtk_tool_item_set_tooltip_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">toolitem</span><span class="symbol">,</span><span class="normal"> text</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-  </p>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.18</div>
-</body>
-</html>

data/vendor/local/share/gtk-doc/html/gtk/gtk-no.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-ok.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-orientation-landscape.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-orientation-portrait.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-orientation-reverse-landscape.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-orientation-reverse-portrait.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-osx.html DELETED Viewed

@@ -1,53 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Using GTK+ on Mac OS X</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
-<link rel="up" href="gtk.html" title="Part I. GTK+ Overview">
-<link rel="prev" href="gtk-windows.html" title="Using GTK+ on Windows">
-<link rel="next" href="gtk-directfb.html" title="Using GTK+ on DirectFB">
-<meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
-<td><a accesskey="p" href="gtk-windows.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="gtk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 2 Reference Manual</th>
-<td><a accesskey="n" href="gtk-directfb.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="refentry">
-<a name="gtk-osx"></a><div class="titlepage"></div>
-<div class="refnamediv"><table width="100%"><tr>
-<td valign="top">
-<h2><span class="refentrytitle">Using GTK+ on Mac OS X</span></h2>
-<p>Using GTK+ on Mac OS X —
-OS X-specific aspects of using GTK+
-</p>
-</td>
-<td valign="top" align="right"></td>
-</tr></table></div>
-<div class="refsect1">
-<a name="id473634"></a><h2>Using GTK+ on Mac OS X</h2>
-<p>
-The Mac OS X port of GTK+ is an implementation of GDK (and therefore GTK+)
-on top of the Quarz API.
-</p>
-<p>
-Currently, the Mac OS X port does not use any additional commandline options
-or environment variables.
-</p>
-<p>
-For up-to-date information about the current status of this port, see the
-<a class="ulink" href="http://live.gnome.org/GTK+/OSX" target="_top">project page</a>.
-</p>
-</div>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.18</div>
-</body>
-</html>

data/vendor/local/share/gtk-doc/html/gtk/gtk-page-setup.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-preferences.png DELETED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gtk/gtk-query-immodules-2.0.html DELETED Viewed

@@ -1,68 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>gtk-query-immodules-2.0</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
-<link rel="up" href="pt05.html" title="Part V. GTK+ Tools">
-<link rel="prev" href="pt05.html" title="Part V. GTK+ Tools">
-<link rel="next" href="gtk-update-icon-cache.html" title="gtk-update-icon-cache">
-<meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
-<td><a accesskey="p" href="pt05.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="pt05.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 2 Reference Manual</th>
-<td><a accesskey="n" href="gtk-update-icon-cache.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="refentry">
-<a name="gtk-query-immodules-2.0"></a><div class="titlepage"></div>
-<div class="refnamediv"><table width="100%"><tr>
-<td valign="top">
-<h2><span class="refentrytitle">gtk-query-immodules-2.0</span></h2>
-<p>gtk-query-immodules-2.0 — Input method module registration utility</p>
-</td>
-<td valign="top" align="right"></td>
-</tr></table></div>
-<div class="refsynopsisdiv">
-<h2>Synopsis</h2>
-<div class="cmdsynopsis"><p><code class="command">gtk-query-immodules-2.0</code>  [module...]</p></div>
-</div>
-<div class="refsect1">
-<a name="id1455683"></a><h2>Description</h2>
-<p>
-<span class="command"><strong>gtk-query-immodules-2.0</strong></span> collects information about loadable
-input method modules for GTK+ and writes it to <code class="filename">stdout</code>.
-</p>
-<p>
-If called without arguments, it looks for modules in the GTK+ input method
-module path.
-</p>
-<p>
-If called with arguments, it looks for the specified modules. The arguments
-may be absolute or relative paths.
-</p>
-</div>
-<div class="refsect1">
-<a name="id1293325"></a><h2>Environment</h2>
-<p>
-The environment variable <code class="envar">GTK_PATH</code> can
-be used to prepend directories to the input method module path.
-</p>
-</div>
-<div class="refsect1">
-<a name="id1453817"></a><h2>Bugs</h2>
-<p>
-None known yet.
-</p>
-</div>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.18</div>
-</body>
-</html>

data/vendor/local/share/gtk-doc/html/gtk/gtk-question-index.html DELETED Viewed

@@ -1,1422 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Common Questions</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
-<link rel="up" href="gtk.html" title="Part I. GTK+ Overview">
-<link rel="prev" href="gtk-resources.html" title="Mailing lists and bug reports">
-<link rel="next" href="chap-drawing-model.html" title="The GTK+ Drawing Model">
-<meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
-<td><a accesskey="p" href="gtk-resources.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="gtk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 2 Reference Manual</th>
-<td><a accesskey="n" href="chap-drawing-model.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="refentry">
-<a name="gtk-question-index"></a><div class="titlepage"></div>
-<div class="refnamediv"><table width="100%"><tr>
-<td valign="top">
-<h2><span class="refentrytitle">Common Questions</span></h2>
-<p>Common Questions —
-Find answers to common questions in the GTK+ manual
-</p>
-</td>
-<td valign="top" align="right"></td>
-</tr></table></div>
-<div class="refsect1">
-<a name="id453320"></a><h2>Questions and Answers</h2>
-<p>
-This is an "index" of the reference manual organized by common "How do
-I..." questions. If you aren't sure which documentation to read for
-the question you have, this list is a good place to start.
-</p>
-<div class="qandaset">
-<a name="id464640"></a><table border="0" width="100%" summary="Q and A Set">
-<col align="left" width="1%">
-<col>
-<tbody>
-<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
-<a name="id405363"></a>1. General</h5></td></tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id474476"></a><a name="id458873"></a><p><b>1.1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I get started with GTK+?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-The GTK+ <a class="ulink" href="http://www.gtk.org" target="_top">website</a> offers a
-<a class="ulink" href="http://www.gtk.org/tutorial" target="_top">tutorial</a> and a
-<a class="ulink" href="http://www.gtk.org/faq" target="_top">FAQ</a>. More documentation ranging
-from whitepapers to online books can be found at the
-<a class="ulink" href="http://developer.gnome.org/doc" target="_top">GNOME developer's site</a>.
-After studying these materials you should be well prepared to come back to
-this reference manual for details.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id458937"></a><a name="id465467"></a><p><b>1.2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Where can I get help with GTK+, submit a bug report, or make a feature
-request?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-See the <a class="link" href="gtk-resources.html" title="Mailing lists and bug reports">documentation on this topic</a>.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id466291"></a><a name="id457892"></a><p><b>1.3.</b></p>
-</td>
-<td align="left" valign="top"><p>How do I port from one GTK+
-version to another?</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-See the <a class="link" href="gtk-changes-2-0.html" title="Changes from 1.2 to 2.0">list of incompatible changes
-from 1.2 to 2.0</a>. Also, the <a class="ulink" href="http://developer.gnome.org/dotplan/porting/" target="_top">GNOME 2.0 porting
-guide</a> on <a class="ulink" href="http://developer.gnome.org" target="_top">http://developer.gnome.org</a>
-has some more detailed discussion of porting from 1.2 to 2.0.
-You may also find useful information in the documentation for
-specific widgets and functions.
-</p>
-<p>
-If you have a question not covered in the manual, feel free to
-ask on the mailing lists and please <a class="ulink" href="http://bugzilla.gnome.org" target="_top">file a bug report</a> against the
-documentation.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id474097"></a><a name="id474100"></a><p><b>1.4.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How does memory management work in GTK+? Should I free data returned
-from functions?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-See the documentation for <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> and <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>. For <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> note
-specifically <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> and <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> is a subclass
-of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> so the same points apply, except that it has a "floating" state
-(explained in its documentation).
-</p>
-<p>
-For strings returned from functions, they will be declared "const"
-if they should not be freed. Non-const strings should be
-freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. Arrays follow the same rule.  (If you find an exception
-to the rules, please report a bug to <a class="ulink" href="http://bugzilla.gnome.org" target="_top">http://bugzilla.gnome.org</a>.)
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id467723"></a><a name="id467725"></a><p><b>1.5.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Why does my program leak memory, if I destroy a widget immediately
-after creating it ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-If <span class="structname">GtkFoo</span> isn't a toplevel window, then
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">foo </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gtk_foo_new</span><span class="normal"> </span><span class="symbol">();</span>
-<span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-is a memory leak, because no one assumed the initial floating
-reference. If you are using a widget and you aren't immediately
-packing it into a container, then you probably want standard
-reference counting, not floating reference counting.
-</p>
-<p>
-To to get this, you must acquire a reference to the widget and drop the
-floating reference (<span class="quote">“<span class="quote">ref and sink</span>”</span> in GTK+ parlance) after
-creating it:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">foo </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gtk_foo_new</span><span class="normal"> </span><span class="symbol">();</span>
-<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">);</span><span class="normal"> </span>
-<span class="function"><a href="GtkObject.html#gtk-object-sink">gtk_object_sink</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_OBJECT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">));</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-When you want to get rid of the widget, you must call <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a>
-to break any external connections to the widget before dropping your
-reference:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">);</span><span class="normal"> </span>
-<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-When you immediately add a widget to a container, it takes care of
-assuming the initial floating reference and you don't have to worry
-about reference counting at all ... just call <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a>
-to get rid of the widget.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id453153"></a><a name="id453155"></a><p><b>1.6.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I use GTK+ with threads?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-This is covered in the <GTKDOCLINK HREF="gdk-Threads">GDK threads
-documentation</GTKDOCLINK>. See also the <a href="http://library.gnome.org/devel/glib/unstable/glib-Threads.html">GThread</a>
-documentation for portable threading primitives.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id453181"></a><a name="id437422"></a><p><b>1.7.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I internationalize a GTK+ program?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-Most people use <a class="ulink" href="http://www.gnu.org/software/gettext/" target="_top">GNU
-gettext</a>, already required in order to install GLib. On a UNIX
-or Linux system with gettext installed, type <code class="literal">info gettext</code>
-to read the documentation.
-</p>
-<p>
-The short checklist on how to use gettext is: call <code class="function">bindtextdomain()</code> so gettext
-can find the files containing your translations, call <code class="function">textdomain()</code> to set the
-default translation domain, call <code class="function">bind_textdomain_codeset()</code> to request that
-all translated strings are returned in UTF-8, then call <code class="function">gettext()</code> to look up
-each string to be translated in the default domain.
-Conventionally, people define macros as follows for convenience:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#gettext-macro">_</a></span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal">  </span><span class="function">gettext</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span>
-<span class="preproc">#define</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#N-:CAPS">N_</a></span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal">  x</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-You use <a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#N-:CAPS"><code class="function">N_()</code></a> (N stands for no-op) to mark a string for translation in a
-context where a function call to <code class="function">gettext()</code> is not allowed, such as in an
-array initializer.
-You eventually have to call <code class="function">gettext()</code> on the string to actually fetch the
-translation.  <a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#gettext-macro"><code class="function">_()</code></a> both marks the string for translation and actually
-translates it.
-</p>
-<p>
-Nowadays, GLib provides the common shorthand macros in the header file
-<code class="filename">gi18n.h</code>, so you don't have to define them yourself,
-just include that header.
-</p>
-<p>
-Code using these macros ends up looking like this:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gi18n.h&gt;</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">global_variable </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#N-:CAPS">N_</a></span><span class="symbol">(</span><span class="string">"Translate this string"</span><span class="symbol">);</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">make_widgets</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">   </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">label1</span><span class="symbol">;</span>
-<span class="normal">   </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">label2</span><span class="symbol">;</span>
-<span class="normal">   label1 </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new">gtk_label_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#gettext-macro">_</a></span><span class="symbol">(</span><span class="string">"Another string to translate"</span><span class="symbol">));</span>
-<span class="normal">   label2 </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new">gtk_label_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#gettext-macro">_</a></span><span class="symbol">(</span><span class="normal">global_variable</span><span class="symbol">));</span>
-<span class="symbol">...</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-<p>
-Libraries using gettext should use <code class="function">dgettext()</code> instead of <code class="function">gettext()</code>, which
-allows them to specify the translation domain each time they ask for a
-translation. Libraries should also avoid calling <code class="function">textdomain()</code>, since they
-will be specifying the domain instead of using the default. For <code class="function">dgettext()</code>
-the <a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#gettext-macro"><code class="function">_()</code></a> macro can be defined as:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#gettext-macro">_</a></span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="function">dgettext</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"MyDomain"</span><span class="symbol">,</span><span class="normal"> x</span><span class="symbol">)</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-<p>
-Again, GLib comes with the <code class="filename">gi18n-lib.h</code>, saving you the
-trouble of defining the macros by hand. The macros in that header expect the
-translation domain to be specified by the <code class="literal">GETTEXT_PACKAGE</code> macro.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id478682"></a><a name="id478684"></a><p><b>1.8.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I use non-ASCII characters in GTK+ programs ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-GTK+ uses <a class="ulink" href="http://www.unicode.org" target="_top">Unicode</a> (more exactly
-UTF-8) for all text. UTF-8 encodes each Unicode codepoint as a sequence of
-one to six bytes and has a number of nice properties which make it a good
-choice for working with Unicode text in C programs:
-</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-ASCII characters are encoded by their familiar ASCII codepoints.
-</p></li>
-<li class="listitem"><p>
-ASCII characters never appear as part of any other character.
-</p></li>
-<li class="listitem"><p>
-The zero byte doesn't occur as part of a character, so that UTF-8 strings
-can be manipulated with the usual C library functions for handling
-zero-terminated strings.
-</p></li>
-</ul></div>
-<p>
-More information about Unicode and UTF-8 can be found in the
-<a class="ulink" href="http://www.cl.cam.ac.uk/~mgk25/unicode.html" target="_top">UTF-8 and Unicode i
-FAQ for Unix/Linux</a>.
-GLib provides functions for converting strings between UTF-8 and other
-encodings, see <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-locale-to-utf8"><code class="function">g_locale_to_utf8()</code></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-convert"><code class="function">g_convert()</code></a>.
-</p>
-<p>
-Text coming from external sources (e.g. files or user input), has to be
-converted to UTF-8 before being handed over to GTK+. The following example
-writes the content of a IS0-8859-1 encoded text file to
-<code class="literal">stdout</code>:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
-17
-18</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">utf8_text</span><span class="symbol">;</span>
-<span class="usertype">gsize</span><span class="normal"> length</span><span class="symbol">;</span>
-<span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
-<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">text</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">length</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">))</span><span class="normal"> </span>
-<span class="normal">  </span><span class="cbracket">{</span>
-<span class="normal">     utf8_text </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-convert">g_convert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">,</span><span class="normal"> length</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"UTF-8"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"ISO-8859-1"</span><span class="symbol">,</span><span class="normal"> </span>
-<span class="normal">                            NULL</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">);</span>
-<span class="normal">     </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
-<span class="normal">       </span><span class="cbracket">{</span>
-<span class="normal">         </span><span class="function">fprintf</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Couldn't convert file %s to UTF-8</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> filename</span><span class="symbol">);</span>
-<span class="normal">         </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
-<span class="normal">       </span><span class="cbracket">}</span>
-<span class="normal">     </span><span class="keyword">else</span>
-<span class="normal">       </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">utf8_text</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="cbracket">}</span>
-<span class="keyword">else</span><span class="normal"> </span>
-<span class="normal">  </span><span class="function">fprintf</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stderr</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Unable to read file %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> filename</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-<p>
-For string literals in the source code, there are several alternatives for
-handling non-ASCII content:
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term">direct UTF-8</span></p></td>
-<td><p>
-If your editor and compiler are capable of handling UTF-8 encoded sources,
-it is very convenient to simply use UTF-8 for string literals, since it allows
-you to edit the strings in "wysiwyg". Note that choosing this option may
-reduce the portability of your code.
-</p></td>
-</tr>
-<tr>
-<td><p><span class="term">escaped UTF-8</span></p></td>
-<td><p>
-Even if your toolchain can't handle UTF-8 directly, you can still encode string
-literals in UTF-8 by using octal or hexadecimal escapes like
-<code class="literal">\212</code> or <code class="literal">\xa8</code> to
-encode each byte. This is portable, but modifying the escaped strings is not
-very convenient. Be careful when mixing hexadecimal escapes with ordinary text;
-<code class="literal">"\xa8abcd"</code> is a string of length 1 !
-</p></td>
-</tr>
-<tr>
-<td><p><span class="term">runtime conversion</span></p></td>
-<td><p>
-If the string literals can be represented in an encoding which your toolchain
-can handle (e.g. IS0-8859-1), you can write your source files in that encoding
-and use <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-convert"><code class="function">g_convert()</code></a> to convert the strings to UTF-8 at runtime. Note that this
-has some runtime overhead, so you may want to move the conversion out of inner
-loops.
-</p></td>
-</tr>
-</tbody>
-</table></div>
-<p>
-Here is an example showing the three approaches using the copyright sign
-© which has Unicode and ISO-8859-1 codepoint 169 and is represented in
-UTF-8 by the two bytes 194, 169:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"direct UTF-8: ©"</span><span class="symbol">);</span>
-<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"escaped UTF-8: </span><span class="specialchar">\3</span><span class="string">02</span><span class="specialchar">\2</span><span class="string">51"</span><span class="symbol">);</span>
-<span class="normal">text </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-convert">g_convert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"runtime conversion: ©"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"ISO-8859-1"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"UTF-8"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span>
-<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-<p>
-If you are using <code class="function">gettext()</code> to localize your application, you need to
-call <code class="function">bind_textdomain_codeset()</code> to ensure that translated strings are
-returned in UTF-8 encoding.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id478882"></a><a name="id478884"></a><p><b>1.9.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I use GTK+ with C++?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-There are two ways to approach this. The GTK+ header files use the subset
-of C that's also valid C++, so you can simply use the normal GTK+ API
-in a C++ program. Alternatively, you can use a "C++ binding"
-such as <a class="ulink" href="http://gtkmm.sourceforge.net/" target="_top">gtkmm</a>
-which provides a native C++ API.
-</p>
-<p>
-When using GTK+ directly, keep in mind that only functions can be
-connected to signals, not methods. So you will need to use global
-functions or "static" class functions for signal connections.
-</p>
-<p>
-Another common issue when using GTK+ directly is that
-C++ will not implicitly convert an integer to an enumeration.
-This comes up when using bitfields; in C you can write the following
-code:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="../gdk/gdk-Windows.html#gdk-window-set-events">gdk_window_set_events</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gdk_window</span><span class="symbol">,</span><span class="normal"> </span>
-<span class="normal">                       GDK_BUTTON_PRESS_MASK </span><span class="symbol">|</span><span class="normal"> <a href="../gdk/gdk-Events.html#GDK-BUTTON-RELEASE-MASK:CAPS">GDK_BUTTON_RELEASE_MASK</a></span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-while in C++ you must write:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="../gdk/gdk-Windows.html#gdk-window-set-events">gdk_window_set_events</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gdk_window</span><span class="symbol">,</span><span class="normal"> </span>
-<span class="normal">                       </span><span class="symbol">(</span><span class="normal"><a href="../gdk/gdk-Events.html#GdkEventMask">GdkEventMask</a></span><span class="symbol">)</span><span class="normal"> <a href="../gdk/gdk-Events.html#GDK-BUTTON-PRESS-MASK:CAPS">GDK_BUTTON_PRESS_MASK</a> </span><span class="symbol">|</span><span class="normal"> <a href="../gdk/gdk-Events.html#GDK-BUTTON-RELEASE-MASK:CAPS">GDK_BUTTON_RELEASE_MASK</a></span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-There are very few functions that require this cast, however.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id478938"></a><a name="id478941"></a><p><b>1.10.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I use GTK+ with other non-C languages?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-See the <a class="ulink" href="http://www.gtk.org/bindings.html" target="_top">list of language
-bindings</a> on <a class="ulink" href="http://www.gtk.org" target="_top">http://www.gtk.org</a>.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id478966"></a><a name="id478969"></a><p><b>1.11.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I load an image or animation from a file?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-To load an image file straight into a display widget, use
-<a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file"><code class="function">gtk_image_new_from_file()</code></a> <sup>[<a name="id478988" href="#ftn.id478988" class="footnote">1</a>]</sup>.
-To load an image for another purpose, use <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"><code class="function">gdk_pixbuf_new_from_file()</code></a>. To i
-load an animation, use <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a>.
-<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a> can also load non-animated images, so
-use it in combination with <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-is-static-image"><code class="function">gdk_pixbuf_animation_is_static_image()</code></a> to load a
-file of unknown type.
-</p>
-<p>
-To load an image or animation file asynchronously (without blocking), use
-<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/GdkPixbufLoader.html"><span class="type">GdkPixbufLoader</span></a>.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479075"></a><a name="id479077"></a><p><b>1.12.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I draw text ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-To draw a piece of text, use a Pango layout and <a href="../gdk/gdk-Drawing-Primitives.html#gdk-draw-layout"><code class="function">gdk_draw_layout()</code></a>,
-using code like the following:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">layout </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-create-pango-layout">gtk_widget_create_pango_layout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> text</span><span class="symbol">);</span>
-<span class="normal">fontdesc </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-from-string">pango_font_description_from_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Luxi Mono 12"</span><span class="symbol">);</span>
-<span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-font-description">pango_layout_set_font_description</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> fontdesc</span><span class="symbol">);</span><span class="normal"> </span>
-<span class="function"><a href="../gdk/gdk-Drawing-Primitives.html#gdk-draw-layout">gdk_draw_layout</a></span><span class="normal"> </span><span class="symbol">(...,</span><span class="normal"> layout</span><span class="symbol">);</span>
-<span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-free">pango_font_description_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fontdesc</span><span class="symbol">);</span>
-<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-Do not use the deprecated <a href="../gdk/gdk-Fonts.html#GdkFont"><span class="type">GdkFont</span></a> and <a href="../gdk/gdk-Drawing-Primitives.html#gdk-draw-text"><code class="function">gdk_draw_text()</code></a>.
-</p>
-<p>
-See also the "Text Handling in GTK 2" section of
-<a class="ulink" href="http://developer.gnome.org/dotplan/porting/" target="_top">Porting applications
-to the GNOME 2.0 platform</a>.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479137"></a><a name="id479140"></a><p><b>1.13.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I measure the size of a piece of text ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-To obtain the size of a piece of text, use a Pango layout and
-<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-pixel-size"><code class="function">pango_layout_get_pixel_size()</code></a>, using code like the following:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">layout </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-create-pango-layout">gtk_widget_create_pango_layout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> text</span><span class="symbol">);</span>
-<span class="normal">fontdesc </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-from-string">pango_font_description_from_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Luxi Mono 12"</span><span class="symbol">);</span>
-<span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-font-description">pango_layout_set_font_description</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> fontdesc</span><span class="symbol">);</span><span class="normal"> </span>
-<span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-pixel-size">pango_layout_get_pixel_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">height</span><span class="symbol">);</span>
-<span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-free">pango_font_description_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fontdesc</span><span class="symbol">);</span>
-<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-Do not use the deprecated function <a href="../gdk/gdk-Fonts.html#gdk-text-width"><code class="function">gdk_text_width()</code></a>.
-</p>
-<p>
-See also the "Text Handling in GTK 2" section of
-<a class="ulink" href="http://developer.gnome.org/dotplan/porting/" target="_top">Porting applications
-to the GNOME 2.0 platform</a>.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479196"></a><a name="id479199"></a><p><b>1.14.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Why are types not registered if I use their <code class="literal">GTK_TYPE_BLAH</code>
-macro ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-The <code class="literal">GTK_TYPE_BLAH</code> macros are defined as calls to
-<code class="literal"><code class="function">gtk_blah_get_type()</code></code>, and the <code class="literal"><code class="function">_get_type()</code></code> i
-functions are declared as <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Macros.html#G-GNUC-CONST:CAPS"><code class="literal">G_GNUC_CONST</code></a> which allows the compiler to optimize
-the call away if it appears that the value is not being used.
-</p>
-<p>
-A common workaround for this problem is to store the result in a volatile
-variable, which keeps the compiler from optimizing the call away.
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">volatile</span><span class="normal"> </span><span class="usertype">GType</span><span class="normal"> dummy </span><span class="symbol">=</span><span class="normal"> GTK_TYPE_BLAH</span><span class="symbol">;</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479274"></a><a name="id479277"></a><p><b>1.15.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I create a transparent toplevel window ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-To make a window transparent, it needs to use a visual which supports that.
-This is done by getting the RGBA colormap of the screen with
-<a href="../gdk/GdkScreen.html#gdk-screen-get-rgba-colormap"><code class="function">gdk_screen_get_rgba_colormap()</code></a> and setting it on the window. Note that
-<a href="../gdk/GdkScreen.html#gdk-screen-get-rgba-colormap"><code class="function">gdk_screen_get_rgba_colormap()</code></a> will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if transparent windows
-are not supported on the screen; also note that this may change from
-screen to screen, so it needs to be repeated whenever the window is moved
-to a different screen.
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6
-7</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GdkColormap</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">colormap</span><span class="symbol">;</span>
-<span class="normal">colormap </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../gdk/GdkScreen.html#gdk-screen-get-rgba-colormap">gdk_screen_get_rgba_colormap</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
-<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">colormap</span><span class="symbol">)</span>
-<span class="normal">  colormap </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../gdk/GdkScreen.html#gdk-screen-get-rgb-colormap">gdk_screen_get_rgb_colormap</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
-<span class="function"><a href="GtkWidget.html#gtk-widget-set-colormap">gtk_widget_set_colormap</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> colormap</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-One possibility to fill the alpha channel on the window is to use
-<a href="../gdk/gdk-GdkRGB.html#gdk-draw-rgb-32-image"><code class="function">gdk_draw_rgb_32_image()</code></a>.
-</p>
-<p>
-Note that the presence of an RGBA visual is no guarantee that the
-window will actually appear transparent on screen. On X11, this
-requires a compositing manager to be running. See
-<a class="link" href="GtkWidget.html#gtk-widget-is-composited" title="gtk_widget_is_composited ()"><code class="function">gtk_widget_is_composited()</code></a> for a way to find out if the alpha
-channel will be respected.
-</p>
-</td>
-</tr>
-<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
-<a name="id479358"></a>2. Which widget should I use...</h5></td></tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479363"></a><a name="id479365"></a><p><b>2.1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-...for lists and trees?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-See <a class="link" href="TreeWidget.html" title="Tree and List Widget Overview">tree widget overview</a> — you
-should use the <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> widget. (A list is just a tree with no branches,
-so the tree widget is used for lists as well.) Do not use the deprecated
-widgets <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a> or <a class="link" href="GtkCList.html" title="GtkCList"><span class="type">GtkCList</span></a>/<a class="link" href="GtkCTree.html" title="GtkCTree"><span class="type">GtkCTree</span></a> in newly-written code, they are
-less flexible and result in an inferior user interface.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479415"></a><a name="id479418"></a><p><b>2.2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-...for multi-line text display or editing?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-See <a class="link" href="TextWidget.html" title="Text Widget Overview">text widget overview</a> — you
-should use the <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> widget. Do not use the deprecated widget <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>
-in newly-written code, it has a number of problems that are best avoided.
-</p>
-<p>
-If you only have a small amount of text, <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> may also be appropriate
-of course. It can be made selectable with <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>. For a
-single-line text entry, see <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479478"></a><a name="id479481"></a><p><b>2.3.</b></p>
-</td>
-<td align="left" valign="top"><p>
-...to display an image or animation?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-<a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> can display images in just about any format GTK+ understands.
-You can also use <a class="link" href="GtkDrawingArea.html" title="GtkDrawingArea"><span class="type">GtkDrawingArea</span></a> if you need to do something more complex,
-such as draw text or graphics over the top of the image.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479509"></a><a name="id479511"></a><p><b>2.4.</b></p>
-</td>
-<td align="left" valign="top"><p>
-...for presenting a set of mutually-exclusive choices, where Windows
-would use a combo box?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-With GTK+, a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> is the recommended widget to use for this use case.
-This widget looks like either a combo box or the current option menu, depending
-on the current theme. If you need an editable text entry, use <a class="link" href="GtkComboBoxEntry.html" title="GtkComboBoxEntry"><span class="type">GtkComboBoxEntry</span></a>.
-</p></td>
-</tr>
-<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
-<a name="id479543"></a>3. GtkWidget</h5></td></tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479547"></a><a name="id479550"></a><p><b>3.1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I change the color of a widget?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-See <a class="link" href="GtkWidget.html#gtk-widget-modify-fg" title="gtk_widget_modify_fg ()"><code class="function">gtk_widget_modify_fg()</code></a>, <a class="link" href="GtkWidget.html#gtk-widget-modify-bg" title="gtk_widget_modify_bg ()"><code class="function">gtk_widget_modify_bg()</code></a>, <a class="link" href="GtkWidget.html#gtk-widget-modify-base" title="gtk_widget_modify_base ()"><code class="function">gtk_widget_modify_base()</code></a>,
-and <a class="link" href="GtkWidget.html#gtk-widget-modify-text" title="gtk_widget_modify_text ()"><code class="function">gtk_widget_modify_text()</code></a>.  See <a class="link" href="gtk-Resource-Files.html" title="Resource Files">GTK+
-resource files</a> for more discussion. You can also change widget color
-by installing a resource file and parsing it with <a class="link" href="gtk-Resource-Files.html#gtk-rc-add-default-file" title="gtk_rc_add_default_file"><code class="function">gtk_rc_add_default_file()</code></a>.
-The advantage of a resource file is that users can then override the
-color you've chosen.
-</p>
-<p>To change the background color for widgets such as <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> that have
-no background, place them in a <a class="link" href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a> and set the background of the
-event box.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479632"></a><a name="id479634"></a><p><b>3.2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I change the font of a widget?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-This has several possible answers, depending on what exactly you want to
-achieve. One option is <a class="link" href="GtkWidget.html#gtk-widget-modify-font" title="gtk_widget_modify_font ()"><code class="function">gtk_widget_modify_font()</code></a>. Note that this function
-can be used to change only the font size, as in the following example:
-</p>
-<pre class="programlisting">
- PangoFontDesc *font_desc = pango_font_description_new ();
- pango_font_description_set_size (font_desc, 40);
- gtk_widget_modify_font (widget, font);
- pango_font_description_free (font_desc);
-</pre>
-<p>
-</p>
-<p>
-If you want to make the text of a label larger, you can use
-<a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>:
-</p>
-<pre class="programlisting">
-gtk_label_set_markup (label, "&lt;big&gt;big text&lt;/big&gt;");
-</pre>
-<p>
-This is preferred for many apps because it's a relative size to the
-user's chosen font size. See <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> if you are
-constructing such strings on the fly.
-</p>
-<p>
-You can also change the font of a widget by putting
-</p>
-<pre class="programlisting">
- gtk-font-name = "Sans 30"
-</pre>
-<p>
-in a resource file and parsing it with <a class="link" href="gtk-Resource-Files.html#gtk-rc-add-default-file" title="gtk_rc_add_default_file"><code class="function">gtk_rc_add_default_file()</code></a>.
-The advantage of a resource file is that users can then override the font you
-have chosen. See <a class="link" href="gtk-Resource-Files.html" title="Resource Files">GTK+ resource files</a>
-for more discussion.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479722"></a><a name="id479725"></a><p><b>3.3.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I disable/ghost/desensitize a widget?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p> In GTK+ a disabled widget is termed "insensitive." See
-<a class="link" href="GtkWidget.html#gtk-widget-set-sensitive" title="gtk_widget_set_sensitive ()"><code class="function">gtk_widget_set_sensitive()</code></a>.
-</p></td>
-</tr>
-<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
-<a name="id479747"></a>4. GtkTextView</h5></td></tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479751"></a><a name="id479754"></a><p><b>4.1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I get the contents of the entire text widget as a string?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-See <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-bounds" title="gtk_text_buffer_get_bounds ()"><code class="function">gtk_text_buffer_get_bounds()</code></a> and <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-text" title="gtk_text_buffer_get_text ()"><code class="function">gtk_text_buffer_get_text()</code></a>
-or <a class="link" href="GtkTextIter.html#gtk-text-iter-get-text" title="gtk_text_iter_get_text ()"><code class="function">gtk_text_iter_get_text()</code></a>.
-</p>
-<p>
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6
-7
-8
-9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkTextIter</span><span class="normal"> start</span><span class="symbol">,</span><span class="normal"> end</span><span class="symbol">;</span>
-<span class="usertype">GtkTextBuffer</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">buffer</span><span class="symbol">;</span>
-<span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">;</span>
-<span class="normal">buffer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTextView.html#gtk-text-view-get-buffer">gtk_text_view_get_buffer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_TEXT_VIEW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text_view</span><span class="symbol">));</span>
-<span class="function"><a href="GtkTextBuffer.html#gtk-text-buffer-get-bounds">gtk_text_buffer_get_bounds</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">start</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">end</span><span class="symbol">);</span>
-<span class="normal">text </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTextIter.html#gtk-text-iter-get-text">gtk_text_iter_get_text</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">start</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">end</span><span class="symbol">);</span>
-<span class="comment">/* use text */</span>
-<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479807"></a><a name="id479809"></a><p><b>4.2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I make a text widget display its complete contents in a specific font?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-If you use <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-with-tags" title="gtk_text_buffer_insert_with_tags ()"><code class="function">gtk_text_buffer_insert_with_tags()</code></a> with appropriate tags to select
-the font, the inserted text will have the desired appearance, but text typed
-in by the user before or after the tagged block will appear in the default
-style.
-</p>
-<p>
-To ensure that all text has the desired appearance, use <a class="link" href="GtkWidget.html#gtk-widget-modify-font" title="gtk_widget_modify_font ()"><code class="function">gtk_widget_modify_font()</code></a>
-to change the default font for the widget.
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479844"></a><a name="id479847"></a><p><b>4.3.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I make a text view scroll to the end of the buffer automatically ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-A good way to keep a text buffer scrolled to the end is to place a
-<a class="link" href="GtkTextMark.html" title="GtkTextMark">mark</a> at the end of the buffer, and
-give it right gravity. The gravity has the effect that text inserted
-at the mark gets inserted <span class="emphasis"><em>before</em></span>, keeping the mark
-at the end.
-</p>
-<p>
-To ensure that the end of the buffer remains visible, use
-<a class="link" href="GtkTextView.html#gtk-text-view-scroll-to-mark" title="gtk_text_view_scroll_to_mark ()"><code class="function">gtk_text_view_scroll_to_mark()</code></a> to scroll to the mark after
-inserting new text.
-</p>
-<p>
-The gtk-demo application contains an example of this technique.
-</p>
-</td>
-</tr>
-<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
-<a name="id479894"></a>5. <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>
-</h5></td></tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479903"></a><a name="id479905"></a><p><b>5.1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I associate some data with a row in the tree?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-Remember that the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> columns don't necessarily have to be displayed.
-So you can put non-user-visible data in your model just like any other data,
-and retrieve it with <a class="link" href="GtkTreeModel.html#gtk-tree-model-get" title="gtk_tree_model_get ()"><code class="function">gtk_tree_model_get()</code></a>. See the
-<a class="link" href="TreeWidget.html" title="Tree and List Widget Overview">tree widget overview</a>.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479942"></a><a name="id479944"></a><p><b>5.2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-What's the <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> equivalent of <a class="link" href="GtkCList.html#gtk-clist-find-row-from-data" title="gtk_clist_find_row_from_data ()"><code class="function">gtk_clist_find_row_from_data()</code></a>?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-As there is no separate data column in the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>, there's no
-built in function to find the iter from data.  You can write a custom
-searching function to walk the tree and find the data, or use
-<a class="link" href="GtkTreeModel.html#gtk-tree-model-foreach" title="gtk_tree_model_foreach ()"><code class="function">gtk_tree_model_foreach()</code></a>.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id479992"></a><a name="id479994"></a><p><b>5.3.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I put an image and some text in the same column?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-You can pack more than one <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> into a single <a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a>
-using <a class="link" href="GtkTreeViewColumn.html#gtk-tree-view-column-pack-start" title="gtk_tree_view_column_pack_start ()"><code class="function">gtk_tree_view_column_pack_start()</code></a> or <a class="link" href="GtkTreeViewColumn.html#gtk-tree-view-column-pack-end" title="gtk_tree_view_column_pack_end ()"><code class="function">gtk_tree_view_column_pack_end()</code></a>.
-So pack both a <a class="link" href="GtkCellRendererPixbuf.html" title="GtkCellRendererPixbuf"><span class="type">GtkCellRendererPixbuf</span></a> and a <a class="link" href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> into the
-column.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480056"></a><a name="id480058"></a><p><b>5.4.</b></p>
-</td>
-<td align="left" valign="top"><p>
-I can set data easily on my <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>/<a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</span></a> models using
-<a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> and <a class="link" href="GtkTreeStore.html#gtk-tree-store-set" title="gtk_tree_store_set ()"><code class="function">gtk_tree_store_set()</code></a>, but can't read it back?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-Both the <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> and the <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</span></a> implement the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>
-interface.  Consequentially, the can use any function this interface
-implements. The easiest way to read a set of data back is to use
-<a class="link" href="GtkTreeModel.html#gtk-tree-model-get" title="gtk_tree_model_get ()"><code class="function">gtk_tree_model_get()</code></a>.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480137"></a><a name="id480139"></a><p><b>5.5.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I change the way that numbers are formatted by <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-Use <a class="link" href="GtkTreeView.html#gtk-tree-view-insert-column-with-data-func" title="gtk_tree_view_insert_column_with_data_func ()"><code class="function">gtk_tree_view_insert_column_with_data_func()</code></a>
-or <a class="link" href="GtkTreeViewColumn.html#gtk-tree-view-column-set-cell-data-func" title="gtk_tree_view_column_set_cell_data_func ()"><code class="function">gtk_tree_view_column_set_cell_data_func()</code></a> and do the conversion from i
-number to string yourself (with, say, <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strdup-printf"><code class="function">g_strdup_printf()</code></a>).
-</p>
-<p>
-The following example demonstrates this:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>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</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">enum</span><span class="normal"> </span>
-<span class="cbracket">{</span>
-<span class="normal">  DOUBLE_COLUMN</span><span class="symbol">,</span>
-<span class="normal">  N_COLUMNS</span>
-<span class="cbracket">}</span><span class="symbol">;</span>
-<span class="usertype">GtkListStore</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">mycolumns</span><span class="symbol">;</span>
-<span class="usertype">GtkTreeView</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">treeview</span><span class="symbol">;</span>
-<span class="type">void</span><span class="normal"> </span>
-<span class="function">my_cell_double_to_text</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkTreeViewColumn</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tree_column</span><span class="symbol">,</span>
-<span class="normal">                    </span><span class="usertype">GtkCellRenderer</span><span class="normal">   </span><span class="symbol">*</span><span class="normal">cell</span><span class="symbol">,</span><span class="normal"> </span>
-<span class="normal">                        </span><span class="usertype">GtkTreeModel</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">tree_model</span><span class="symbol">,</span>
-<span class="normal">                    </span><span class="usertype">GtkTreeIter</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span>
-<span class="normal">                        </span><span class="usertype">gpointer</span><span class="normal">           data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GtkCellRendererText</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cell_text </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkCellRendererText.html">GtkCellRendererText</a> </span><span class="symbol">*)</span><span class="normal">cell</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">gdouble</span><span class="normal"> d</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="comment">/* Get the double value from the model. */</span>
-<span class="normal">  </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get">gtk_tree_model_get</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tree_model</span><span class="symbol">,</span><span class="normal"> iter</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a></span><span class="symbol">)</span><span class="normal">data</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">d</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="comment">/* Now we can format the value ourselves. */</span>
-<span class="normal">  text </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strdup-printf">g_strdup_printf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%.2f"</span><span class="symbol">,</span><span class="normal"> d</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set">g_object_set</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cell</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"text"</span><span class="symbol">,</span><span class="normal"> text</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
-<span class="type">void</span><span class="normal"> </span>
-<span class="function">set_up_new_columns</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkTreeView</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">myview</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GtkCellRendererText</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">renderer</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GtkTreeViewColumn</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">column</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GtkListStore</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">mycolumns</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="comment">/* Create the data model and associate it with the given TreeView */</span>
-<span class="normal">  mycolumns </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkListStore.html#gtk-list-store-new">gtk_list_store_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">N_COLUMNS</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS">G_TYPE_DOUBLE</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GtkTreeView.html#gtk-tree-view-set-model">gtk_tree_view_set_model</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">myview</span><span class="symbol">,</span><span class="normal"> </span><span class="function">GTK_TREE_MODEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mycolumns</span><span class="symbol">));</span>
-<span class="normal">  </span><span class="comment">/* Create a GtkCellRendererText */</span>
-<span class="normal">  renderer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkCellRendererText.html#gtk-cell-renderer-text-new">gtk_cell_renderer_text_new</a></span><span class="normal"> </span><span class="symbol">();</span>
-<span class="normal">  </span><span class="comment">/* Create a new column that has a title ("Example column"),</span>
-<span class="comment">   * uses the above created renderer that will render the double</span>
-<span class="comment">   * value into text from the associated model's rows. </span>
-<span class="comment">   */</span>
-<span class="normal">  column </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeViewColumn.html#gtk-tree-view-column-new">gtk_tree_view_column_new</a></span><span class="normal"> </span><span class="symbol">();</span>
-<span class="normal">  </span><span class="function"><a href="GtkTreeViewColumn.html#gtk-tree-view-column-set-title">gtk_tree_view_column_set_title</a></span><span class="normal">  </span><span class="symbol">(</span><span class="normal">column</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Example column"</span><span class="symbol">);</span>
-<span class="normal">  renderer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkCellRendererText.html#gtk-cell-renderer-text-new">gtk_cell_renderer_text_new</a></span><span class="normal"> </span><span class="symbol">();</span>
-<span class="normal">  </span><span class="function"><a href="GtkTreeViewColumn.html#gtk-tree-view-column-pack-start">gtk_tree_view_column_pack_start</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">column</span><span class="symbol">,</span><span class="normal"> renderer</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="comment">/* Append the new column after the GtkTreeView's previous columns. */</span>
-<span class="normal">  </span><span class="function"><a href="GtkTreeView.html#gtk-tree-view-append-column">gtk_tree_view_append_column</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_TREE_VIEW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">myview</span><span class="symbol">),</span><span class="normal"> column</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="comment">/* Since we created the column by hand, we can set it up for our</span>
-<span class="comment">   * needs, e.g. set its minimum and maximum width, etc.</span>
-<span class="comment">   */</span>
-<span class="normal">  </span><span class="comment">/* Set up a custom function that will be called when the column content</span>
-<span class="comment">   * is rendered. We use the func_data pointer as an index into our</span>
-<span class="comment">   * model. This is convenient when using multi column lists. </span>
-<span class="comment">   */</span>
-<span class="normal">  </span><span class="function"><a href="GtkTreeViewColumn.html#gtk-tree-view-column-set-cell-data-func">gtk_tree_view_column_set_cell_data_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">column</span><span class="symbol">,</span><span class="normal"> renderer</span><span class="symbol">,</span>
-<span class="normal">                                       my_cell_double_to_text</span><span class="symbol">,</span><span class="normal"> </span>
-<span class="normal">                                           </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a></span><span class="symbol">)</span><span class="normal">DOUBLE_COLUMN</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480221"></a><a name="id480223"></a><p><b>5.6.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I hide the expander arrows in my tree view ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-Set the expander-column property of the tree view to a hidden column.
-See <a class="link" href="GtkTreeView.html#gtk-tree-view-set-expander-column" title="gtk_tree_view_set_expander_column ()"><code class="function">gtk_tree_view_set_expander_column()</code></a> and <a class="link" href="GtkTreeViewColumn.html#gtk-tree-view-column-set-visible" title="gtk_tree_view_column_set_visible ()"><code class="function">gtk_tree_view_column_set_visible()</code></a>.
-</p></td>
-</tr>
-<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
-<a name="id480255"></a>6. Using cairo with GTK+</h5></td></tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480260"></a><a name="id480262"></a><p><b>6.1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-How do I use cairo to draw in GTK+ applications ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-Use <a href="../gdk/gdk-Cairo-Interaction.html#gdk-cairo-create"><code class="function">gdk_cairo_create()</code></a> to obtain a cairo context for drawing
-on a GDK window or pixmap. See <GTKDOCLINK HREF="gdk-Cairo-Interaction">Cairo
-Interaction</GTKDOCLINK> for some more useful functions.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480288"></a><a name="id480291"></a><p><b>6.2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-I have created a cairo context with <a href="../gdk/gdk-Cairo-Interaction.html#gdk-cairo-create"><code class="function">gdk_cairo_create()</code></a>, but when I
-later use it, my drawing does not show up. Why is that ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top">
-<p>
-All drawing in GTK+ is normally done in an expose handler, and GTK+
-creates a temporary pixmap for double-buffering the drawing. If you
-create a cairo context outside the expose handler, it is backed
-by the GDK window itself, not the double-buffering pixmap. Consequently,
-any drawing you do with that cairo context gets overwritten at the
-end of the expose handler, when the double-buffering pixmap is copied
-back.
-</p>
-<p>
-Possible solutions to this problem are:
-</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-Turn off double-buffering, with <a class="link" href="GtkWidget.html#gtk-widget-set-double-buffered" title="gtk_widget_set_double_buffered ()"><code class="function">gtk_widget_set_double_buffered()</code></a>.
-This is not ideal, since it can cause some flickering.
-</p></li>
-<li class="listitem"><p>
-Create the cairo context inside the expose handler. If you do this,
-<code class="function">gdk_create_cairo()</code> arranges for it to be backed by the double-buffering
-pixmap. This is the preferred solution, and is used throughout GTK+
-itself.
-</p></li>
-</ul></div>
-<p>
-</p>
-</td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480355"></a><a name="id480358"></a><p><b>6.3.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Can I improve the performance of my application by using the
-Glitz backend of cairo ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-No. The GDK X11 backend uses the cairo X backend (and the other
-GDK backends use their respective native cairo backends). The
-GTK+ developers believe that the best way to improving the GDK
-drawing performance is to optimize the cairo X backend and the
-relevant code paths in the X server that is uses (mostly the
-Render extension).
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a name="id480372"></a><a name="id480374"></a><p><b>6.4.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Can I use cairo to draw on a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> ?
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-No, at least not yet. The cairo image surface does not support the
-pixel format used by GdkPixbuf.
-</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="footnotes">
-<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id478988" href="#id478988" class="para">1</a>] </sup> If the file load fails,
-<a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file"><code class="function">gtk_image_new_from_file()</code></a> will display no image graphic — to detect
-a failed load yourself, use <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"><code class="function">gdk_pixbuf_new_from_file()</code></a> directly, then
-<a class="link" href="GtkImage.html#gtk-image-new-from-pixbuf" title="gtk_image_new_from_pixbuf ()"><code class="function">gtk_image_new_from_pixbuf()</code></a>.</p></div>
-</div>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.18</div>
-</body>
-</html>