MATLAB文本注釋及特殊符號的表示

text

向數據點添加文本說明

全頁折疊

語法

text(x,y,txt)

text(x,y,z,txt)

text(___,Name,Value)

text(ax,___)

t = text(___)

 

說明

示例

text(x,y,txt) 使用由 txt 指定的文本，向當前坐標區中的一個或多個數據點添加文本說明。若要將文本添加到一個點，請將 x 和 y 指定為以數據單位表示的標量。若要將文本添加到多個點，請將 x 和 y 指定為長度相同的向量。

text(x,y,z,txt) 在三維坐標中定位文本。

示例

text(___,Name,Value) 使用一個或多個名稱-值對組指定 Text 對象的屬性。例如，'FontSize',14 將字體大小設置為 14 磅。您可以使用上述語法中的任意輸入參數組合指定文本屬性。如果您將 Position 和 String 屬性指定為名稱-值對組，則不需要指定 x、y、z 和 txt 輸入。

text(ax,___) 在由 ax 指定的坐標區中，而不是在當前坐標區 (gca) 中創建文本。選項 ax 可以位於前面的語法中的任何輸入參數組合之前。

示例

t = text(___) 返回一個或多個文本對象。使用 t 修改所創建的文本對象的屬性。有關屬性和說明的列表，請參閱 Text 屬性。可以使用上述任意語法指定一個輸出。

 

示例

全部折疊

向數據點添加文本說明

Try This Example 

繪制一條正弦曲線。在點  處，添加文本說明 。使用 TeX 標記 \pi 表示希臘字母 。使用 \leftarrow 顯示一個向左箭頭。

x = 0:pi/20:2*pi;
y = sin(x);
plot(x,y)
text(pi,0,'\leftarrow sin(\pi)')

有關希臘字母和其他 TeX 標記的列表，請參閱 Interpreter 屬性說明。

 

 

向多個數據點添加文本

Try This Example 

繪制一個線條。將相同的文本添加到沿該線條的兩個點。

x = linspace(-5,5);
y = x.^3-12*x;
plot(x,y)

xt = [-2 2];
yt = [16 -16];
str = 'dy/dx = 0';
text(xt,yt,str)

通過將 str 指定為元胞數組，向每個點添加不同文本。

x = linspace(-5,5);
y = x.^3-12*x;
plot(x,y)

xt = [-2 2];
yt = [16 -16];
str = {'local max','local min'};
text(xt,yt,str)

 

 

顯示多行文本

Try This Example 

創建一個線圖，並向坐標區添加一個文本說明。通過將 str 指定為元胞數組顯示多行文本。

plot(1:10)
str = {'A simple plot','from 1 to 10'};
text(2,7,str)

創建一個線圖，並向坐標區添加兩個文本說明。在向坐標區添加多個文本說明時，通過指定嵌套元胞數組顯示多行文本。

plot(1:10)
str = {{'A simple plot','from 1 to 10'},'y = x'};
text([2 8],[7 7],str)

 

 

指定文本大小和顏色

Try This Example 

創建一個線圖，並向坐標區添加文本說明。使用紅色 14 號字體。

plot(1:10)
text(2,8,'A Simple Plot','Color','red','FontSize',14)

 

 

修改現有文本

Try This Example 

創建一個線圖，並沿線條添加兩個文本說明。返回文本對象 t。

x = linspace(-5,5);
y = x.^3-12*x;
plot(x,y)
t = text([-2 2],[16 -16],'dy/dx = 0')

t = 
  2x1 Text array:

  Text    (dy/dx = 0)
  Text    (dy/dx = 0)

text 函數為每個文本說明創建一個文本對象。因此，t 包含兩個文本對象。

使用 t(1) 更改第一個文本對象的顏色和字體大小。從 R2014b 開始，您可以使用圓點表示法設置屬性。如果您使用的是早期版本，請改用 set 函數。

t(1).Color = 'red';
t(1).FontSize = 14;

 

 

輸入參數

全部折疊

x - 沿 x 軸的文本放置
標量 | 向量

沿 x 軸的文本放置，以下列形式之一指定：

• 標量 - 將文本添加到單個點。

• 向量 - 將文本添加到多個點。

x 和 y 的大小必須相同。默認單位是數據單位。要更改單位，請設置 Text 對象的 Units 屬性。

若要控制相對於指定點的文本放置，請使用 Text 對象的 HorizontalAlignment、VerticalAlignment 和 Extent 屬性。

數據類型： double | categorical | datetime | duration

y - 沿 y 軸的文本放置
標量 | 向量

沿 y 軸的文本放置，以下列形式之一指定：

• 標量 - 將文本添加到單個點。

• 向量 - 將文本添加到多個點。

