datatip

创建数据提示

描述

数据提示是小文本框关于各个数据点显示的信息。默认情况下,数据提示显示一个数据点的坐标。

创建

通过单击图表中的数据点,交互式地创建数据提示,例如直线图和散点图。属性还可以创建数据提示datatip功能。

描述

datatip (目标创建指定图所示,在第一绘制数据点的数据尖端诸如线或散点图。

datatip (目标Xÿ上创建2-d作图数据的数据前端点通过指定Xÿ。如果指定近似坐标,然后datatip在最近的数据点创建数据提示。

datatip (目标Xÿž上创建3-d作图数据的数据前端点通过指定Xÿž。如果指定近似坐标,然后datatip在最近的数据点创建数据提示。

datatip (目标, 'DataIndex',n)的创建的数据提示ñ通过设置TH绘制的数据点DataIndex属性。

datatip (___,名称,值)指定性能使用一个或多个名称 - 值对的参数。所有其他参数后指定名称 - 值对。

dt = datatip (___回报DataTip对象。可以在前面的语法中指定任何输入参数组合。此语法用于控制数据提示的属性。

输入参数

全部展开

目标,指定为与一个对象DataTipTemplate属性。与物体的实例DataTipTemplate财产包括线柱状图表面FunctionLine对象。

数据提示,指定为标量的第一坐标。的第一坐标的解释取决于轴的类型:

  • 对于笛卡尔轴,所述第一坐标是X使用相同的单位作为数据轴位置。

  • 对于极轴,第一坐标是弧度极角θ。

  • 对于地理坐标轴,第一个坐标是纬度,单位是度数。

默认情况下,如果指定数据点的近似坐标,则datatip函数创建在最近的数据点的数据提示。最近的数据点取决于图表的类型。例如,在折线图的最近点具有从近似坐标的最小欧几里得距离。

要在数据点之间创建数据提示,请设置SnapToDataVertex属性“关闭”

数据提示,指定为标量的第二坐标。所述第二坐标系的解释取决于轴的类型:

  • 对于笛卡尔轴,所述第二坐标是ÿ使用相同的单位作为数据轴位置。

  • 对于极轴,所述第二坐标是所述半径[R与你的数据单位相同。

  • 对于地理坐标轴,第二个坐标是经度。

默认情况下,如果指定数据点的近似坐标,则datatip函数创建在最近的数据点的数据提示。最近的数据点取决于图表的类型。例如,在折线图的最近点具有从近似坐标的最小欧几里得距离。

要在数据点之间创建数据提示,请设置SnapToDataVertex属性“关闭”

数据提示,指定为标量的第三坐标。对于笛卡尔轴,所述第三坐标是ž使用相同的单位作为数据轴位置。

默认情况下,如果指定数据点的近似坐标,则datatip函数创建在最近的数据点的数据提示。最近的数据点取决于图表的类型。例如,在折线图的最近点具有从近似坐标的最小欧几里得距离。

要在数据点之间创建数据提示,请设置SnapToDataVertex属性“关闭”

属性

全部展开

数据提示

所绘制的数据,指定为正整数的索引。

例如,在一组笛卡尔坐标轴的2-d对象的绘制的数据被包含在其扩展数据YData属性。当您指定DataIndex一个数据提示,MATLAB®通过索引到来定位图表中的数据提示扩展数据YData

使用此属性创建数据提示时,不要指定Xÿ, 要么ž参数。

例子:datatip(图表,“DataIndex”, 3)创建在第三绘制数据点的数据提示。

显示在最近的数据点,指定为以下值之一:

  • '上'- 显示在最近的数据点的数据提示。最近的数据点取决于图表的类型。例如,在折线图的最接近点具有从指定位置的最小欧几里得距离。

  • “关闭”- 显示在图表上的最近指定位置的数据前端,即使它是在数据点之间。

从偏移量DataIndex,指定为一个标量。使用此属性来创建一个相邻数据点之间的数据提示线对象通过设置SnapToDataVertex“关闭”InterpolationFactor为0和1之间的标量。

例如,通过指定在一行上相邻数据点的中间创建一个数据提示InterpolationFactor为0.5。

X = 1:4;y = 2。* x;P =积(X,Y,' -  *');dt = datatip (p,'DataIndex',2,'位置''东南''SnapToDataVertex'“关闭”“InterpolationFactor”,0.5);

InterpolationFactor不支持所有类型万博1manbetx的对象的数据提示。

位置相对于所述数据点,指定为下列值之一:

描述 外观
'东北' 数据点的右上角
'西北' 数据点的左上角
'东南' 数据点的右下角
“西南” 数据点的左下角

例子:dt。位置=“西南”;

选择模式为位置属性值,指定为下列值之一:

  • '汽车'- - -datatip功能自动地选择的位置。

  • “手动”- 如果设置了位置特性,LocationMode属性自动更改为“手动”

此属性是只读的。

数据提示内容,指定为单元阵列。默认情况下,数据提示内容是用于2 d数据提示的2×1单元阵列或3-d数据提示的3×1的单元阵列。

到其他行添加到数据提示内容,使用dataTipTextRow

字形

字体名称,指定为支持的字体名称或万博1manbetx“固定宽度”。要显示和正确打印文本,你必须选择一个字体,系统支持的。万博1manbetx默认字体取决于您的操作系统和语言环境。

若要使用在任何语言环境中都好看的固定宽度字体,请使用“固定宽度”。固定宽度的字体依赖于根FixedWidthFontName属性。设置rootFixedWidthFontName性能使显示器使用新字体的即时更新。

选择模式为字体名属性,指定为以下值之一:

  • '汽车'- 使用相同的值字体名属性为DataTipTemplate与包含数据提示的图表相关联的对象。

  • “手动”- 如果设置了字体名特性,FontNameMode属性自动更改为“手动”

字体大小,指定为点单位中大于零的标量值。一个点=1/72英寸。

字体大小,指定为这些值中的一个选择模式:

  • '汽车'- 使用相同的值字体大小属性为DataTipTemplate与包含数据提示的图表相关联的对象。

  • “手动”- 如果设置了字体大小特性,FontSizeMode属性自动更改为“手动”

字符倾斜,指定为'正常'要么“斜体”

不是所有的字体兼得字体样式。因此,斜体看起来一样的普通字体。

选择模式为FontAngle属性,指定为以下值之一:

  • '汽车'- 使用相同的值FontAngle属性为DataTipTemplate与包含数据提示的图表相关联的对象。

  • “手动”- 如果设置了FontAngle特性,FontAngleMode属性自动更改为“手动”

文本解释器,指定为以下值之一:

  • 'TEX'-使用TeX标记的子集解释字符。

  • “乳胶”- 解释用LaTeX的标记字符。

  • '没有'- 显示文字字符。

特克斯标记

默认情况下,MATLAB支持Tex标记万博1manbetx的一个子集。使用Tex标记添加上下标,修改字体和颜色,并在文本中包含特殊字符。

修饰符仍然有效,直到文本的结尾。上下标是个例外,因为它们只修改下一个字符或大括号中的字符。当您设置的解释器'TEX',支持的修饰万博1manbetx符如下。

修饰符 描述
^ {} 上标 “文本^{上标}’
_ {} 'text_ {标}'
\ BF 粗体 '\ BF文本'
它\ 斜体 “\它的文本”
\ sl 斜字体(通常一样斜体) '\ SL文本'
rm \ 正常的字体 “\ rm文本”
\ {字体名说明符} 字体名称-替换说明符与字体家族的名字。您可以与其他修饰组合使用。 “\ {字体名快递}文本”
\字体大小{说明符} 字体大小取代说明符在点为单位的数值标量值。 '\ {字号15}文本'
\颜色{说明符} 字体颜色 - 更换说明符这些颜色中的一种:红色绿色黄色品红色的蓝色黑色的白色灰色的暗绿色橙子, 要么浅蓝 “\ {色品红}文本”
\颜色(rgb){说明符} 自定义字体颜色-替换说明符具有三元件RGB三元。 '\颜色[RGB] {0,0.5,0.5}文本'

该表列出了所支持的特殊字符万博1manbetx'TEX'翻译。

字符序列 符号 字符序列 符号 字符序列 符号

α

\埃普西隆

υ

\ sim

\角度

\披

\当量

\ AST

*

\志

χ

\ infty

\公测

β

\ PSI

ψ

\ clubsuit

\伽玛

γ

\欧米茄

ω

\ diamondsuit

\三角洲

δ

\伽玛

Γ

\ heartsuit

\小量

ε

\三角洲

Δ

\ spadesuit

\泽塔

ζ

\西塔

Θ

\ leftrightarrow

\ ETA

η

Λ

\左箭头

\ THETA

θ

\曦

Ξ

\ Leftarrow

\ vartheta

θ

\皮

Π

\向上箭头

\丝毫

ι

\西格玛

Σ

\ rightarrow

\卡帕

κ

\埃普西隆

Υ

\ Rightarrow

λ

\披

Φ

\ DownArrow中文

μ

\幽

Ψ

\保监会

º

ν

Ω

下午\

±

\喜

ξ

\对所有人

\组

π

\存在

\ propto

\ RHO

ρ

倪\

\分

\西格玛

σ

\聪

\子弹

\ varsigma

ς

\约

\ div

÷

τ

\回覆

\ NEQ

\当量

\ oplus

\ ALEPH

、即时通讯

\杯子

\ WP

\ otimes

\ subseteq

\帕

\帽

中\

\ supseteq

\ supset

\ lceil

\子

int \

\ CDOT

·

\ o

ο

\ rfloor

\ NEG

¬

\ nabla

\ lfloor

\倍

X

\ ldots

\ PERP

\清音

\主要

\楔

\ varpi

π

\ 0

\ rceil

\ rangle

>

\中

|

\三角

\ langle

<

\版权

©

乳胶标记

要使用LaTeX的标记,设置译员“乳胶”。使用美元符号周围的文本,例如,使用'$ \ INT_1 ^ {20}的x ^ 2 DX $'内联模式或'$$ \ INT_1 ^ {20}的x ^ 2 DX $$'为显示模式。

显示的文本使用默认的LaTeX的字体样式。该字体名fontWeight设置FontAngle属性没有效果。要更改字体样式,请使用LaTeX标记。

文本,你可以用LaTeX的翻译使用的最大尺寸为1200个字符。对于多行文本,这样可减少每行约10个字符。

有关LaTeX的系统的更多信息,请参阅在胶乳项目网站https://www.latex-project.org/

选择模式为翻译员属性,指定为以下值之一:

  • '汽车'- 使用相同的值翻译员属性为DataTipTemplate与包含数据提示的图表相关联的对象。

  • “手动”- 如果设置了翻译员特性,InterpreterMode属性自动更改为“手动”

笛卡儿坐标数据

沿位置X轴,指定为使用相同的单位作为数据标量。

沿位置ÿ轴,指定为使用相同的单位作为数据标量。

沿位置ž轴,指定为使用相同的单位作为数据标量。

极坐标数据

半径,指定为标量,使用与数据相同的单位。

此属性只适用于极座标图上的数据的方法。

角度,用标量表示。

此属性只适用于极座标图上的数据的方法。

地理坐标数据

纬度,指定为在度的标量。

此属性仅适用于地理图上的数据提示。

经度,指定为标量的度数。

此属性仅适用于地理图上的数据提示。

互动

可见状态,指定为'上'要么“关闭”或作为数字或逻辑1真正) 要么0)。的价值'上'相当于真正“关闭”相当于。因此,你可以使用这个属性的值是一个逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnOffSwitchState

  • '上'-显示对象。

  • “关闭”- 隐藏的物体而不删除它。您仍然可以访问一种无形的对象的属性。

上下文菜单,指定为上下文菜单对象,它提供数据提示选项。无法设置此属性。

选择状态,指定为'上'要么“关闭”或作为数字或逻辑1真正) 要么0)。的价值'上'等于true,然后呢“关闭”相当于。因此,你可以使用这个属性的值是一个逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnOffSwitchState

  • '上'——选择。如果在绘图编辑模式下单击对象,则MATLAB会设置它属性'上'。如果SelectionHighlight属性也设置为'上',然后MATLAB显示对象周围的选择手柄。

  • “关闭”- 未选中的。

选中时显示选择手柄,指定为'上'要么“关闭”或作为数字或逻辑1真正) 要么0)。的价值'上'等于true,然后呢“关闭”相当于。因此,你可以使用这个属性的值是一个逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnOffSwitchState

  • '上'- 显示选择手柄时属性设置为'上'

  • “关闭”-永远不要显示选择手柄,即使在属性设置为'上'

