| Top |
| guint | current-alpha | Read / Write |
| GdkColor * | current-color | Read / Write |
| gboolean | has-opacity-control | Read / Write |
| gboolean | has-palette | Read / Write |
GObject
╰── GInitiallyUnowned
╰── GtkObject
╰── GtkWidget
╰── GtkContainer
╰── GtkBox
╰── GtkVBox
╰── GtkColorSelection
GtkColorSelection implements AtkImplementorIface, GtkBuildable and GtkOrientable.
GtkWidget *
gtk_color_selection_new (void);
Creates a new GtkColorSelection.
void gtk_color_selection_set_update_policy (GtkColorSelection *colorsel,GtkUpdateType policy);
gtk_color_selection_set_update_policy is deprecated and should not be used in newly-written code.
void gtk_color_selection_set_has_opacity_control (GtkColorSelection *colorsel,gboolean has_opacity);
Sets the colorsel
to use or not use opacity.
gboolean
gtk_color_selection_get_has_opacity_control
(GtkColorSelection *colorsel);
Determines whether the colorsel has an opacity control.
void gtk_color_selection_set_has_palette (GtkColorSelection *colorsel,gboolean has_palette);
Shows and hides the palette based upon the value of has_palette
.
gboolean
gtk_color_selection_get_has_palette (GtkColorSelection *colorsel);
Determines whether the color selector has a color palette.
guint16
gtk_color_selection_get_current_alpha (GtkColorSelection *colorsel);
Returns the current alpha value.
void gtk_color_selection_set_current_alpha (GtkColorSelection *colorsel,guint16 alpha);
Sets the current opacity to be alpha
. The first time this is called, it will
also set the original opacity to be alpha
too.
void gtk_color_selection_get_current_color (GtkColorSelection *colorsel,GdkColor *color);
Sets color
to be the current color in the GtkColorSelection widget.
void gtk_color_selection_set_current_color (GtkColorSelection *colorsel,const GdkColor *color);
Sets the current color to be color
. The first time this is called, it will
also set the original color to be color
too.
guint16
gtk_color_selection_get_previous_alpha
(GtkColorSelection *colorsel);
Returns the previous alpha value.
void gtk_color_selection_set_previous_alpha (GtkColorSelection *colorsel,guint16 alpha);
Sets the 'previous' alpha to be alpha
. This function should be called with
some hesitations, as it might seem confusing to have that alpha change.
void gtk_color_selection_get_previous_color (GtkColorSelection *colorsel,GdkColor *color);
Fills color
in with the original color value.
void gtk_color_selection_set_previous_color (GtkColorSelection *colorsel,const GdkColor *color);
Sets the 'previous' color to be color
. This function should be called with
some hesitations, as it might seem confusing to have that color change.
Calling gtk_color_selection_set_current_color() will also set this color the first
time it is called.
gboolean
gtk_color_selection_is_adjusting (GtkColorSelection *colorsel);
Gets the current state of the colorsel
.
gboolean gtk_color_selection_palette_from_string (const gchar *str,GdkColor **colors,gint *n_colors);
Parses a color palette string; the string is a colon-separated
list of color names readable by gdk_color_parse().
str |
a string encoding a color palette. |
|
colors |
return location for allocated array of GdkColor. |
[out][array length=n_colors] |
n_colors |
return location for length of array. |
gchar * gtk_color_selection_palette_to_string (const GdkColor *colors,gint n_colors);
Encodes a palette as a string, useful for persistent storage.
GtkColorSelectionChangePaletteFunc
gtk_color_selection_set_change_palette_hook
(GtkColorSelectionChangePaletteFunc func);
gtk_color_selection_set_change_palette_hook has been deprecated since version 2.4 and should not be used in newly-written code.
This function does not work in multihead environments.
Use gtk_color_selection_set_change_palette_with_screen_hook() instead.
Installs a global function to be called whenever the user tries to modify the palette in a color selection. This function should save the new palette contents, and update the GtkSettings property "gtk-color-palette" so all GtkColorSelection widgets will be modified.
void (*GtkColorSelectionChangePaletteFunc) (const GdkColor *colors,gint n_colors);
GtkColorSelectionChangePaletteWithScreenFunc
gtk_color_selection_set_change_palette_with_screen_hook
(GtkColorSelectionChangePaletteWithScreenFunc func);
Installs a global function to be called whenever the user tries to modify the palette in a color selection. This function should save the new palette contents, and update the GtkSettings property "gtk-color-palette" so all GtkColorSelection widgets will be modified.
Since: 2.2
void (*GtkColorSelectionChangePaletteWithScreenFunc) (GdkScreen *screen,const GdkColor *colors,gint n_colors);
void gtk_color_selection_set_color (GtkColorSelection *colorsel,gdouble *color);
gtk_color_selection_set_color has been deprecated since version 2.0 and should not be used in newly-written code.
Use gtk_color_selection_set_current_color() instead.
Sets the current color to be color
. The first time this is called, it will
also set the original color to be color
too.
void gtk_color_selection_get_color (GtkColorSelection *colorsel,gdouble *color);
gtk_color_selection_get_color has been deprecated since version 2.0 and should not be used in newly-written code.
Use gtk_color_selection_get_current_color() instead.
Sets color
to be the current color in the GtkColorSelection widget.
“current-alpha” property “current-alpha” guint
The current opacity value (0 fully transparent, 65535 fully opaque).
Flags: Read / Write
Allowed values: <= 65535
Default value: 65535
“has-opacity-control” property “has-opacity-control” gboolean
Whether the color selector should allow setting opacity.
Flags: Read / Write
Default value: FALSE
“color-changed” signalvoid user_function (GtkColorSelection *colorselection, gpointer user_data)
Flags: Run First