annotation

annotation(lineType,x,y) 创建一个在当前图窗中的两个点之间延伸的线条或箭头注释。将 lineType 指定为 'line'、'arrow'、'doublearrow' 或 'textarrow'。将 x 和 y 分别指定为 [x_begin x_end] 和 [y_begin y_end] 形式的二元素向量。

annotation(lineType) 在点 (0.3,0.3) 和 (0.4,0.4) 之间的默认位置创建注释。

annotation(shapeType,dim) 在当前图窗中创建具有特定大小和位置的矩形、椭圆或文本框注释。将 shapeType 指定为 'rectangle'、'ellipse' 或 'textbox'。指定 dim 作为 [x y w h] 形式的四元素向量。x 和 y 元素确定位置，w 和 h 元素确定大小。

annotation(shapeType) 会在默认位置创建注释，以使左下角位于 (0.3,0.3) 且宽度和高度均为 0.1。

annotation(___,Name,Value) 用于创建注释并将属性指定为名称-值对组参量。不同类型的注释支持不同属性。您可以使用上述语法中的任意输入参量组合指定属性。

annotation(container,___) 在由 container 指定的图窗、uipanel 或 uitab 中创建注释，而不是在当前图窗中创建。

an = annotation(___) 返回注释对象。返回的对象的类型取决于第一个输入参量。创建对象之后，可使用 an 修改其属性。可以使用上述任意语法指定输出参量。

示例

创建文本箭头注释

创建一个简单线图并向图窗添加文本箭头。用归一化的图窗坐标指定文本箭头位置，起点为 (0.3,0.6)，终点为 (0.5,0.5)。通过设置 String 属性指定文本说明。

figure
plot(1:10)
x = [0.3 0.5];
y = [0.6 0.5];
annotation('textarrow',x,y,'String','y = x ')

创建文本框注释

创建一个简单线图并向图窗添加文本框注释。通过设置 String 属性指定文本说明。通过将 FitBoxToText 属性设置为 'on'，强制使文本框紧贴文本。

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str,'FitBoxToText','on');

创建文本框注释而不设置 FitBoxToText 属性。文本框使用指定的宽度和高度，并根据需要进行文本换行。

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str)

创建包含多行文本的文本框注释

通过将 String 属性设置为元胞数组，创建包含多行文本的文本框注释。元胞数组的每个元素显示在单独的行上。通过将 FitBoxToText 属性设置为 'on'，强制使文本框紧贴文本。

figure
plot(1:10)
dim = [0.2 0.5 0.3 0.3];
str = {'Straight Line Plot','from 1 to 10'};
annotation('textbox',dim,'String',str,'FitBoxToText','on');

创建矩形注释

创建一个针状图并向图窗添加矩形注释。通过指定 Color 属性更改矩形轮廓的颜色。

figure
data = [2 4 6 7 8 7 5 2];
stem(data)
dim = [.3 .68 .2 .2];
annotation('rectangle',dim,'Color','red')

向图窗添加另一个矩形注释。通过设置 FaceColor 属性指定填充颜色。通过将 FaceAlpha 属性设置为 0（完全透明）到 1（完全不透明）之间的值添加透明度。

dim2 = [.74 .56 .1 .1];
annotation('rectangle',dim2,'FaceColor','blue','FaceAlpha',.2)

创建椭圆注释

创建一个简单线图并向图窗添加椭圆注释。将 dim 指定为包围椭圆的最小矩形的尺寸和位置。

figure
x = linspace(-4,4);
y = x.^3 - 12*x;
plot(x,y)

dim = [.2 .74 .25 .15];
annotation('ellipse',dim)

使用相同的尺寸绘制一个红色矩形，以显示椭圆如何填充矩形区域。

annotation('rectangle',dim,'Color','red')

组合使用两种类型的注释

创建一个简单的线图。然后，通过组合使用线条和箭头注释向图形添加一个弯曲箭头。

figure
plot(1:10)

xl = [.3 .3];
yl = [.3 .4];
annotation('line',xl,yl)

xa = [.3 .4];
ya = [.4 .4];
annotation('arrow',xa,ya)

创建后修改注释

向图窗添加一个文本箭头，并返回注释文本箭头对象 a。

figure
plot(1:10)
x = [0.3,0.5];
y = [0.6,0.5];
a = annotation('textarrow',x,y,'String','y = x ');