回调

鼠标点击回调,指定为这些值之一:

  • 功能手柄

  • 含有功能句柄和附加参数单元阵列

  • 字符向量,是一个有效的MATLAB命令或功能,这是在所述基工作区进行评估(不推荐)

当您单击对象使用该属性来执行代码。如果使用指定的函数处理这个属性,那么MATLAB传递两个参数来执行回调,回调函数:

  • 点击的对象 - 从回调函数中点击的对象的访问属性。

  • 事件数据 - 空的参数。用波浪号字符替换它()在函数定义来表示,这种说法不被使用。

有关如何使用功能句柄来定义回调函数的详细信息,请参阅回调函数定义

注意

如果PickableParts属性设置为'没有'或者如果的HitTest属性设置为“关闭”,则此回调不执行。

对象创建函数,指定为以下值之一:

  • 功能句柄。

  • 单元阵列,其中所述第一元件是一个功能句柄。在单元阵列中随后的元件是要传递给回调函数的参数。

  • 字符向量包含一个有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关指定的回调作为函数手柄,电池阵列,或字符向量的更多信息,请参见回调函数定义

此属性指定在MATLAB创建对象时执行的回调函数。的初始化所有属性值CreateFcn打回来。如果不指定CreateFcn属性,那么MATLAB执行默认创建功能。

