Text 属性
图例文本的外观和行为
图例文本属性控制图例标题的外观和行为。通过更改属性值,您可以修改该标题的特定方面。使用圆点表示法引用特定的对象和属性:
l = legend('show'); l.Title.String = 'My Title'; l.Title.Color = 'red'; c = l.Title.Color
文本
String
— 要显示为标题的文本
字符数组 | 字符串数组 | 元胞数组 | 分类数组 | 数值
要显示为标题的文本,指定为字符数组、字符串数组、元胞数组、分类数组或数值。
示例: '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® 将使用数组中的值,而不是类别。
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{ | 字体名称 - 将 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。 | '\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} | 自定义字体颜色 - 将 替换为三元素 RGB 三元组。 | '\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 个字符。
有关使用 TeX 和 LaTeX 的示例,请参阅图文本中的希腊字母和特殊字符。有关 LaTeX 系统的详细信息,请访问 LaTeX Project 网站:https://www.latex-project.org/。
InterpreterMode
— Interpreter
的选择模式
'auto'
(默认) | 'manual'
Interpreter
属性的选择模式,指定为下列值之一:
'auto'
- 使用与关联的Legend
对象的Interpreter
属性相同的值。'manual'
- 使用您指定的Interpreter
值。要指定值,请设置Interpreter
属性。当您设置Interpreter
属性时,InterpreterMode
属性将更改为'manual'
。
字体样式和外观
Color
— 文本颜色
[0 0 0]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
文本颜色,指定为 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" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
示例: 'blue'
示例: [0 0 1]
示例: '#0000FF'
ColorMode
— Color
的选择模式
'auto'
(默认) | 'manual'
Color
属性的选择模式,指定为下列值之一:
'auto'
- 使用与关联的Legend
对象的TextColor
属性相同的值。'manual'
- 使用您指定的Color
值。要指定值,请设置Color
属性。当您设置Color
属性时,ColorMode
属性将更改为'manual'
。
FontAngle
— 字符倾斜
'normal'
(默认) | 'italic'
字符倾斜,指定为 'normal'
或 'italic'
。
并非所有字体都有两种字体样式。因此,斜体可能看上去和常规字体一样。
FontAngleMode
— FontAngle
的选择模式
'auto'
(默认) | 'manual'
FontAngle
属性的选择模式,指定为下列值之一:
'auto'
- 使用与关联的Legend
对象的FontAngle
属性相同的值。'manual'
- 使用您指定的FontAngle
值。要指定值,请设置FontAngle
属性。当您设置FontAngle
属性时,FontAngleMode
属性将更改为'manual'
。
FontName
— 字体名称
支持的字体名称 | "FixedWidth"
字体名称,指定为支持的字体名称或 "FixedWidth"
。要正确显示和打印文本,您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。
要使用在任何区域设置中都有较好显示效果的等宽字体,请使用 "FixedWidth"
。等宽字体依赖于根 FixedWidthFontName
属性。设置根 FixedWidthFontName
属性会导致立即更新显示方式以使用新字体。
FontNameMode
— FontName
的选择模式
'auto'
(默认) | 'manual'
FontName
属性的选择模式,指定为下列值之一:
'auto'
- 使用与关联的Legend
对象的FontName
属性相同的值。'manual'
- 使用您指定的FontName
值。要指定值,请设置FontName
属性。当您设置FontName
属性时,FontNameMode
属性将更改为'manual'
。
FontSize
— 字体大小
大于 0 的标量值
字体大小,指定为大于 0 的标量值(以磅为单位)。默认字体大小取决于具体操作系统和区域设置。
如果您更改坐标区字体大小,MATLAB 会自动将颜色栏的字体大小设置为坐标区字体大小的 90%。如果手动设置了颜色栏的字体大小,则更改坐标区字体大小不会影响颜色栏的字体。
FontSizeMode
— FontSize
的选择模式
'auto'
(默认) | 'manual'
FontSize
属性的选择模式,指定为下列值之一:
'auto'
- 使用与关联的Legend
对象的FontSize
属性相同的值。'manual'
- 使用您指定的FontSize
值。要指定值,请设置FontSize
属性。当您设置FontSize
属性时,FontSizeMode
属性将更改为'manual'
。
FontWeight
— 字符粗细
'normal'
(默认) | 'bold'
字符粗细,指定为 'normal'
或 'bold'
。
MATLAB 使用 FontWeight
属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此,指定加粗字体仍可能得到普通字体。
FontWeightMode
— FontWeight
的选择模式
'auto'
(默认) | 'manual'
FontWeight
属性的选择模式,指定为下列值之一:
'auto'
- 使用与关联的Legend
对象的FontWeight
属性相同的值。'manual'
- 使用您指定的FontWeight
值。要指定值,请设置FontWeight
属性。当您设置FontWeight
属性时,FontWeightMode
属性将更改为'manual'
。
Visible
— 可见性状态
"on"
(默认) | on/off 逻辑值
可见性状态,指定为 "on"
或 "off"
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 "on"
等效于 true
,"off"
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
"on"
- 显示对象。"off"
- 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。
版本历史记录
在 R2016a 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)