TextBox 属性

要显示的文本，指定为字符向量、字符向量元胞数组、字符串数组、分类数组或数值。根据您需要的文本外观指定一个值。下表列出了最常见的情况。

str = 'My Text'

str = "My Text"

str = {'First line','Second line'};

str = ["First line", "Second line"];

x = 42;
str = ['The value is ',num2str(x)];

str = 'x ranges from 0 to 2\pi'

文本颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0 0 0] 对应于黑色。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 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'

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

TeX 标记

默认情况下，MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。

修饰符会一直作用到文本结尾，但上标和下标除外，因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex" 时，支持的修饰符如下所示。

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

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 的示例，请参阅图文本中的希腊字母和特殊字符。

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

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

字体大小，指定为大于 0 的标量值（以磅为单位）。默认字体大小取决于具体操作系统和区域设置。一磅等于 1/72 英寸。要更改字体单位，请使用 FontUnits 属性。

示例: 12

字符粗细，指定为 'normal' 或 'bold'。

MATLAB 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能得到普通字体。

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

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

字体大小单位，指定为此表中的一个值。

如果在一次函数调用中同时设置字体大小和字体单位，必须先设置 FontUnits 属性以使坐标区能正确解释指定的字体大小。

使框宽和框高适合文本的选项，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

如果您在绘图编辑模式下调整文本框的大小，或者更改 Position 属性，则 FitBoxToText 属性将更改为 'off'。

框轮廓的颜色，指定为三元素 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0 0 0] 对应于黑色。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 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"

文本框背景色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 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"

背景色的透明度，指定为介于 0 和 1 之间的一个标量值。如果值为 1，则颜色是不透明的。要增加透明度，请将该属性设置为接近 0 的值，其中 0 表示完全透明。

框轮廓的线型，指定为下表中列出的选项之一。

框轮廓的宽度，指定为数值标量（以磅为单位）。一磅等于 1/72 英寸。

示例: 1.5

文本框中文本周围的空间，指定为以像素为单位的数值标量。

尺寸和位置，指定为 [x_begin y_begin length height] 形式的四元素向量。前两个元素指定文本框的左下角坐标。后两个元素指定文本框的长度和高度。

默认情况下，使用归一化的图窗单位。图窗的左下角映射到 (0,0)，右上角映射到 (1,1)。要更改单位，请使用 Units 属性。

示例: [0.2 0.3 0.4 0.5]

以度为单位的旋转角度，指定为数值标量。旋转角度是绝对角度，并非相对于以前的旋转的相对角度。

下表显示使用可能的 Rotation 值所生成的注解旋转。

旋转的锚点是由 Position 属性向量的前两个元素指定的位置，由 [x y] 值指示。

示例: 45

位置单位，指定为此表中的一个值。

所有单位都是从图窗窗口左下角进行测量的。

此属性会影响 Position 属性。如果您更改单位，则比较好的做法是在完成计算后将其恢复为默认值，以便不影响其他假定 Units 设置为默认值的函数。

如果您在创建对象时使用名称-值参量指定 Position 和 Units 属性，则指定顺序很重要。如果想用特定单位定义位置，则必须在设置 Position 属性之前先设置 Units 属性。

文本框中文本的水平对齐方式，指定为此表中的一个值。

文本框中文本的垂直对齐方式，指定为此表中的一个值。