设置CreateFcn属性对现有组件无效。

如果将此属性指定为函数句柄或单元格数组,则可以访问使用回调函数的第一个参数创建的对象。否则,使用gcbo函数来访问该对象。

对象删除功能,指定为下列值之一:

  • 功能句柄。

  • 单元阵列,其中所述第一元件是一个功能句柄。在单元阵列中随后的元件是要传递给回调函数的参数。

  • 字符向量包含一个有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关指定的回调作为函数手柄,电池阵列,或字符向量的更多信息,请参见回调函数定义

此属性指定一个回调函数,当MATLAB删除对象来执行。MATLAB执行DeleteFcn销毁对象的属性之前回调。如果不指定DeleteFcn属性,然后MATLAB执行一个默认的删除函数。

如果指定此属性作为功能手柄或单元阵列,您可以访问正在使用回调函数的第一个参数被删除的对象。否则,使用gcbo函数来访问该对象。

回调执行控制

回调中断,指定为'上'要么“关闭”或作为数字或逻辑1真正) 要么0)。的价值'上'相当于真正“关闭”相当于。因此,你可以使用这个属性的值是一个逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnOffSwitchState

此属性确定是否正在运行的回调可以被打断。有两种回调状态来考虑:

  • 运行回调是当前执行的回调。

  • 中断回调是一个回调,试图中断正在运行的回调。

