主要内容

datatip

创建数据提示

描述

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

创建

交互式地创建数据提示点击图表数据点,例如,散点图。您还可以创建数据使用的建议datatip函数。

描述

datatip (目标)创建一个数据提示在第一次绘制指定图表的数据点,一条线或散点图等。

例子

datatip (目标,x,y)创建一个数据提示在指定的二维绘制数据点xy。如果您指定近似坐标datatip创建一个数据提示在最近的数据点。

datatip (目标,x,y,z)创建一个数据提示在指定的三维绘制数据点x,y,z。如果您指定近似坐标datatip创建一个数据提示在最近的数据点。

例子

datatip (目标“DataIndex”, n)创建一个数据提示n绘制数据点通过设置DataIndex财产。

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

dt = datatip (___)返回一个DataTip对象。您可以指定任何输入参数组合在前面的语法。这个语法是有用的控制数据的属性提示。

输入参数

全部展开

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

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

  • 笛卡尔轴,第一个坐标是x设在位置使用相同的单位作为你的数据。

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

  • 地理轴,第一个坐标是纬度。

默认情况下,如果你指定一个数据点的近似坐标,然后datatip函数创建一个数据提示在最近的数据点。最近的数据点取决于类型的图表。例如,对一个折线图最近的点的最小欧氏距离的近似坐标。

创建数据点之间的数据提示,设置SnapToDataVertex财产“关闭”

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

  • 笛卡尔轴,第二个坐标是y设在位置使用相同的单位作为你的数据。

  • 对极轴,第二个坐标是半径r在同一单位数据。

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

默认情况下,如果你指定一个数据点的近似坐标,然后datatip函数创建一个数据提示在最近的数据点。最近的数据点取决于类型的图表。例如,对一个折线图最近的点的最小欧氏距离的近似坐标。

创建数据点之间的数据提示,设置SnapToDataVertex财产“关闭”

三坐标数据,指定为一个标量。笛卡儿坐标,第三个坐标是z设在位置使用相同的单位作为你的数据。

默认情况下,如果你指定一个数据点的近似坐标,然后datatip函数创建一个数据提示在最近的数据点。最近的数据点取决于类型的图表。例如,对一个折线图最近的点的最小欧氏距离的近似坐标。

创建数据点之间的数据提示,设置SnapToDataVertex财产“关闭”

属性

全部展开

数据提示

指数的绘制数据,指定为一个正整数。

例如,绘制数据的二维对象的笛卡尔轴包含在它XDataYData属性。当你指定DataIndex数据提示,MATLAB®位置上的数据提示图索引到XDataYData

当你创建一个数据提示使用此属性,不指定x,y,或z参数。

例子: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×1单元阵列的二维数据提示或3×1单元阵列三维数据的提示。

添加额外的行数据提示内容,使用dataTipTextRow

字体

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

使用固定宽度字体看起来不错在任何场所,使用“FixedWidth”。固定宽度字体依靠根FixedWidthFontName财产。设置根FixedWidthFontName财产造成立即更新的显示使用新字体。

选择模式字体名属性,指定这些值之一:

  • “汽车”——使用相同的值字体名财产DataTipTemplate包含数据对象与表相关的提示。

  • “手动”——如果你设置字体名财产,FontNameMode属性自动变化“手动”

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

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

  • “汽车”——使用相同的值字形大小财产DataTipTemplate包含数据对象与表相关的提示。

  • “手动”——如果你设置字形大小财产,FontSizeMode属性自动变化“手动”

性格偏,指定为“正常”“斜体”

不是所有的字体都字体样式。因此,斜体字体看起来一样正常的字体。

选择模式FontAngle属性,指定这些值之一:

  • “汽车”——使用相同的值FontAngle财产DataTipTemplate包含数据对象与表相关的提示。

  • “手动”——如果你设置FontAngle财产,FontAngleMode属性自动变化“手动”

文本翻译,指定这些值之一:

  • “泰克斯”——解读人物使用特克斯标记的一个子集。

  • “乳胶”——解读人物使用乳胶标记。

  • “没有”——显示文字字符。

