功能 在图形上添加图例。该命令对有多种图形对象类型(线条图，条形图，饼形图等)的窗口中显示一个图例。对于每一线条，图例会在用户给定的文字标签旁显示线条的线型，标记符号和颜色等。当所画的是区域(patch或surface对象)时，图例会在文字旁显示表面颜色。Matlab在一个坐标轴中仅仅显示一个图例。图例的位置有几个因素决定，像遮挡的对象等，用户可以用鼠标拖动图例到恰当的位置，双击标签可以进入标签编辑状态。

用法 legend('string1','string2',…) 用指定的文字string在当前坐标轴中对所给数据的每一部分显示一个图例。

legend(h,'string1','string2',…) 用指定的文字string在一个包含于句柄向量h中的图形显示图例。用给定的数据对相应的图形对象加上图例。

legend(string_matrix) 用字符矩阵参量string­_matrix的每一行字符串作为标签。

legend(h,string_matrix) 用字符矩阵参量string­_matrix的每一行字符串作为标签给包含于句柄向量h中的相应的图形对象加标签。

legend(axes_handle,…) 给由句柄axes_handle指定的坐标轴显示图例。

legend('off') 从当前的坐标轴，或是由axes-handle指定的坐标轴中除掉图例。

legend(axes_handle,'off') 从由axes_handle指定的坐标轴中除掉图例。

legend_handle = legend 返回当前坐标轴中的图例句柄，若坐标轴中没有图例存在，则返回空向量。

legend 对当前图形中所有的图例进行刷新。

legend(legend_handle) 对由句柄legend_handle指定的图例进行刷新。

legend(…,pos) 在指定的位置pos放置图例见表7-5。

表7-5Pos取值

pos=-1

pos=0

Pos=1

图例位置

坐标轴之外的右边

坐标轴之内，有可能遮挡部分图形

坐标轴的右上角(缺省位置)

Pos取值

pos=2

pos=3

pos=4

图例位置

坐标轴的左上角

在坐标轴的左下角

坐标轴的右下角

h = legend(…) 返回图例的句柄向量。

[legend_handle,object_handles] = legend(…) 返回图例句柄，该句柄为坐标轴定义于图例中的图形对象、line对象、text对象的句柄。这些句柄允许用户对每个对象进行详细的操作。

例7-22

>>x = -pi:pi/20:pi;

>>plot(x,(cos(x)).^2,'rd',x,asin(x),'-.b')

>>h = legend('cos2x','asin',2);

图形结果为图7-22。