每当MATLAB调用一个回调时,这个回调就试图中断正在运行的回调(如果存在)。该可中断拥有该运行回调对象的属性确定是否中断被允许。

  • 的价值'上'允许其他回调中断对象的回调。中断发生在MATLAB处理队列的下一个点,比如有一个的DrawNow数字uifiguregetframe等待, 要么暂停命令。

    • 如果运行的回调包含这些命令中的一个,那么MATLAB停止回调的执行在这一点上并执行中断回调。MATLAB恢复执行运行时回调中断回调完成。

    • 如果运行的回调不包含这些命令之一,然后MATLAB完成不间断地执行回调。

  • 的价值“关闭”阻止所有中断的尝试。该BusyAction拥有该中断回调对象的属性确定该中断回调被丢弃或放入队列中。

注意

回调中断和执行在这些情况下表现不同:

  • 如果中断回调是DeleteFcnCloseRequestFcn要么SizeChangedFcn回调,那么中断不管发生可中断适当的价值。

  • 如果正在运行的回调当前正在执行等待函数,则中断发生而不管可中断适当的价值。

  • 计时器对象根据计划执行,而不考虑可中断适当的价值。

当中断发生时,MATLAB不保存属性或显示的状态。对象返回的对象gca要么gcf命令可能会改变另一个回调执行时。

回调队列,指定为“队列”要么'取消'。该BusyAction属性决定MATLAB如何处理中断回调的执行。有两种回调状态来考虑:

  • 运行回调是当前执行的回调。

  • 中断回调是一个回调,试图中断正在运行的回调。

每当MATLAB调用一个回调函数时,这个回调函数都试图中断一个正在运行的回调函数。该可中断拥有该运行回调对象的属性确定是否中断被允许。如果中断是不允许的,那么BusyAction拥有该中断回调对象的属性确定,如果它被丢弃或置于队列中。这些都是可能的值BusyAction属性:

  • “队列”-将中断的回调放到一个队列中,在运行的回调完成执行后进行处理。

  • '取消'-不执行中断的回调。

捕捉鼠标点击的能力,指定为以下值之一:

  • '可见'-捕捉鼠标点击时可见。该可见属性必须设置为'上'你必须点击的一部分DataTip具有已定义颜色的对象。不能单击已设置为关联颜色属性的部件'没有'。该的HitTest属性决定DataTip对象响应单击,或者如果父对象响应单击。

  • '所有'- 捕捉鼠标点击,无论知名度。该可见属性可以设置为'上'要么“关闭”您可以点击的部分DataTip没有颜色的物体。该的HitTest属性决定DataTip对象响应单击,或者如果父对象响应单击。

  • '没有'- 无法捕捉鼠标点击。点击DataTip物体通过它到低于它的对象图中的窗口的当前视图中的点击。该的HitTest财产没有影响。

