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

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

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

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

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

如下图所示:

SAP UI5 sap.ui.base.ManagedObject 的构造函数参数讲解_第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
});

SAP UI5 sap.ui.base.ManagedObject 的构造函数参数讲解_第2张图片

你可能感兴趣的:(SAP UI5 sap.ui.base.ManagedObject 的构造函数参数讲解)