diff options
author | Yeongjong Lee <yj34.lee@samsung.com> | 2019-03-11 12:17:17 +0100 |
---|---|---|
committer | Xavi Artigas <xavierartigas@yahoo.es> | 2019-03-11 12:17:36 +0100 |
commit | c043b11f467d2df38ed9dbfc78f20c493011ad4b (patch) | |
tree | 1d7977956a9830db93ee519e6af2d0f3ce067c6c | |
parent | 6524589e861639710d84e9f76e3ea9ea60d571a2 (diff) | |
download | efl-c043b11f467d2df38ed9dbfc78f20c493011ad4b.tar.gz |
ui.widget: enhance documentation of sub_object_add
Reviewers: segfaultxavi, bu5hm4n
Reviewed By: segfaultxavi, bu5hm4n
Subscribers: bu5hm4n, kimcinoo, cedric, #reviewers, #committers
Tags: #efl
Differential Revision: https://phab.enlightenment.org/D8281
-rw-r--r-- | src/lib/elementary/efl_ui_widget.eo | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/src/lib/elementary/efl_ui_widget.eo b/src/lib/elementary/efl_ui_widget.eo index c06587a533..d25174e810 100644 --- a/src/lib/elementary/efl_ui_widget.eo +++ b/src/lib/elementary/efl_ui_widget.eo @@ -253,7 +253,15 @@ abstract Efl.Ui.Widget extends Efl.Canvas.Group implements Efl.Access.Object, /* Internal hooks. */ widget_sub_object_add @protected { - [[Virtual function handling sub objects being added. + [[Virtual function customizing sub objects being added. + + When a widget is added as a sub-object of another widget (like list + elements inside a list container, for example) some of its properties + are automatically adapted to the parent's current values (like focus, + access, theme, scale, mirror, scrollable child get, translate, + display mode set, tree dump). + Override this method if you want to customize differently sub-objects + being added to this object. Sub objects can be any canvas object, not necessarily widgets. @@ -266,11 +274,17 @@ abstract Efl.Ui.Widget extends Efl.Canvas.Group implements Efl.Access.Object, return: bool; [[Indicates if the operation succeeded.]] } widget_sub_object_del @protected { - [[Virtual function handling sub objects being removed. + [[Virtual function customizing sub objects being removed. + + When a widget is removed as a sub-object from another widget + (@Efl.Pack.unpack, @Efl.Content.content_unset, for example) some of + its properties are automatically adjusted.(like focus, access, tree dump) + Override this method if you want to customize differently sub-objects + being removed to this object. Sub objects can be any canvas object, not necessarily widgets. - See also @.widget_parent. + See also @.widget_parent and @.widget_sub_object_add. ]] params { @in sub_obj: Efl.Canvas.Object; |