对捕获的鼠标单击的响应,指定为'上'要么“关闭”或作为数字或逻辑1真正) 要么0)。的价值'上'等于true,然后呢“关闭”相当于。因此,你可以使用这个属性的值是一个逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnOffSwitchState

  • '上'- 触发了ButtonDownFcn回调DataTip对象。如果您已经定义了上下文菜单属性,然后调用上下文菜单。

  • “关闭”- 触发的回调的最近祖先DataTip对象有下列操作之一:

    • 的HitTest属性设置为'上'

    • PickableParts属性设置为使祖先能够捕获鼠标单击的值

注意

PickableParts属性决定DataTip对象可以捕获鼠标单击。如果不能,那么的HitTest财产没有影响。

此属性是只读的。

删除状态,返回一个开/关类型的逻辑值matlab.lang.OnOffSwitchState

MATLAB设置BeingDeleted属性'上'当。。。的时候DeleteFcn回调函数开始执行。该BeingDeleted属性保持设置为'上'直到组件对象不再存在。

检查的价值BeingDeleted属性,以验证该对象不是关于查询或修改之前被删除。

父/子

母体,指定为与一个对象DataTipTemplate属性。用数据提示模板对象的示例包括线柱状图表面FunctionLine对象。通过设置此属性,将数据提示移动到另一个对象。

该对象没有子对象。无法设置此属性。

对象句柄的可见性孩子母体,指定为这些值中的一个的属性:

  • '上'- 对象句柄始终可见。

  • “关闭”-对象句柄在任何时候都是不可见的。此选项用于防止另一个函数的意外更改。设置HandleVisibility“关闭”该函数的执行过程中暂时隐藏把手。

  • '打回来'-对象句柄从回调函数内部或由回调函数调用可见,但不从命令行调用的函数内部可见。这个选项在命令行上阻止对对象的访问,但是允许回调函数访问它。

如果对象未在列孩子父的财产,然后通过搜索对象层次或查询处理性能获得对象句柄功能无法返回。这些功能的示例包括得到findobjgcagcfgconewplotCLACLF功能。

隐藏的对象句柄仍然有效。将根ShowHiddenHandles属性'上'列出所有对象句柄,而不管它们是什么HandleVisibility属性设置。

身份标识

此属性是只读的。

类型的图形对象,返回“datatip”。使用此属性找到一个绘图层次结构中的给定类型的所有对象,例如,在使用搜索的类型findobj

对象标识符,指定为字符向量或标量的字符串。您可以指定一个唯一的标签值作为对象的标识符。当需要访问代码中其他地方的对象时,可以使用findobj功能搜索基础上的对象标签价值。

用户数据,指定为任何MATLAB数组。例如,可以指定标量、向量、矩阵、单元数组、字符数组、表或结构。使用此属性在对象上存储任意数据。

如果你在App Designer中工作,在App中创建公共或私有属性来共享数据,而不是使用用户数据属性。欲了解更多信息,请参阅在App Designer应用程序中共享数据

例子

全部收缩

画出散点图上的数据并返回分散对象。然后,通过指定在创建的特定数据点的数据尖端x -y -坐标。

X = linspace(0,10,11);Y = X ^ 2。sc =散射(x, y);DT =数据提示(SC,7,49);

在条形图上绘制数据,并返回酒吧对象。然后,通过指定创建第七条上的数据提示DataIndex名称 - 值对的参数。

x = 1900:10:2000;y = [75 91 105 123.5 131 120 107 96 82 73 70];b =酒吧(x, y);dt = datatip (b,'DataIndex',7);

画出散点图上的数据并返回分散对象。通过指定在(3,0)附近的数据点创建一个数据提示X= 3,ÿ= 0作为近似坐标。当您使用近似坐标创建一个数据提示,数据提示出现在最近的数据点。

x = linspace(0, 2π,20);y = sin (x);sc =散射(x, y);网格;dt = datatip (sc 3 0);

绘制数据并返回线对象。显示在每个绘制的数据点的标记。然后,通过指定创建两个数据点之间的数据提示x -y -为数据提示指定坐标SnapToDataVertex名称-值对参数为“关闭”

x = linspace (1、10、10);y = 2。* x;P =积(X,Y,' -  *');DT =数据提示(P,3.5,7,'SnapToDataVertex'“关闭”);

提示

  • 通过单击图表中的数据点,交互式地创建数据提示。要将交互式创建的数据提示分配给变量,请使用findobj功能。

    DT = findobj(图表,“类型”“datatip”);

  • 要删除数据提示,请使用删除功能。

    删除(DT);

介绍了在R2019b