📄 gtkcolorselection.html
字号:
<HTML><HEAD><TITLE>GtkColorSelection</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkCList"HREF="gtkclist.html"><LINKREL="NEXT"TITLE="GtkColorSelectionDialog"HREF="gtkcolorselectiondialog.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkclist.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkcolorselectiondialog.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKCOLORSELECTION">GtkColorSelection</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN19172"></A><H2>Name</H2>GtkColorSelection -- a widget used to select a color.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN19175"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkcolorselection.html#GTKCOLORSELECTION-STRUCT">GtkColorSelection</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkcolorselection.html#GTK-COLOR-SELECTION-NEW">gtk_color_selection_new</A> (void);void <AHREF="gtkcolorselection.html#GTK-COLOR-SELECTION-SET-UPDATE-POLICY">gtk_color_selection_set_update_policy</A> (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF="gtk-standard-enumerations.html#GTKUPDATETYPE">GtkUpdateType</A> policy);void <AHREF="gtkcolorselection.html#GTK-COLOR-SELECTION-SET-OPACITY">gtk_color_selection_set_opacity</A> (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> use_opacity);void <AHREF="gtkcolorselection.html#GTK-COLOR-SELECTION-SET-COLOR">gtk_color_selection_set_color</A> (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF=../glib/glib-basic-types.html#GDOUBLE>gdouble</A> *color);void <AHREF="gtkcolorselection.html#GTK-COLOR-SELECTION-GET-COLOR">gtk_color_selection_get_color</A> (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF=../glib/glib-basic-types.html#GDOUBLE>gdouble</A> *color); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN19193"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkcontainer.html">GtkContainer</A> +----<AHREF="gtkbox.html">GtkBox</A> +----<AHREF="gtkvbox.html">GtkVBox</A> +----GtkColorSelection</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN19201"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkcolorselection.html#GTKCOLORSELECTION-COLOR-CHANGED">color-changed</A>" void user_function (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorselection, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN19207"></A><H2>Description</H2><P>The <AHREF="gtkcolorselection.html">GtkColorSelection</A> is a widget that is used to select a color. It consists of a color wheel and number of slidersand entry boxes for color parameters such as hue, saturation,value, red, green, blue, and opacity. It is found on the standard color selection dialog box <AHREF="gtkcolorselectiondialog.html">GtkColorSelectionDialog</A>.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN19212"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN19214"></A><H3><ANAME="GTKCOLORSELECTION-STRUCT"></A>struct GtkColorSelection</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkColorSelection;</PRE></TD></TR></TABLE><P>The <AHREF="gtkcolorselection.html#GTKCOLORSELECTION-STRUCT">GtkColorSelection</A> struct contains private data only, and should be accessed using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN19220"></A><H3><ANAME="GTK-COLOR-SELECTION-NEW"></A>gtk_color_selection_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_color_selection_new (void);</PRE></TD></TR></TABLE><P>Create a new <AHREF="gtkcolorselection.html">GtkColorSelection</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN19227"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcolorselection.html">GtkColorSelection</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN19237"></A><H3><ANAME="GTK-COLOR-SELECTION-SET-UPDATE-POLICY"></A>gtk_color_selection_set_update_policy ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_color_selection_set_update_policy (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF="gtk-standard-enumerations.html#GTKUPDATETYPE">GtkUpdateType</A> policy);</PRE></TD></TR></TABLE><P>Sets the policy controlling when the color_changed signals are emitted.The available policies are:<P></P><UL><LI><P><TTCLASS="LITERAL">GTK_UPDATE_CONTINUOUS</TT> - signals are sent continuously as the colorselection changes.</P></LI><LI><P><TTCLASS="LITERAL">GTK_UPDATE_DISCONTINUOUS</TT> - signals are sent only when the mouse button is released.</P></LI><LI><P><TTCLASS="LITERAL">GTK_UPDATE_DELAYED</TT> - signals are sent when the mouse button isreleased or when the mouse has been motionless for a period oftime.</P></LI></UL></P><DIVCLASS="INFORMALTABLE"><ANAME="AEN19254"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>colorsel</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcolorselection.html">GtkColorSelection</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>policy</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtk-standard-enumerations.html#GTKUPDATETYPE">GtkUpdateType</A> value indicating the desired policy. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN19269"></A><H3><ANAME="GTK-COLOR-SELECTION-SET-OPACITY"></A>gtk_color_selection_set_opacity ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_color_selection_set_opacity (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> use_opacity);</PRE></TD></TR></TABLE><P>Controls whether opacity can be set with the <AHREF="gtkcolorselection.html">GtkColorSelection</A>.If this functionality is enabled, the necessary additional widgetsare added to the <AHREF="gtkcolorselection.html">GtkColorSelection</A> and the opacity value can beretrieved via the fourth value in the color array returned bythe <AHREF="gtkcolorselection.html#GTK-COLOR-SELECTION-GET-COLOR">gtk_color_selection_get_color</A>() function.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN19279"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>colorsel</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcolorselection.html">GtkColorSelection</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>use_opacity</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a boolean indicating whether the opacity selectionis enabled. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN19293"></A><H3><ANAME="GTK-COLOR-SELECTION-SET-COLOR"></A>gtk_color_selection_set_color ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_color_selection_set_color (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF=../glib/glib-basic-types.html#GDOUBLE>gdouble</A> *color);</PRE></TD></TR></TABLE><P>Sets the color in the <AHREF="gtkcolorselection.html">GtkColorSelection</A>. The widgets are updatedto reflect the new color.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN19301"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>colorsel</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcolorselection.html">GtkColorSelection</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>color</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a color array consisting of 4 gfloat values for red, green,blue, and opacity. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN19315"></A><H3><ANAME="GTK-COLOR-SELECTION-GET-COLOR"></A>gtk_color_selection_get_color ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_color_selection_get_color (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorsel, <AHREF=../glib/glib-basic-types.html#GDOUBLE>gdouble</A> *color);</PRE></TD></TR></TABLE><P>Retrieve the currently selected color value.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN19322"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>colorsel</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcolorselection.html">GtkColorSelection</A></TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>color</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a color array consisting of 4 gfloat values for red, green,blue, and opacity. </TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN19336"></A><H2>Signals</H2><DIVCLASS="REFSECT2"><ANAME="AEN19338"></A><H3><ANAME="GTKCOLORSELECTION-COLOR-CHANGED"></A>The "color-changed" signal</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void user_function (<AHREF="gtkcolorselection.html">GtkColorSelection</A> *colorselection, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE><P>This signal is emitted when the color changes in the <AHREF="gtkcolorselection.html">GtkColorSelection</A>according to its update policy.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN19346"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>colorselection</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the object which received the signal. </TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>user_data</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">user data set when the signal handler was connected.</TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="NAVFOOTER"><BRCLEAR="all"><BR><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkclist.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkcolorselectiondialog.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR><TR><TDCOLSPAN="2"ALIGN="left"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkCList</B></FONT></TD><TDCOLSPAN="2"ALIGN="right"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkColorSelectionDialog</B></FONT></TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -