【注】详情请参阅 MatLab help 文档。

1. 简介

legend 函数可以在 MatLab 的坐标区按曲线的绘制顺序添加对应曲线的图例。

2. 格式

legend
legend(label1,···,labelN)
legend(labels)
legend(subset,___)
legend(target,___)
legend(___,Name,Value)
legend(bkgd)
lgd = legend(___)
[lgd,icons,plots,text] = legend(___)
legend(vsbl)
legend('off')

• legend
  legend 为每个绘制的数据序列创建一个带有描述性标签的图例。对于标签，图例使用数据序列的 DisplayName 属性中的文本（在绘图函数中指定的 DisplayName 的属性值）。如果 DisplayName 属性为空，则图例使用 'dataN' 形式的标签。当在坐标区上添加或删除数据序列时，图里会自动更新（若不希望自动更新可将图例的 AutoUpdate 属性设置为 'off'）。此命令为 gca 返回的当前坐标区或图形创建图例，如果当前坐标区为空，则图例为空；如果坐标区不存在，则此命令将创建坐标区。

• legend(label1,···,labelN)
  设置图例标签。以字符向量或字符串列表形式指定标签。

• legend(labels)
  使用 labels 设置标签，labels 可以是字符向量元胞数组、字符串数组或字符矩阵。

• legend(subset,___)
  仅在图例中包括 subset 中列出的数据序列的项，未包括的数据序列则不在图例中。

• legend(target,___)
  在 target 指定的坐标区、极坐标区或图形设置图例。

• legend(___,Name,Value)
  legend 函数常见属性的键值对如下：

'Location',lct ：lct 为相对于坐标区的位置，其可选取值如下表：

值	说明
'north'	坐标区中的顶部
'south'	坐标区中的底部
'east'	坐标区中的右侧
'west'	坐标区中的左侧
'northeast'	坐标区中的右上角（二维坐标区的默认值）
'northwest'	坐标区中的左上角
'southeast'	坐标区中的右下角
'southwest'	坐标区中的左下角
'northoutside'	坐标区的上方
'southoutside'	坐标区的下方
'eastoutside'	坐标区外的右侧
'westoutside'	坐标区外的左侧
'northeastoutside'	坐标区外的右上角（三维坐标区的默认值）
'northwestoutside'	坐标区外的左上角
'southeastoutside'	坐标区外的右下角
'southwestoutside'	坐标区外的左下角
'best'	坐标区内与绘图数据冲突最少的地方
'bestoutside'	坐标区外的右上角（当图例为垂直方向）或坐标区的下方（当图例为水平方向）
'none'	由 Position 属性决定，可使用 Position 属性在自定义位置显示图例

'Orientation',ornt ：ornt 为图例的d堆叠方向（'vertical'（默认）| 'horizontal'）

'TextColor',[R G B] | 常用颜色 ： 指定文本颜色，默认颜色为 [0 0 0]

'Color',[R G B] | 常用颜色 ： 指定文本颜色，默认颜色为 [1 1 1]

'EdgeColor',常用颜色 ： 指定文本颜色，默认颜色为 [0.15 0.15 0.15]

'Box','on'（默认）| 'off' ：指定图例框轮廓是否显示。

'LineWidth',Value ：设置轮廓框的宽度（默认值为 0.5，Value 为以磅为单位的正值）

'FontSize',Value ：指定字体大小（默认大小取决于系统和区域设置，Value 为大于 0 的标量值，以磅为单位）

'NumColumns',Value ：指定图例项的显示列数（默认为 1，Value 为正整数）

'NumColumnsMode','auto'（默认）| 'manual' ：设置 NumColumns 值的选择模式

'Position',[left bottom width height] ：设置图例框位置和大小，四元素向量中 left 和 bottom 指定从图窗左下角到图例左下角的距离，width 和 height 分别指定图例框的宽度和高度

'Units',Value ：设置位置单位，Value 可选取值如下表：【注】所有的位置大小都是从图窗左下角开始进行测量的。

Value	说明
'normalized'（默认值）	相对于图窗进行归一化（图窗左下角映射到(0,0)，右上角映射到(1,1)
'inches'	英寸
'centimeters'	厘米
'characters'	基于默认系统字体的字符大小（字符宽度 = 字母 x 的宽度，字符高度 = 两个文本行的基线之间的距离）
'points'	磅（1 磅 = 1/72 英寸）
'pixels'	像素

'AutoUpdate','on'（默认）| 'off' ：设置是否自动更新图例项以反映坐标区的当前状态。

'Interpreter','tex'（默认）| 'latex' | 'none' ：设置解释文本字符的方式。

'FontName',支持的字体名称 | 'FixedWidth' ：设置字体（必须选择系统支持的字体，默认字体取决于系统和区域设置，FixWidth 为等宽字体）

'FontSize',Value ：设置字体大小为 Value（Value 为大于 0 的标量值，以磅为单位）

'FontWeight','normal'（默认）| 'bold' ：设置字体粗细。

'FontAngle','normal'（默认）| 'italic' ：设置字体是否倾斜。

• legend(bkgd)
  设置图例框显示，bkgd 可选值为 'boxon'（默认）| 'boxoff'。前者表示显示图例背景和轮廓，后者表示不显示图例背景和轮廓。

• lgd = legend(___)
  返回 legend 对象，可使用 lgd 在创建图例后查询和设置图例属性。

• [lgd,icons,plots,text] = legend(___)
  返回用于创建图例图标的对象、在图形中绘制的对象以及标签文本数组（该语法不支持某些功能，且添加删除数据后图例不会自动更新）

• legend(vsbl)
  控制图例的可见性，vsbl 的可选值为 'hide' | 'show' | 'toggle'，依次对应隐藏图例、显示图例或创建图例（图里不存在时）、切换图例可见性。

• legend('off')
  删除图例。