特克斯标记

默认情况下,MATLAB支持特克斯标记万博1manbetx的一个子集。使用特克斯标记添加标和下标,修改字体类型和颜色,包括特殊字符的文本。

修饰符仍然有效,直到结束的文本。标和下标是一个例外,因为他们只修改下一个字符或字符在大括号内。当你设置翻译“泰克斯”支持的修饰符万博1manbetx,如下所示。

修饰符 描述 例子
^ {} 上标 “文本^{上标}’
_ {} 下标 “text_{下标}’
\男朋友 大胆的字体 “\ bf文本”
它\ 斜体字体 “\它文本”
\ sl 斜字体斜体字体(通常是一样的) “\ sl文本”
rm \ 正常的字体 “\ rm文本”
\字体名{说明符} 字体的名字——取代说明符字体的名称。您可以使用此结合其他修饰符。 “\字体名{快递}文本”
\字形大小{说明符} 字体大小取代说明符数字标量值的单位。 ”字形大小{15}文本”
{\颜色说明符} 字体颜色——取代说明符用一个颜色:红色的,绿色,黄色的,品红色的,蓝色的,黑色的,白色的,灰色的,暗绿色,橙色,或lightBlue “{品红}\颜色文本”
\颜色(rgb){说明符} 自定义字体颜色——取代说明符三元素RGB值。 “\颜色(rgb){0, 0.5, 0.5}文本”

此表列出了支持的特殊字符万博1manbetx“泰克斯”翻译。

字符序列 象征 字符序列 象征 字符序列 象征

α

\ upsilon

υ

\ sim

~

\角

\ leq

\ ast

*

\气

χ

\ infty

β\

β

ψ

\ clubsuit

γ

ω

\ diamondsuit

δ

Γ

\ heartsuit

ϵ

Δ

\ spadesuit

ζ

Θ

\ leftrightarrow

\埃塔

η

Λ

\ leftarrow

θ

习\

Ξ

\ Leftarrow

\ vartheta

ϑ

Π

\向上光标键

\极微小

ι

Σ

\ rightarrow

\卡巴

κ

\ Upsilon

ϒ

\ Rightarrow

λ

Φ

\ downarrow

µ

Ψ

\保监会

º

ν

Ω

下午\

±

习\

ξ

\原则

\组

π

\存在

\ propto

ρ

倪\

\部分

σ

丛\

\子弹

\ varsigma

ς

\约

\ div

÷

τ

\再保险

\ neq

\枚

\ oplus

\ aleph

、即时通讯

\杯

\ wp

\ otimes

\ subseteq

\帕

\帽

中\

\ supseteq

\ supset

\ lceil

\子集

int \

\ cdot

·

阿\

ο

\ rfloor

\底片

¬

\微分算符

\ lfloor

\ *

x

\ ldots

\补

\清音

\ '

´

\楔

\ varpi

ϖ

\ 0

\ rceil

\捕杀

>

中期\

|

\三角

\ langle

<

\版权

©

乳胶标记

使用乳胶标记,设置翻译“乳胶”。对于内联模式,围绕标记与单美元符号(美元)。显示模式,围绕标记双美元符号($ $)。

乳胶模式 例子 结果
内联

“美元\ int_1 ^ {20} x ^ 2 dx $ '

方程与乳胶内联模式。

显示

' $ $ \ int_1 ^ {20} x ^ 2 dx $ $”

方程与乳胶显示模式。

显示的文本使用默认的乳胶字体风格。的字体名,FontWeight,FontAngle性能没有影响。改变字体样式,使用乳胶标记。

文本的最大大小,您可以使用乳胶解释器是1200个字符。多行文本,这减少了约10个字符每行。

例子使用特克斯和乳胶,看到希腊字母和特殊字符图文本。关于乳胶系统的更多信息,请参见乳胶项目网站https://www.latex-project.org/

选择模式翻译属性,指定这些值之一:

  • “汽车”——使用相同的值翻译财产DataTipTemplate包含数据对象与表相关的提示。

  • “手动”——如果你设置翻译财产,InterpreterMode属性自动变化“手动”

