hilite_system

R2026b

突出显示模块、信号线或注解

全页折叠

语法

hilite_system(obj)
hilite_system(obj,style)

描述

hilite_system(obj) 在打开的模型中使用默认突出显示样式突出显示指定的模块、信号线或注解。每次使用该函数都会添加到突出显示中。突出显示不会随模型一起保存。

示例

hilite_system(obj,style) 使用指定的突出显示样式。

示例

示例

全部折叠

假设您有一个名为 myModel 的模型。该模型包含名为 myBlock 的 Integrator 模块。一条分支信号线将 myBlock 的输出端口连接到多个其他模块。突出显示该信号线，包括所有分支。

在此示例中，您要获取一条信号线（包括所有分支）的句柄。您可以通过使用 get_param 函数查询哪些信号线连接到给定模块来获取信号线句柄。如果您在输出端口查询连接到信号线的模块，get_param 函数将返回整个信号线（包括所有分支）的句柄。如果您在输入端口查询连接到信号线的模块之一，该函数将返回连接到该模块的分支的句柄。在此示例中，您要获取整个信号线的信号线句柄，因此您要在输出端口查询连接到信号线的模块。

获取连接到 Integrator 模块的所有信号线的句柄。

hAll = get_param("myModel/myBlock","LineHandles");

获取连接到 Integrator 模块输出端口的信号线的句柄。

h = hAll.Outport;

以默认样式突出显示该信号线，包括所有分支。

hilite_system(h);

假设您有一个名为 myModel 的模型，它包含一个名为 myBlock1 的模块和一个名为 myBlock2 的模块。

以默认样式突出显示这些模块。

blockPaths = "myModel/"+["myBlock1";"myBlock2"];
hilite_system(blockPaths);

以查找样式突出显示这些模块。

hilite_system(blockPaths,"find");

假设您有名为 myModel 的模型，其中包含名为 myBlock 的突出显示模块。

通过将突出显示样式设置为 none 来取消该模块的突出显示。

hilite_system("myModel/myBlock","none")

或者，通过按 Ctrl+Shift+H（在 macOS 上，则按 Command+Shift+H）以交互方式取消突出显示。

假设您有一个名为 myModel 的模型。该模型包含 Integrator 模块。一条分支信号线将 Integrator 模块的输出端口连接到多个其他模块，包括名为 myBlock 的模块。突出显示连接到 myBlock 的信号线分支。

在此示例中，您要获取信号线分支的句柄。您可以通过使用 get_param 函数查询哪些信号线连接到给定模块来获取信号线句柄。如果您在输出端口查询连接到信号线的模块，get_param 函数将返回整个信号线（包括所有分支）的句柄。如果您在输入端口查询连接到信号线的模块之一，该函数将返回连接到该模块的分支的句柄。在此示例中，您要获取分支的信号线句柄，因此您要在输入端口查询连接到该分支的模块。

获取连接到 myBlock 的所有信号线的句柄。

hAll = get_param("myModel/myBlock","LineHandles");

获取连接到 myBlock 输入端口的信号线的句柄。

h = hAll.Inport;

以默认样式突出显示连接到 myBlock 的信号线分支。

hilite_system(h);

假设您有一个名为 myModel 的模型。在模型中，突出显示包含单词 note 的所有注解。

获取包含单词 note 的所有注解的句柄。

h = find_system("myModel",FindAll="on",Regexp="on",CaseSensitive="off",Name=".*note.*");

以默认样式突出显示这些注解。

hilite_system(h);

您可以使用 set_param 函数在根级模型上设置 HiliteAncestorsData 参数的值来自定义突出显示样式。

set_param(0,HiliteAncestorsData=hiliteData)

将 hiliteData 指定为一个具有以下字段的结构体数组：

  • 'HiliteType' - 要自定义的突出显示样式，例如 'user1'、'debug' 或 'error'

  • 'ForegroundColor' - 模块填充颜色

  • 'BackgroundColor' - 模块轮廓颜色

