efl_ui_factory: improve docs

Summary:
and remove TAAABS
Depends on D10038

Reviewers: segfaultxavi

Reviewed By: segfaultxavi

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D10042
This commit is contained in:
Marcel Hollerbach 2019-09-20 15:16:25 +02:00 committed by Xavi Artigas
parent 47ab7e1b83
commit 4672598b03
2 changed files with 13 additions and 8 deletions

View File

@ -6,7 +6,12 @@ struct @beta Efl.Ui.Factory_Item_Created_Event {
interface @beta Efl.Ui.Factory extends Efl.Ui.Property_Bind, Efl.Ui.Factory_Bind
{
[[Efl UI factory interface]]
[[Interface for factory-pattern object creation.
This object represents a Factory in the factory pattern. Objects should be created via the method
@Efl.Ui.View_Factory.create_with_event, which will in turn call the necessary APIs from this interface.
Objects created this way should be removed using @.release.
]]
methods {
create @protected {
[[Create a UI object from the necessary properties in the specified model.
@ -16,14 +21,14 @@ interface @beta Efl.Ui.Factory extends Efl.Ui.Property_Bind, Efl.Ui.Factory_Bind
params {
models: iterator<Efl.Model>; [[Efl iterator providing the model to be associated to the new item.
It should remain valid until the end of the function call.]]
parent: Efl.Gfx.Entity; [[Efl canvas]]
parent: Efl.Gfx.Entity; [[Efl canvas.]]
}
return: future<Efl.Gfx.Entity>; [[Created UI object]]
return: future<Efl.Gfx.Entity>; [[Created UI object.]]
}
release {
[[Release a UI object and disconnect from models.]]
params {
ui_view: Efl.Gfx.Entity; [[Efl canvas]]
ui_view: Efl.Gfx.Entity; [[Object to remove.]]
}
}
building @const {