datacursormode
启用数据游标模式
说明
您可以使用数据游标模式,通过以交互方式创建和编辑数据提示来浏览数据。数据提示是显示关于单个数据点的信息的小文本框。使用 datacursormode
函数启用或禁用数据游标模式,并设置其他基本选项。要控制数据提示的外观和行为,请返回并使用 DataCursorManager
对象。
大多数图支持数据提示,包括线图、条形图、直方图和曲面图。支持数据提示的图通常会在坐标区工具栏中显示数据提示 图标。
您还可以使用默认情况下启用的内置坐标区交互来以交互方式浏览数据。例如,您可以通过在数据点上暂停来临时显示数据提示,也可以通过点击数据点来固定数据提示。内置交互不要求您启用交互模式,并且比交互模式响应更快。但是,您可以启用数据游标模式来自定义数据提示行为。有关内置交互的详细信息,请参阅对图的交互进行控制。
创建对象
语法
描述
datacursormode
设置当前图窗中所有坐标区的数据游标模式。例如,option
datacursormode on
会启用数据游标模式,而 datacursormode off
则会禁用数据游标模式。
启用数据游标模式时,可以使用光标或键盘创建数据提示。
游标 - 点击绘制的数据点。要创建多个数据提示,请在选择数据点时按住 Shift 键。要将数据提示移至另一个数据点,请拖动数据提示所在的点。
键盘 - 对于某些图,要将当前所选数据提示移至另一个数据点,请按向上箭头 (↑) 键、向下箭头 (↓) 键、向左箭头 (←) 键或 向右箭头 (→) 键。
不管当前交换模式如何,某些内置交互都默认处于启用状态。要禁用独立于数据游标模式的内置数据提示交互,请使用 disableDefaultInteractivity
函数。
datacursormode
在 on
和 off
之间切换数据游标模式。
输入参数
属性
对象函数
getCursorInfo |
对数据游标管理器对象
|
示例
提示
通常,数据提示显示所选数据点的坐标。但是,对于某些类型的图,数据提示会显示专用信息。例如,使用
histogram
函数创建的直方图显示的数据提示会逐条列出观察计数和 bin 边界。
替代功能
坐标区工具栏
对于某些图,通过点击坐标区工具栏中的数据提示 图标来启用数据游标模式。
编程工作流
要以编程方式创建和自定义数据提示,请使用 datatip
和 dataTipTextRow
函数。有关详细信息,请参阅创建自定义数据提示。