elm widget item: add guide about when to use item_signal_emit

genlist/gengrid now uses cache for view objects of items and
re-associate edje objects to different obj items whenever needed.
problem here is if app user changes the state of view object
(by sending edje signal, elm_object_item_signal_emit()) and
forget to reset it in unrealized, the old edje object state will link to other
object item, so its application user responsibility to reset
the edje state to normal in "unrealized" callback.

Signed-off-by: Amitesh Singh <amitesh.sh@samsung.com>
This commit is contained in:
Amitesh Singh 2017-02-09 13:06:42 +05:30
parent 2a239c211c
commit a90c3ffe80
1 changed files with 3 additions and 1 deletions

View File

@ -307,7 +307,9 @@ class Elm.Widget.Item(Efl.Object, Elm.Interface.Atspi_Accessible,
This function sends a signal to the edje object of the obj item. An
edje program can respond to a signal by specifying matching
'signal' and 'source' fields.]]
'signal' and 'source' fields.
Don't use this unless you want to also handle resetting of part states to default on
every unrealize in case of genlist/gengrid.]]
params {
emission: string; [[The signal's name.]]
source: string; [[The signal's source.]]