主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

为模型添加注解

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

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

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

  • 文本

  • 图像

  • 使用 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 编辑器选项板中,点击 Image

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

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

    Image icon in canvas

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

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

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

    提示

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

    • 如果您调整了图像大小,可将其重置为原始大小。右键点击图像,然后选择格式 > 还原大小

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

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

要将剪贴板中的图像粘贴到注解中,右键点击画布并选择粘贴

要在每个新模型中包含图像(例如公司徽标),请将图像添加到默认模板中。请参阅Create Template from Model

要创建注解的副本,请在点击并拖动注解的同时按 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. 右键点击注解。

  2. 从上下文菜单中,选择转换为标记

注意

无论您设置的背景颜色是什么,标记都有浅蓝色背景。如果将标记更改为注解,则注解将返回到您设置的背景颜色。

要将标记更改回注解,右键点击标记并选择转换为注解

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

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

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

向注解添加超链接

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

要向注解添加超链接:

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

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

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

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

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

  4. 点击确定

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

您还可以将文本或图像注解与运行的回调函数关联:

  • 当分段变量加载包含注解的模型时(加载函数)

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

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

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

例如,添加一个注解,在加载或关闭模型时修改变量 x 的值:

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

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

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

    an=getCurrentAnnotation;
  4. 要指定注解的加载函数,请输入此命令。

    an.LoadFcn="x=x+1;";
  5. 要指定注解的删除函数,请输入此命令。

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

  7. 关闭模型并检查工作区面板中 x 的值。x 的值 2,因为删除函数已将该值减少了 1

  8. 重新打开模型并检查工作区面板中 x 的值。x 的值 3,因为加载函数将该值增加了 1

另请参阅

主题