Rectangle 属性

注释矩形的外观和行为

Rectangle 属性控制 Rectangle 对象的外观和行为。通过更改属性值，您可以修改矩形的特定方面。使用圆点表示法查询和设置属性。

h = annotation("rectangle");
c = h.Color;
h.Color = "red";

颜色和样式

全部展开

`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"

`FaceColor` — 填充颜色
`"none"` (默认) | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

填充颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色，请指定 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"

`FaceAlpha` — 填充透明度
`1` (默认) | 范围 `[0,1]` 之间的值

填充透明度，指定为 [0,1] 范围之间的一个标量值。值为 1 时不透明，值为 0 时完全透明。介于 0 和 1 之间的值表示半透明。

示例: 0.5

`LineStyle` — 线型
`"-"` (默认) | `"--"` | `":"` | `"-."` | `"none"`

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

线型	描述	表示的线条
`"-"`	实线
`"--"`	虚线
`":"`	点线
`"-."`	点划线
`"none"`	无线条	无线条

`LineWidth` — 线条宽度
`0.5` (默认) | 正值

矩形轮廓的线条宽度，指定为以磅为单位的正值。一磅等于 1/72 英寸。

示例: 0.75

位置

全部展开

`Position` — 尺寸和位置
`[0.3 0.3 0.1 0.1]` (默认) | 四元素向量

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

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

示例: [0.2 0.3 0.4 0.5]

`Rotation` — 以度为单位的旋转角度
`0` (默认) | 数值标量

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

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

旋转值	生成的旋转
0	未旋转
正标量值	逆时针旋转指定的度数
负标量值	顺时针旋转指定的度数

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

示例: 45

`Units` — 位置单位
`"normalized"` (默认) | `"inches"` | `"centimeters"` | `"characters"` | `"points"` | `"pixels"`

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

`Units`	描述
`"normalized"`（默认值）	针对包含注释的图窗、uipanel 或 uitab 进行归一化。容器的左下角映射到 `(0,0)`，右上角映射到 `(1,1)`。
`"inches"`	英寸。
`"centimeters"`	厘米。
`"characters"`	基于默认系统字体的字符大小。字符宽度 = 字母 `x` 的宽度。字符高度 = 两个文本行的基线之间的距离。
`"points"`	磅。一磅等于 1/72 英寸。
`"pixels"`	像素。从 R2015b 开始，以像素为单位的距离不再依赖 Windows^® 和 Macintosh 系统上的系统分辨率：在 Windows 系统上，一个像素是 1/96 英寸。在 Macintosh 系统上，一个像素是 1/72 英寸。在 Linux^® 系统上，一个像素的大小由系统分辨率确定。