gdk-properties-and-atoms.html

最新gtk中文资料集

</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the newly allocated string, or <a
href="/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"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_utf8_to_compound_text           (const <a
href="/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,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *format,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> **ctext,
                                                         <a
href="/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> <a
href="/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"><a
href="/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 <a
href="/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,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *format,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> **ctext,
                                                         <a
href="/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> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the conversion succeeded, otherwise
              <a
href="/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 <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *atom_name,
                                                         <a
href="/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 <a
href="/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 <a
href="/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> except
that 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 statically
allocated strings in the main program, but not with statically 
allocated memory in dynamically loaded modules, if you expect to
ever unload the module again (e.g. do not use this function in
GTK+ 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"><a
href="/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 <a
href="/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"><a
href="/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,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong"
>gulong</a> offset,