GtkColorChooserWidget

GtkColorChooserWidget — A widget for choosing colors

Properties

gboolean show-editor Read / Write

Actions

  color.customize (dddd)
  color.select (dddd)

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkColorChooserWidget

Implemented Interfaces

GtkColorChooserWidget implements AtkImplementorIface, GtkBuildable, GtkConstraintTarget and GtkColorChooser.

Includes

#include <gtk/gtk.h>

Description

The GtkColorChooserWidget widget lets the user select a color. By default, the chooser presents a predefined palette of colors, plus a small number of settable custom colors. It is also possible to select a different color with the single-color editor. To enter the single-color editing mode, use the context menu of any color of the palette, or use the '+' button to add a new custom color.

The chooser automatically remembers the last selection, as well as custom colors.

To change the initially selected color, use gtk_color_chooser_set_rgba(). To get the selected color use gtk_color_chooser_get_rgba().

The GtkColorChooserWidget is used in the GtkColorChooserDialog to provide a dialog for selecting colors.

CSS names

GtkColorChooserWidget has a single CSS node with name colorchooser.

Functions

gtk_color_chooser_widget_new ()

GtkWidget *
gtk_color_chooser_widget_new (void);

Creates a new GtkColorChooserWidget.

Returns

a new GtkColorChooserWidget

Types and Values

GtkColorChooserWidget

typedef struct _GtkColorChooserWidget GtkColorChooserWidget;

Property Details

The “show-editor” property

  “show-editor”              gboolean

The ::show-editor property is TRUE when the color chooser is showing the single-color editor. It can be set to switch the color chooser into single-color editing mode.

Owner: GtkColorChooserWidget

Flags: Read / Write

Default value: FALSE

Action Details

The “color.customize” action

Activates the color editor for the given color.

Parameter type: (dddd)

Parameters

red

the red value, between 0 and 1

 

green

the green value, between 0 and 1

 

blue

the blue value, between 0 and 1

 

alpha

the alpha value, between 0 and 1

 

The “color.select” action

Emits the “color-activated” signal for the given color.

Parameter type: (dddd)

Parameters

red

the red value, between 0 and 1

 

green

the green value, between 0 and 1

 

blue

the blue value, between 0 and 1

 

alpha

the alpha value, between 0 and 1