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).
Owner: GtkColorSelection
Flags: Read / Write
Allowed values: <= 65535
Default value: 65535
“current-color”
property“current-color” GdkColor *
The current color.
Owner: GtkColorSelection
Flags: Read / Write
“has-opacity-control”
property “has-opacity-control” gboolean
Whether the color selector should allow setting opacity.
Owner: GtkColorSelection
Flags: Read / Write
Default value: FALSE
“color-changed”
signalvoid user_function (GtkColorSelection *colorselection, gpointer user_data)
Flags: Run First