Edje Text example

This example shows how to manipulate TEXT and TEXTBLOCK parts from code.

The very first we are going to do is register a callback to react to changes in the text of our parts:

edje_object_text_change_cb_set(edje_obj, _on_text_change, NULL);
_on_text_change(void *data EINA_UNUSED, Evas_Object *obj, const char *part)
#define EINA_UNUSED
Used to indicate that a function parameter is purposely unused.
Definition: eina_types.h:339
Efl_Canvas_Object Evas_Object
An Evas Object handle.
Definition: Evas_Common.h:185
Note
Since edje_obj represent a group we'll be notified whenever any part's text in that group changes.

We now set the text for two our two parts:

edje_object_part_text_set(edje_obj, "part_two", "<b>Click here");
Eina_Bool edje_object_part_text_set(const Evas_Object *obj, const char *part, const char *text)
Sets a given text to an Edje object TEXT or TEXTBLOCK parts.
Definition: edje_util.c:6723
Note
Since the "part_two" part is a TEXTBLOCK we can use formatting such as <b>

And we now move on to selection issues, first thing we do is make sure the user can select text:

void edje_object_part_text_select_allow_set(const Evas_Object *obj, const char *part, Eina_Bool allow)
Enables selection if the entry is an EXPLICIT selection mode type.
Definition: edje_util.c:2454
#define EINA_TRUE
boolean value TRUE (numerical value 1)
Definition: eina_types.h:539

We then select the entire text, and print the selected text:

printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj, "part_two"));
const char * edje_object_part_text_selection_get(const Evas_Object *obj, const char *part)
Returns the selection text of the object part.
Definition: edje_util.c:2387

We now unselect the entire text(set selection to none), and print the selected text:

edje_object_part_text_select_none(edje_obj, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj, "part_two"));
void edje_object_part_text_select_none(const Evas_Object *obj, const char *part)
Sets the selection to be none.
Definition: edje_util.c:2404

Our example will look like this:

The full source code follows:

