gtkcolorbutton.html

最新gtk中文资料集

</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998007"></a><h3>
<a name="gtk-color-button-set-alpha"></a>gtk_color_button_set_alpha ()</h3>
<a class="indexterm" name="id3998023"></a><pre class="programlisting">void                gtk_color_button_set_alpha          (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *color_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint16"
>guint16</a> alpha);</pre>
<p>
Sets the current opacity to be <em class="parameter"><code>alpha</code></em>.</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_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></p></td>
<td> an integer between 0 and 65535.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998116"></a><h3>
<a name="gtk-color-button-get-alpha"></a>gtk_color_button_get_alpha ()</h3>
<a class="indexterm" name="id3998132"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint16"
>guint16</a>             gtk_color_button_get_alpha          (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *color_button);</pre>
<p>
Returns the current alpha value.</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_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> an integer between 0 and 65535.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998208"></a><h3>
<a name="gtk-color-button-set-use-alpha"></a>gtk_color_button_set_use_alpha ()</h3>
<a class="indexterm" name="id3998224"></a><pre class="programlisting">void                gtk_color_button_set_use_alpha      (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *color_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> use_alpha);</pre>
<p>
Sets whether or not the color button should use the alpha channel.</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_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>use_alpha</code></em>&#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 color button should use alpha channel, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998333"></a><h3>
<a name="gtk-color-button-get-use-alpha"></a>gtk_color_button_get_use_alpha ()</h3>
<a class="indexterm" name="id3998349"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_color_button_get_use_alpha      (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *color_button);</pre>
<p>
Does the color selection dialog use the alpha channel?</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_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</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 color sample uses alpha channel, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998446"></a><h3>
<a name="gtk-color-button-set-title"></a>gtk_color_button_set_title ()</h3>
<a class="indexterm" name="id3998462"></a><pre class="programlisting">void                gtk_color_button_set_title          (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *color_button,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title);</pre>
<p>
Sets the title for the color selection dialog.</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_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></p></td>
<td> String containing new window title.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998550"></a><h3>
<a name="gtk-color-button-get-title"></a>gtk_color_button_get_title ()</h3>
<a class="indexterm" name="id3998566"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_color_button_get_title          (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *color_button);</pre>
<p>
Gets the title of the color selection dialog.</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_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> An internal string, do not free the return value

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3998645"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3998656"></a><h3>
<a name="GtkColorButton--alpha"></a>The <code class="literal">"alpha"</code> property</h3>
<a class="indexterm" name="id3998672"></a><pre class="programlisting">  "alpha"                    <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>                 : Read / Write</pre>
<p>
The selected opacity value (0 fully transparent, 65535 fully opaque).</p>
<p>

</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 65535</p>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998713"></a><h3>
<a name="GtkColorButton--color"></a>The <code class="literal">"color"</code> property</h3>
<a class="indexterm" name="id3998729"></a><pre class="programlisting">  "color"                    <a
href="/usr/share/gtk-doc/html/gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a>              : Read / Write</pre>
<p>
The selected color.</p>
<p>

</p>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998762"></a><h3>
<a name="GtkColorButton--title"></a>The <code class="literal">"title"</code> property</h3>
<a class="indexterm" name="id3998777"></a><pre class="programlisting">  "title"                    <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>
The title of the color selection dialog</p>
<p>

</p>
<p>Default value: "Pick a Color"</p>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3998814"></a><h3>
<a name="GtkColorButton--use-alpha"></a>The <code class="literal">"use-alpha"</code> property</h3>
<a class="indexterm" name="id3998830"></a><pre class="programlisting">  "use-alpha"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
If this property is set to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the color swatch on the button is rendered against a 
checkerboard background to show its opacity and the opacity slider is displayed in the 
color selection dialog.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3998880"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3998890"></a><h3>
<a name="GtkColorButton-color-set"></a>The <code class="literal">"color-set"</code> signal</h3>
<a class="indexterm" name="id3998907"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a> *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)      : Run First</pre>
<p>
The ::color-set signal is emitted when the user selects a color. 
When handling this signal, use <a class="link" href="GtkColorButton.html#gtk-color-button-get-color"><code class="function">gtk_color_button_get_color()</code></a> and 
<a class="link" href="GtkColorButton.html#gtk-color-button-get-alpha"><code class="function">gtk_color_button_get_alpha()</code></a> to find out which color was just selected.
</p>
<p>
Note that this signal is only emitted when the <span class="emphasis"><em>user</em></span>
changes the color. If you need to react to programmatic color changes
as well, use the notify::color signal.</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>widget</code></em>&#160;:</span></p></td>
<td> the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3999020"></a><h2>See Also</h2>
<p>
<a class="link" href="GtkColorSelectionDialog.html" title="GtkColorSelectionDialog"><span class="type">GtkColorSelectionDialog</span></a>, <a class="link" href="GtkFontButton.html" title="GtkFontButton"><span class="type">GtkFontButton</span></a>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3999046"></a><div class="refsect2" lang="en"><a name="id3999047"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3999048"></a></div>
</div>
</div>
</body>
</html>