Text 属性
图例文本的外观和行为
图例文本属性控制图例标题的外观和行为。通过更改属性值，您可以修改该标题的特定方面。使用圆点表示法引用特定的对象和属性：
l = legend('show');
l.Title.String = 'My Title';
l.Title.Color = 'red';
c = l.Title.Color文本
要显示为标题的文本，指定为字符数组、字符串数组、元胞数组、分类数组或数值。
示例: 'my title'
示例: string('my title')
示例: {'first line','second line'}
示例: 123
要将数值变量和文本包括在标题中，请使用 num2str 函数。例如：
x = 42;
str = ['The value is ',num2str(x)];要包括特殊字符（例如上标、下标、希腊字母或数学符号），请使用 TeX 标记。有关支持的标记的列表，请参阅 Interpreter 属性。
要创建多行标题：
使用字符串数组，其中每个元素包含一行文本，例如
string({'line one','line two'})。使用元胞数组，其中每个元胞包含一行文本，例如
{'first line','second line'}。使用字符数组，其中每一行包含一行文本，例如
['abc'; 'ab ']。如果使用这种方法，每行的字符数必须相同。使用
sprintf创建包含换行符的文本，例如sprintf('first line \n second line')。
使用 sprintf('%g',value) 将数值型标题转换为文本。例如，12345678 显示为 1.23457e+07。
注意
词语
default、factory和remove是保留字，作为标准字符向量引用时，标题中将不会出现。要在文本中单独显示这些单词中的任意单词，需在该单词之前放置反斜杠，例如'\default'或'\remove'。如果将此属性指定为分类数组，MATLAB® 将使用数组中的值，而不是类别。
文本解释器，指定为下列值之一：
'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'- 使用与关联的Legend对象的Interpreter属性相同的值。'manual'- 使用您指定的Interpreter值。要指定值，请设置Interpreter属性。当您设置Interpreter属性时，InterpreterMode属性将更改为'manual'。
字体样式和外观
文本颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0 0 0] 对应于黑色。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]范围内，例如[0.4 0.6 0.7]。十六进制颜色代码是字符串标量或字符向量，以井号 (
#) 开头，后跟三个或六个十六进制数字，范围可以是0到F。这些值不区分大小写。因此，颜色代码"#FF8800"与"#ff8800"、"#F80"与"#f80"是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
示例: 'blue'
示例: [0 0 1]
示例: '#0000FF'
Color 属性的选择模式，指定为下列值之一：
'auto'- 使用与关联的Legend对象的TextColor属性相同的值。'manual'- 使用您指定的Color值。要指定值，请设置Color属性。当您设置Color属性时，ColorMode属性将更改为'manual'。
FontAngle 属性的选择模式，指定为下列值之一：
'auto'- 使用与关联的Legend对象的FontAngle属性相同的值。'manual'- 使用您指定的FontAngle值。要指定值，请设置FontAngle属性。当您设置FontAngle属性时，FontAngleMode属性将更改为'manual'。
FontName 属性的选择模式，指定为下列值之一：
'auto'- 使用与关联的Legend对象的FontName属性相同的值。'manual'- 使用您指定的FontName值。要指定值，请设置FontName属性。当您设置FontName属性时，FontNameMode属性将更改为'manual'。
FontSize 属性的选择模式，指定为下列值之一：
'auto'- 使用与关联的Legend对象的FontSize属性相同的值。'manual'- 使用您指定的FontSize值。要指定值，请设置FontSize属性。当您设置FontSize属性时，FontSizeMode属性将更改为'manual'。
FontWeight 属性的选择模式，指定为下列值之一：
'auto'- 使用与关联的Legend对象的FontWeight属性相同的值。'manual'- 使用您指定的FontWeight值。要指定值，请设置FontWeight属性。当您设置FontWeight属性时，FontWeightMode属性将更改为'manual'。
版本历史记录
在 R2016a 中推出