x 和 y 的大小必須相同。默認單位是數據單位。要更改單位，請設置 Text 對象的 Units 屬性。

若要控制相對於指定點的文本放置，請使用 Text 對象的 HorizontalAlignment、VerticalAlignment 和 Extent 屬性。

數據類型： double | categorical | datetime | duration

z - 沿 z 軸的文本放置
0 （默認） | 標量 | 向量

沿 z 軸的文本放置，以下列形式之一指定：

• 標量 - 將文本添加到單個點。

• 向量 - 將文本添加到多個點。

x、y 和 z 的大小必須相同。默認單位是數據單位。要更改單位，請設置 Text 對象的 Units 屬性。

數據類型： double | categorical | datetime | duration

txt - 要顯示的文本
字符向量 | 字符串 | 字符數組 | 字符串數組 | 元胞數組

要顯示的文本，指定為字符向量、字符串、字符數組、字符串數組或元胞數組。

用於單個數據點的文本

要為單個點添加文本，請將 txt 指定為字符向量或字符串。例如，text(.5,.5,'my text')。

對於多行文本，請：

• 使用元胞數組，其中每個元胞包含一行文本。例如，text(.5,.5,{'first','second'})。

• 使用字符串數組，其中每個元素是一行文本。例如，text(.5,.5,["first","second"])。

• 使用具有多個行的字符數組，其中每一行包含相同數量的字符。例如，text(.5,.5,['first '; 'second'])。

• 使用 sprintf 創建一個換行符。例如，text(.5,.5,sprintf('first \nsecond'))。

 

用於多個數據點的文本

要在每個位置顯示相同的文本，請將 txt 指定為字符向量或字符串。例如，text([0 1],[0 1],'my text')。

要在每個位置顯示不同文本，請使用元胞數組。例如，text([0 1],[0 1],{'first','second'})。

對於多行文本，請使用嵌套元胞數組。例如，text([0 1],[0 1],{{'first','new line'},'second'})。

希臘字母、特殊字符和數值變量

要包括特殊字符（例如上標、下標、希臘字母或數學符號），請使用 TeX 標記。有關支持的標記的列表，請參閱 Interpreter 屬性。

要在文本中包含數值變量，請使用 num2str 函數。

v = 42;
txt = ['The value is ',num2str(v)];

 

ax - 目標坐標區
Axes 對象 | PolarAxes 對象

目標坐標區，指定為 Axes 對象或 PolarAxes 對象。如果您不指定坐標區，則 text 使用當前坐標區。

名稱-值對組參數

指定可選的、以逗號分隔的 Name,Value 對組參數。Name 為參數名稱，Value 為對應的值。Name 必須放在引號中。您可采用任意順序指定多個名稱-值對組參數，如 Name1,Value1,...,NameN,ValueN 所示。

示例： text(.5,.5,'my text','FontSize',14,'Color','red')

此處所列的屬性只是一部分。有關完整列表，請參閱 Text 屬性。

'FontSize' - 字體大小
大於 0 的標量值

字體大小，指定為大於 0 的標量值（以磅為單位）。默認字體大小取決於具體操作系統和區域設置。一磅等於 1/72 英寸。要更改字體單位，請使用 FontUnits 屬性。

示例： 12

數據類型： single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'FontWeight' - 字符粗細
'normal' （默認） | 'bold'

字符粗細，指定為 'normal' 或 'bold'。

MATLAB® 使用 FontWeight 屬性從系統提供的字體中選擇一種字體。並非所有字體都有加粗字體。因此，指定加粗字體仍可能得到普通字體。

'FontName' - 字體名稱
支持的字體名稱 | 'FixedWidth'

字體名稱，指定為支持的字體名稱或 'FixedWidth'。要正確顯示和打印文本，您必須選擇系統支持的字體。默認字體取決於您的操作系統和區域設置。

要使用在任何區域設置中都有較好顯示效果的等寬字體，請使用 'FixedWidth'。等寬字體依賴於根 FixedWidthFontName 屬性。設置根 FixedWidthFontName 屬性會導致立即更新顯示方式以使用新字體。

'Color' - 文本顏色
[0 0 0] （默認） | RGB 三元組 | 'r' | 'g' | 'b' | ...

文本顏色，指定為 RGB 三元組或表中列出的顏色選項之一。默認值 [0 0 0] 對應於黑色。

如果想自定義顏色，請指定一個 RGB 三元組。RGB 三元組是包含三個元素的行向量，其元素分別指定顏色中紅、綠、藍分量的強度。強度值必須位於 [0,1] 范圍內，例如 [0.4 0.6 0.7]。此外，還可以按名稱指定一些常見的顏色。下表列出長和短顏色名稱選項以及對應的 RGB 三元組值。

