DataTipTemplate 属性

数据提示内容和外观

DataTipTemplate 属性控制数据提示的内容和外观。通过更改属性值，您可以修改数据提示的特定方面。

p = plot(1:10);
dtt = p.DataTipTemplate

内容

全部展开

`DataTipRows` — 行内容
`DataTipTextRow` 对象数组

行内容，指定为 DataTipTextRow 对象数组。

您可以通过设置 DataTipTextRow 对象的属性来修改现有行。通过对对象数组进行索引来访问特定行。

示例: dtt.DataTipRows(1).Label = 'My label' 更改第一行的标签。

示例: dtt.DataTipRows(1).Value = 'YData' 将第一行的值源更改为使用绘图对象的 YData 属性。

示例: dtt.DataTipRows(1).Format = 'usd' 更改第一行的值格式。

您也可以使用 dataTipTextRow 函数向数据提示添加新行。

示例: dtt.DataTipRows(end+1) = dataTipTextRow(label,value) 使用指定的标签和值源向数据提示添加新行。

字体

全部展开

`FontName` — 字体名称
支持的字体名称 | `"FixedWidth"`

字体名称，指定为支持的字体名称或 "FixedWidth"。要正确显示和打印文本，您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体，请使用 "FixedWidth"。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

`FontSize` — 字体大小
10 (默认) | 大于 0 的标量值

字体大小，指定为大于 0 的标量值（以磅为单位）。一磅等于 1/72 英寸。

`FontAngle` — 字符倾斜
`'normal'` (默认) | `'italic'`

字符倾斜，指定为 'normal' 或 'italic'。

并非所有字体都有两种字体样式。因此，斜体可能看上去和常规字体一样。

`Interpreter` — 文本解释器
`'tex'` (默认) | `'latex'` | `'none'`

文本解释器，指定为下列值之一：

'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{specifier}`	字体名称 - 将 `specifier` 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。	`"\fontname{Courier} text"`
`\fontsize{specifier}`	字体大小 - 将 `specifier` 替换为以磅为单位的数值标量值。	`"\fontsize{15} text"`
`\color{specifier}`	字体颜色 - 将 `specifier` 替换为以下颜色之一：`red`、`green`、`yellow`、`magenta`、`blue`、`black`、`white`、`gray`、`darkGreen`、`orange` 或 `lightBlue`。	`"\color{magenta} text"`
`\color[rgb]{specifier}`	自定义字体颜色 - 将 `specifier` 替换为三元素 RGB 三元组。	`"\color[rgb]{0,0.5,0.5} text"`

下表列出了 "tex" 解释器所支持的特殊字符。

字符序列	符号	字符序列	符号	字符序列	符号
`\alpha`	α	`\upsilon`	υ	`\sim`	~
`\angle`	∠	`\phi`	ϕ	`\leq`	≤
`\ast`	`*`	`\chi`	χ	`\infty`	∞
`\beta`	β	`\psi`	ψ	`\clubsuit`	♣
`\gamma`	γ	`\omega`	ω	`\diamondsuit`	♦
`\delta`	δ	`\Gamma`	Γ	`\heartsuit`	♥
`\epsilon`	ϵ	`\Delta`	Δ	`\spadesuit`	♠
`\zeta`	ζ	`\Theta`	Θ	`\leftrightarrow`	↔
`\eta`	η	`\Lambda`	Λ	`\leftarrow`	←
`\theta`	θ	`\Xi`	Ξ	`\Leftarrow`	⇐
`\vartheta`	ϑ	`\Pi`	Π	`\uparrow`	↑
`\iota`	ι	`\Sigma`	Σ	`\rightarrow`	→
`\kappa`	κ	`\Upsilon`	ϒ	`\Rightarrow`	⇒
`\lambda`	λ	`\Phi`	Φ	`\downarrow`	↓
`\mu`	µ	`\Psi`	Ψ	`\circ`	º
`\nu`	ν	`\Omega`	Ω	`\pm`	±
`\xi`	ξ	`\forall`	∀	`\geq`	≥
`\pi`	π	`\exists`	∃	`\propto`	∝
`\rho`	ρ	`\ni`	∍	`\partial`	∂
`\sigma`	σ	`\cong`	≅	`\bullet`	•
`\varsigma`	ς	`\approx`	≈	`\div`	÷
`\tau`	τ	`\Re`	ℜ	`\neq`	≠
`\equiv`	≡	`\oplus`	⊕	`\aleph`	ℵ
`\Im`	ℑ	`\cup`	∪	`\wp`	℘
`\otimes`	⊗	`\subseteq`	⊆	`\oslash`	∅
`\cap`	∩	`\in`	∈	`\supseteq`	⊇
`\supset`	⊃	`\lceil`	⌈	`\subset`	⊂
`\int`	∫	`\cdot`	·	`\o`	ο
`\rfloor`	⌋	`\neg`	¬	`\nabla`	∇
`\lfloor`	⌊	`\times`	x	`\ldots`	...
`\perp`	⊥	`\surd`	√	`\prime`	´
`\wedge`	∧	`\varpi`	ϖ	`\0`	∅
`\rceil`	⌉	`\rangle`	〉	`\mid`	\|
`\vee`	∨	`\langle`	〈	`\copyright`	©

LaTeX 标记

要使用 LaTeX 标记，请将解释器设置为 "latex"。对于行内模式，用单美元符号 ($) 将标记括起来。对于显示模式，用双美元符号 ($$) 将标记括起来。

LaTeX 模式	示例	结果
行内	"$\int_1^{20} x^2 dx$"
显示	"$$\int_1^{20} x^2 dx$$"

LaTeX 模式

示例

结果

行内

"$\int_1^{20} x^2 dx$"

Equation with LaTeX inline mode

显示

"$$\int_1^{20} x^2 dx$$"

Equation with LaTeX display mode

显示的文本将使用默认的 LaTeX 字体样式。FontName、FontWeight 和 FontAngle 属性不起任何作用。要更改字体样式，请使用 LaTeX 标记。

用于 LaTeX 解释器的文本最多可以包含 1200 个字符。对于多行文本，请在此数量的基础上每行减少约 10 个字符。

MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息，请参阅支持的 LaTeX 命令。有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。

提示

通过修改 datatip 对象的属性来控制数据提示的行为。

版本历史记录

在 R2019a 中推出

另请参阅

dataTipTextRow

DataTipTemplate 属性

内容

DataTipRows — 行内容 DataTipTextRow 对象数组

字体

FontName — 字体名称 支持的字体名称 | "FixedWidth"

FontSize — 字体大小 10 (默认) | 大于 0 的标量值

FontAngle — 字符倾斜 'normal' (默认) | 'italic'

Interpreter — 文本解释器 'tex' (默认) | 'latex' | 'none'