![]() |
![]() |
![]() |
GTK+ 3 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <gtk/gtk.h> GtkColorButton; GtkWidget * gtk_color_button_new (void
); GtkWidget * gtk_color_button_new_with_color (const GdkColor *color
); GtkWidget * gtk_color_button_new_with_rgba (const GdkRGBA *rgba
); void gtk_color_button_set_color (GtkColorButton *color_button
,const GdkColor *color
); void gtk_color_button_get_color (GtkColorButton *color_button
,GdkColor *color
); void gtk_color_button_set_alpha (GtkColorButton *color_button
,guint16 alpha
); guint16 gtk_color_button_get_alpha (GtkColorButton *color_button
); void gtk_color_button_set_rgba (GtkColorButton *color_button
,const GdkRGBA *rgba
); void gtk_color_button_get_rgba (GtkColorButton *color_button
,GdkRGBA *rgba
); void gtk_color_button_set_use_alpha (GtkColorButton *color_button
,gboolean use_alpha
); gboolean gtk_color_button_get_use_alpha (GtkColorButton *color_button
); void gtk_color_button_set_title (GtkColorButton *color_button
,const gchar *title
); const gchar * gtk_color_button_get_title (GtkColorButton *color_button
);
The GtkColorButton is a button which displays the currently selected color an allows to open a color selection dialog to change the color. It is suitable widget for selecting a color in a preference dialog.
GtkWidget * gtk_color_button_new (void
);
Creates a new color button.
This returns a widget in the form of a small button containing a swatch representing the current selected color. When the button is clicked, a color-selection dialog will open, allowing the user to select a color. The swatch will be updated to reflect the new color when the user finishes.
Returns : |
a new color button |
Since 2.4
GtkWidget * gtk_color_button_new_with_color (const GdkColor *color
);
Creates a new color button.
|
A GdkColor to set the current color with |
Returns : |
a new color button |
Since 2.4
GtkWidget * gtk_color_button_new_with_rgba (const GdkRGBA *rgba
);
Creates a new color button.
|
A GdkRGBA to set the current color with |
Returns : |
a new color button |
Since 3.0
void gtk_color_button_set_color (GtkColorButton *color_button
,const GdkColor *color
);
Sets the current color to be color
.
|
a GtkColorButton |
|
A GdkColor to set the current color with |
Since 2.4
void gtk_color_button_get_color (GtkColorButton *color_button
,GdkColor *color
);
Sets color
to be the current color in the GtkColorButton widget.
|
a GtkColorButton |
|
a GdkColor to fill in with the current color. [out] |
Since 2.4
void gtk_color_button_set_alpha (GtkColorButton *color_button
,guint16 alpha
);
Sets the current opacity to be alpha
.
|
a GtkColorButton |
|
an integer between 0 and 65535 |
Since 2.4
guint16 gtk_color_button_get_alpha (GtkColorButton *color_button
);
Returns the current alpha value.
|
a GtkColorButton |
Returns : |
an integer between 0 and 65535 |
Since 2.4
void gtk_color_button_set_rgba (GtkColorButton *color_button
,const GdkRGBA *rgba
);
Sets the current color to be rgba
.
|
a GtkColorButton |
|
a GdkRGBA to set the current color with |
Since 3.0
void gtk_color_button_get_rgba (GtkColorButton *color_button
,GdkRGBA *rgba
);
Sets rgba
to be the current color in the GtkColorButton widget.
|
a GtkColorButton |
|
a GdkRGBA to fill in with the current color. [out] |
Since 3.0
void gtk_color_button_set_use_alpha (GtkColorButton *color_button
,gboolean use_alpha
);
Sets whether or not the color button should use the alpha channel.
|
a GtkColorButton |
|
TRUE if color button should use alpha channel, FALSE if not
|
Since 2.4
gboolean gtk_color_button_get_use_alpha (GtkColorButton *color_button
);
Does the color selection dialog use the alpha channel ?
|
a GtkColorButton |
Returns : |
TRUE if the color sample uses alpha channel, FALSE if not
|
Since 2.4
void gtk_color_button_set_title (GtkColorButton *color_button
,const gchar *title
);
Sets the title for the color selection dialog.
|
a GtkColorButton |
|
String containing new window title |
Since 2.4
const gchar * gtk_color_button_get_title (GtkColorButton *color_button
);
Gets the title of the color selection dialog.
|
a GtkColorButton |
Returns : |
An internal string, do not free the return value |
Since 2.4