使用 a 修改注释文本箭头的属性。例如，将颜色更改为红色，将字体大小更改为 14 磅。

a.Color = 'red';
a.FontSize = 14;

请参阅注释属性页，了解每种类型的注释的属性列表。

输入参数

`lineType` — 线条注释的类型
`'line'` | `'arrow'` | `'doublearrow'` | `'textarrow'`

线条注释的类型，指定为下列值之一。

值	对象类型	示例
`'line'`	注释线条	`annotation('line',[.1 .2],[.1 .2])`
`'arrow'`	注释箭头	`annotation('arrow',[.1 .2],[.1 .2])`
`'doublearrow'`	注释双箭头	`annotation('doublearrow',[.1 .2],[.1 .2])`
`'textarrow'`	注释文本箭头。要在文本箭头的末尾添加文本，请使用 `String` 属性。	`annotation('textarrow',[.1 .2],[.1 .2],'String','my text')`

`shapeType` — 形状注释的类型
`'rectangle'` | `'ellipse'` | `'textbox'`

形状注释的类型，指定为下列值之一。

值	对象类型	示例
`'rectangle'`	注释矩形	`annotation('rectangle',[.2 .3 .4 .5])`
`'ellipse'`	注释椭圆	`annotation('ellipse',[.2 .3 .4 .5])`
`'textbox'`	注释文本框。要指定文本，请设置 `String` 属性。要自动调整文本框尺寸，使其紧贴在文本周围，请将 `FitBoxToText` 属性设置为 `'on'`。	`annotation('textbox',[.2 .3 .4 .5],'String','my text','FitBoxToText','on')`

`x` — 起点和终点的 x 坐标
`[x_begin x_end]` 形式的二元素向量

起点和终点的 x 坐标，指定为 [x_begin x_end] 形式的二元素向量。x 和 y 输入参量共同确定线条、箭头、双箭头或文本箭头注释的端点。注释从点 (x_begin, y_begin) 延伸到点 (x_end, y_end)。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 (0,0)，右上角映射到 (1,1)。要更改单位，请使用 Units 属性。

示例: x = [.3 .5]

`y` — 起点和终点的 y 坐标
`[y_begin y_end]` 形式的二元素向量

起点和终点的 y 坐标，指定为 [y_begin y_end] 形式的二元素向量。x 和 y 输入参量共同确定线条、箭头、双箭头或文本箭头注释的端点。注释从点 (x_begin, y_begin) 延伸到点 (x_end, y_end)。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 (0,0)，右上角映射到 (1,1)。要更改单位，请使用 Units 属性。

示例: y = [.3 .5]

`dim` — 尺寸和位置
`[x y w h]` 形式的四元素向量

尺寸和位置，指定为 [x y w h] 形式的四元素向量。前两个元素指定文本框、矩形或椭圆的左下角相对于图窗左下角的坐标。后两个元素分别指定注释的宽度和高度。

如果您创建椭圆，则 dim 是包围该椭圆的最小矩形的尺寸和位置。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 (0,0)，右上角映射到 (1,1)。要更改单位，请使用 Units 属性。

示例: dim = [.3 .4 .5 .6]

`container` — 注释的目标
图窗对象 | uipanel 对象 | uitab 对象

注释的目标，指定为图窗、uipanel 或 uitab 对象。例如，要将注释添加到特定图窗，请将图窗对象指定为函数的第一个输入参量。

f = figure;
annotation(f,'line',[.1 .2],[.2 .3])

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: annotation('rectangle',[.5 .5 .1 .1],'EdgeColor','r') 创建具有红色轮廓的矩形注释。

每种类型的注释对象支持一组不同的属性。有关每种类型的属性和描述的完整列表，请参阅相关联的属性页。

输出参量

`an` — 注释对象
标量

注释对象，以标量形式返回。返回的注释对象的类型取决于第一个输入参量。

第一个输入参量	返回的对象类型	属性页
`'line'`	线条	Line 属性
`'arrow'`	箭头	Arrow 属性
`'doublearrow'`	双箭头	DoubleEndArrow 属性
`'textarrow'`	文本箭头	TextArrow 属性
`'textbox'`	文本框	TextBox 属性
`'rectangle'`	矩形	Rectangle 属性
`'ellipse'`	椭圆	Ellipse 属性

详细信息