#ifdef HAVE_CONFIG_H
# include "config.h"
#else
# define EINA_UNUSED
#endif
#ifndef PACKAGE_DATA_DIR
#define PACKAGE_DATA_DIR "."
#endif
#include <Ecore.h>
#include <Ecore_Evas.h>
#include <Edje.h>
#include <locale.h>
#include "Eo.h"
#define WIDTH (500)
#define HEIGHT (500)
static int lang_idx = 0;
static const char *lang[] = {
"en_IN",
"ta_IN",
"hi_IN"
};
static void
_on_delete(Ecore_Evas *ee EINA_UNUSED)
{
}
static void
_on_text_change(void *data EINA_UNUSED, Evas_Object *obj, const char *part)
{
char *str = edje_object_part_text_unescaped_get(obj, part);
printf("text: %s\n", str);
free(str);
}
static void
_on_mouse_down(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *o, void *event_info EINA_UNUSED)
{
static char envbuf[20]; // doesn't have to be static, but a good habit
char *env;
lang_idx = (lang_idx + 1) % (sizeof (lang) / sizeof (lang[0]));
fprintf(stderr, "Setting lang of this edje object to '%s'\n", lang[lang_idx]);
// unfortunately dealing with env vars portably means using putenv()
// which has issues that lead to complexity like below. the envbuf is
// static because in general it's a good habit when dealing with putenv()
// but in this case it doesn't need to be. it's good to show good habits
// at any rate. read up pn putenv() and how it takes the string pointer
// directly into the env and takes "ownership" (but will never actually
// free it if its an allocated string etc.).
env = getenv("LANGUAGE");
if (env) env = strdup(env);
snprintf(envbuf, sizeof(envbuf), "LANGUAGE=%s", lang[lang_idx]);
putenv(envbuf);
edje_object_language_set(o, lang[lang_idx]);
snprintf(envbuf, sizeof(envbuf), "LANGUAGE=%s", env ? env : "");
putenv(envbuf);
free(env);
}
static void
_on_mouse_down_text(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *o EINA_UNUSED, void *event_info EINA_UNUSED)
{
static char *env_lang_str = NULL;
char *s;
lang_idx = (lang_idx + 1) % (sizeof (lang)/ sizeof (lang[0]));
fprintf(stderr, "Setting lang to '%s'\n", lang[lang_idx]);
s = malloc(10 + strlen(lang[lang_idx]));
if (s)
{
strcpy(s, "LANGUAGE=");
strcpy(s + 9, lang[lang_idx]);
putenv(s);
if (env_lang_str) free(env_lang_str);
env_lang_str = s;
}
edje_language_set(lang[lang_idx]);
}
int
main(int argc EINA_UNUSED, char *argv[] EINA_UNUSED)
{
const char *edje_file = PACKAGE_DATA_DIR"/text.edj";
Ecore_Evas *ee;
Evas *evas;
Evas_Object *edje_obj;
Evas_Object *edje_obj_one;
Evas_Object *edje_obj_two;
Evas_Object *edje_obj_three;
return EXIT_FAILURE;
if (!edje_init())
goto shutdown_ecore_evas;
/* this will give you a window with an Evas canvas under the first
* engine available */
ee = ecore_evas_new(NULL, 0, 0, WIDTH, HEIGHT, NULL);
if (!ee) goto shutdown_edje;
ecore_evas_title_set(ee, "Edje Text Example");
evas = ecore_evas_get(ee);
evas_object_color_set(bg, 255, 255, 255, 255); /* white bg */
evas_object_move(bg, 0, 0); /* at canvas' origin */
evas_object_resize(bg, WIDTH, HEIGHT); /* covers full canvas */
ecore_evas_object_associate(ee, bg, ECORE_EVAS_OBJECT_ASSOCIATE_BASE);
edje_obj = edje_object_add(evas);
edje_object_file_set(edje_obj, edje_file, "example_group");
evas_object_move(edje_obj, 0, 20);
evas_object_resize(edje_obj, WIDTH - 40, HEIGHT - 40);
evas_object_show(edje_obj);
putenv("LANGUAGE=en_IN");
edje_object_language_set(edje_obj, "en_IN");
edje_object_text_change_cb_set(edje_obj, _on_text_change, NULL);
edje_object_part_text_set(edje_obj, "part_two", "<b>Click here");
edje_object_part_text_select_all(edje_obj, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj, "part_two"));
edje_object_part_text_select_none(edje_obj, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj, "part_two"));
evas_object_event_callback_add(edje_obj, EVAS_CALLBACK_MOUSE_DOWN, _on_mouse_down, NULL);
edje_obj_one = edje_object_add(evas);
edje_object_file_set(edje_obj_one, edje_file, "example_group1");
evas_object_move(edje_obj_one, 0, 50);
evas_object_resize(edje_obj_one, WIDTH - 40, HEIGHT - 40);
evas_object_show(edje_obj_one);
edje_object_language_set(edje_obj_one, "en_IN");
edje_object_text_change_cb_set(edje_obj_one, _on_text_change, NULL);
edje_object_part_text_set(edje_obj_one, "part_two", "<b>Click here");
edje_object_part_text_select_all(edje_obj_one, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj_one, "part_two"));
edje_object_part_text_select_none(edje_obj_one, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj_one, "part_two"));
evas_object_event_callback_add(edje_obj_one, EVAS_CALLBACK_MOUSE_DOWN, _on_mouse_down, NULL);
//Generic Language change
edje_obj_two = edje_object_add(evas);
edje_object_file_set(edje_obj_two, edje_file, "example_group2");
evas_object_move(edje_obj_two, 0, 250);
evas_object_resize(edje_obj_two, WIDTH - 40, HEIGHT - 40);
evas_object_show(edje_obj_two);
edje_object_text_change_cb_set(edje_obj_two, _on_text_change, NULL);
edje_object_part_text_set(edje_obj_two, "part_two", "<b>Click here");
edje_object_part_text_select_all(edje_obj_two, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj_two, "part_two"));
edje_object_part_text_select_none(edje_obj_two, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj_two, "part_two"));
evas_object_event_callback_add(edje_obj_two, EVAS_CALLBACK_MOUSE_DOWN, _on_mouse_down_text, NULL);
edje_obj_three = edje_object_add(evas);
edje_object_file_set(edje_obj_three, edje_file, "example_group3");
evas_object_move(edje_obj_three, 0, 350);
evas_object_resize(edje_obj_three, WIDTH - 40, HEIGHT - 40);
evas_object_show(edje_obj_three);
edje_object_text_change_cb_set(edje_obj_three, _on_text_change, NULL);
edje_object_part_text_set(edje_obj_three, "part_two", "<b>Click here");
edje_object_part_text_select_allow_set(edje_obj_three, "part_two", EINA_TRUE);
edje_object_part_text_select_all(edje_obj_three, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj_three, "part_two"));
edje_object_part_text_select_none(edje_obj_three, "part_two");
printf("selection: %s\n", edje_object_part_text_selection_get(edje_obj_three, "part_two"));
evas_object_event_callback_add(edje_obj_three, EVAS_CALLBACK_MOUSE_DOWN, _on_mouse_down_text, NULL);
return EXIT_SUCCESS;
shutdown_edje:
shutdown_ecore_evas:
return EXIT_FAILURE;
}
Evas wrapper functions.
Edje Graphical Design Library.
@ EVAS_CALLBACK_MOUSE_DOWN
Mouse Button Down Event.
Definition: Evas_Common.h:422
EAPI int ecore_evas_init(void)
Inits the Ecore_Evas system.
Definition: ecore_evas.c:602
EAPI void ecore_evas_title_set(Ecore_Evas *ee, const char *t)
Sets the title of an Ecore_Evas' window.
Definition: ecore_evas.c:1527
EAPI void ecore_evas_callback_delete_request_set(Ecore_Evas *ee, Ecore_Evas_Event_Cb func)
Sets a callback for Ecore_Evas delete request events.
Definition: ecore_evas.c:1176
EAPI void ecore_evas_show(Ecore_Evas *ee)
Shows an Ecore_Evas' window.
Definition: ecore_evas.c:1480
EAPI Evas * ecore_evas_get(const Ecore_Evas *ee)
Gets an Ecore_Evas's Evas.
Definition: ecore_evas.c:1300
EAPI Ecore_Evas * ecore_evas_new(const char *engine_name, int x, int y, int w, int h, const char *extra_options)
Creates a new Ecore_Evas based on engine name and common parameters.
Definition: ecore_evas.c:1039
EAPI int ecore_evas_shutdown(void)
Shuts down the Ecore_Evas system.
Definition: ecore_evas.c:666
EAPI Eina_Bool ecore_evas_object_associate(Ecore_Evas *ee, Evas_Object *obj, Ecore_Evas_Object_Associate_Flags flags)
Associates the given object to this ecore evas.
Definition: ecore_evas_util.c:223
EAPI void ecore_evas_free(Ecore_Evas *ee)
Frees an Ecore_Evas.
Definition: ecore_evas.c:1083
void ecore_main_loop_quit(void)
Quits the main loop once all the events currently on the queue have been processed.
Definition: ecore_main.c:1321
void ecore_main_loop_begin(void)
Runs the application main loop.
Definition: ecore_main.c:1311
int edje_shutdown(void)
Shuts down the Edje library.
Definition: edje_main.c:262
int edje_init(void)
Initializes the Edje library.
Definition: edje_main.c:35
void edje_language_set(const char *locale)
Sets Edje language.
Definition: edje_util.c:321
Evas_Object * edje_object_add(Evas *evas)
Instantiates a new Edje object.
Definition: edje_smart.c:22
Eina_Bool edje_object_file_set(Evas_Object *obj, const char *file, const char *group)
Sets the EDJ file (and group within it) to load an Edje object's contents from.
Definition: edje_smart.c:467
void edje_object_language_set(Edje_Object *obj, const char *language)
Sets the language for this object.
Definition: edje_legacy.c:199
char * edje_object_part_text_unescaped_get(const Eo *obj, const char *part)
Returns the text of the object part, without escaping.
Definition: edje_legacy.c:974
void edje_object_part_text_select_all(const Evas_Object *obj, const char *part)
Sets the selection to be everything.
Definition: edje_util.c:2419
Eo Evas
An opaque handle to an Evas canvas.
Definition: Evas_Common.h:163
EVAS_API void evas_object_show(Evas_Object *eo_obj)
Makes the given Evas object visible.
Definition: evas_object_main.c:1814
EVAS_API void evas_object_color_set(Evas_Object *obj, int r, int g, int b, int a)
Sets the general/main color of the given Evas object to the given one.
Definition: evas_object_main.c:2024
EVAS_API void evas_object_event_callback_add(Evas_Object *eo_obj, Evas_Callback_Type type, Evas_Object_Event_Cb func, const void *data)
Add (register) a callback function to a given Evas object event.
Definition: evas_callbacks.c:478
EVAS_API void evas_object_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y)
Move the given Evas object to the given location inside its canvas' viewport.
Definition: evas_object_main.c:1171
EVAS_API void evas_object_resize(Evas_Object *obj, Evas_Coord w, Evas_Coord h)
Changes the size of the given Evas object.
Definition: evas_object_main.c:1236
EVAS_API Evas_Object * evas_object_rectangle_add(Evas *e)
Adds a rectangle to the given evas.
Definition: evas_object_rectangle.c:78

