Gtk.ColorSelection¶

Subclasses:	None

Methods¶

Inherited:	Gtk.Box (14), Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Orientable (2)
Structs:	Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` ()
class	`palette_from_string` (str)
class	`palette_to_string` (colors)
	`get_current_alpha` ()
	`get_current_color` ()
	`get_current_rgba` ()
	`get_has_opacity_control` ()
	`get_has_palette` ()
	`get_previous_alpha` ()
	`get_previous_color` ()
	`get_previous_rgba` ()
	`is_adjusting` ()
	`set_current_alpha` (alpha)
	`set_current_color` (color)
	`set_current_rgba` (rgba)
	`set_has_opacity_control` (has_opacity)
	`set_has_palette` (has_palette)
	`set_previous_alpha` (alpha)
	`set_previous_color` (color)
	`set_previous_rgba` (rgba)

Virtual Methods¶

Inherited:	Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10)

do_color_changed ()

Properties¶

Inherited:	Gtk.Box (3), Gtk.Container (3), Gtk.Widget (39), Gtk.Orientable (1)

Name	Type	Flags	Short Description
`current-alpha`	`int`	r/w	The current opacity value (0 fully transparent, 65535 fully opaque)
`current-color`	`Gdk.Color`	d/r/w	The current color `deprecated`
`current-rgba`	`Gdk.RGBA`	r/w	The current RGBA color
`has-opacity-control`	`bool`	r/w	Whether the color selector should allow setting opacity
`has-palette`	`bool`	r/w	Whether a palette should be used

Child Properties¶

Inherited:	Gtk.Box (5)

Style Properties¶

Inherited:	Gtk.Widget (17)

Signals¶

Inherited:	Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Short Description
`color-changed`	This signal is emitted when the color changes in the `Gtk.ColorSelection` according to its update policy.

Fields¶

Inherited:	Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Type	Access	Description
parent_instance	`Gtk.Box`	r

Class Details¶

class Gtk.ColorSelection(*args, **kwargs)¶

Bases:	`Gtk.Box`
Abstract:	No
Structure:	`Gtk.ColorSelectionClass`

classmethod new()[source]¶

Returns:	a new `Gtk.ColorSelection`
Return type:	`Gtk.Widget`

Creates a new Gtk.ColorSelection.

classmethod palette_from_string(str)[source]¶

Parameters: str (str) – a string encoding a color palette

Returns:

True if a palette was successfully parsed

colors:	return location for allocated array of `Gdk.Color`

Return type: (bool, colors: [Gdk.Color])

Parses a color palette string; the string is a colon-separated list of color names readable by Gdk.Color.parse().

classmethod palette_to_string(colors)[source]¶

Parameters:	colors ([`Gdk.Color`]) – an array of colors
Returns:	allocated string encoding the palette
Return type:	`str`

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

get_current_alpha()[source]¶

Returns:	an integer between 0 and 65535
Return type:	`int`

Returns the current alpha value.

get_current_color()[source]¶

Returns:	a `Gdk.Color` to fill in with the current color
Return type:	color: `Gdk.Color`

Sets color to be the current color in the Gtk.ColorSelection widget.

Deprecated since version 3.4: Use Gtk.ColorSelection.get_current_rgba() instead.

get_current_rgba()[source]¶

Returns:	a `Gdk.RGBA` to fill in with the current color
Return type:	rgba: `Gdk.RGBA`

Sets rgba to be the current color in the Gtk.ColorSelection widget.

New in version 3.0.

get_has_opacity_control()[source]¶

Returns:	`True` if the self has an opacity control, `False` if it does’t
Return type:	`bool`

Determines whether the colorsel has an opacity control.

get_has_palette()[source]¶

Returns:	`True` if the selector has a palette, `False` if it hasn’t
Return type:	`bool`

Determines whether the color selector has a color palette.

get_previous_alpha()[source]¶

Returns:	an integer between 0 and 65535
Return type:	`int`

Returns the previous alpha value.

get_previous_color()[source]¶

Returns:	a `Gdk.Color` to fill in with the original color value
Return type:	color: `Gdk.Color`

Fills color in with the original color value.

Deprecated since version 3.4: Use Gtk.ColorSelection.get_previous_rgba() instead.

get_previous_rgba()[source]¶

Returns:	a `Gdk.RGBA` to fill in with the original color value
Return type:	rgba: `Gdk.RGBA`

Fills rgba in with the original color value.

New in version 3.0.

is_adjusting()[source]¶

Returns:	`True` if the user is currently dragging a color around, and `False` if the selection has stopped
Return type:	`bool`

Gets the current state of the self.

set_current_alpha(alpha)[source]¶

Parameters:	alpha (`int`) – an integer between 0 and 65535

Sets the current opacity to be alpha.

The first time this is called, it will also set the original opacity to be alpha too.

set_current_color(color)[source]¶

Parameters:	color (`Gdk.Color`) – a `Gdk.Color` to set the current color with

Sets the current color to be color.

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

Deprecated since version 3.4: Use Gtk.ColorSelection.set_current_rgba() instead.

set_current_rgba(rgba)[source]¶

Parameters:	rgba (`Gdk.RGBA`) – A `Gdk.RGBA` to set the current color with

Sets the current color to be rgba.

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

New in version 3.0.

set_has_opacity_control(has_opacity)[source]¶

Parameters:	has_opacity (`bool`) – `True` if self can set the opacity, `False` otherwise

Sets the self to use or not use opacity.

set_has_palette(has_palette)[source]¶

Parameters:	has_palette (`bool`) – `True` if palette is to be visible, `False` otherwise

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

set_previous_alpha(alpha)[source]¶

Parameters:	alpha (`int`) – an integer between 0 and 65535

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.

set_previous_color(color)[source]¶

Parameters:	color (`Gdk.Color`) – a `Gdk.Color` to set the previous color with

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.ColorSelection.set_current_color() will also set this color the first time it is called.

Deprecated since version 3.4: Use Gtk.ColorSelection.set_previous_rgba() instead.

set_previous_rgba(rgba)[source]¶

Parameters:	rgba (`Gdk.RGBA`) – a `Gdk.RGBA` to set the previous color with

Sets the “previous” color to be rgba.

This function should be called with some hesitations, as it might seem confusing to have that color change. Calling Gtk.ColorSelection.set_current_rgba() will also set this color the first time it is called.

New in version 3.0.

do_color_changed() virtual¶

Signal Details¶

Gtk.ColorSelection.signals.color_changed(color_selection)¶

Signal Name:	`color-changed`
Flags:	`RUN_FIRST`
Parameters:	color_selection (`Gtk.ColorSelection`) – The object which received the signal

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

Property Details¶

Gtk.ColorSelection.props.current_alpha¶

Name:	`current-alpha`
Type:	`int`
Default Value:	`65535`
Flags:	`READABLE`, `WRITABLE`

The current opacity value (0 fully transparent, 65535 fully opaque)

Gtk.ColorSelection.props.current_color¶

Name:	`current-color`
Type:	`Gdk.Color`
Default Value:	`None`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

The current Gdk.Color color.

Deprecated since version 3.4: Use Gtk.ColorSelection :current-rgba instead.

Gtk.ColorSelection.props.current_rgba¶

Name:	`current-rgba`
Type:	`Gdk.RGBA`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The current RGBA color.

New in version 3.0.

Gtk.ColorSelection.props.has_opacity_control¶

Name:	`has-opacity-control`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Whether the color selector should allow setting opacity

Gtk.ColorSelection.props.has_palette¶

Name:	`has-palette`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Whether a palette should be used