xartigas pushed a commit to branch master.
http://git.enlightenment.org/core/efl.git/commit/?id=c043b11f467d2df38ed9dbfc78f20c493011ad4b
commit c043b11f467d2df38ed9dbfc78f20c493011ad4b
Author: Yeongjong Lee <yj34....@samsung.com>
Date: Mon Mar 11 12:17:17 2019 +0100
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
---
src/lib/elementary/efl_ui_widget.eo | 20 +++++++++++++++++---
1 file 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;
--
