Tizen Native API
5.0
|
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 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)
Functions | |
void | elm_colorselector_color_set (Elm_Colorselector *obj, int r, int g, int b, int a) |
Set color to colorselector. | |
void | elm_colorselector_color_get (const Elm_Colorselector *obj, int *r, int *g, int *b, int *a) |
Get current color from colorselector. | |
void | elm_colorselector_palette_name_set (Elm_Colorselector *obj, const char *palette_name) |
Set current palette's name. | |
const char * | elm_colorselector_palette_name_get (const Elm_Colorselector *obj) |
Get current palette's name. | |
void | elm_colorselector_mode_set (Elm_Colorselector *obj, Elm_Colorselector_Mode mode) |
Set Colorselector's mode. | |
Elm_Colorselector_Mode | elm_colorselector_mode_get (const Elm_Colorselector *obj) |
Get Colorselector's mode. | |
const Eina_List * | elm_colorselector_palette_items_get (const Elm_Colorselector *obj) |
Get list of palette items. | |
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. | |
void | elm_colorselector_palette_clear (Elm_Colorselector *obj) |
void | elm_colorselector_palette_item_color_get (const Elm_Object_Item *it, int *r, int *g, int *b, int *a) |
Get Palette item's color. | |
void | elm_colorselector_palette_item_color_set (Elm_Object_Item *it, int r, int g, int b, int a) |
Set palette item's color. | |
Eina_Bool | elm_colorselector_palette_item_selected_get (const Elm_Object_Item *it) |
Get the selected state of color palette item. | |
void | elm_colorselector_palette_item_selected_set (Elm_Object_Item *it, Eina_Bool selected) |
Set the selected state of color palette item. | |
Evas_Object * | elm_colorselector_add (Evas_Object *parent) |
Add a new colorselector to the parent. |
Enumeration Type Documentation
Different modes supported by Colorselector.
See also elm_colorselector_mode_set, elm_colorselector_mode_get.
- Enumerator:
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
- Examples:
- colorselector_example_01.c.
void elm_colorselector_color_get | ( | const Elm_Colorselector * | obj, |
int * | r, | ||
int * | g, | ||
int * | b, | ||
int * | a | ||
) |
Get current color from colorselector.
- Parameters:
-
[in] obj The object. [out] r Red value of color [out] g Green value of color [out] b Blue value of color [out] a Alpha value of color
- Since :
- 2.3
- Examples:
- colorselector_example_01.c.
void elm_colorselector_color_set | ( | Elm_Colorselector * | obj, |
int | r, | ||
int | g, | ||
int | b, | ||
int | a | ||
) |
Set color to colorselector.
- Parameters:
-
[in] obj The object. [in] r Red value of color [in] g Green value of color [in] b Blue value of color [in] a Alpha value of color
- Since :
- 2.3
- Examples:
- colorselector_example_01.c.
Elm_Colorselector_Mode elm_colorselector_mode_get | ( | const Elm_Colorselector * | obj | ) |
Get Colorselector's mode.
- Parameters:
-
[in] obj The object.
- Returns:
- Elm_Colorselector_Mode
- Since :
- 2.3
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.
- Parameters:
-
[in] obj The object. [in] mode Elm_Colorselector_Mode
- Since :
- 2.3
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.
- Parameters:
-
[in] obj The object. [in] r Red value of color [in] g Green value of color [in] b Blue value of color [in] a Alpha value of color
- Returns:
- A new color palette Item.
- Since :
- 2.3
void elm_colorselector_palette_item_color_get | ( | const Elm_Object_Item * | it, |
int * | r, | ||
int * | g, | ||
int * | b, | ||
int * | a | ||
) |
Get Palette item's color.
- Parameters:
-
[in] it The color palette item. [out] r integer pointer for r-value of color [out] g integer pointer for g-value of color [out] b integer pointer for b-value of color [out] a integer pointer for a-value of color
- Since :
- 2.3
- Examples:
- colorselector_example_01.c.
void elm_colorselector_palette_item_color_set | ( | Elm_Object_Item * | it, |
int | r, | ||
int | g, | ||
int | b, | ||
int | a | ||
) |
Set palette item's color.
- Parameters:
-
[in] it The color palette item. [in] r r-value of color [in] g g-value of color [in] b b-value of color [in] a a-value of color
- Since :
- 2.3
Get the selected state of color palette item.
- Parameters:
-
[in] it The colorpalette item
- Returns:
EINA_TRUE
if the item is selected,EINA_FALSE
otherwise.
- Since :
- 3.0
void elm_colorselector_palette_item_selected_set | ( | Elm_Object_Item * | it, |
Eina_Bool | selected | ||
) |
Set the selected state of color palette item.
- Parameters:
-
[in] it The colorpalette item [in] selected The selected state
- Since :
- 3.0
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.
- Parameters:
-
[in] obj The object.
- Returns:
- The list of color palette items.
- Since (EFL) :
- 1.9
- Since :
- 2.3
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.
- Parameters:
-
[in] obj The object.
- Returns:
- Name of palette
- Since :
- 2.3
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.
- Parameters:
-
[in] obj The object. [in] palette_name Name of palette
- Since :
- 2.3
- Examples:
- colorselector_example_01.c.