SAP UI5 sap.ui.base.ManagedObject 的构造函数参数讲解

该构造函数使用给定的 sId 和设置构造和初始化托管对象。

如果给出了可选的 mSettings，它们必须是一个简单的对象，定义了属性、聚合、关联或事件的值，它们的名称为键。

对象字面量(object literal)中支持的属性（键）名称正是 JSDoc 中记录的当前类及其基类的属性、聚合、关联和事件的（区分大小写的）名称。

请注意，对于 0…n 聚合和关联，此名称通常是复数名称，而在 0…1 关系的情况下它是单数名称。

如下图所示：

• 对于简单的属性，值必须与属性的记录类型匹配（不发生类型转换）
• 对于 0…1 聚合，值必须是聚合类型的实例
• 对于 0…n 聚合，该值必须是聚合类型的实例数组或单个实例
• 对于 0…1 关联，接受关联类型或 id（字符串）的实例
• 对于 0…n 关联，接受关联类型或 ID 的实例数组
• 对于事件，要么接受一个函数（事件处理程序），要么接受一个长度为 2 的数组，其中第一个元素是函数，第二个元素是调用方法的对象； 或长度为 3 的数组，其中第一个元素是任意有效负载对象，第二个元素是函数，第三个元素是调用方法的对象； 或者一个数组数组，其中每个嵌套数组都具有前面描述的 2 或 3 个元素结构（多个侦听器）。

每个子类都应在其构造函数文档中记录其支持设置的名称和类型。

看个实际的例子：

ew Dialog({
   title: "Some title text",            // property of type "string"
   showHeader: true,                    // property of type "boolean"
   endButton: new Button(...),          // 0..1 aggregation
   content: [                           // 0..n aggregation
      new Input(...),
      new Input(...)
   ],
   afterClose: function(oEvent) { ... } // event handler function
});
1
2
3
4
5
6
7
8
9
10