xline
具有常量 x 值的垂直线
语法
说明
xline(___, 使用一个或多个名称-值对组参量指定常量线属性。有关属性列表，请参阅 ConstantLine 属性。请在所有其他输入参量之后指定名称-值对组。Name,Value)
xl = xline(___) 返回一个 ConstantLine 对象或 ConstantLine 对象数组。使用 xl 修改或查询所创建的线条的属性。
示例
在 x = 3 处创建一条垂直线。
xline(3);
要创建一条具有标签的线条，还必须指定线型。默认线型是实线 '-'。
x = linspace(0,6,100); y = exp(x); plot(x,y) xline(4.5,'-',{'Acceptable','Limit'});
创建一个由正态分布随机数组成的向量，并在直方图中显示它们。然后创建三条带标签的垂直线，一条表示平均值、一条表示低于平均值一个标准差，一条表示高于平均值一个标准差。
data = 5 * randn(1,500) + 20; histogram(data,'FaceAlpha',0.1,'EdgeAlpha',0.1); m = mean(data); s = std(data); xline([m-s m m+s],'-',{'-1 Standard Dev.','Average','+1 Standard Dev.'})
在 x = 5 处创建一条红色虚线。
xline(5,'--r');
为图例创建一条既具有标签又具有显示名称的垂直点划线。
y = [3187 2693 1771 1826 1958 3222 1645]; barh(y,'DisplayName','Daily Sales') xl = xline(2328,'-.','Average','DisplayName','Average Sales');
调整该标签的垂直和水平对齐，然后显示图例。
xl.LabelVerticalAlignment = 'middle'; xl.LabelHorizontalAlignment = 'center'; legend('show');
调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。然后在每个坐标区中绘图。通过将坐标区传递给 xline 函数，为每个图添加一条垂直虚线和标签。
tiledlayout(2,1) ax1 =nexttile; x = linspace(0,10,200); y1 = cos(x); plot(ax1,x,y1) ax2 = nexttile; y2 = sin(x); plot(ax2,x,y2) xline(ax1,pi/2,':','cos(\pi/2)=0'); xline(ax2,pi,':','sin(\pi)=0');
输入参数
x 坐标，指定为标量或包含数值、分类、日期时间或持续时间值的向量。x 的数据类型必须与 x 轴的数据类型匹配。
示例: xline(10) 在 x=10 处显示一条线。
示例: xline([13 20 33]) 在 x=13、x=20 和 x=33 处显示线条。
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration
线型和颜色，指定为包含字符和符号的字符向量或字符串标量。字符和符号可以按任何顺序出现。您可以指定线型和/或线条颜色。忽略 'o' 等标记符号。
示例: '--g' 表示绿色虚线。
| 线型 | 描述 | 表示的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
| 颜色名称 | 短名称 | 外观 |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
目标坐标区，指定为 Axes 对象。如果希望 xline 在当前坐标区以外的坐标区中绘图，请使用此参量。
信号线标签，指定为字符向量、字符串标量、字符向量元胞数组或字符串数组。
为一条线创建标签
指定一个字符向量或字符串标量来显示一行文本。要显示多行文本，请指定字符向量元胞数组或字符串数组。
| 表示形式 | 如何指定 labels | 示例 |
|---|---|---|
| 一行文本 | 指定一个字符向量或字符串标量。 |
xline(12,'-','Sample')
|
| 多行文本 | 指定一个字符向量元胞数组或字符串数组。数组中的每个元素是不同行的文本。 | xline(12,'-',{'Sample','x=12'})
|
为多行创建标签
指定一个字符向量或字符串标量，以便在所有行旁边显示相同的标签。指定一个字符向量元胞数组或字符串数组，为每行显示不同标签。
| 表示形式 | 如何指定 labels | 示例 |
|---|---|---|
| 一个共享文本标签 | 指定一个字符向量或字符串标量。 |
xline([13 20 33],'-','Sample')
|
| 每行有不同标签 | 指定一个字符向量元胞数组或字符串数组。数组中的每个元素都是一个对应不同行的标签。labels 数组中的元素数必须与 x 的长度匹配。 | label = {'Sample 1','Sample 2','Sample 3'};
xline([13 20 33],'-',label)
|
| 不同的标签，部分标签有多行 | 创建一个字符向量元胞数组或字符串数组。使用 sprintf 函数在文本中插入换行符 ('\n')。 | label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'};
xline([13 20 33],'-',label)
|
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。
示例: xline(5,'LabelVerticalAlignment','middle') 将标签的垂直对齐方式指定为 'middle'。
注意
此处所列的属性只是一部分。有关完整列表，请参阅 ConstantLine 属性。
线条颜色，指定为 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" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 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)) 获取十六进制颜色代码。
示例: 'g'
示例: [0.6 0.2 0.5]
示例: '#D2F9A7'
线宽，指定为以磅为单位的正值。
标签相对于线的水平对齐，指定为下表中的选项之一。
| 选项 | 描述 | 示例 |
|---|---|---|
'right' | 线的右侧。 |
|
'left' | 线的左侧。 |
|
'center' | 线的中心。标签将线分段。 |
|
标签相对于线的垂直对齐，指定为下表中的选项之一。
| 选项 | 描述 | 示例 |
|---|---|---|
'top' | 线的顶部 |
|
'middle' | 线的中间 |
|
'bottom' | 线的底部 |
|
标签方向，指定为 'aligned' 或 'horizontal'。下表中显示了示例。
| 方向 | 描述 | 示例 |
|---|---|---|
'aligned' | 标签与线的方向相同。 |
|
'horizontal' | 无论线的方向如何，标签始终为水平方向。 |
|
算法
在坐标区的三维视图中，常量线出现在 z 坐标轴范围中点处的 x-y 平面中。如果坐标区旋转，则常量线会随之旋转。
版本历史记录
在 R2018b 中推出
