datatip
创建数据提示
说明
数据提示是显示关于单个数据点的信息的小文本框。默认情况下，数据提示包括在图创建过程中指定的与单个数据点对应的数据。
创建对象
通过点击图（例如线图和散点图）中的数据点以交互方式创建数据提示。您还可以使用 datatip 函数创建数据提示。
语法
描述
输入参量
属性
数据提示
绘图数据的索引，指定为正整数。
例如，二维对象在笛卡尔坐标区上的绘图数据包含在其 XData 和 YData 属性中。当您指定数据提示的 DataIndex 时，MATLAB® 通过对 XData 和 YData 进行索引在图上定位数据提示。
使用此属性创建数据提示时，请不要指定 x、y 或 z 参量。
示例: datatip(chart,'DataIndex',3) 在第三个绘图数据点上创建数据提示。
在最近的数据点上显示，指定为下列值之一：
'on'- 在最近的数据点显示数据提示。最近的数据点取决于图的类型。例如，在线图上，最近的点与指定位置的欧几里德距离最小。'off'- 在图上最近的指定位置显示数据提示，即使数据提示位于数据点之间也是如此。
相对于 DataIndex 的偏移量，指定为标量。使用此属性在 Line 对象上的相邻数据点之间创建数据提示，方法是：将 SnapToDataVertex 设置为 'off'，将 InterpolationFactor 设置为 0 到 1 之间的标量。
例如，通过将 InterpolationFactor 指定为 0.5，在一条直线上两个相邻数据点的正中间创建数据提示。
x = 1:4; y = 2.*x; p = plot(x,y,'-*'); dt = datatip(p,'DataIndex',2, ... 'Location','southeast', ... 'SnapToDataVertex','off', ... 'InterpolationFactor',0.5);
并非所有类型的对象上的数据提示都支持 InterpolationFactor。
相对于数据点的位置，指定为下列值之一：
| 值 | 描述 | 外观 |
|---|---|---|
'northeast' | 数据点的右上角 |
|
'northwest' | 数据点的左上角 |
|
'southeast' | 数据点的右下角 |
|
'southwest' | 数据点的左下角 |
|
示例: dt.Location = 'southwest';
Location 属性值的选择模式，指定为下列值之一：
'auto'-datatip函数自动选择位置。'manual'- 如果您设置Location属性，LocationMode属性将自动更改为'manual'。
此 属性 为只读。
数据提示内容，指定为元胞数组。默认情况下，对于二维数据提示，数据提示内容是 2×1 元胞数组，对于三维数据提示，数据提示内容是 3×1 元胞数组。
要向数据提示内容添加更多行，请使用 dataTipTextRow。
字体
FontName 属性的选择模式，指定为下列值之一：
'auto'- 使用与包含数据提示的图关联的DataTipTemplate对象的FontName属性相同的值。'manual'- 如果您设置FontName属性，FontNameMode属性将自动更改为'manual'。
字体大小，指定为大于 0 的标量值（以磅为单位）。一磅等于 1/72 英寸。
字体大小的选择模式，指定为下列值之一：
'auto'- 使用与包含数据提示的图关联的DataTipTemplate对象的FontSize属性相同的值。'manual'- 如果您设置FontSize属性，FontSizeMode属性将自动更改为'manual'。
FontAngle 属性的选择模式，指定为下列值之一：
'auto'- 使用与包含数据提示的图关联的DataTipTemplate对象的FontAngle属性相同的值。'manual'- 如果您设置FontAngle属性，FontAngleMode属性将自动更改为'manual'。
文本解释器，指定为下列值之一：
'tex'- 使用 TeX 标记子集解释字符。'latex'- 使用 LaTeX 标记解释字符。'none'- 显示字面字符。
TeX 标记
默认情况下，MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。
修饰符会一直作用到文本结尾，但上标和下标除外，因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex" 时，支持的修饰符如下所示。
| 修饰符 | 描述 | 示例 |
|---|---|---|
^{ } | 上标 | "text^{superscript}" |
_{ } | 下标 | "text_{subscript}" |
\bf | 粗体 | "\bf text" |
\it | 斜体 | "\it text" |
\sl | 伪斜体（通常与斜体相同） | "\sl text" |
\rm | 常规字体 | "\rm text" |
\fontname{ | 字体名称 - 将 | "\fontname{Courier} text" |
\fontsize{ | 字体大小 - 将 | "\fontsize{15} text" |
\color{ | 字体颜色 - 将 red、green、yellow、magenta、blue、black、white、gray、darkGreen、orange 或 lightBlue。 | "\color{magenta} text" |
\color[rgb]{specifier} | 自定义字体颜色 - 将 | "\color[rgb]{0,0.5,0.5} text" |
下表列出了 "tex" 解释器所支持的特殊字符。
| 字符序列 | 符号 | 字符序列 | 符号 | 字符序列 | 符号 |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX 标记
要使用 LaTeX 标记，请将解释器设置为 "latex"。对于行内模式，用单美元符号 ($) 将标记括起来。对于显示模式，用双美元符号 ($$) 将标记括起来。
| LaTeX 模式 | 示例 | 结果 |
|---|---|---|
| 行内 |
"$\int_1^{20} x^2 dx$" |
|
| 显示 |
"$$\int_1^{20} x^2 dx$$" |
|
显示的文本将使用默认的 LaTeX 字体样式。FontName、FontWeight 和 FontAngle 属性不起任何作用。要更改字体样式，请使用 LaTeX 标记。
用于 LaTeX 解释器的文本最多可以包含 1200 个字符。对于多行文本，请在此数量的基础上每行减少约 10 个字符。
MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息，请参阅支持的 LaTeX 命令。有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。
Interpreter 属性的选择模式，指定为下列值之一：
'auto'- 使用与包含数据提示的图关联的DataTipTemplate对象的Interpreter属性相同的值。'manual'- 如果您设置Interpreter属性，InterpreterMode属性将自动更改为'manual'。
笛卡尔坐标数据
沿 x 轴的位置，指定为标量，使用与数据相同的单位。
沿 y 轴的位置，指定为标量，使用与数据相同的单位。
沿 z 轴的位置，指定为标量，使用与数据相同的单位。
极坐标数据
半径，指定为标量，使用与数据相同的单位。
此属性仅适用于极坐标图上的数据提示。
角度，指定为标量，以度为单位。
此属性仅适用于极坐标图上的数据提示。
地理坐标数据
纬度，指定为标量，以度为单位。
此属性仅适用于地理图上的数据提示。
经度，指定为标量，以度为单位。
此属性仅适用于地理图上的数据提示。
交互性
上下文菜单，指定为提供数据提示选项的 ContextMenu 对象。您不能设置该属性。
回调
回调执行控件
父级/子级
父级，指定为具有 DataTipTemplate 属性的对象。具有数据提示模板的对象示例包括 Line、Histogram、Surface 和 FunctionLine 对象。通过设置此属性将数据提示移至另一个对象。
示例
使用示例文件 patients.xls 创建一个表。然后，在气泡图中绘制 Systolic、Diastolic 和 Weight 变量。然后，添加数据提示。
tbl = readtable("patients.xls"); b = bubblechart(tbl,"Systolic","Diastolic","Weight"); dt = datatip(b);
绘制数据散点图，并将 sz 定义为指定标记大小的向量。返回 Scatter 对象。
然后，通过指定 x 坐标和 y 坐标，在特定数据点上创建数据提示。
x = linspace(1,10,10); y = x.^2; sz = x; sc = scatter(x,y,sz); dt = datatip(sc,7,49);
在条形图上绘制数据，并返回 Bar 对象。然后，通过指定 DataIndex 名称-值对组参量，在第七个条形上创建数据提示。
x = 1900:10:2000;
y = [75 91 105 123.5 131 120 107 96 82 73 70];
b = bar(x,y);
dt = datatip(b,'DataIndex',7);
在散点图上绘制数据，并返回 Scatter 对象。通过将 x = 3 和 y = 0 指定为近似坐标，在 (3,0) 附近的数据点上创建数据提示。使用近似坐标创建数据提示时，数据提示会出现在最近的数据点上。
x = linspace(0,2*pi,20);
y = sin(x);
sc = scatter(x,y);
grid on;
dt = datatip(sc,3,0);
绘制数据并返回 Line 对象。在每个绘制的数据点上显示一个标记。然后，通过指定数据提示的 x 和 y 坐标，并将 SnapToDataVertex 名称-值对组参量指定为 'off'，在两个数据点之间创建数据提示。
x = linspace(1,10,10); y = 2.*x; p = plot(x,y,'-*'); dt = datatip(p,3.5,7,'SnapToDataVertex','off');
