主要内容

为模型添加注解

您可以使用注解来标注模块图,并在画布中提供有关其内容的信息。您还可以添加可在点击后执行某种操作的注解。

您可以创建文本注解或图像注解。

文本注解可以包含以下元素的任意组合:

  • 文本

  • 图像

  • 使用 LaTeX 和 MathML 命令生成的方程

  • 打开网站或运行 MATLAB® 函数的超链接

图像注解只能包含图像。当您要独立于文本调整图像大小或移动图像时,请使用图像注解。

要以编程方式为模型添加注解,请参阅Create and Edit Annotations Programmatically

要在不使画布混乱的情况下为模型提供广泛的背景信息或说明,您可以编写备注。有关详细信息,请参阅Write In-Model Documentation Using Notes

创建文本注解

要创建文本注解,请执行以下操作:

  1. 双击画布上要添加注解的位置。快速插入菜单将打开。快速插入菜单中的默认选项是创建注解

    Quick insert menu showing the Create Annotation option

  2. Enter

  3. 键入注解文本。

    • 使用格式化工具栏编辑文本字体、字号、字体颜色或突出显示颜色。

    • 要创建项目符号列表或有序列表,请选择注解文本,右键点击所选内容,然后选择段落 > 项目符号段落 > 编号

    • 要对齐注解文本,请选择注解文本,右键点击所选内容,然后选择段落 > 对齐

    要向注解添加图像、表或方程,请在格式化工具栏中点击“插入图像”、“插入表” 或“插入方程”。有关添加方程的详细信息,请参阅向文本注解添加方程

    The formatting toolbar is above the annotation text. The Insert Image, Insert Table, and Insert Equation buttons are labeled.

    要添加超链接,请在注解中选择您希望具有交互功能的内容。右键点击所选内容并选择超链接或按 Ctrl+K 键。有关添加超链接的详细信息,请参阅向注解添加超链接

提示

或者,要创建文本注解,请在模型窗口左边缘的 Simulink® 编辑器选项板中,点击“注解”。然后,点击画布并键入注解文本。

要使用来自另一个应用程序的文本创建注解,请将文本从该应用程序拖到画布上。

要将剪贴板中的文本粘贴到注解中,请右键点击画布,点击箭头 ,然后点击“粘贴”按钮

要创建注解副本,请在点击并拖动注解的同时按住 Ctrl 键。

向文本注解添加方程

要向文本注解添加方程,请执行以下操作:

  1. 在格式化工具栏中,点击“插入方程”。

    Annotation formatting toolbar, with the cursor hovering over the Insert Equation button

  2. 在“编辑方程”对话框中,输入 LaTeX 或 MathML 代码以生成方程。有关支持的 LaTeX 命令,请参阅插入 LaTeX 方程

    Edit Equation dialog box with LaTeX code in the Enter equation code box, and a preview of the resulting equations in the Preview box

  3. 要格式化方程,请使用格式化工具栏。您可以更改文本字体、字号、字体颜色或突出显示颜色。

要编辑方程代码,请双击注解中的方程。

向文本注解添加符号

要向注解文本添加符号或希腊字母,请在注解文本中键入生成这些符号的 TeX 格式设置命令。

  1. 将支持的 TeX 命令添加到注解中。例如,添加以下文本:

    \sigma \kappa \mu
    
  2. 在已选中注解或文本光标在注解中的状态下,在属性检查器中的外观下,选择启用 TeX 命令

    当您在注解外部点击时,TeX 命令在注解中显示为符号。

该表显示您可以直接键入 Simulink 注解文本中的 TeX 字符。

支持的 TeX 字符

alpha

beta

gamma

delta

epsilon

zeta

eta

theta

vartheta

iota

kappa

lambda

mu

nu

xi

pi

rho

sigma

varsigma

tau

upsilon

phi

chi

psi

omega

Gamma

Delta

Theta

Lambda

Xi

Pi

Sigma

Upsilon

Phi

Psi

Omega

forall

exists

ast

cong

sim

leq

infty

clubsuit

diamondsuit

heartsuit

spadesuit

leftarrow

uparrow

rightarrow

downarrow

circ

pm

geq

propto

partial

bullet

div

neq

equiv

approx

aleph

Im

Re

otimes

oplus

oslash

cap

cup

supseteq

supset

subseteq

subset

int

in

o

copyright

0

ldots

varpi

times

cdot

vee

wedge

perp

mid

Leftarrow

Rightarrow

Uparrow

Downarrow

prime

nabla

surd

angle

neg

lceil

rceil

lfloor

rfloor

langle

rangle

创建图像注解

您可以使用图像注解将图像添加到 Simulink 画布中,这些图像可以作为整个模块图或模型元素组的背景图像,传达有关模型或函数的信息。

