</tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> the newly allocated string, or <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the              conversion failed. (It should not fail for              any properly formed UTF-8 string.)</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3274637"></a><h3><a name="gdk-utf8-to-compound-text"></a>gdk_utf8_to_compound_text ()</h3><a class="indexterm" name="id3274651"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a>            gdk_utf8_to_compound_text           (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);</pre><p>Convert from UTF-8 to compound text.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td><td>      a UTF-8 string</td></tr><tr><td><p><span class="term"><em class="parameter"><code>encoding</code></em>&#160;:</span></p></td><td> location to store resulting encoding</td></tr><tr><td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td><td>   location to store format of the result</td></tr><tr><td><p><span class="term"><em class="parameter"><code>ctext</code></em>&#160;:</span></p></td><td>    location to store the data of the result</td></tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td><td>   location to store the length of the data           stored in <em class="parameter"><code>ctext</code></em></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the conversion succeeded, otherwise              false.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3274818"></a><h3><a name="gdk-utf8-to-compound-text-for-display"></a>gdk_utf8_to_compound_text_for_display ()</h3><a class="indexterm" name="id3274834"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a>            gdk_utf8_to_compound_text_for_display                                                        (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,                                                         const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);</pre><p>Converts from UTF-8 to compound text.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></p></td><td>  a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td><td>      a UTF-8 string</td></tr><tr><td><p><span class="term"><em class="parameter"><code>encoding</code></em>&#160;:</span></p></td><td> location to store resulting encoding</td></tr><tr><td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td><td>   location to store format of the result</td></tr><tr><td><p><span class="term"><em class="parameter"><code>ctext</code></em>&#160;:</span></p></td><td>    location to store the data of the result</td></tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td><td>   location to store the length of the data           stored in <em class="parameter"><code>ctext</code></em></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the conversion succeeded, otherwise              <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td></tr></tbody></table></div><p class="since">Since  2.2</p></div><hr><div class="refsect2" lang="en"><a name="id3275048"></a><h3><a name="gdk-atom-intern"></a>gdk_atom_intern ()</h3><a class="indexterm" name="id3275061"></a><pre class="programlisting"><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a>             gdk_atom_intern                     (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *atom_name,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> only_if_exists);</pre><p>Finds or creates an atom corresponding to a given string.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>atom_name</code></em>&#160;:</span></p></td><td>a string.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>only_if_exists</code></em>&#160;:</span></p></td><td>if <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, GDK is allowed to not create a new atom, but                 just return <a class="link" href="gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"><code class="literal">GDK_NONE</code></a> if the requested atom doesn't already                 exists. Currently, the flag is ignored, since checking the                  existance of an atom is as expensive as creating it.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td>the atom corresponding to <em class="parameter"><code>atom_name</code></em>.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3275172"></a><h3><a name="gdk-atom-intern-static-string"></a>gdk_atom_intern_static_string ()</h3><a class="indexterm" name="id3275188"></a><pre class="programlisting"><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a>             gdk_atom_intern_static_string       (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *atom_name);</pre><p>Finds or creates an atom corresponding to a given string.</p><p>Note that this function is identical to <a class="link" href="gdk-Properties-and-Atoms.html#gdk-atom-intern"><code class="function">gdk_atom_intern()</code></a> exceptthat if a new <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> is created the string itself is used rather than a copy. This saves memory, but can only be used if the string will <span class="emphasis"><em>always</em></span> exist. It can be used with staticallyallocated strings in the main program, but not with statically allocated memory in dynamically loaded modules, if you expect toever unload the module again (e.g. do not use this function inGTK+ theme engines).</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>atom_name</code></em>&#160;:</span></p></td><td> a static string</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> the atom corresponding to <em class="parameter"><code>atom_name</code></em></td></tr></tbody></table></div><p class="since">Since  2.10</p></div><hr><div class="refsect2" lang="en"><a name="id3275295"></a><h3><a name="gdk-atom-name"></a>gdk_atom_name ()</h3><a class="indexterm" name="id3275308"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>*              gdk_atom_name                       (<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> atom);</pre><p>Determines the string corresponding to an atom.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>atom</code></em>&#160;:</span></p></td><td>a <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td>a newly-allocated string containing the string          corresponding to <em class="parameter"><code>atom</code></em>. When you are done          with the return value, you should free it           using <ahref="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3275392"></a><h3><a name="gdk-property-get"></a>gdk_property_get ()</h3><a class="indexterm" name="id3275404"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a>            gdk_property_get                    (<a class="link" href="gdk-Windows.html#GdkWindow">GdkWindow</a> *window,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> property,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> type,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong">gulong</a> offset,