選項	說明	對應的 RGB 三元組
'red' 或 'r'	紅色	[1 0 0]
'green' 或 'g'	綠色	[0 1 0]
'blue' 或 'b'	藍色	[0 0 1]
'yellow' 或 'y'	黃色	[1 1 0]
'magenta' 或 'm'	品紅色	[1 0 1]
'cyan' 或 'c'	青藍色	[0 1 1]
'white' 或 'w'	白色	[1 1 1]
'black' 或 'k'	黑色	[0 0 0]
'none'	無顏色	不適用

示例： 'blue'

示例： [0 0 1]

'HorizontalAlignment' - 相對於位置點水平對齊文本
'left' （默認） | 'center' | 'right'

相對於 Position 屬性中的 x 值水平對齊文本，指定為此表中的一個值。垂直線指示 x 值相對於文本的位置。

值	結果
'left'（默認值）
'center'
'right'

 

'Position' - 文本位置
[0 0 0] （默認） | [x y] 格式的二元素向量 | [x y z] 格式的三元素向量

文本位置，指定為 [x y] 格式的二元素向量或 [x y z] 格式的三元素向量。如果您省略第三個元素 z，則 MATLAB 將其設置為 0。

使用數值指定位置。要將日期時間或持續時間值轉換為特定坐標方向上的相應數值，請參閱 ruler2num。

默認情況下，位置值是以數據單位定義的。要更改單位，請使用 Units 屬性。

示例： [0.5 0.5 0]

數據類型： double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'Units' - 位置和范圍單位
'data' （默認） | 'normalized' | 'inches' | 'centimeters' | 'characters' | 'points' | 'pixels'

位置單位，指定為此表中的一個值。

單位	說明
'data'（默認值）	數據坐標。
'normalized'	針對坐標區進行歸一化。坐標區的左下角映射到 (0,0)，右上角映射到 (1,1)。
'inches'	英寸。
'centimeters'	厘米。
'characters'	基於默認系統字體的字符大小。 字符寬度 = 字母 x 的寬度。 字符高度 = 兩個文本行的基線之間的距離。
'points'	磅。一磅等於 1/72 英寸。
'pixels'	像素。 從 R2015b 開始，以像素為單位的距離不再依賴 Windows® 和 Macintosh 系統上的系統分辨率： 在 Windows 系統上，一個像素是 1/96 英寸。 在 Macintosh 系統上，一個像素是 1/72 英寸。 在 Linux® 系統上，一個像素的大小由系統分辨率確定。

 

所有單位（'data' 除外）都是從坐標區的左下角進行測量的。此屬性會影響 Position 和 Extent 屬性。

如果您在創建 Text 對象時以 Name,Value 對組的形式指定 Position 和 Units 屬性，則指定順序很重要。若要使用特定單位定義位置，請在設置 Position 屬性之前先設置 Units 屬性。

'Interpreter' - 文本字符的解釋
'tex' （默認） | 'latex' | 'none'

文本字符的解釋，指定為下列值之一：

• 'tex' - 使用 TeX 標記子集解釋字符。

• 'latex' - 使用 LaTeX 標記解釋字符。

• 'none' - 顯示字面字符。

 

TeX 標記

默認情況下，MATLAB 支持一部分 TeX 標記。使用 TeX 標記可添加下標和上標，修改字體類型和顏色，並在文本中包括特殊字符。

修飾符會一直作用到文本結尾，但上標和下標除外，因為它們僅修飾下一個字符或花括號中的字符。當您將 Interpreter 屬性設置為 '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'

 

下表列出了當 Interpreter 屬性設置為 '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 標記，請將 Interpreter 屬性設置為 'latex'。使用美元符號將文本括起來，例如，對於內聯模式，使用 '$\int_1^{20} x^2 dx$'；對於顯示模式，使用 '$$\int_1^{20} x^2 dx$$'。

顯示的文本將使用默認的 LaTeX 字體樣式。FontName、FontWeight 和 FontAngle 屬性不起任何作用。要更改字體樣式，請使用 LaTeX 標記。

用於 LaTeX 解釋器的文本最多可以包含 1200 個字符。對於多行文本，請在此數量的基礎上每行減少約 10 個字符。

有關 LaTeX 系統的詳細信息，請訪問 LaTeX Project 網站：https://www.latex-project.org/。

輸出參數

全部折疊

t - Text 對象
Text 對象

Text 對象。在創建特定 Text 對象后，使用 t 的元素對其進行修改。有關屬性列表，請參閱 Text 屬性。

提示

• 默認情況下，文本對象的 Clipping 屬性設置為 'off'，這樣文本可能顯示在坐標區之外。若要裁剪文本使其在坐標區邊界內，請將該屬性設置為 'on'。