Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

以编程方式控制链接模块

链接模块信息

使用 libinfo 命令获取有关模型中链接模块的信息。libinfo 还提供有关链接模块的父级库模块的信息。

例如,以下是一个具有链接模块的模型:

封装变体模块

对此模块执行 libinfo(gcb) 命令时:

 Block: 'slexMaskVariantExample/VariantSubsystem2' %Linked block
           Library: 'slexMaskingVariants_libraryblock' %Parent library block
    ReferenceBlock: 'slexMaskingVariants_libraryblock/VariantSubsystem2'
        LinkStatus: 'resolved' %Link status

ReferenceBlock 属性提供模块链接到的库模块的路径。您可以使用 set_param 命令以编程方式更改此路径。例如:

set_param('slexMaskVariantExample/VariantSubsystem2','ReferenceBlock','slexMaskVariantExample2/VariantSubsystem')

此处,slexMaskVariantExample/VariantSubsystem2 是原始库模块路径,slexMaskVariantExample2/VariantSubsystem 是新库模块路径。

注意

不推荐在引用模块的封装初始化代码中或回调代码中使用 set_param 命令更改同一引用模块的属性。对于此类建模模式,您可以使用 Variant 模块 (Masking variant blocks) 或对引用模块的父模块的回调代码或封装初始化代码使用 ReferenceBlock 参数。

锁定链接模块

从命令行使用 LockLinksToLibrary 命令锁定或解锁库中的链接模块。当您将 LockLinksToLibrary 的值设置为 on 时,指向库的链接模块的链接将被锁定。

set_param('MyLibraryName', 'LockLinksToLibrary', 'on') %Lock links
set_param('MyLibraryName', 'LockLinksToLibrary', 'off') %Unlock links

链接状态

所有模块都有一个 LinkStatus 参数和一个 StaticLinkStatus 参数,以指示该模块是否为链接模块。

使用 get_param(gcb, 'StaticLinkStatus') 可查询链接状态,而不必更新链接模块。您可以使用 StaticLinkStatus 来查询活动或过期的链接模块的状态。

使用 get_param 发送查询以获取 LinkStatus 的值。

获取 LinkStatus 值Description
none

模块不是链接模块。

resolved

已解析的链接。

unresolved

未解析的链接。

implicit

模块驻留在库模块中,它本身不是指向库模块的链接。假设 A 是指向库中子系统的链接,该库包含 Gain 模块。如果打开 A 并选择 Gain 模块,get_param(gcb, 'LinkStatus') 会返回 implicit

inactive

禁用的链接。

使用 set_param 设置 LinkStatus

设置 LinkStatus 值Description

none

断开链接。使用 none 可断开链接,例如 set_param(gcb, 'LinkStatus', 'none')

breakWithoutHierarchy

在不破坏链接的嵌套父级层次结构的情况下断开链接。例如,set_param(gcb, 'LinkStatus', 'breakWithoutHierarchy')

inactive

禁用链接。使用 inactive 可禁用链接,例如 set_param(gcb, 'LinkStatus', 'inactive')

restore

还原指向库模块的非活动或已禁用的链接,并放弃对库模块的本地副本所做的任何更改。例如,set_param(gcb, 'LinkStatus', 'restore') 将所选模块替换为指向相同类型的库模块的链接。它会放弃在库模块的本地副本中所做的任何更改。

restore 相当于 Links Tool 中的 “Restore Individual”。

propagate

将对禁用链接所做的所有更改推送到库模块并重新建立其链接。propagate 相当于 Links Tool 中的 “Push Individual”。

restoreHierarchy

使用对应的库模块还原层次结构中的所有禁用链接。restoreHierarchy 等效于 Links Tool 的 Hierarchy 模式中的 “Restore”。

propagateHierarchy

将层次结构中发生了更改的所有链接推送到其库。propagateHierarchy 等效于 Links Tool 的 Hierarchy 模式中的 “Push”。请参阅Restore Disabled Links

注意

  • 当您使用 get_param 查询模块的链接状态时,会同时解析过时的模块链接。

  • 当在子模块的回调代码中使用 get_param 时,推荐使用 StaticLinkStatus 命令查询链接状态。StaticLinkStatus 命令不能解析任何过时的链接。

如果对库链接内的模块调用 get_param,则 Simulink® 会在必要时解析链接。执行 get_param 可能涉及加载部分库并执行回调。

相关主题