要向模型添加图像,请执行以下操作:

  1. 在模型窗口左边缘的 Simulink 编辑器选项板中,点击图像

    Upper left corner of Simulink Window with pointer hovering over the Image button

  2. 点击画布上要放置图像的位置。

    Image icon in canvas

  3. 双击画布中的图像图标。

  4. 在打开的文件定位器中,找到并打开您要添加的图像。

  5. 如果画布中显示的图像太大或太小,您可以点击并拖动其角点之一来调整其大小。

    提示

    • 要按比例调整大小,请在拖动时按住 Shift

    • 如果您调整了图像大小,可将其重置为原始大小。右键点击图像,然后点击“还原大小”按钮

要使用来自另一个应用程序的图像创建注解,请将图像从该应用程序拖到画布上。

要使用图像文件创建注解,请将图像文件拖到画布上。

要将剪贴板中的图像粘贴到注解中,请右键点击画布,点击箭头 ,然后点击“粘贴”按钮

要在每个新模型中都包含某个图像(例如公司徽标),请将该图像添加到默认模板中。请参阅从模型创建模板

要创建注解副本,请在点击并拖动注解的同时按住 Ctrl 键。

要将该图像更改为不同图像,请双击该图像。在打开的文件定位器中,找到并打开您要使用的新图像。

将注解与模块和区域相关联

您可以在模型中的注解和模块或区域之间添加一条线。这些注解连接线在两端动态连接,以便它们根据需要移动和调整大小来保持连接。

要添加连接线,请执行以下操作:

  1. 将光标暂停在注解边框上要开始连接线的位置。

    Block diagram with line between an annotation and an input block

  2. 当光标是十字准线时,将连接线拖到要作为线条端点的模块或区域。

Block diagram with one line between an annotation and an input block, and another line between the same annotation and an area

要指定注解连接线的颜色或宽度,请右键点击连接线,然后使用格式菜单进行设置。

隐藏注解

您无法隐藏注解,但您可以将注解转换为标记,然后隐藏该标记。

要将注解转换为标记,请执行以下操作:

  1. 右键点击注解,然后在可见性下,选择标记

注意

无论您设置何种背景颜色,标记都具有浅蓝色背景。如果您将标记更改为注解,该注解将恢复使用您设置的背景颜色。

要将标记改回注解,请右键点击该标记,然后在可见性下,选择注解

要隐藏模型中的标记,请在格式选项卡中,点击显示标记

要显示隐藏的标记注解,请在格式选项卡中,点击显示标记

在模型引用层次结构中,显示标记隐藏标记仅应用于当前模型引用级别。

向注解添加超链接

您可以向注解添加可打开网页或运行 MATLAB 函数的超链接。

要向注解添加超链接,请执行以下操作:

  1. 在注解中,选择您希望具有交互功能的内容。

  2. 右键点击并从上下文菜单中选择超链接

  3. 在“超链接”对话框中,执行以下操作之一:

    • 选择 URL 地址,并在代码框中输入网址。

    • 选择 MATLAB 代码,并在代码框中输入 MATLAB 函数。

  4. 点击确定

当您点击注解时,您指定的网页将打开,或您指定的代码将运行。

您也可以将文本或图像注解与在以下情况下运行的回调函数相关联:

  • 当您加载包含注解的模型时(load 函数)

  • 当您以编程方式删除注解时,或当您以交互方式或以编程方式关闭模型时(delete 函数)。

  • 要将 load 函数与注解相关联,请以编程方式将 Simulink.Annotation 对象的 LoadFcn 属性设置为所需的函数。

  • 要将 delete 函数与注解相关联,请以编程方式将 Simulink.Annotation 对象的 DeleteFcn 属性设置为所需的函数。

例如,向您的模型添加注解,该注解在您加载或关闭模型时会修改变量 x 的值:

  1. 向您的模型添加文本为 increment x 的注解。

  2. 要初始化 x,请在 MATLAB 命令行窗口中输入以下命令。

    x=3;
  3. 要以编程方式获取注解,请在您的模型中选择该注解。然后,输入以下命令。

    an=getCurrentAnnotation;
  4. 要为注解指定 load 函数,请输入以下命令。

    an.LoadFcn="x=x+1;";
  5. 要为注解指定 delete 函数,请输入以下命令。

    an.DeleteFcn="x=x-1;";
  6. 保存模型。

  7. 关闭模型并在“工作区”面板中检查 x 的值。x 的值为 2,因为 delete 函数已将该值减小 1

  8. 重新打开模型并在“工作区”面板中检查 x 的值。x 的值为 3,因为 load 函数已将该值增大 1

另请参阅

主题