Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

annotation

创建注释

说明

示例

annotation(lineType,x,y) 创建一个在当前图窗中的两个点之间延伸的线条或箭头注释。将 lineType 指定为 'line''arrow''doublearrow''textarrow'。将 xy 分别指定为 [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] 形式的四元素向量。xy 元素确定位置,wh 元素确定大小。

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

Figure contains an axes. The axes contains an object of type line.

创建一个简单线图并向图窗添加文本框注释。通过设置 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');

Figure contains an axes. The axes contains an object of type line.

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

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

Figure contains an axes. The axes contains an object of type line.

通过将 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');

Figure contains an axes. The axes contains an object of type line.

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

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

Figure contains an axes. The axes contains an object of type stem.

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

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

Figure contains an axes. The axes contains an object of type stem.

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

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

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

Figure contains an axes. The axes contains an object of type line.

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

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

Figure contains an axes. The axes contains an object of type line.

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

figure
plot(1:10)

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

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

Figure contains an axes. The axes contains an object of type line.

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

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

Figure contains an axes. The axes contains an object of type line.

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

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

Figure contains an axes. The axes contains an object of type line.

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

输入参数

全部折叠

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

对象类型示例
'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')

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

对象类型示例
'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_begin x_end] 形式的二元素向量。xy 输入参数共同确定线条、箭头、双箭头或文本箭头注释的端点。注释从点 (x_begin, y_begin) 延伸到点 (x_end, y_end)。

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

示例: x = [.3 .5]

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

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

示例: y = [.3 .5]

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

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

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

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

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

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

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

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

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

输出参数

全部折叠

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

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

详细信息

全部折叠

兼容性考虑

从 R2014b 开始,注释不能超出 uipanel 边界,而是会在边界处进行裁剪。MATLAB® 的早期版本允许注释延伸到边界内或超出边界。要在特定的图窗、uipanel 或 uitab 内显示注释,请使用 container 输入参数。

在 R2006a 之前推出