e-mail clients where bidi oddities can occur when mixing RTL
and LTR.
- @since 1.1
+ @since 1.18
]]
set {}
get {}
values {
- delim: string; [[A null terminated string of delimiters, e.g ",|" or $null if empty.]]
+ delim: string; [[A null terminated string of delimiters, e.g ",|" or $null if empty]]
}
}
@property legacy_newline {
[[When true, newline character will behave as a paragraph separator.
- @since 1.1
+ @since 1.18
]]
set {}
get {}
values {
- mode: bool; [[$true for legacy mode, $false otherwise.]]
+ mode: bool; [[$true for legacy mode, $false otherwise]]
}
}
@property style {
first.
Set $style to $NULL to delete it.
+
+ @since 1.18
]]
set {
legacy: null;
key: string; [[The name to the style. $NULL is the default style]]
}
values {
- style: string; [[The style.]]
+ style: string; [[The style]]
}
}
@property size_formatted {
"You shall not pass!" with no margins or padding and assuming
a monospace font and a size of 7x10 char widths (for simplicity)
has a native size of 19x1 and a formatted size of 5x4.
+
+ @since 1.18
]]
get {}
values {
}
}
@property cursor {
- [[The object's main cursor.]]
+ [[The object's main cursor.
+
+ @since 1.18
+ ]]
get {
return: Efl.Canvas.Text.Cursor;
}
"You shall not pass!" with no margins or padding and assuming
a monospace font and a size of 7x10 char widths (for simplicity)
has a native size of 19x1 and a formatted size of 5x4.
+
+ @since 1.18
]]
get {}
values {
}
}
@property style_insets {
+ [[Gets the left, right, top and bottom insets of the text.
+
+ The inset is any applied padding on the text.
+
+ @since 1.18
+ ]]
get {}
values {
- l: Evas.Coord;
- r: Evas.Coord;
- t: Evas.Coord;
- b: Evas.Coord;
+ l: Evas.Coord; [[Left padding]]
+ r: Evas.Coord; [[Right padding]]
+ t: Evas.Coord; [[Top padding]]
+ b: Evas.Coord; [[Bottom padding]]
}
}
@property is_empty {
- [[Whether the object is empty (no text) or not]]
+ [[Whether the object is empty (no text) or not
+
+ @since 1.18
+ ]]
get {
legacy: null;
}
The textblock does the layout of the text according to the
position of the obstacle.
- @since 1.15
+ @since 1.18
]]
params {
@in eo_obs: Efl.Canvas.Object;
obstacle_del {
[[Removes $eo_obs from observation during text layout.
- @since 1.15
+ @since 1.18
]]
params {
@in eo_obs: Efl.Canvas.Object;
call this so it will consider this new state and will relayout
the text.
- @since 1.15
+ @since 1.18
]]
}
@property annotation {
legacy: null;
}
keys {
- annotation: Efl.Canvas.Text.Annotation *;
+ annotation: Efl.Canvas.Text.Annotation *; [[Given annotation]]
}
values {
- format: string;
+ format: string; [[The new format for the given annotation]]
}
}
range_annotations_get {
]]
legacy: null;
params {
- @in start: const(Efl.Canvas.Text.Cursor);
- @in end: const(Efl.Canvas.Text.Cursor);
+ @in start: const(Efl.Canvas.Text.Cursor); [[Start of range]]
+ @in end: const(Efl.Canvas.Text.Cursor); [[End of range]]
}
return: free(own(iterator<Efl.Canvas.Text.Annotation *>),
eina_iterator_free); [[Handle of the Annotation]]
}
- annotation_del {
- [[Deletes $annotation.
+ annotation_insert {
+ [[Inserts an annotation format in a specified range [$start, $end - 1].
- All formats applied by $annotations will be removed and it will be
- deleted.
+ The $format will be applied to the given range, and the $annotation
+ handle will be returned for further handling.
+
+ @since 1.18
]]
legacy: null;
params {
- @in annotation: Efl.Canvas.Text.Annotation *;
+ @in start: Efl.Canvas.Text.Cursor; [[Start of range]]
+ @in end: Efl.Canvas.Text.Cursor; [[End of range]]
+ @in format: string;
}
- return: bool; [[$true on success, $false otherwise.]]
+ return: Efl.Canvas.Text.Annotation *; [[Handle of inserted annotation]]
}
- annotation_insert {
- [[Inserts an annotation format in a specified range [$start, $end - 1].
+ annotation_del {
+ [[Deletes given annotation.
- This will add both opening and closing formats for the given
- $format.
- Returns a handle to manipulate the inserted annotation.
+ All formats applied by $annotation will be removed and it will be
+ deleted.
@since 1.18
]]
legacy: null;
params {
- @in start: Efl.Canvas.Text.Cursor;
- @in end: Efl.Canvas.Text.Cursor;
- @in format: string;
+ @in annotation: Efl.Canvas.Text.Annotation *; [[Annotation to be
+ removed]]
}
- return: Efl.Canvas.Text.Annotation *;
+ return: bool; [[$true on success, $false otherwise.]]
}
range_geometry_get {
[[Get the geometry of a range in the text.
]]
legacy: null;
params {
- @in cur1: const(Efl.Canvas.Text.Cursor);
- @in cur2: const(Efl.Canvas.Text.Cursor);
+ @in cur1: const(Efl.Canvas.Text.Cursor); [[Start of range]]
+ @in cur2: const(Efl.Canvas.Text.Cursor); [[End of range]]
}
return: free(own(iterator<Eina.Rectangle>),
- eina_iterator_free);
+ eina_iterator_free); [[Iterator on all geoemtries of
+ the given range]]
}
range_simple_geometry_get {
[[Get the "simple" geometry of a range.
range are merged into one big rectangle. This is an optimized
version of @.range_geometry_get.
- @since 1.13
+ @since 1.19
]]
legacy: null;
params {
- @in cur1: const(Efl.Canvas.Text.Cursor);
- @in cur2: const(Efl.Canvas.Text.Cursor);
+ @in cur1: const(Efl.Canvas.Text.Cursor); [[Start of range]]
+ @in cur2: const(Efl.Canvas.Text.Cursor); [[End of range]]
}
return: free(own(iterator<Eina.Rectangle>),
- eina_iterator_free);
+ eina_iterator_free); [[Iterator on all simple
+ geometries of the given range]]
}
range_delete {
- [[Deletes the range between given cursors.]]
+ [[Deletes the range between given cursors.
+
+ This removes all the text in given range [$start,$end].
+ ]]
legacy: null;
params {
- @in cur1: Efl.Canvas.Text.Cursor; [[Range start position.]]
- @in cur2: Efl.Canvas.Text.Cursor; [[Range end position.]]
+ @in cur1: Efl.Canvas.Text.Cursor; [[Range start position]]
+ @in cur2: Efl.Canvas.Text.Cursor; [[Range end position]]
}
}
visible_range_get {
@since 1.18
]]
- return: bool; [[$true on success, $false otherwise.]]
+ return: bool; [[$true on success, $false otherwise]]
params {
- @in start: Efl.Canvas.Text.Cursor; [[Range start position.]]
- @in end: Efl.Canvas.Text.Cursor; [[Range end position.]]
+ @in start: Efl.Canvas.Text.Cursor; [[Range start position]]
+ @in end: Efl.Canvas.Text.Cursor; [[Range end position]]
}
}
range_text_get {
- [[Returns the text in the range between $cur1 and $cur2.]]
+ [[Returns the text in the range between $cur1 and $cur2.
+
+ @since 1.18
+ ]]
legacy: null;
- return: own(char*); [[The text in the given range.]]
+ return: own(char*); [[The text in the given range]]
params {
- @in cur1: const(Efl.Canvas.Text.Cursor); [[Range start position.]]
- @in cur2: const(Efl.Canvas.Text.Cursor); [[Range end position.]]
+ @in cur1: const(Efl.Canvas.Text.Cursor); [[Start of range]]
+ @in cur2: const(Efl.Canvas.Text.Cursor); [[End of range]]
}
}
object_item_geometry_get {
- [[Queries a given object item for its geometry
+ [[Queries a given object item for its geometry.
Note that the provided annotation should be an object item type.
+
+ @since 1.18
]]
legacy: null;
params {
@in an: const(Efl.Canvas.Text.Annotation)*; [[Given annotation to query]]
- @out x: Evas.Coord;
- @out y: Evas.Coord;
- @out w: Evas.Coord;
- @out h: Evas.Coord;
+ @out x: Evas.Coord; [[x coordinate of the annotation]]
+ @out y: Evas.Coord; [[y coordinate of the annotation]]
+ @out w: Evas.Coord; [[w coordinate of the annotation]]
+ @out h: Evas.Coord; [[h coordinate of the annotation]]
}
return: bool; [[$true if given annotation is an object item, $false otherwise]]
}