主要内容

数据

创建数据提示

描述

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

创建

通过单击图表中的数据点,例如行和散点图,交互式创建数据提示。您还可以使用使用的数据提示数据作用

描述

DataTip(目标)在指定图表的第一个打印数据点(如直线图或散点图)上创建数据提示。

实例

DataTip(目标,x,Y)在指定的二维绘制数据点上创建数据提示xY.如果指定近似坐标,则数据在最近的数据点创建数据提示。

DataTip(目标,x,Y,Z)在由指定的三维打印数据点上创建数据提示x,Y,Z.如果指定近似坐标,则数据在最近的数据点创建数据提示。

实例

DataTip(目标,'DataIndex',n)创建数据提示N通过设置,绘制了数据点数据索引所有物

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

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

输入参数

展开全部

目标,指定为具有数据模板所有物带有数据模板财产包括线,直方图,表面,FunctionLine对象。

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

  • 对于笛卡尔坐标轴,第一个坐标是x-轴位置使用与数据相同的单位。

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

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

默认情况下,如果指定数据点的近似坐标,则数据函数在最近的数据点创建数据提示。最近的数据点取决于图表的类型。例如,在折线图上,最近点与近似坐标之间的欧氏距离最小。

要在数据点之间创建数据提示,请设置SnapToDataVertex财产'离开'

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

  • 对于笛卡尔坐标轴,第二个坐标是Y-轴位置使用与数据相同的单位。

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

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

默认情况下,如果指定数据点的近似坐标,则数据函数在最近的数据点创建数据提示。最近的数据点取决于图表的类型。例如,在折线图上,最近点与近似坐标之间的欧氏距离最小。

要在数据点之间创建数据提示,请设置SnapToDataVertex财产'离开'

数据提示的第三个坐标,指定为标量。对于笛卡尔坐标轴,第三个坐标是Z-轴位置使用与数据相同的单位。

默认情况下,如果指定数据点的近似坐标,则数据函数在最近的数据点创建数据提示。最近的数据点取决于图表的类型。例如,在折线图上,最近点与近似坐标之间的欧氏距离最小。

要在数据点之间创建数据提示,请设置SnapToDataVertex财产'离开'

特性

展开全部

数据提示

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

例如,二维对象在一组笛卡尔坐标轴上的打印数据包含在其坐标系中XDataYData特性。当您指定时数据索引一个数据提示,MATLAB®通过索引到,在图表上定位数据提示XDataYData

使用此属性创建数据提示时,不要指定x,Y, 或者Z论点。

例子:DataTip(图表,'dataindex',3)在第三个打印数据点处创建数据提示。

在最近的数据点显示,指定为其中一个值:

  • “开”–在最近的数据点显示数据提示。最近的数据点取决于图表的类型。例如,在折线图上,最近的点与指定位置的欧氏距离最小。

  • '离开'-显示在图表上最近的指定位置的数据提示,即使它是在数据点之间。

偏移量从数据索引,指定为标量。使用此属性可以在图形上的相邻数据点之间创建数据提示线对象通过设置SnapToDataVertex'离开'插值表法到介于0和1之间的标量。

例如,通过指定,在一行上的相邻数据点之间形成数据尖端插值表法为0.5。

x = 1:4;y = 2. * x;p = plot(x,y,'-*');dt = dataTip(p,“DataIndex”2....“位置”,‘东南’,...“SnapToDataVertex”,'离开',...“InterpolationFactor”, 0.5);

与星号显示为星号的数据点和星号之间的数据点

插值表法不支持所有类型金宝app对象的数据提示。

相对于数据点的位置,指定为以下值之一:

价值 描述 外观
“东北” 数据点的右上角

数据点右上角的示例数据提示

“西北” 数据点的左上角

数据点左上角的示例数据提示

‘东南’ 数据点的右下角

数据点右下角的示例数据提示

“西南” 数据点的左下角

数据点左下角的示例数据提示

例子:dt.location ='西南';

系统的选择模式地点属性值,指定为以下值之一:

  • “自动”- 这数据函数自动选择位置。

  • “手动”—如果设置了地点财产,LocationMode属性自动更改为“手动”

此属性是只读的。

数据提示内容,指定为单元格数组。默认情况下,数据提示内容是二维数据提示的2×1单元格数组或三维数据提示的3×1单元格数组。

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

字体

字体名称,指定为受支持的字体名称或金宝app“FixedWidth”.要正确显示和打印文本,必须选择系统支持的字体。金宝app默认字体取决于您的操作系统和地区。

