GtkColorSelection

Name

GtkColorSelection -- a widget used to select a color.

Synopsis


#include <gtk/gtk.h>


struct      GtkColorSelection;
GtkWidget*  gtk_color_selection_new         (void);
void        gtk_color_selection_set_update_policy
                                            (GtkColorSelection *colorsel,
                                             GtkUpdateType policy);
void        gtk_color_selection_set_has_opacity_control
                                            (GtkColorSelection *colorsel,
                                             gboolean has_opacity);
gboolean    gtk_color_selection_get_has_opacity_control
                                            (GtkColorSelection *colorsel);
void        gtk_color_selection_set_has_palette
                                            (GtkColorSelection *colorsel,
                                             gboolean has_palette);
gboolean    gtk_color_selection_get_has_palette
                                            (GtkColorSelection *colorsel);
guint16     gtk_color_selection_get_current_alpha
                                            (GtkColorSelection *colorsel);
void        gtk_color_selection_set_current_alpha
                                            (GtkColorSelection *colorsel,
                                             guint16 alpha);
void        gtk_color_selection_get_current_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
void        gtk_color_selection_set_current_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
guint16     gtk_color_selection_get_previous_alpha
                                            (GtkColorSelection *colorsel);
void        gtk_color_selection_set_previous_alpha
                                            (GtkColorSelection *colorsel,
                                             guint16 alpha);
void        gtk_color_selection_get_previous_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
void        gtk_color_selection_set_previous_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
gboolean    gtk_color_selection_is_adjusting
                                            (GtkColorSelection *colorsel);
gboolean    gtk_color_selection_palette_from_string
                                            (const gchar *str,
                                             GdkColor **colors,
                                             gint *n_colors);
gchar*      gtk_color_selection_palette_to_string
                                            (const GdkColor *colors,
                                             gint n_colors);
GtkColorSelectionChangePaletteFunc gtk_color_selection_set_change_palette_hook
                                            (GtkColorSelectionChangePaletteFunc func);
void        (*GtkColorSelectionChangePaletteFunc)
                                            (const GdkColor *colors,
                                             gint n_colors);
void        gtk_color_selection_set_color   (GtkColorSelection *colorsel,
                                             gdouble *color);
void        gtk_color_selection_get_color   (GtkColorSelection *colorsel,
                                             gdouble *color);


Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBox
                           +----GtkVBox
                                 +----GtkColorSelection

Properties


  "has-palette"          gboolean             : Read / Write
  "has-opacity-control"  gboolean             : Read / Write
  "current-color"        GdkColor             : Read / Write
  "current-alpha"        guint                : Read / Write

Signal Prototypes


"color-changed"
            void        user_function      (GtkColorSelection *colorselection,
                                            gpointer user_data);

Description

The GtkColorSelection is a widget that is used to select a color. It consists of a color wheel and number of sliders and 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 GtkColorSelectionDialog.

Details

struct GtkColorSelection

struct GtkColorSelection;

The GtkColorSelection struct contains private data only, and should be accessed using the functions below.


gtk_color_selection_new ()

GtkWidget*  gtk_color_selection_new         (void);

Creates a new GtkColorSelection.


gtk_color_selection_set_update_policy ()

void        gtk_color_selection_set_update_policy
                                            (GtkColorSelection *colorsel,
                                             GtkUpdateType policy);

Warning

gtk_color_selection_set_update_policy is deprecated and should not be used in newly-written code.

Sets the policy controlling when the color_changed signals are emitted. The available policies are:


gtk_color_selection_set_has_opacity_control ()

void        gtk_color_selection_set_has_opacity_control
                                            (GtkColorSelection *colorsel,
                                             gboolean has_opacity);

Sets the colorsel to use or not use opacity.


gtk_color_selection_get_has_opacity_control ()

gboolean    gtk_color_selection_get_has_opacity_control
                                            (GtkColorSelection *colorsel);

Determines whether the colorsel has an opacity control.


gtk_color_selection_set_has_palette ()

void        gtk_color_selection_set_has_palette
                                            (GtkColorSelection *colorsel,
                                             gboolean has_palette);

Shows and hides the palette based upon the value of has_palette.


gtk_color_selection_get_has_palette ()

gboolean    gtk_color_selection_get_has_palette
                                            (GtkColorSelection *colorsel);

Determines whether the color selector has a color palette.


gtk_color_selection_get_current_alpha ()

guint16     gtk_color_selection_get_current_alpha
                                            (GtkColorSelection *colorsel);

Returns the maximum number of palette colors.


gtk_color_selection_set_current_alpha ()

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.


gtk_color_selection_get_current_color ()

void        gtk_color_selection_get_current_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);

Sets color to be the current color in the GtkColorSelection widget.


gtk_color_selection_set_current_color ()

void        gtk_color_selection_set_current_color
                                            (GtkColorSelection *colorsel,
                                             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.


gtk_color_selection_get_previous_alpha ()

guint16     gtk_color_selection_get_previous_alpha
                                            (GtkColorSelection *colorsel);

Returns the previous alpha value.


gtk_color_selection_set_previous_alpha ()

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.


gtk_color_selection_get_previous_color ()

void        gtk_color_selection_get_previous_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);

Fills color in with the original color value.


gtk_color_selection_set_previous_color ()

void        gtk_color_selection_set_previous_color
                                            (GtkColorSelection *colorsel,
                                             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.


gtk_color_selection_is_adjusting ()

gboolean    gtk_color_selection_is_adjusting
                                            (GtkColorSelection *colorsel);

Gets the current state of the colorsel.


gtk_color_selection_palette_from_string ()

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().


gtk_color_selection_palette_to_string ()

gchar*      gtk_color_selection_palette_to_string
                                            (const GdkColor *colors,
                                             gint n_colors);

Encodes a palette as a string, useful for persistent storage.


gtk_color_selection_set_change_palette_hook ()

GtkColorSelectionChangePaletteFunc gtk_color_selection_set_change_palette_hook
                                            (GtkColorSelectionChangePaletteFunc 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.


GtkColorSelectionChangePaletteFunc ()

void        (*GtkColorSelectionChangePaletteFunc)
                                            (const GdkColor *colors,
                                             gint n_colors);


gtk_color_selection_set_color ()

void        gtk_color_selection_set_color   (GtkColorSelection *colorsel,
                                             gdouble *color);

Warning

gtk_color_selection_set_color is deprecated and should not be used in newly-written code.

Sets the current color to be color. The first time this is called, it will also set the original color to be color too.

This function is deprecated, use gtk_color_selection_set_current_color() instead.


gtk_color_selection_get_color ()

void        gtk_color_selection_get_color   (GtkColorSelection *colorsel,
                                             gdouble *color);

Warning

gtk_color_selection_get_color is deprecated and should not be used in newly-written code.

Sets color to be the current color in the GtkColorSelection widget.

This function is deprecated, use gtk_color_selection_get_current_color() instead.

Properties

"has-palette" (gboolean : Read / Write)

"has-opacity-control" (gboolean : Read / Write)

"current-color" (GdkColor : Read / Write)

"current-alpha" (guint : Read / Write)

Signals

The "color-changed" signal

void        user_function                  (GtkColorSelection *colorselection,
                                            gpointer user_data);

This signal is emitted when the color changes in the GtkColorSelection according to its update policy.