gdk-colormaps-and-colors.html

最新gtk中文资料集

<a name="id3148759"></a><h3>
<a name="gdk-color-white"></a>gdk_color_white ()</h3>
<a class="indexterm" name="id3148774"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gdk_color_white                     (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_color_white</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the white color for a given colormap. The resulting
value has already allocated been allocated.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></p></td>
<td> the location to store the color.
</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 allocation succeeded.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3148888"></a><h3>
<a name="gdk-color-black"></a>gdk_color_black ()</h3>
<a class="indexterm" name="id3148903"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gdk_color_black                     (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_color_black</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the black color for a given colormap. The resulting
value has already benn allocated.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></p></td>
<td> the location to store the color.
</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 allocation succeeded.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149017"></a><h3>
<a name="gdk-color-parse"></a>gdk_color_parse ()</h3>
<a class="indexterm" name="id3149030"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_color_parse                     (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *spec,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color);</pre>
<p>
Parses a textual specification of a color and fill in
the <em class="structfield"><code>red</code></em>,
<em class="structfield"><code>green</code></em>, and 
<em class="structfield"><code>blue</code></em> fields of a 
<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> structure. The color is <span class="emphasis"><em>not</em></span> 
allocated, you must call <a class="link" href="gdk-Colormaps-and-Colors.html#gdk-colormap-alloc-color"><code class="function">gdk_colormap_alloc_color()</code></a> yourself.
The text string can be in any of the forms accepted
by <code class="function">XParseColor</code>; these include
name for a color from <code class="filename">rgb.txt</code>, such as
<code class="literal">DarkSlateGray</code>, or a hex specification
such as <code class="literal">#3050b2</code> or <code class="literal">#35b</code>.</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>spec</code></em>&#160;:</span></p></td>
<td> the string specifying the color.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to fill in
</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 parsing succeeded.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149197"></a><h3>
<a name="gdk-color-alloc"></a>gdk_color_alloc ()</h3>
<a class="indexterm" name="id3149213"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gdk_color_alloc                     (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_color_alloc</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="gdk-Colormaps-and-Colors.html#gdk-colormap-alloc-color"><code class="function">gdk_colormap_alloc_color()</code></a> instead.</p>
</div>
<p>
Allocates a single color from a colormap.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></p></td>
<td> The color to allocate. On return, the 
   <em class="structfield"><code>pixel</code></em> field will be filled in.
</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 allocation succeeded.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149342"></a><h3>
<a name="gdk-color-change"></a>gdk_color_change ()</h3>
<a class="indexterm" name="id3149357"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gdk_color_change                    (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_color_change</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Changes the value of a color that has already
been allocated. If <em class="parameter"><code>colormap</code></em> is not a private
colormap, then the color must have been allocated
using <a class="link" href="gdk-Colormaps-and-Colors.html#gdk-colormap-alloc-colors"><code class="function">gdk_colormap_alloc_colors()</code></a> with the 
<em class="parameter"><code>writeable</code></em> set to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>, with the color to change
in the <em class="structfield"><code>pixel</code></em> field,
and the new value in the remaining fields.
</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 color was successfully changed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149517"></a><h3>
<a name="gdk-color-equal"></a>gdk_color_equal ()</h3>
<a class="indexterm" name="id3149529"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_color_equal                     (const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *colora,
                                                         const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *colorb);</pre>
<p>
Compares two colors.</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>colora</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>colorb</code></em>&#160;:</span></p></td>
<td> another <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.
</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 two colors compare equal
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149637"></a><h3>
<a name="gdk-color-hash"></a>gdk_color_hash ()</h3>
<a class="indexterm" name="id3149650"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gdk_color_hash                      (const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *colora);</pre>
<p>
A hash function suitable for using for a hash
table that stores <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>'s.</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>colora</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The hash function applied to <em class="parameter"><code>colora</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149733"></a><h3>
<a name="gdk-color-to-string"></a>gdk_color_to_string ()</h3>
<a class="indexterm" name="id3149748"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gdk_color_to_string                 (const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color);</pre>
<p>
Returns a textual specification of <em class="parameter"><code>color</code></em> in the hexadecimal form
<code class="literal">#rrrrggggbbbb</code>, where <code class="literal">r</code>,
<code class="literal">g</code> and <code class="literal">b</code> are hex digits
representing the red, green and blue components respectively.</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>color</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</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 text string

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3149857"></a><div class="refsect2" lang="en"><a name="id3149858"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3149859"></a></div>
</div>
</div>
</body>
</html>