图例的外观和行为

点击图例项时执行的回调，指定为下列值之一：

函数句柄。例如，@myCallback。

元胞数组，包含一个函数句柄和其他参数。例如，{@myCallback,arg3}。

作为有效 MATLAB 命令或函数（在基础工作区中计算）的字符向量（不推荐）。

如果您使用函数句柄指定此属性，MATLAB 将传递 Legend 对象和事件数据结构体作为该函数的第一个和第二个输入参数。此表介绍了事件数据结构体中的字段。

事件数据结构体字段

点击的类型，返回为下列值之一：

'normal' - 单击鼠标左键

'extend' - 按住 Shift 键并单击鼠标左键

'open' - 双击任何鼠标按键

'alt' - 单击鼠标右键、同时单击鼠标左右键（Windows 和 Mac）或者单击鼠标中键（Mac 和 Linux）。如果 ContextMenu 属性包含有效的上下文菜单（这是默认值），则此类点击将打开上下文菜单，而不是触发 ItemHitFcn 回调。

注意

如果设置 ButtonDownFcn 属性，则 ItemHitFcn 属性将被禁用。

您可以创建交互式图例，以便在点击图例中的项目时，关联的图表会以某种方式进行更新。例如，您可以切换图表的可见性或更改其线宽。将图例的 ItemHitFcn 属性设置为可控制图表更改方式的回调函数。以下示例演示如何在点击图例中的图表图标或标签时切换图表的可见性。它会创建一个回调函数，该函数将图表的 Visible 属性设置为 'on' 或 'off'。

将以下代码复制到一个新的函数文件，然后将其以 hitcallback_ex1.m 的名称保存在当前文件夹或 MATLAB 搜索路径上的某个文件夹中。两个输入参数 src 和 evnt 为图例对象和事件数据结构体。当您点击图例中的项目时，MATLAB 会将这些输入自动传递给回调函数。使用事件数据结构体的 Peer 字段访问与所点击的图例项目关联的图形对象属性。

然后，绘制四条线条、创建一个图例并将图例对象赋给变量。将图例对象的 ItemHitFcn 属性设置为回调函数。点击图例中的项目以显示或隐藏所关联的图形。当您隐藏图形时，图例标签会更改为灰色。