要使用在任何区域设置中看起来都不错的固定宽度字体,请使用“FixedWidth”.固定宽度的字体依赖于根fixedwidthfontname.所有物设置根fixedwidthfontname.属性导致立即更新显示以使用新字体。

系统的选择模式fontname.属性,指定为以下值之一:

  • “自动”—请使用与fontname.财产数据模板与包含数据提示的图表相关联的。

  • “手动”—如果设置了fontname.财产,FontNameMode属性自动更改为“手动”

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

字体大小的选择模式,指定为以下值之一:

  • “自动”—请使用与字形大小财产数据模板与包含数据提示的图表相关联的。

  • “手动”—如果设置了字形大小财产,FontSizeMode属性自动更改为“手动”

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

并非所有字体都有这两种字体样式。因此,斜体字体可能看起来与普通字体相同。

系统的选择模式方角属性,指定为以下值之一:

  • “自动”—请使用与方角财产数据模板与包含数据提示的图表相关联的。

  • “手动”—如果设置了方角财产,FontAngleMode属性自动更改为“手动”

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

  • “特克斯”-使用TeX标记的子集解释字符。

  • “乳胶”—使用LaTeX标记解释字符。

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

特克斯标记

默认情况下,MATLAB支持TeX标记金宝app的子集。使用TeX标记可以添加上标和下标,修改字体类型和颜色,并在文本中包含特殊字符。

修改器在文本结束前保持有效。上标和下标是例外,因为它们只修改下一个字符或大括号内的字符。当您将解释器设置为“特克斯”,支持的修饰金宝app符如下所示。

修饰符 描述 例子
^ {} 上标 “文本^{上标}’
_ {} 下标 '文本{下标}'
\男朋友 大胆的字体 “\bf text”
\它 斜体字体 “\它文本”
\ 斜字体(通常与斜体相同) “\sl text”
\R M 正常字体 '\ rm text'
\字体名{说明书} 字体名称-替换说明书使用字体系列的名称。可以将其与其他修改器结合使用。 “\字体名{快递}文本”
\字体大小{说明书} 字体大小-replace.说明书具有以点为单位的数值标量值。 “\fontsize{15}文本”
\颜色{说明书} 字体颜色-替换说明书用其中一种颜色:红色,绿色,黄的,品红色的,蓝色,黑色的,白色,灰色的,暗绿色,橙色, 或者浅蓝 “{品红}\颜色文本”
\颜色(rgb){说明符} 自定义字体颜色-替换说明书用三元素RGB三联体。 “\color[rgb]{0,0.5,0.5}文本”

此表列出了支持的特殊字符金宝app“特克斯”口译译员

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

\阿尔法

α

\上升

υ

\ SIM.

~

\角度

\phi

\莱克

\ ast

*

\池

χ

\ infty

β\

β

ψ

\ clubsuit

\ Gamma.

γ

ω

\ diamondsuit

\三角洲

δ

Γ

\胸衣

ϵ

\三角洲

Δ

\黑桃

ζ

\θ.

Θ

\ leftrightarrow

\埃塔

η

Λ

\ leftarrow

\西塔

θ

习\

Ξ

\左箭头

\ vartheta

ϑ

\圆周率

Π

\向上箭头

\一丁点儿

ι

\西格玛

Σ

\右箭头

\卡巴

κ

\ Upsilon

ϒ

\ Rightarrow

\ lambda.

λ

\Phi

Φ

\向下箭头

\亩

µ

Ψ

\ inc.

º

\ nu.

ν

\ omega.

Ω

\下午

±

\十一

ξ

\福尔

\组

\ PI.

π

\存在

\普罗普托

\rho

ρ

\你

\局部的

\西格玛

σ

丛\

\子弹头

\瓦西格玛

ς

\约

\ div.

÷

τ

\再

\neq

\等价物

\ oplus

\阿莱夫

、即时通讯

\杯

\可湿性粉剂

\有时

\分段

\ Oslash.

\帽

\在

\supseteq

\支持

\ lceil.

\子集

int \

\ cdot

·

\o

ο

\ rfloor

\负数

¬

\微分算符

\ lfloor

\时代

x

\ ldots

...

\罪犯

\苏德

\主要的

´

\楔子

\瓦皮

ϖ

\0

\赛尔

\激怒

\中段

|

\三角

\ langle.

\版权

©

乳胶标记

要使用LaTeX标记,请将解释器设置为“乳胶”.对于内联模式,用单个美元符号包围标记($).对于显示模式,将标记与双美元符号括起来($$).

乳胶模式 例子 结果
内联

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

具有LaTeX内联模式的方程式。

展示

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

具有乳胶显示模式的等式。