The theme used in this example is:

efl_version: 1 22;
collections {
group {
name: "sel_group";
parts {
part {
name: "rect";
type: RECT;
description {
state: "default" 0.0;
color: 0 255 0 255; /* green */
rel1.relative: 0.0 0.0;
rel2.relative: 1.0 1.0;
}
}
}
}
group {
name: "example_group";
max: 500 500;
min: 50 50;
translation {
file {
locale: en_IN;
source: domain_name.po; /* Can be either .po file or .mo file*/
}
file {
locale: hi_IN;
source: domain_name.po;
}
file {
locale: ta_IN;
source: domain_name.po;
}
}
styles {
style {
name: "textblock_style_en";
base: "font=Sans font_size=22 color=#f00 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_ta";
base: "font=Sans font_size=22 color=#000 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_hi";
base: "font=Sans font_size=22 color=#00f wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
}
parts {
part {
name: "part_one";
type: TEXT;
description {
min: 50 50;
state: "default" 0.0;
color: 0 0 255 255; /* blue */
rel1.relative: 0.5 0.0;
rel2.relative: 0.5 0.0;
text {
text : "LOADING";
domain: "domain_name";
font: "arial";
size: 22;
min: 1 1;
ellipsis: -1;
}
}
}
part {
name: "part_two";
type: TEXTBLOCK;
select_mode: EXPLICIT;
source: "sel_group";
entry_mode: PLAIN;
description {
min: 50 50;
state: "default" 0.0;
rel1.relative: 0.0 0.25;
rel2.relative: 0.5 0.0;
text {
style: "textblock_style_en";
min: 1 1;
ellipsis: -1;
}
}
description {
inherit: "default" 0.0;
state: "one" 0.0;
text {
style: "textblock_style_hi";
min: 1 1;
}
}
description {
inherit: "default" 0.0;
state: "two" 0.0;
text {
style: "textblock_style_ta";
min: 1 1;
}
}
}
}
programs {
program {
signal: "edje,language,hi_IN";
source: "edje";
script {
set_state(PART:"part_two", "one", 1.0);
}
}
program {
signal: "edje,language,ta_IN";
source: "edje";
script {
set_state(PART:"part_two", "two", 1.0);
}
}
program {
signal: "edje,language,en_IN";
source: "edje";
script {
set_state(PART:"part_two", "default", 1.0);
}
}
}
}
group {
name: "example_group1";
max: 500 500;
min: 50 50;
translation {
file {
locale: en_IN;
source: domain_name.po;
}
file {
locale: hi_IN;
source: domain_name.po;
}
file {
locale: ta_IN;
source: domain_name.mo;
}
}
styles {
style {
name: "textblock_style_en1";
base: "font=Sans font_size=22 color=#f00 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_ta1";
base: "font=Sans font_size=22 color=#000 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_hi1";
base: "font=Sans font_size=22 color=#00f wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
}
parts {
part {
name: "part_one";
type: TEXT;
description {
min: 50 50;
state: "default" 0.0;
color: 0 0 255 255; /* blue */
rel1.relative: 0.5 0.25;
rel2.relative: 0.5 0.0;
text {
text : "LANG";
domain: "domain_name";
font: "arial";
size: 22;
min: 1 1;
ellipsis: -1;
}
}
}
part {
name: "part_two";
type: TEXTBLOCK;
select_mode: EXPLICIT;
source: "sel_group";
entry_mode: PLAIN;
description {
min: 50 50;
state: "default" 0.0;
rel1.relative: 0.0 0.5;
rel2.relative: 1.0 0.0;
text {
style: "textblock_style_en1";
min: 1 1;
ellipsis: -1;
}
}
description {
inherit: "default" 0.0;
state: "one" 0.0;
text {
style: "textblock_style_hi1";
min: 1 1;
}
}
description {
inherit: "default" 0.0;
state: "two" 0.0;
text {
style: "textblock_style_ta1";
min: 1 1;
}
}
}
}
programs {
program {
signal: "edje,language,hi_IN";
source: "edje";
script {
set_state(PART:"part_two", "one", 1.0);
}
}
program {
signal: "edje,language,ta_IN";
source: "edje";
script {
set_state(PART:"part_two", "two", 1.0);
}
}
program {
signal: "edje,language,en_IN";
source: "edje";
script {
set_state(PART:"part_two", "default", 1.0);
}
}
}
}
group {
name: "example_group2";
max: 500 500;
min: 50 50;
translation {
file {
locale: en_IN;
source: domain_name.po;
}
file {
locale: hi_IN;
source: domain_name.po;
}
file {
locale: ta_IN;
source: domain_name.mo;
}
}
styles {
style {
name: "textblock_style_en2";
base: "font=Sans font_size=22 color=#f00 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_ta2";
base: "font=Sans font_size=22 color=#000 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_hi2";
base: "font=Sans font_size=22 color=#00f wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
}
parts {
part {
name: "part_one";
type: TEXT;
description {
min: 50 50;
state: "default" 0.0;
color: 0 0 255 255; /* blue */
rel1.relative: 0.5 0.25;
rel2.relative: 0.5 0.0;
text {
text : "SYSTEM LANGUAGE";
domain: "domain_name";
font: "arial";
size: 22;
min: 1 1;
ellipsis: -1;
}
}
}
part {
name: "part_two";
type: TEXTBLOCK;
select_mode: EXPLICIT;
source: "sel_group";
entry_mode: PLAIN;
description {
min: 50 50;
state: "default" 0.0;
rel1.relative: 0.0 0.5;
rel2.relative: 1.0 0.0;
text {
style: "textblock_style_en2";
min: 1 1;
ellipsis: -1;
}
}
description {
inherit: "default" 0.0;
state: "one" 0.0;
text {
style: "textblock_style_hi2";
min: 1 1;
}
}
description {
inherit: "default" 0.0;
state: "two" 0.0;
text {
style: "textblock_style_ta2";
min: 1 1;
}
}
}
}
programs {
program {
signal: "edje,language,hi_IN";
source: "edje";
script {
set_state(PART:"part_two", "one", 1.0);
}
}
program {
signal: "edje,language,ta_IN";
source: "edje";
script {
set_state(PART:"part_two", "two", 1.0);
}
}
program {
signal: "edje,language,en_IN";
source: "edje";
script {
set_state(PART:"part_two", "default", 1.0);
}
}
}
}
group {
name: "example_group3";
max: 500 500;
min: 50 50;
translation {
file {
locale: en_IN;
source: domain_name.po;
}
file {
locale: hi_IN;
source: domain_name.po;
}
file {
locale: ta_IN;
source: domain_name.mo;
}
}
styles {
style {
name: "textblock_style_en3";
base: "font=Sans font_size=22 color=#f00 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_ta3";
base: "font=Sans font_size=22 color=#000 wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
style {
name: "textblock_style_hi3";
base: "font=Sans font_size=22 color=#00f wrap=word";
tag: "br" "\n";
tag: "hilight" "+ font_weight=Bold";
tag: "b" "+ font_weight=Bold";
tag: "tab" "\t";
}
}
parts {
part {
name: "part_one";
type: TEXT;
description {
min: 50 50;
state: "default" 0.0;
color: 0 0 255 255; /* blue */
rel1.relative: 0.5 0.25;
rel2.relative: 0.5 0.0;
text {
text : "CHANGED";
domain: "domain_name";
font: "arial";
size: 22;
min: 1 1;
ellipsis: -1;
}
}
}
part {
name: "part_two";
type: TEXTBLOCK;
select_mode: EXPLICIT;
source: "sel_group";
entry_mode: PLAIN;
description {
min: 50 50;
state: "default" 0.0;
rel1.relative: 0.0 0.5;
rel2.relative: 1.0 0.0;
text {
style: "textblock_style_en3";
min: 1 1;
ellipsis: -1;
}
}
description {
inherit: "default" 0.0;
state: "one" 0.0;
text {
style: "textblock_style_hi3";
min: 1 1;
}
}
description {
inherit: "default" 0.0;
state: "two" 0.0;
text {
style: "textblock_style_ta3";
min: 1 1;
}
}
}
}
programs {
program {
signal: "edje,language,hi_IN";
source: "edje";
script {
set_state(PART:"part_two", "one", 1.0);
}
}
program {
signal: "edje,language,ta_IN";
source: "edje";
script {
set_state(PART:"part_two", "two", 1.0);
}
}
program {
signal: "edje,language,en_IN";
source: "edje";
script {
set_state(PART:"part_two", "default", 1.0);
}
}
}
}
}

To compile use this command:

* gcc -o edje-text edje-text.c -DPACKAGE_BIN_DIR=\"/Where/enlightenment/is/installed/bin\" -DPACKAGE_LIB_DIR=\"/Where/enlightenment/is/installed/lib\"
* -DPACKAGE_DATA_DIR=\"/Where/enlightenment/is/installed/share\"
* `pkg-config --cflags --libs evas ecore ecore-evas edje`
*
* edje_cc text.edc
*