'ForegroundColor' 和 'BackgroundColor' 支持的值包括：

  • 'black'

  • 'white'

  • 'gray'

  • 'red'

  • 'orange'

  • 'yellow'

  • 'green'

  • 'darkGreen'

  • 'blue'

  • 'lightBlue'

  • 'cyan'

  • 'magenta'

自定义调试突出显示样式。

myHiliteData = struct(HiliteType='debug',ForegroundColor='darkBlue',BackgroundColor='magenta');
set_param(0,HiliteAncestorsData=myHiliteData);

假设您有一个名为 myModel 的模型，它包含一个名为 myBlock 的模块。使用自定义调试样式突出显示该模块。

hilite_system("myModel/myBlock","debug");

如果您拥有 Simulink® Coder™ 许可证，则可以从生成的代码追溯到模型中对应的源模块。

打开 RollAxisAutopilot 模型。

openExample("ecoder/GettingStartedEcoderExample")
open_system("RollAxisAutopilot");

为模型生成代码。在 Simulink® 工具条中，在 App 选项卡的代码生成下，点击 Embedded Coder。C 代码选项卡会出现在工具条中。在 C 代码选项卡上，点击编译。

在编辑器或代码生成报告中，打开生成的源文件或头文件。查看代码行时，请注意对应于感兴趣代码的可追溯性标记。

In the RollAsixAutopilot.c file, this line is selected: Inport: '<Root>/Turn_Knob'. In the RollAxisAutopilot model, the Inport block named Turn_Knob is selected.

使用可追溯性标记突出显示模块。

hilite_system("<Root>/Turn_Knob")

突出显示子系统中的模块。

hilite_system("<S1>/RateGain")

输入参数

全部折叠

要突出显示的一个或多个模块、信号线或注解，指定为以下项之一：

  • 句柄

    要突出显示信号线，请指定信号线的句柄或连接到信号线的端口的句柄。

  • 模块路径，格式化为字符串、字符串数组、字符向量或字符向量元胞数组。

  • Simulink.BlockPath 对象

  • Simulink 标识符

  • 来自 Simulink Coder 生成代码的注释的可追溯性标记

    使用可追溯性标记需要 Simulink Coder 许可证。

有关获取句柄和路径的信息，请参阅Get Handles and Paths。

可追溯性标记的格式为 <model>/block，其中 model 是以下任一项：

  • Root

  • 在代码生成期间由 Simulink 分配的唯一模型编号

示例: "myModel/myBlock"

示例: ["myModel/myBlock1","myModel/myBlock2"]

示例: "<Root>/myBlock"

数据类型: double | array of doubles | string | string array | character vector | cell array of character vectors | Simulink.BlockPath object

突出显示样式，指定为下列值之一。您可以自定义任一样式的外观。请参阅使用自定义样式突出显示。

  • "default" - 默认颜色方案：红色轮廓，黄色填充。

  • "none" - 清除突出显示。

    要清除所有突出显示，请按 Ctrl+Shift+H。在 macOS 上，请按 ⌘+Shift+H。

  • "debug" - 使用默认的颜色方案。

  • "different" - 应用红色轮廓，白色填充。

  • "error" - 使用默认的颜色方案。

  • "fade" - 应用灰色轮廓，白色填充。

  • "find" - 应用深蓝色轮廓，蓝色填充。

  • "lineTrace" - 应用红色轮廓，蓝色填充。

  • "unique" - 深蓝色轮廓，白色填充。

  • "user1"、"user2"、"user3"、"user4"、"user5" - 应用自定义突出显示：默认为黑色轮廓，白色填充（即，没有突出显示）。

此外，您还可以使用以下颜色方案。第一个词是轮廓，第二个词是填充颜色。

  • "orangeWhite"

  • "blackWhite"

  • "redWhite"

  • "blueWhite"

  • "greenWhite"

数据类型: string | character vector

版本历史记录

在 R2006a 之前推出

另请参阅

(Embedded Coder) |

主题