显示的文本使用默认的乳胶字体样式。这个fontname.,FontWeight,方角属性没有效果。要更改字体样式,请使用乳胶标记。

LaTeX解释器可以使用的文本的最大大小是1200个字符。对于多行文本,每行减少约10个字符。

有关使用TeX和LaTeX的示例,请参见图表文本中的希腊字母和特殊字符.有关乳胶系统的更多信息,请参阅乳胶项目网站https://www.latex-project.org/

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

  • “自动”—请使用与翻译财产数据模板与包含数据提示的图表相关联的。

  • “手动”-如果你设定翻译财产,解释器模式属性自动更改为“手动”

笛卡儿坐标数据

沿途位置x-轴,使用与数据相同的单位指定为标量。

沿途位置Y-轴,使用与数据相同的单位指定为标量。

沿途位置Z-轴,使用与数据相同的单位指定为标量。

极坐标数据

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

此属性仅适用于极坐标图上的数据提示。

角,指定为度的标量。

此属性仅适用于极坐标图上的数据提示。

地理坐标数据

纬度,以度为单位指定为标量。

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

经度,指定为标量以度为单位。

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

交互性

可见性状态,指定为“开”'离开',或作为数字或逻辑1.(真正的)或0().的值“开”相当于真正的,'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnoffSwitchState.

  • “开”—显示对象。

  • '离开'-隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

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

选择状态,指定为“开”'离开',或作为数字或逻辑1.(真正的)或0().的值“开”相当于真实,而且'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnoffSwitchState.

  • “开”——选择。如果在绘图编辑模式下单击对象,则MATLAB将其设置为挑选出来的财产“开”.如果选择突出显示财产也设定为“开”,然后matlab显示对象周围的选择处理。

  • '离开'- 未选中的。

选择句柄时的显示,指定为“开”'离开',或作为数字或逻辑1.(真正的)或0().的值“开”相当于真实,而且'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnoffSwitchState.

  • “开”-显示选择手柄时挑选出来的属性设置为“开”

  • '离开'- 切勿显示选择处理,即使是挑选出来的属性设置为“开”

回调

鼠标单击回调,指定为以下值之一:

  • 函数句柄

  • 包含函数句柄和附加参数的单元格数组

  • 有效MATLAB命令或函数的字符向量,在基本工作空间中进行评估(不推荐)

在单击对象时使用此属性执行代码。如果使用函数句柄指定此属性,则MATLAB在执行回调函数时传递两个参数:

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

  • 事件数据-空参数。将其替换为平铺字符(~)在函数定义中,指示未使用此参数。

有关如何使用函数句柄定义回调函数的更多信息,请参见回调函数定义

笔记

如果可挑选的属性设置为“没有”或者如果是命中测试属性设置为'离开',则此回调不执行。

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

  • 函数处理。

  • 第一个元素是函数句柄的单元格数组。单元格数组中的后续元素是传递给回调函数的参数。

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定MATLAB创建对象时执行的回调函数。方法之前,MATLAB初始化所有属性值创建FCN回调。如果未指定创建FCN属性,然后MATLAB执行默认的创建函数。

设置创建FCN属性对现有组件没有影响。

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

对象删除函数,指定为以下值之一:

  • 函数处理。

  • 第一个元素是函数句柄的单元格数组。单元格数组中的后续元素是传递给回调函数的参数。

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定MATLAB删除对象时要执行的回调函数删除FCN在销毁对象属性之前进行回调。如果未指定删除FCN属性,然后matlab执行默认删除函数。

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

回调执行控制

回调中断,指定为“开”'离开',或作为数字或逻辑1.(真正的)或0().的值“开”相当于真正的,'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnoffSwitchState.

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

  • 这个运行Callback是当前正在执行的回调。

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

每当执行处理回调队列的命令时,MATLAB确定回调中断行为。这些命令包括drawnow,数字,uifigure,getframe,等待,暂停

如果运行回调不包含其中一个命令,则不会发生中断。MATLAB首先完成执行运行回调,稍后执行中断回调。

如果运行回调确实包含其中一个命令,那么打断拥有运行回调的对象的属性确定中断是否发生中断:

  • 如果是值打断'离开',则不发生中断。相反,BusyAction拥有中断回调的对象的属性确定是放弃中断回调还是将其添加到回调队列。

  • 如果是值打断“开”,则中断发生。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB将继续执行正在运行的回调。

笔记

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

  • 如果中断回调是一个删除FCN,关闭请求FCN, 或者SizeChangedFcn回调,则中断发生,而不考虑打断属性值。

  • 如果正在运行的回调当前正在执行等待功能,无论的内容都会发生中断打断属性值。

  • 如果中断回调由计时器对象,然后回调根据时间表执行打断属性值。

