Main Content

hilite_system

突出显示模块、信号线、端口或注释

说明

示例

hilite_system(obj) 使用默认突出显示样式在打开的模型中突出显示模块、信号线、端口或注释。将 hilite_system 用于端口可突出显示连接到端口的信号线。每次使用 hilite_system 都会叠加突出显示。突出显示不会随模型一起保存。

示例

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

示例

全部折叠

突出显示一个模块

打开示例。然后,打开 slexAircraftExample 模型。

open_system('slexAircraftExample')

突出显示名为 Controller 的 Subsystem 模块。当使用默认突出显示样式时,模块以红色轮廓和黄色填充突出显示。

hilite_system('slexAircraftExample/Controller')

突出显示多个模块

您可以用一个命令突出显示多个模块。

使用一个命令突出显示名为 Actuator Model 的 Transfer Fcn 模块和名为 Aircraft Dynamics Model 的 Subsystem 模块。将要突出显示的模块指定为字符向量元胞数组。

hilite_system({'slexAircraftExample/Actuator Model','slexAircraftExample/Aircraft Dynamics Model'})

或者,按顺序突出显示这些模块。

hilite_system('slexAircraftExample/Actuator Model')
hilite_system('slexAircraftExample/Aircraft Dynamics Model')

突出显示的模块在您突出显示其他模块时会保持突出显示。

您可以通过指定以下选项之一来突出显示信号线:

  • 信号线句柄

  • 信号线连接的端口

此示例说明如何获得名为 wGust 的信号线的句柄。有关如何以交互方式突出显示信号线的信息,请参阅突出显示信号的源和目标

打开示例。然后,打开 slexAircraftExample 模型。

open_system('slexAircraftExample')

获取名为 wGust 的信号线的句柄。

h=find_system('slexAircraftExample','FindAll','on','type','line','name','wGust');

突出显示名为 x1 的信号线。

hilite_system(h)

当您使用默认突出显示样式时,信号线会以红色突出显示。

您可以通过指定以下选项之一来突出显示信号线:

  • 信号线句柄

  • 信号线连接的端口

此示例说明如何获取名为 Actuator Model 的 Transfer Fcn 模块的输入端口的句柄。有关如何以交互方式突出显示信号线的信息,请参阅突出显示信号的源和目标

打开示例。然后,打开 slexAircraftExample 模型。

open_system('slexAircraftExample')

获取 slexAircraftExample 模型中所有端口的句柄。

h=find_system('slexAircraftExample','FindAll','on','type','port');

获取与端口对应的完整路径名称。

names=getfullname(h);

获取 names 元胞数组中包含关键字 'Actuator\nModel' 的端口的索引。

index=find(contains(names,sprintf('Actuator\nModel')));

index(1) 对应于名为 Actuator Model 的 Transfer Fcn 模块的输入端口。index(2) 对应于输出端口。

突出显示输入端口。

hilite_system(h(index(1)))

使用默认突出显示样式时,连接到指定端口的信号线会以红色突出显示。

打开示例。然后,打开 slexAircraftExample 模型。

open_system('slexAircraftExample')

获取名为 Vertical Gust wGust, ft/sec 的 Subsystem 模块的 Inport 模块的句柄。

h=Simulink.findBlocks('slexAircraftExample/Aircraft Dynamics Model','name','Vertical Gust wGust (ft/sec)');

突出显示端口。

hilite_system(h)

Aircraft Dynamics Model 子系统会打开并显示名为 Vertical Gust wGust, ft/sec 的 Inport 模块。

当使用默认突出显示样式时,端口模块和包含该端口模块的 Subsystem 模块会以红色轮廓和黄色填充突出显示。

打开示例。然后,打开 slexAircraftExample 模型。

open_system('slexAircraftExample')

获取位于 slexAircraftExample 模型顶部的注释的句柄。

h=find_system('slexAircraftExample','FindAll','on','type','annotation','name','Aircraft Longitudinal Flight Control');

突出显示注释。

hilite_system(h)

当使用默认突出显示样式时,注释会突出显示为具有黄色填充的红色文本。

打开示例。然后,打开 vdp 模型。

open_system('vdp')

突出显示名为 Mu 的封装子系统模块。

hilite_system('vdp/Mu')

要从名为 Mu 的封装子系统模块中取消突出显示,请将突出显示样式指定为 'none'

hilite_system('vdp/Mu','none')

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

指定模块的突出显示样式

打开示例。然后,打开 vdp 模型。

open_system('vdp')

使用样式 'fade' 突出显示名为 Mu 模块的封装子系统模块。

hilite_system('vdp/Mu','fade')

指定信号线的突出显示样式

获取名为 x1 的信号线的句柄。

h=find_system('vdp','FindAll','on','type','line','name','x1');

使用样式 'fade' 突出显示名为 x1 的信号线。

hilite_system(h,'fade')

您可以使用 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'

现在,您可以自定义 debug 突出显示样式。

打开示例。然后,打开 f14 模型。

open_system('f14')

自定义突出显示样式 'debug'

set_param(0,'HiliteAncestorsData',struct('HiliteType','debug','ForegroundColor','darkBlue','BackgroundColor','lightBlue'));

使用 'debug' 突出显示样式来突出显示模块。

hilite_system('f14/Controller/Alpha-sensor Low-pass Filter','debug')

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

打开 RollAxisAutopilot 模型。

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

为模型生成代码。在 Simulink® 工具条中,在 App 选项卡的代码生成下,点击 Embedded CoderC 代码选项卡会出现在工具条中。在 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 许可证。

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

  • Root

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

示例: 'vdp/Mu', 'sldemo_fuelsys/fuel_rate_control/airflow_calc', 'vdp:3', '<Root>/Mu'

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

  • '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'

版本历史记录

在 R2006a 之前推出

另请参阅

(Embedded Coder) |