为模型添加注解
您可以使用注解来标记您的模块图并在画布中提供有关其内容的信息。您还可以添加可在点击后执行某种操作的注解。
您可以创建文本注解或图像注解。
文本注解可以包含以下元素的任意组合:
文本
图像
使用 LaTeX 和 MathML 命令生成的方程式
打开网站或运行 MATLAB® 函数的超链接
图像注解只能包含图像。当您想要独立于文本调整图像大小或移动图像时,请使用图像注解。
要以编程方式注解模型,请参阅Create and Edit Annotations Programmatically。
为了提供模型的大量背景信息或说明而又不使画布混乱,您可以写注释。有关详细信息,请参阅Write In-Model Documentation Using Notes。
创建文本注解
要创建文本注解:
提示
或者,要创建文本注解,请在模型窗口左边缘的 Simulink® 编辑器选项板中点击注解 。然后,点击画布并键入注解文本。
要使用来自另一个应用程序的文本创建注解,请将文本从应用程序拖到画布上。
要将剪贴板中的文本粘贴到注解中,右键点击画布并选择粘贴。
要创建注解的副本,请在点击并拖动注解的同时按 Ctrl。
向文本注释添加注解
要将方程式添加到文本注解中:
在格式工具栏中,点击“插入公式”。
在“编辑方程”对话框中,输入 LaTeX 或 MathML 代码以生成方程。有关支持的 LaTeX 命令,请参阅插入 LaTeX 方程。
要格式化公式,请使用格式工具栏。您可以更改文本字体、字体大小、字体颜色或突出显示颜色。
要编辑方程代码,请双击注解中的方程。
向文本注解添加符号
要在注解文本中添加符号或希腊字母,请键入将这些符号生成到注解文本中的 TeX 格式化命令。
将支持的 TeX 命令添加到注解中。例如,添加以下文本:
\sigma \kappa \mu
在已选中注解或文本光标在注解中的状态下,在属性检查器中的外观下,选择启用 TeX 命令。
当您在注解外部点击时,TeX 命令在注解中显示为符号。
该表显示您可以直接键入 Simulink 注解文本中的 TeX 字符。
支持的 TeX 字符 | ||
---|---|---|
|
|
|
创建图像注解
您可以使用图像注解将图像添加到 Simulink 画布,以传达有关模型的信息,或作为整个模块图或模型元素组的背景图像。
要将图像添加到模型:
在模型窗口左边缘的 Simulink 编辑器选项板中,点击 Image。
点击画布上您想要放置图像的位置。
双击画布中的图像图标。
在打开的文件定位器中,找到并打开要添加的图像。
如果画布中显示的图像太大或太小,要调整其大小,点击并拖动其一个角。
提示
要按比例调整大小,请在拖动时按住 Shift。
如果您调整了图像大小,可将其重置为原始大小。右键点击图像,然后选择格式 > 还原大小。
要使用来自其他应用程序的图像创建注解,请将图像从该应用程序拖到画布上。
要使用图像文件创建注解,请将图像文件拖到画布上。
要将剪贴板中的图像粘贴到注解中,右键点击画布并选择粘贴。
要在每个新模型中包含图像(例如公司徽标),请将图像添加到默认模板中。请参阅Create Template from Model。
要创建注解的副本,请在点击并拖动注解的同时按 Ctrl。
要将图像更改为其他图像,请双击该图像。在打开的文件定位器中,找到并打开要使用的新图像。
将注解与模块和区域相关联
您可以在模型中的注解和模块或区域之间添加一条线。这些注解连接线在两端动态连接,以便它们根据需要移动和调整大小来保持连接。
要添加连接线:
将光标暂停在希望线条开始的注解轮廓上。
当光标是十字准线时,将连接线拖到要作为线条端点的模块或区域。
要指定注解连接线的颜色或宽度,请右键点击连接线,然后使用格式菜单进行设置。
隐藏注解
您无法隐藏注解,但可以将注解转换为标记,然后隐藏标记。
将注解转换为标记:
右键点击注解。
从上下文菜单中,选择转换为标记。
注意
无论您设置的背景颜色是什么,标记都有浅蓝色背景。如果将标记更改为注解,则注解将返回到您设置的背景颜色。
要将标记更改回注解,右键点击标记并选择转换为注解。
要隐藏模型中的标记,请在格式选项卡中点击显示标记。
要显示隐藏的标记注解,请在格式选项卡中点击显示标记。
在模型引用层次结构中,显示标记和隐藏标记仅应用于当前模型引用级别。
向注解添加超链接
您可以向打开网页或运行 MATLAB 函数的注解添加超链接。
要向注解添加超链接:
在注解中,选择您希望具有交互功能的内容。
右键点击并从上下文菜单中选择超链接。
在“超链接”对话框中,执行以下操作之一:
选择 URL 地址,并在代码框中输入网址。
选择 MATLAB 代码,并在代码框中输入 MATLAB 函数。
点击确定。
当您点击注解时,将打开您指定的网页或运行您指定的代码。
您还可以将文本或图像注解与运行的回调函数关联:
当分段变量加载包含注解的模型时(加载函数)
当您以编程方式删除注解或以交互方式或编程方式关闭模型(删除函数)时。
要将加载函数与注解相关联,请以编程方式将
Simulink.Annotation
对象的LoadFcn
属性设置为所需的函数。要将删除函数与注解相关联,请以编程方式将
Simulink.Annotation
对象的DeleteFcn
属性设置为所需的函数。
例如,添加一个注解,在加载或关闭模型时修改变量 x
的值:
使用文本
increment x
向您的模型添加注解。要初始化
x
,请在 MATLAB 命令行窗口中输入此命令。x=3;
要以编程方式获取注解,请在模型中选择注解。然后,输入此命令。
an=getCurrentAnnotation;
要指定注解的加载函数,请输入此命令。
an.LoadFcn="x=x+1;";
要指定注解的删除函数,请输入此命令。
an.DeleteFcn="x=x-1;";
保存模型。
关闭模型并检查工作区面板中
x
的值。x
的值2
,因为删除函数已将该值减少了1
。重新打开模型并检查工作区面板中
x
的值。x
的值3
,因为加载函数将该值增加了1
。