笔记

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

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

  • 这个运行Callback是当前正在执行的回调。

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

这个BusyAction属性仅在满足这两个条件时确定回调排队行为:

在这种情况下BusyAction属性决定了MATLAB如何处理中断回调。这些是可能的值BusyAction属性:

  • '队列'—将中断回调放入正在运行的回调执行完成后待处理的队列中。

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

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

  • “可见的”- 可见时捕获鼠标单击。这个可见的属性必须设置为“开”而且你必须点击一部分DataTip具有定义颜色的对象。您无法单击将关联颜色属性设置为的部分“没有”.这个命中测试财产确定是否存在DataTip对象对单击作出响应,如果是祖先则响应。

  • “所有”-捕获鼠标单击而不考虑可见性。这个可见的属性可以设置为“开”'离开'您可以单击DataTip没有颜色的对象。这个命中测试财产确定是否存在DataTip对象对单击作出响应,如果是祖先则响应。

  • “没有”-无法捕获鼠标单击。点击DataTip对象将单击传递给图形窗口当前视图中它下方的对象。这个命中测试财产没有影响。

对捕获的鼠标单击的响应,指定为“开”'离开',或作为数字或逻辑1.(真正的)或0().的值“开”相当于真实,而且'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnoffSwitchState.

  • “开”-触发buttondownfcn.回调的DataTip对象。如果已定义上下文菜单属性,然后调用上下文菜单。

  • '离开'-触发最接近的源的回调DataTip对象,该对象具有以下之一:

    • 命中测试属性设置为“开”

    • 可挑选的属性设置为一个值,该值使祖先能够捕获鼠标单击

笔记

这个可挑选的财产确定是否存在DataTip对象可以捕获鼠标点击。如果不能,那么命中测试财产没有影响。

此属性是只读的。

删除状态,返回类型为开/关逻辑值matlab.lang.OnoffSwitchState.

MATLAB设置BeingDeleted财产“开”删除FCN回调函数开始执行。这个BeingDeleted属性仍然设置为“开”直到组件对象不再存在。

检查该值BeingDeleted属性,以验证在查询或修改对象之前不会删除该对象。

父母/孩子

父对象,指定为具有数据模板所有物具有数据提示模板的对象示例包括线,直方图,表面,FunctionLine对象。通过设置此属性将数据提示移动到另一个对象。

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

物体手柄的可见性孩子们属性,指定为以下值之一:

  • “开”-对象句柄总是可见的。

  • '离开'- 对象句柄始终是不可见的。此选项对于防止其他功能的意外变化很有用。设定HandleVisibility'离开'在执行该函数期间临时隐藏句柄。

  • “回调”-对象句柄在回调或由回调调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止对命令行对象的访问,但允许回调函数访问它。

属性中未列出的对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获得对象句柄的函数不能返回它。此类函数的示例包括得到,findobj,GCA.,GCF.,GCO,新图,cla,clf,职能。

隐藏的对象句柄仍然有效。设置根ShowHiddenHandles财产“开”无论其何种方式列出所有对象句柄HandleVisibility属性设置。

标识符

此属性是只读的。

图形对象的类型,返回为'DataTip'. 使用此属性可以查找打印层次结构中给定类型的所有对象,例如,在使用搜索类型时findobj

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

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

如果你在应用程序设计器中工作,在应用程序中创建公共或私有属性来共享数据,而不是使用用户数据所有物有关详细信息,请参阅在App Designer应用程序中共享数据

例子

全部折叠

在散点图上绘制数据并返回分散对象然后,通过指定X-y-坐标。

x=linspace(0,10,11);y=x.^2;sc=散射(x,y);dt=数据提示(sc,7,49);

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

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

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,Y=0作为近似坐标。使用近似坐标创建数据提示时,数据提示将显示在最近的数据点处。

X = LINSPACE(0,2 * PI,20);y = sin(x);sc =散射(x,y);网格;dt = datatip (sc 3 0);

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

绘制数据并返回线对象。在每个打印的数据点显示一个标记。然后,通过指定X-y-数据提示的坐标,并指定SnapToDataVertex名称 - 值对参数为'离开'

x = Linspace(1,10,10);y = 2. * x;p = plot(x,y,'-*'); dt=数据提示(p,3.5,7,“SnapToDataVertex”,'离开');

图中包含一个轴对象。axis对象包含一个类型为line的对象。

提示

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

    dt = findobj(图表,'类型','DataTip');

  • 要删除数据提示,请使用删除作用

    删除(dt);

在R2019b中引入