Macros | Typedefs | Enumerations
Text Object Functions

Functions that operate on single line, single style text objects. More...

Macros

#define EVAS_TEXT_STYLE_MASK_BASIC   0xf
 
#define EVAS_TEXT_STYLE_BASIC_SET(x, s)   do { x = ((x) & ~EVAS_TEXT_STYLE_MASK_BASIC) | (s); } while (0)
 Text style type creation macro. More...
 
#define EVAS_TEXT_STYLE_MASK_SHADOW_DIRECTION   (0x7 << 4)
 
#define EVAS_TEXT_STYLE_SHADOW_DIRECTION_SET(x, s)   do { x = ((x) & ~EVAS_TEXT_STYLE_MASK_SHADOW_DIRECTION) | (s); } while (0)
 Text style type creation macro. More...
 

Typedefs

typedef enum _Evas_Text_Style_Type Evas_Text_Style_Type
 Types of styles to be applied on text objects. More...
 

Enumerations

enum  _Evas_Text_Style_Type {
  EVAS_TEXT_STYLE_PLAIN,
  EVAS_TEXT_STYLE_SHADOW,
  EVAS_TEXT_STYLE_OUTLINE,
  EVAS_TEXT_STYLE_SOFT_OUTLINE,
  EVAS_TEXT_STYLE_GLOW,
  EVAS_TEXT_STYLE_OUTLINE_SHADOW,
  EVAS_TEXT_STYLE_FAR_SHADOW,
  EVAS_TEXT_STYLE_OUTLINE_SOFT_SHADOW,
  EVAS_TEXT_STYLE_SOFT_SHADOW,
  EVAS_TEXT_STYLE_FAR_SOFT_SHADOW,
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM_RIGHT = (0x0 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM = (0x1 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM_LEFT = (0x2 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_LEFT = (0x3 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP_LEFT = (0x4 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP = (0x5 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP_RIGHT = (0x6 << 4),
  EVAS_TEXT_STYLE_SHADOW_DIRECTION_RIGHT = (0x7 << 4)
}
 
Evas_Objectevas_object_text_add (Evas *e)
 Creates a new text object on the provided canvas. More...
 

Detailed Description

Functions that operate on single line, single style text objects.

For multiline and multiple style text, see Textblock Object Functions.

See some examples on this group of functions.

Warning
We don't guarantee any proper results if you create a Text object without setting the evas engine.

Macro Definition Documentation

#define EVAS_TEXT_STYLE_BASIC_SET (   x,
 
)    do { x = ((x) & ~EVAS_TEXT_STYLE_MASK_BASIC) | (s); } while (0)

Text style type creation macro.

Use style types on the 's' arguments, being 'x' your style variable.

#define EVAS_TEXT_STYLE_SHADOW_DIRECTION_SET (   x,
 
)    do { x = ((x) & ~EVAS_TEXT_STYLE_MASK_SHADOW_DIRECTION) | (s); } while (0)

Text style type creation macro.

This one will impose shadow directions on the style type variable – use the EVAS_TEXT_STYLE_SHADOW_DIRECTION_* values on 's', incrementally.

Typedef Documentation

Types of styles to be applied on text objects.

The EVAS_TEXT_STYLE_SHADOW_DIRECTION_* ones are to be ORed together with others imposing shadow, to change shadow's direction

Enumeration Type Documentation

Enumerator
EVAS_TEXT_STYLE_PLAIN 

plain, standard text

EVAS_TEXT_STYLE_SHADOW 

text with shadow underneath

EVAS_TEXT_STYLE_OUTLINE 

text with an outline

EVAS_TEXT_STYLE_SOFT_OUTLINE 

text with a soft outline

EVAS_TEXT_STYLE_GLOW 

text with a glow effect

EVAS_TEXT_STYLE_OUTLINE_SHADOW 

text with both outline and shadow effects

EVAS_TEXT_STYLE_FAR_SHADOW 

text with (far) shadow underneath

EVAS_TEXT_STYLE_OUTLINE_SOFT_SHADOW 

text with outline and soft shadow effects combined

EVAS_TEXT_STYLE_SOFT_SHADOW 

text with (soft) shadow underneath

EVAS_TEXT_STYLE_FAR_SOFT_SHADOW 

text with (far soft) shadow underneath

EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM_RIGHT 

shadow growing to bottom right

EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM 

shadow growing to the bottom

EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM_LEFT 

shadow growing to bottom left

EVAS_TEXT_STYLE_SHADOW_DIRECTION_LEFT 

shadow growing to the left

EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP_LEFT 

shadow growing to top left

EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP 

shadow growing to the top

EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP_RIGHT 

shadow growing to top right

EVAS_TEXT_STYLE_SHADOW_DIRECTION_RIGHT 

shadow growing to the right

Function Documentation

Evas_Object* evas_object_text_add ( Evas e)

Creates a new text object on the provided canvas.

Parameters
eThe canvas to create the text object on.
Returns
NULL on error, a pointer to a new text object on success.

Text objects are for simple, single line text elements. If you want more elaborated text blocks, see Textblock Object Functions.

See also
evas_object_text_font_source_set()
evas_object_text_font_set()
evas_object_text_text_set()