A ColorSelector is a color selection widget. It allows application to set a series of colors.It also allows to load/save colors from/to config with a unique identifier, by default, the colors are loaded/saved from/to config using "default" identifier. The colors can be picked by user from the color set by clicking on individual color item on the palette or by selecting it from selector.

This widget inherits from the Layout one, so that all the functions acting on it also work for check objects.

This widget emits the following signals, besides the ones sent from Elm_Layout:

"changed" - When the color value changes on selector event_info is NULL.
"color,item,selected" - When user clicks on color item. The event_info parameter of the callback will be the selected color item.
"color,item,longpressed" - When user long presses on color item. The event info parameter of the callback contains selected color item.
"focused" - When the colorselector has received focus. (since 1.8)
"unfocused" - When the colorselector has lost focus. (since 1.8)
"language,changed" - the program's language changed (since 1.9)

See Color selector example.

Functions
void	elm_colorselector_color_set (Elm_Colorselector *obj, int r, int g, int b, int a)

void	elm_colorselector_color_get (const Elm_Colorselector obj, int r, int g, int b, int *a)

void	elm_colorselector_palette_name_set (Elm_Colorselector obj, const char palette_name)

const char *	elm_colorselector_palette_name_get (const Elm_Colorselector *obj)

void	elm_colorselector_mode_set (Elm_Colorselector *obj, Elm_Colorselector_Mode mode)

Elm_Colorselector_Mode	elm_colorselector_mode_get (const Elm_Colorselector *obj)

const Eina_List *	elm_colorselector_palette_items_get (const Elm_Colorselector *obj)

Elm_Widget_Item *	elm_colorselector_palette_color_add (Elm_Colorselector *obj, int r, int g, int b, int a)

void	elm_colorselector_palette_clear (Elm_Colorselector *obj)

Evas_Object *	elm_colorselector_add (Evas_Object *parent)
	Add a new colorselector to the parent.

Enumeration Type Documentation

enum Elm_Colorselector_Mode

Enumerator:

ELM_COLORSELECTOR_PALETTE	Only color palette is displayed, default
ELM_COLORSELECTOR_COMPONENTS	Only color selector is displayed
ELM_COLORSELECTOR_BOTH	Both Palette and selector is displayed
ELM_COLORSELECTOR_PICKER	Only color picker is displayed
ELM_COLORSELECTOR_PLANE	Deprecated: This mode is not supported. If you use this, nothing will be shown
ELM_COLORSELECTOR_PALETTE_PLANE	Deprecated: This mode is not supported. If you use this, it will be shown same with ELM_COLORSELECTOR_PALETTE mode
ELM_COLORSELECTOR_ALL	Deprecated: This mode is not supported. If you use this, it will be shown same with ELM_COLORSELECTOR_PALETTE mode

Function Documentation

Evas_Object* elm_colorselector_add ( Evas_Object * parent )

Add a new colorselector to the parent.

Parameters:

parent The parent object

Returns:: The new object or NULL if it cannot be created

Since :: 2.3

void elm_colorselector_color_get	(	const Elm_Colorselector *	obj,
		int *	r,
		int *	g,
		int *	b,
		int *	a
	)

Get current color from colorselector.

Since :: 2.3

Parameters:

[out]	r	r-value of color
[out]	g	g-value of color
[out]	b	b-value of color
[out]	a	a-value of color

void elm_colorselector_color_set	(	Elm_Colorselector *	obj,
		int	r,
		int	g,
		int	b,
		int	a
	)

Set color to colorselector.

Since :: 2.3

Parameters:

[in]	r	r-value of color
[in]	g	g-value of color
[in]	b	b-value of color
[in]	a	a-value of color

Elm_Colorselector_Mode elm_colorselector_mode_get ( const Elm_Colorselector * obj )

Get Colorselector's mode.

Since :: 2.3

Returns:: Elm_Colorselector_Mode

void elm_colorselector_mode_set	(	Elm_Colorselector *	obj,
		Elm_Colorselector_Mode	mode
	)

Set Colorselector's mode.

Colorselector supports three modes palette only, selector only and both. Only palette mode is supported in Tizen 3.0.

Since :: 2.3

Parameters:

[in] mode Elm_Colorselector_Mode

void elm_colorselector_palette_clear ( Elm_Colorselector * obj )

Clear the palette items.

Since :: 2.3

Elm_Widget_Item* elm_colorselector_palette_color_add	(	Elm_Colorselector *	obj,
		int	r,
		int	g,
		int	b,
		int	a
	)

Add a new color item to palette.

Since :: 2.3

Parameters:

[in]	g	g-value of color
[in]	b	b-value of color
[in]	a	a-value of color

Returns:: A new color palette Item.

const Eina_List* elm_colorselector_palette_items_get ( const Elm_Colorselector * obj )

Get list of palette items.

Note That palette item list is internally managed by colorselector widget and it should not be freed/modified by application.

Since :: 2.3

Returns:: The list of color palette items.

Since (EFL) :: 1.9

const char* elm_colorselector_palette_name_get ( const Elm_Colorselector * obj )

Get current palette's name

Returns the currently set palette name using which colors will be saved/loaded in to config.

Since :: 2.3

Returns:: Name of palette

void elm_colorselector_palette_name_set	(	Elm_Colorselector *	obj,
		const char *	palette_name
	)

Set current palette's name

When colorpalette name is set, colors will be loaded from and saved to config using the set name. If no name is set then colors will be loaded from or saved to "default" config.

Since :: 2.3

Parameters:

[in] palette_name Name of palette

Functions

Enumeration Type Documentation

Function Documentation