笛卡儿坐标数据

位置在x设在,指定为一个标量数据使用相同的单位。

位置在y设在,指定为一个标量数据使用相同的单位。

位置在z设在,指定为一个标量数据使用相同的单位。

极坐标数据

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

这个属性只适用于数据提示在极地的情节。

度角,指定为一个标量。

这个属性只适用于数据提示在极地的情节。

地理坐标数据

在度纬度,指定为一个标量。

这个属性只适用于数据提示在地理图。

在度经度,指定为一个标量。

这个属性只适用于数据提示在地理图。

交互性

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

  • “上”——显示对象。

  • “关闭”——隐藏对象没有删除它。你仍然可以访问一个看不见的对象的属性。

指定为一个上下文菜单快捷菜单对象,该对象提供数据提示选项。你不能设置该属性。

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

  • “上”——选择。如果单击对象在策划编辑模式,然后用MATLAB设置它选择财产“上”。如果SelectionHighlight财产也被设置为“上”,然后用MATLAB显示选择对象处理。

  • “关闭”——而不是选择。

显示选择处理的选择,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • “上”——显示选择处理时选择属性设置为“上”

  • “关闭”——从不显示选择处理,即使选择属性设置为“上”

回调

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

  • 函数处理

  • 单元阵列包含一个函数句柄和附加参数

  • 特征向量是一个有效的MATLAB命令或函数,这是评价的基础工作空间(不推荐)

使用这个属性来执行代码当你点击对象。如果你使用一个函数处理指定这个属性,然后用MATLAB将两个参数传递给回调函数在执行回调:

  • 点击点击对象的对象——访问属性的回调函数。

  • 事件数据——空参数。代之以波浪号字符(~)函数定义,表明这种观点是不习惯。

为更多的信息关于如何使用函数定义回调函数,处理回调函数定义

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”不执行,那么这个回调。

对象创建函数,指定这些值之一:

  • 函数处理。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

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

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了回调函数定义

这个属性指定一个回调函数执行时MATLAB创建对象。MATLAB之前执行初始化所有的属性值CreateFcn回调。如果你不指定CreateFcn属性,然后MATLAB执行默认创建函数。

设置CreateFcn属性在一个现有的组件没有影响。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被创建使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

对象删除函数,指定这些值之一:

  • 函数处理。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

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

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了回调函数定义

这个属性指定一个回调函数执行时MATLAB删除对象。MATLAB执行DeleteFcn回调之前破坏对象的属性。如果你不指定DeleteFcn属性,然后MATLAB默认执行删除功能。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被删除使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

回调执行控制

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

这个属性决定了如果一个回调可以运行中断。有两种回调状态考虑:

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

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

每当MATLAB调用回调,回调试图中断正在运行的回调(如果存在的话)。的可中断对象的属性拥有运行调决定是否允许中断。

  • 的值“上”允许其他回调中断对象的回调。中断发生在接下来的MATLAB处理队列,比如有一个的时候drawnow,,uifigure,getframe,等待,或暂停命令。

    • 如果运行调包含其中的一个命令,然后用MATLAB停止执行回调并执行中断的回调。MATLAB简历执行运行时回调打断调完成。

    • 如果跑回调不包含其中的一个命令,然后用MATLAB完成执行回调没有中断。

  • 的值“关闭”块全部中断。的BusyAction属性的对象拥有打断调决定如果打断回调被丢弃或放到一个队列中。

请注意

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

  • 如果中断的回调DeleteFcn,CloseRequestFcnSizeChangedFcn回调,那么无论发生中断可中断属性值。

  • 如果运行目前执行的回调等待函数,那么无论发生中断可中断属性值。

  • 计时器根据时间表不管对象执行可中断属性值。

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

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

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

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

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

  • “队列”——将中断处理回调在一个队列跑回调结束后执行。

  • “取消”——不执行中断回调。

