关于 SAP UI5 所有控件的共同祖先 - sap.ui.base.ManagedObject

ManagedObject 的新子类是通过调用 ManagedObject.extend 创建的,并且可以使用本文介绍的以下托管功能。

托管属性表示 ManagedObject 的状态。它们可以存储简单数据类型(如“字符串”或“整数”)的单个值。它们具有名称(例如 size)和获取当前值(getSize)或设置新值(setSize)的方法。

这些 getter 方法如下图所示:

关于 SAP UI5 所有控件的共同祖先 - sap.ui.base.ManagedObject_第1张图片

这些 setter 方法如下图所示:

关于 SAP UI5 所有控件的共同祖先 - sap.ui.base.ManagedObject_第2张图片

当通过调用 setter 修改属性时,ManagedObject 被标记为无效。可以使用 bindProperty 方法将托管属性绑定到 sap.ui.model.Model 中的属性。对模型属性的更新将自动反映在托管属性中,并且如果 TwoWay 数据绑定模式处于开启状态,则对托管属性的更改将反映在模型中。

可以通过调用 unbindProperty 删除现有绑定。

如果克隆了 ManagedObject,则克隆的托管属性将具有与克隆源相同的值,前提是该属性未绑定。如果已绑定,则克隆中的属性将绑定到与源中相同的模型属性。

有关托管属性的声明、描述它的元数据以及自动生成以访问它的方法集的详细信息,可以在扩展方法的文档中找到。

Aggregation

托管聚合可以存储一个或多个对其他 ManagedObjects 的引用。它们是控制聚合对象生命周期的一种手段:一个 ManagedObject 可以随时由最多一个父 ManagedObject 聚合。当 ManagedObject 被销毁时,所有聚合对象也会被销毁,并且对象本身也会从其父对象中移除。也就是说,聚合不会包含被破坏的对象或 null/undefined。

聚合具有名称(例如 titleitem)、基数(0..10..n)并且属于特定类型(也必须是 ManagedObject 的子类或UI5界面)。 ManagedObject 将提供方法来设置或获取基数为 0..1 的特定聚合的聚合对象(例如,setHeader、getHeader 用于名为 header的聚合)。对于基数为 0..n 的聚合,有一些方法可以获取所有聚合对象 (getItems),在聚合中定位对象(例如 indexOfItem),添加、插入或删除单个聚合对象(addItem、insertItem、removeItem ) 或从聚合中删除或销毁所有对象(removeAllItems、destroyItems)。

聚合的一些例子:

关于 SAP UI5 所有控件的共同祖先 - sap.ui.base.ManagedObject_第3张图片

基数为 0..n 的聚合可以使用 bindAggregation 绑定到模型中的集合(并使用 unbindAggregation 再次解除绑定)。对于模型集合中的每个上下文,将在托管聚合中创建相应的对象,方法是克隆模板对象或调用工厂函数。

聚合还控制绑定对象的数据绑定上下文:默认情况下,聚合对象从其父对象继承所有模型和绑定上下文。

克隆 ManagedObject 时,所有聚合对象也将被克隆 - 但前提是它们尚未通过数据绑定添加。在这种情况下,克隆中的聚合将绑定到同一个模型集合。

你可能感兴趣的:(关于 SAP UI5 所有控件的共同祖先 - sap.ui.base.ManagedObject)