主要内容

open_system

打开模型、库、子系统或模块对话框

说明

open_system(obj) 打开指定的模型、库、子系统或模块。

模型或库将在新窗口中打开。对于模型内的子系统或模块,行为取决于模块的类型及其属性。

  • 计算模块或模型的任何 OpenFcn 回调。

  • 如果模块或模型没有 OpenFcn 回调,但是定义了封装,则将打开封装参数对话框。

  • 如果没有 OpenFcn 回调或封装参数,软件将打开该对象。

    • 引用的模型将在新窗口中打开。

      提示

      要在模型层次结构的上下文中打开引用模型,请使用 open 函数和 Simulink.BlockPath 对象。

    • 子系统将在同一窗口中的新选项卡上打开。

    • 对于模块,将打开模块的模块参数对话框。

要打开特定的子系统或模块,必须加载包含此模块的模型或库。否则,软件会引发错误。

您可以通过指定多个输入参量来覆盖默认行为。以下是有效的参量组合:

  • 当将 ForceTabWindow 结合使用时,您可以在新窗口或新选项卡中查看模块的封装内容。

  • ActiveChoiceTabWindow 结合使用会在新选项卡或新窗口中打开 Variant Subsystem 模块的活动选择项。如果其中一个参量是 ActiveChoice,则通过将 Force 作为另一个参量与 TabWindow 一起传递,来打开封装的活动选择项的内容。

以下输入参量组合将导致出错。

  • 如果指定参量 parametermaskOpenFcn 以及除 ActiveChoice 之外的任何其他参量。

  • 如果对 Variant Subsystem 模块以外的任何其他模块指定 ActiveChoice

  • 如果指定 force 时带有 ActiveChoicewindowtab 以外的任何其他参量。

  • 如果同时指定 windowtab 作为参量。

  • 如果指定 loadonly 时带有任何其他参量。

示例

open_system(sys,"loadonly") 加载指定的模型或库,无需打开 Simulink® 编辑器。使用此语法等效于调用 load_system 函数。

示例

open_system(sbsys,"window") 在新的 Simulink 编辑器窗口中打开子系统 sbsys。在打开特定的子系统或模块之前,加载包含该子系统或模块的模型或库。否则,软件会引发错误。

示例

open_system(sbsys,"tab") 在同一 Simulink 编辑器窗口的新选项卡中打开该子系统。在打开特定的子系统或模块之前,加载包含该子系统或模块的模型或库。否则,软件会引发错误。

open_system(blk,"mask") 打开由 blk 指定的模块或子系统的封装对话框。打开 blk 之前,加载包含它的模型或库。

示例

open_system(blk,"force") 在封装的模块或子系统的封装下进行查找。此语法在 Simulink 编辑器的新选项卡中打开封装内部模块的对话框或打开封装子系统。使用此语法等效于查看封装内部菜单项。在打开特定的子系统或模块之前,加载包含该子系统或模块的模型或库。否则,软件会引发错误。

open_system(blk,"parameter") 打开“模块参数”对话框。

open_system(blk,"OpenFcn") 为模块 blk 运行 OpenFcn 回调。

open_system(vssblk,"ActiveChoice","window") 在新窗口中打开 Variant Subsystem 的活动选择项。

示例

open_system(blk,"force","window") 在新窗口中打开封装子系统的内容。

示例

示例

全部折叠

假设您有一个名为 myModel 的模型。

打开模型。

open_system("myModel")

假设您有一个名为 myModel 的模型。

在不打开该模型的情况下加载它。

load_system("myModel")

假设您有一个名为 myModel 的模型。该模型包含一个名为 mySubsystem 的子系统。

打开该子系统。

load_system("myModel")
open_system("myModel/mySubsystem")

假设您有一个名为 myModel 的模型。该模型包含一个名为 mySubsystem 的子系统。

在一个新选项卡中打开该子系统。

load_system("myModel")
open_system("myModel/mySubsystem","tab")

假设您有一个名为 myModel 的模型。该模型包含一个名为 mySubsystem 的子系统。

在子系统自己的 Simulink 编辑器窗口中打开该子系统。

load_system("myModel")
open_system("myModel/mySubsystem","window")

假设您有一个名为 myModel 的模型,它使用名为 myRefModelBlockModel 模块来引用另一个模型。

打开引用模型。

load_system("myModel")
open_system("myModel/myRefModelBlock")

引用的模型在其自身的 Simulink 编辑器窗口中作为顶层模型打开。

提示

要在模型层次结构的上下文中打开引用模型,请使用 open 函数和 Simulink.BlockPath 对象。

假设您有一个名为 myModel 的模型。该模型包含一个名为 mySubsystem 的子系统,该子系统包含多个 Gain 模块。

打开子系统中第一个 Gain 模块的模块参数对话框。

load_system("myModel")
open_system("myModel/mySubsystem/Gain")

假设您有一个名为 myModel 的模型,它包含一个名为 KConstant 模块。

Constant 模块定义一个 OpenFcn 回调。

load_system("myModel")
set_param("myModel/K",OpenFcn="disp('Hello World!')")

执行模块回调。

open_system("myModel/K","OpenFcn")

单词 Hello World 出现在 MATLAB® 命令行窗口中。

假设您有一个名为 myModel 的模型。该模型包含一个名为 myMaskedSubsystem 的封装子系统。

打开该封装子系统的内容。

load_system("myModel")
open_system("myModel/myMaskedSubsystem","force")

假设您有两个模型 myModel1myModel2。您可以用一个命令打开这两个模型。

创建一个由模型名称组成的字符串数组。

models = ["myModel1","myModel2"]

打开模型。

open_system(models)

假设您有名为 vssBlockVariant Subsystem 模块。该 Variant Subsystem 包含两个变体选择项。

在新窗口中打开 Variant Subsystem 的活动选择项

open_system("vssBlock","ActiveChoice","window")

假设您有一个名为 myModel 的模型。该模型包含一个名为 myMaskedSubsystem 的封装子系统。

在新选项卡中打开封装子系统的内容。

load_system("myModel")
open_system("myModel/myMaskedSubsystem","force","tab")

输入参数

全部折叠

模型、引用的模型、库、子系统或模块路径,指定为字符串或字符向量。要打开多个此类项,请将路径指定为字符串数组或字符向量元胞数组。如果您要打开的模型不在 MATLAB 路径中,请指定模型文件的完整路径。使用完整名称(例如 f14/Controller/Gain)指定已打开或已加载的模型中的模块或子系统。在 UNIX® 系统上,模型的完全限定路径名称可以用波浪号 (~) 开头,表示它是您的主目录。

数据类型: string | char

模型或库的完整名称或路径,指定为字符串或字符向量。要打开多个此类项,请将名称或路径指定为字符串数组或字符向量元胞数组。

数据类型: string | char

已打开或已加载的模型中的子系统的完整名称或路径,指定为字符串或字符向量。要打开多个此类项,请将名称或路径指定为字符串数组或字符向量元胞数组。

数据类型: string | char

打开或加载的模型中模块或子系统的完整名称或路径,指定为字符串或字符向量。要打开多个此类项,请将名称或路径指定为字符串数组或字符向量元胞数组。

数据类型: string | char

打开或加载的模型中 Variant Subsystem 模块的完整名称或路径,指定为字符串或字符向量。要打开多个此类项,请将名称或路径指定为字符串数组或字符向量元胞数组。有关 Variant Subsystem 模块的详细信息,请参阅Variant Subsystem

数据类型: string | char

提示

要在模型层次结构的上下文中打开引用模型,请使用 open 函数和 Simulink.BlockPath 对象。

版本历史记录

在 R2006a 之前推出