主要内容

创建自定义库

您可以创建自己的库，并可选择将其添加到Simulink中金宝app®库浏览器．将库保存为.slx文件，就像你做一个模型。但是，您不能在库中进行模拟，并且每次关闭库时，库都会被锁定以进行编辑。在对库进行更改之前，必须解锁库。看到锁定和解锁库．

  1. 从Simulink金宝app开始页中，选择空白的图书馆并点击创建库．

    请注意

    库浏览器只支持库。金宝app不能在Library Browser中显示模型的内容。

  2. (可选)在Simulink数据字典中定义要用于块接口的数据类型。金宝app然后，将数据字典附加到库。当库用户将一个块从库中拖到模型中时，库用户自动获得对字典中包含的数据的访问权。

  3. 向新库中添加块。对块进行您想要的更改，例如更改块参数、添加掩码或向子系统添加块。

    库层次结构中的子系统名称必须唯一。例如，不要创建这样的层次结构Subsystem_Name1 / Subsystem_Name2 / Subsystem_Name1．

  4. 添加注释或图像。在library Browser中右键单击想要出现在库中的文件，然后选择在图书馆浏览器中显示．

  5. 如果计划将库添加到库浏览器，则可以对库中的块和注释进行排序。默认情况下，它们在Library Browser中按字母顺序显示，首先是子系统，然后是块，然后是注释。库的用户可以使用library Browser上下文菜单选择按字母顺序或按您指定的顺序查看它们。当用户选择此选项时，它们在库中出现的顺序决定了它们在library Browser中的库中网格中的出现顺序。

  6. 如果希望库显示在库浏览器中，请启用EnableLBRepository属性，然后再保存库。

    set_param (gcs,“EnableLBRepository”，“上”）;

  7. 拯救图书馆。

    保存库的位置取决于您计划如何使用它。如果您想将其添加到库浏览器中，请将其保存到MATLAB的文件夹中®路径或将位置添加到MATLAB路径。否则，将其保存到使用块的模型可以访问它的位置。

如果希望库显示在库浏览器中，还必须创建一个函数slblocks在将库添加到浏览器的MATLAB路径上。有关显示向浏览器添加库的完整步骤的示例，请参见向库浏览器添加库．

请注意

若要使用自定义库更新库浏览器，请右键单击库浏览器库列表中的任意位置并选择刷新库浏览器．刷新库浏览器还会更新快速插入菜单，以包括当前生效的自定义库中的块。快速插入菜单允许您在不离开画布的情况下向模型添加块。单击画布并开始输入以从快速插入菜单中添加块。

自定义库的数据字典

当定义要在块接口上使用的数据类型(例如总线和枚举类型)时，可以将这些数据类型存储在附加到库的数据字典中，从而使用户可以使用这些数据类型。当用户将一个数据块从库中拖到模型中时，模型会自动获得对字典中包含的数据的访问权。

  1. 创建数据字典。

  2. 在字典中，定义总线对象、枚举类型或其他将用于库块的接口定义的数据对象。

  3. 通过使用，以编程方式将字典作为库的外部数据源附加set_param或在UI中使用外部数据选项卡。Model Explorer将附加的字典及其内容显示为库的外部数据源。

  4. 若要保存数据字典规范，请保存库。

您在库中定义的类型现在可以在开发库块时使用。看到链接数据字典到自定义库．

自定义库的块

您的库可以包含您需要的块，并根据您的目的进行配置。库中的子系统、屏蔽块和图表成为模型中的实例链接块，并在库中更改它们时保持更新。在创建库时，了解自定义块也很有用。看到设计和创建一个自定义块．

您可以在自定义库中创建具有特定目的设置的块。

创建子库

如果您的库包含许多块，您可以将这些块分组到子系统或单独的子库中。要创建子库，您可以创建子库块的库，并从子系统块在父库。

  1. 在要添加子库的库中，添加子系统块。

  2. 在子系统块，删除默认的输入输出端口。

  3. 如果需要，可以为子系统创建一个掩码，用于显示传达子库目的的文本或图像。

  4. 在子系统块属性中，设置OpenFcn回调到要引用的库的名称。

要了解更多关于面具的信息，请参见创建一个简单的蒙版．

阻止库块链接到实例

您可以配置一个库块，以便从它创建的实例不是链接块，而是副本。设置块的CopyFcn回调。

set_param (gcbh“LinkStatus”，“没有”）;

在链接块中包含块描述

若要添加出现在链接块中的描述，请对库块进行掩码，并将该描述添加到文档蒙版的面板。通过块的属性添加到库块的描述不会出现在链接块上。

配置块与关键字快速插入

您可以将一个或多个关键字添加到库中的块中。关键字允许您通过输入关键字或块名从快速插入菜单中将块添加到模型中。

例如，假设您有一个定制获得在你的库中阻塞。可以添加关键字我获得到木台上去。然后，您可以通过输入将块添加到您的模型中我获得在快速插入菜单。

请注意

不能将关键字添加到的块中常用积木因为它们是一个查看各种库中经常使用的块的地方。中可用的块中添加关键字常用积木，请确保您在定义块的库中设置它。

若要将关键字添加到库中的块，请使用set_param与“BlockKeywords”参数。可以使用字符向量、字符串标量或字符串数组作为值。例如:

set_param (gcb),“BlockKeywords”, {“我的”，“增益”}) set_param (gcb),“BlockKeywords”，“我的积分”）

请注意

关键字中金宝app支持的特殊字符为'&'， '('， ')'， '+'， '@'， '!'．

请注意

快速插入菜单还支持使用国际化关键字搜索除英语以外的其他金宝app语言的块。

为库浏览器配置OpenFcn回调子系统

A的常用用法子系统块在自定义库中的作用OpenFcn属性以打开库，从而创建库层次结构。但是，您可以使用OpenFcn的回调属性。子系统块用于其他目的，例如运行MATLAB代码或打开链接。

如果一个子系统块在库中是空的OpenFcn回调函数包含执行除指向库之外的操作的代码，则需要添加“ShowInLibBrowser”为子系统设置掩码参数，使其显示在库浏览器中。

  1. 右键单击子系统并选择面具>创建面具．如果该块已经有掩码，请选择编辑蒙版代替。

  2. 在蒙版编辑器中参数&对话框选项卡，在控制窗格中,单击复选框．

  3. 在对话框窗格中，设置新复选框的提示符和名称为ShowInLibBrowser并点击好吧．

自定义库中的注释

您可以在自定义库中添加注释，也可以选择将它们显示在library Browser中。例如，您可以添加记录库的注释。您还可以添加注释，库的用户可以从library Browser中将注释添加到他们的模型中。注释可以包含文本和图像，也可以显示方程式。注释也可以在单击时执行操作。中了解有关注释的更多信息使用注释和注解描述模型．

可以将注释中的标注行添加到库中的块中。但是，标注不会出现在库浏览器中。

如果希望注释显示在Library Browser中，在将其添加到库后，右键单击它并选择在图书馆浏览器中显示．如果希望当用户将鼠标悬停在Library Browser中的注释上时，说明显示在工具提示中，请以编程方式将说明添加到注释中。在MATLAB命令提示符中，输入:

set_param (annotationHandle,“描述”、“descriptionText）

要获得注释句柄，使用find_system．这个示例获取库中的所有注释mylib：

Ann = find_system(“mylib”，“FindAll”，“上”，“类型”，“注释”）;

要获得特定的注释，请打开正则表达式搜索并使用“名字”论点:

安= find_system (mylib2, FindAll”、“在”、“正则表达式”,……“上”、“类型”、“注释”,“名称”、“matchingText”);

向库浏览器添加库包括添加出现在库浏览器中的注释的说明。

锁定和解锁库

当您关闭一个库时，它将被锁定以进行编辑。当您下次打开它时，如果您想对它进行更改，请解锁它。单击库的左下角的锁定徽章来解锁它。此外，如果您尝试修改一个锁定的库，则会有消息提示您解锁它。

您可以通过编程方式解锁库。在MATLAB命令提示符中，输入:

set_param ('library_name”、“锁”,“关闭”);

要以编程方式锁定库，输入:

set_param ('library_name”、“锁”、“在”);

防止禁用图书馆链接

默认情况下，库中的块的用户可以禁用到库块的链接。如果要控制链接块的编辑并防止块用户禁用链接，可以将链接锁定到库。锁定库链接可以防止用户对块实例进行任何更改。

  • 在你的图书馆，在图书馆选项卡上,单击锁的链接．

要了解块用户如何与来自锁定库的块交互，请参见将链接锁定到库中的块．

相关的话题