能够捕获鼠标点击,指定这些值之一:

  • “可见”——捕获鼠标点击时可见。的可见属性必须设置为“上”,你必须点击的一部分DataTip对象定义了颜色。你不能点击一个部分都有一个关联的颜色属性集“没有”。的HitTest属性决定了如果DataTip对象响应单击或者一个祖先。

  • “所有”——捕获鼠标点击无论知名度。的可见属性可以设置为“上”“关闭”你可以点击的一部分DataTip对象,没有颜色。的HitTest属性决定了如果DataTip对象响应单击或者一个祖先。

  • “没有”——不能捕获鼠标点击。单击DataTip对象通过点击它下面的对象在当前视图的图窗口。的HitTest房地产没有任何影响。

应对捕获鼠标点击,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • “上”——触发ButtonDownFcn回调的DataTip对象。如果您已经定义了快捷菜单属性,然后调用上下文菜单。

  • “关闭”——触发回调的最近的祖先DataTip其中一个的对象:

    • HitTest属性设置为“上”

    • PickableParts属性设置为一个值,使祖先来捕获鼠标点击

请注意

PickableParts属性决定了如果DataTip对象可以捕获鼠标点击。如果不能,那么HitTest房地产没有任何影响。

这个属性是只读的。

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

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted房地产仍将“上”直到组件对象已不复存在。

检查的价值BeingDeleted属性来验证对象不会被删除之前查询或修改它。

父/子

家长,指定为一个对象DataTipTemplate财产。对象的数据提示模板的例子包括,柱状图,表面,FunctionLine对象。数据提示转移到另一个对象通过设置此属性。

对象没有孩子。你不能设置该属性。

可见性的对象处理孩子们的家长,指定这些值之一:

  • “上”——对象处理总是可见的。

  • “关闭”——对象句柄是无形的。这个选项是有用的防止意外更改另一个函数。设置HandleVisibility“关闭”暂时隐藏处理在这个函数的执行。

  • “回调”——对象句柄是可见的在回调函数或函数调用回调,但不是在从命令行调用的函数。这个选项块访问对象在命令行,但允许回调函数来访问它。

如果对象不是中列出孩子们父母的财产,那么函数获取对象处理对象层次结构或通过搜索查询处理属性不能返回它。这些功能的示例包括得到,findobj,gca,gcf,gco,newplot,,clf,关闭功能。

隐藏对象处理仍然有效。设置根ShowHiddenHandles财产“上”列出所有对象处理不管他们的HandleVisibility属性设置。

标识符

这个属性是只读的。

类型的图形对象,返回“datatip”。使用这个属性来查找给定类型的所有对象在一个策划的层次结构,例如,当寻找使用类型findobj

对象标识符指定为一个特征向量或字符串标量。您可以指定一个唯一的标签价值作为一个对象的标识符。当你需要访问对象在您的代码,您可以使用findobj基于函数搜索对象标签价值。

用户数据,指定为任何MATLAB数组。例如,您可以指定一个标量、向量,矩阵,单元阵列,字符数组,表,或者结构。使用这个属性来存储任意数据对象。

如果你是在应用程序设计师工作,创建公共或私有属性的应用程序共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用程序设计应用程序共享数据

例子

全部折叠

散点图和返回数据散射对象。然后,创建一个数据提示被指定在一个特定的数据点x -y -坐标。

x = linspace (0、10、11);y = x ^ 2;sc =散射(x, y);dt = datatip (sc 7 49);

图包含一个轴。轴包含一个散射类型的对象。

情节一个条形图,并返回数据酒吧对象。然后,创建一个数据提示第七栏指定DataIndex名称-值对的论点。

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

图包含一个轴。轴包含一个对象类型的酒吧。

散点图和返回数据散射对象。创建一个数据提示(3 0)附近的数据点通过指定x= 3,y= 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 = datatip (p 3.5 7,“SnapToDataVertex”,“关闭”);

图包含一个轴。轴包含一个类型的对象。

提示

  • 交互式地创建数据提示点击图表数据点。将交互式地创建的数据建议分配给一个变量,使用findobj函数。

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

  • 要删除数据提示,使用删除函数。

    删除(dt);

介绍了R2019b