![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkColorButton; GtkWidget* gtk_color_button_new (void); GtkWidget* gtk_color_button_new_with_color (const GdkColor *color); 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_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.
typedef struct { GtkButton button; } GtkColorButton;
The GtkColorButton struct has only private fields and should not be used directly.
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
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. |
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_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