主要内容

定义数据类

这个例子展示了如何子类化Simulink金宝app®数据类。

使用MATLAB®类语法用于在包中创建数据类。也可以为数据类指定属性并定义存储类。

使用一个例子来定义数据类

  1. 查看+金宝app SimulinkDemos文件夹中的数据类包matlabroot/工具/模型/ s金宝appimdemos / dataclasses开放).

    这个包包含预定义的数据类。

  2. 将文件夹复制到要定义数据类的位置。

  3. 重命名文件夹+ mypkg并将其父文件夹添加到MATLAB路径中。

  4. 修改数据类定义。

手动定义数据类

  1. 创建一个包文件夹+ mypkg并将其父文件夹添加到MATLAB路径中。

  2. 创建类文件夹@ phase@Signal内部+ mypkg

    请注意

    金宝appSimulink要求在内部定义数据类+包/ @Class文件夹。

  3. @ phase文件夹,创建MATLAB文件Parameter.m并打开它进行编辑。

  4. 的子类定义一个数据类金宝app仿真软件。参数使用MATLAB类语法。

    classdef参数<仿真软件。金宝app参数结束% classdef

使用自定义类名而不是参数信号,使用自定义名称来命名类文件夹。例如,定义一个类mypkg.myParameter:

  • 的子类定义数据类金宝app仿真软件。参数金宝app仿真软件。信号

    classdefmyParameter <仿金宝app真软件。参数结束% classdef

  • 在类定义中,将构造函数方法命名为myParametermySignal

  • 将包含类定义的类文件夹命名为@myParameter@mySignal

可选:向数据类添加属性

属性结束关键字包含一个属性定义块。

classdef参数<仿真软件。金宝app参数属性%无约束的属性类型Prop1 = [];结束属性(PropertyType =“逻辑标量”) Prop2 = false;结束属性(PropertyType =“字符”) Prop3 =''结束属性(PropertyType =“字符”...AllowedValues = {“红色”“绿色”“蓝”}) Prop4 =“红色”结束结束% classdef

的子类添加属性金宝app仿真软件。参数金宝app仿真软件。信号,或金宝app仿真软件。CustomStorageClassAttributes,您可以指定以下属性类型。

属性类型 语法
两倍数量 属性(PropertyType = '双标量')
int32数量 属性(PropertyType = 'int32标量')
逻辑数 属性(PropertyType = '逻辑标量')
特征向量(字符) 属性(PropertyType =“字符”)
具有有限允许值集的字符向量 属性(PropertyType = 'char', AllowedValues = {'a', 'b', 'c'})

如果您使用MATLAB属性验证(参见验证属性值)而不是PropertyType,属性将显示为类属性对话框中的编辑字段。如果你使用PropertyTypeAllowedValues,则属性对话框显示:

  • 用于逻辑标量属性的复选框。

  • 一个字符向量和的下拉菜单AllowedValues

可选:向数据类添加初始化代码

可以在数据类中添加构造函数,以便在类实例化时执行初始化活动。添加的构造函数不能要求输入参数。

在本例中,构造函数初始化object的值obj基于一个可选的输入参数。

classdef参数<仿真软件。金宝app参数方法函数obj =参数(optionalValue)如果(nargin == 1)值= optionalValue;结束结束结束%的方法结束% classdef

可选:定义存储类

使用setupCoderInfo方法配置CoderInfo类的对象。然后,创建一个调用useLocalCustomStorageClasses方法并打开自定义存储类设计器。

  1. 在数据类的构造函数中,调用useLocalCustomStorageClasses方法。

    classdef参数<仿真软件。金宝app参数方法函数setupCoderInfo (obj) useLocalCustomStorageClasses (obj,“mypkg”);obj.CoderInfo.StorageClass =“自定义”结束结束%的方法结束% classdef
  2. 打开包的自定义存储类设计器。

    cscdesigner (“mypkg”
  3. 定义存储类。

可选:为存储类定义自定义属性

  1. 创建一个MATLAB文件myCustomAttribs.m并打开它进行编辑。将此文件保存在+ mypkg / @myCustomAttribs文件夹,+ mypkg文件夹中是否包含@ phase@Signal文件夹。

  2. 定义的子类金宝app仿真软件。CustomStorageClassAttributes使用MATLAB类语法。例如,考虑一个存储类,它使用原始标识符定义数据,但也为生成的代码中的数据提供了替代名称。

    classdefmyCustomAttribs <仿金宝app真软件。CustomStorageClassAttributes属性(PropertyType =“字符”) AlternateName =''结束结束% classdef

  3. 控件的默认实现isAddressable方法确定存储类是否可写。

    classdefmyCustomAttribs <仿金宝app真软件。CustomStorageClassAttributes属性(PropertyType =“逻辑标量”) IsAlternateNameInstanceSpecific = true;结束方法函数retVal = isAddressable(hObj, hCSCDefn, hData) retVal = false;结束结束%的方法结束% classdef
  4. 控件的默认实现getInstanceSpecificProps方法。

    有关示例,请参见CSCTypeAttributes_FlatStructure.m在文件夹matlabroot、工具箱、仿真软件金宝app\仿真软件\ dataclasses \ +仿真软件\ @CSCTypeAttributes_FlatStructure开放),CSCTypeAttributes_Unstructed.m在文件夹matlabroot、工具箱、仿真软件金宝app\仿真软件\ dataclasses \ + mpt \ @CSCTypeAttributes_Unstructed开放).

    请注意

    这是一个可选的步骤。默认情况下,所有自定义属性都是特定于实例的,并且可以针对每个数据对象进行修改。但是,您可以限制哪些属性是特定于实例的。

  5. 控件的默认实现getIdentifiersForInstance方法定义数据类对象的标识符。

    请注意

    在其默认实现中,该方法查询数据对象的名称或标识符,并在生成的代码中使用该标识符。通过覆盖此方法,您可以在生成的代码中控制数据对象的标识符。

    classdefmyCustomAttribs <仿金宝app真软件。CustomStorageClassAttributes属性(PropertyType =“字符”) GetFunction ='';SetFunction =''结束方法函数retVal = getIdentifiersForInstance (hCSCAttrib,...retVal = struct(“GetFunction”...hData.CoderInfo.CustomAttributes.GetFunction,...“SetFunction”, hData.CoderInfo.CustomAttributes.SetFunction);结束结束%的方法结束% classdef
  6. 如果使用分组存储类,请重写getIdentifiersForGroup方法以在生成的代码中指定组的标识符。

    例如,请参见CSCTypeAttributes_FlatStructure.m在文件夹matlabroot、工具箱、仿真软件金宝app\仿真软件\ dataclasses \ +仿真软件\ @CSCTypeAttributes_FlatStructure开放).

相关的话题