Main Content

Simulink.BlockDiagram.createSubsystem

创建包含指定模块集的子系统

说明

示例

Simulink.BlockDiagram.createSubsystem(blocks) 创建一个子系统,并将指定的模块移入其中。所有指定的模块最初必须位于同一个模块图中。

如果任何模块有未连接的端口,该函数会在子系统内部创建 InportOutport 模块并连接到它们。

如果任何模块是输入或输出端口模块,该函数将在父级系统中创建 InportOutport 模块,以连接到新 Subsystem 模块上的对应端口。

Simulink.BlockDiagram.createSubsystem() 用包含这些模块的新子系统替换当前所选模块。

示例

Simulink.BlockDiagram.createSubsystem(___,Name,Value) 支持上述语法中的输入参量,且可使用一个或多个名称-值对组参量指定选项。例如,'Name','MySubsystem' 将新子系统命名为 'MySubsystem'

示例

全部折叠

打开或加载示例模型。

CreateSubsystemModel

使用 Simulink.findBlocks 函数获取模型顶层所有模块的模块句柄。

bh = Simulink.findBlocks('CreateSubsystemModel');

用包含模型内容的子系统替换模型内容。

Simulink.BlockDiagram.createSubsystem(bh);

打开或加载示例模型。

CreateSubsystemModel

使用 Simulink.findBlocks 函数获取模型顶层所有模块的模块句柄。

bh = Simulink.findBlocks('CreateSubsystemModel');

用包含模型内容的名为 ss1 的子系统替换模型内容。

Simulink.BlockDiagram.createSubsystem(bh,'Name','ss1');

输入参数

全部折叠

模块句柄,指定为数值数组。要获取模块句柄,请使用 Simulink.findBlocksgcbh 函数。

数据类型: double

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: Simulink.BlockDiagram.createSubsystem(blocks, 'Name', 'MySubsystemName')

新子系统的名称,指定为由 'Name' 和字符向量或字符串标量组成的以逗号分隔的对组。

数据类型: char | string

使子系统名称唯一的选项,指定为由 'MakeNameUnique''on''off' 组成的以逗号分隔的对组。

如果您为 Name 指定的值已在图中使用:

  • 'on' - 使用名称的下一个可用递增编号。例如,如果 Name 设置为 'Controller',并且该图已包含名为 'Controller' 的模块,则该函数将新子系统命名为 'Controller1'

  • 'off' - 返回错误。

依存关系

要使用此参数,请为 Name 参量指定值。

数据类型: char | string

版本历史记录

在 R2009a 中推出