Evas Textblock Style Options

Table of Contents

This page describes how to style text in an Evas Text Block.

Index

The following styling commands are accepted:

Contents

Backing Color

Sets a background color for text. The following formats are accepted:

Backing

Sets if the text will have backing. The value must be one of the following:

Second Underline Color

Sets the color of the second line of underline(when using underline mode "double"). The following formats are accepted:

Second Glow Color

Sets the second color of the glow of text. The following formats are accepted:

Tabstops

Sets the size of the tab character. The value must be a number greater than one.

tabstops=<number>

Line size

Sets the size of line of text. The value should be a number.

Warning
Setting this value sets linerelsize to 0%!
linesize=<number>

Relative line size

Sets the relative size of line of text. The value must be a percentage.

Warning
Setting this value sets linesize to 0!
linerelsize=<number>%

Line gap

Sets the size of the line gap in text. The value should be a number.

Warning
Setting this value sets linerelgap to 0%!
linegap=<number>

Relative line gap

Sets the relative size of the line gap in text. The value must be a percentage.

Warning
Setting this value sets linegap to 0!
linerelgap=<number>%

Line fill

Sets the size of the line fill in text. The value must be a percentage.

linefill=<number>%

Underline Dash Color

Sets the color of dashed underline. The following formats are accepted:

Underline

Sets if and how a text will be underlined. The value must be one of the following:

Strikethrough

Sets if the text will be striked through. The value must be one of the following:

Style

Sets the style of the text. The value must be a string composed of two comma separated parts. The first part of the value sets the appearance of the text, the second the position.

The first part may be any of the following values:

Underline dash width

Sets the width of the underline dash. The value should be a number.

underline_dash_width=<number>

Underline dash gap

Sets the gap of the underline dash. The value should be a number.

underline_dash_gap=<number>

Font

This sets the name of the font to be used.

font=<font name>

Font fallback

This sets the name of the fallback font to be used. This font will be used if the primary font is not available.

font_fallbacks=<font name>

Font size

This sets the the size of font in points to be used.

font_size=<size>

Font source

Specify an object from which to search for the font.

font_source=<source>

Font weight

Sets the weight of the font. The value must be one of:

Font style

Sets the style of the font. The value must be one of:

Font width

Sets the width of the font. The value must be one of:

Language

Sets the language of the text for FontConfig. The value can either be a language text or one of presets:

Color

Sets the color of the text. The following formats are accepted:

Underline Color

Sets the color of the underline. The following formats are accepted:

Outline Color

Sets the color of the outline of the text. The following formats are accepted:

Shadow Color

Sets the color of the shadow of the text. The following formats are accepted:

First Glow Color

Sets the first color of the glow of text. The following formats are accepted:

Strikethrough Color

Sets the color of text that is striked through. The following formats are accepted:

Horizontal Align

Sets the horizontal alignment of the text. The value can either be a number, a percentage or one of several presets:

Vertical Align

Sets the vertical alignment of the text. The value can either be a number or one of the following presets:

See explanation of baseline at: https://en.wikipedia.org/wiki/Baseline_%28typography%29

Wrap

Sets the wrap policy of the text. The value must be one of the following:

Left margin

Sets the left margin of the text. The value can be a number, an increment, decrement or "reset":

Right margin

Sets the right margin of the text. The value can be a number, an increment, decrement or "reset":

Item

Not implemented! Does nothing!

item=<anything>

Ellipsis

Sets ellipsis mode. The value should be a number. Any value smaller than 0.0 or greater than 1.0 disables ellipsis. A value of 0 means ellipsizing the leftmost portion of the text first, 1 on the other hand the rightmost portion.

ellipsis=<number>

Password

Sets if the text is being used for passwords. Enabling this causes all characters to be substituted for '*'. Value must be one of the following:

Underline height

Sets the height of the single underline. The value should be a floating number.

underline_height=<floatingnumber>

Gfx Filter

Experimental filter, see efl_gfx_filter for more information.

gfx_filter='filter name'