本页翻译不是最新的。点击此处可查看最新英文版本。
图形线条的外观和行为
全页展开
Line 属性控制 Line 对象的外观和行为。通过更改属性值，您可以修改线图的某些方面。使用圆点表示法查询和设置属性。
p = plot(1:10);c = p.Color;p.Color = 'red';
线条
全部展开
SeriesIndex — 序列索引
正整数 (默认) | "none"
序列索引，指定为正整数或 "none"。此属性可用于重新分配 Line 对象的颜色、线型或标记，使它们与其他对象匹配。
默认情况下，SeriesIndex 属性是一个数字，对应于 Line 对象的创建顺序，从 1 开始。在您调用绘图函数时，MATLAB 使用该数字计算用于自动分配颜色、线型或标记的索引。索引引用存储在坐标区的 ColorOrder 和 LineStyleOrder 属性中的数组的行。坐标区中具有相同 SeriesIndex 编号的任何对象也都具有相同的颜色（以及线型和标记，如果适用）。
SeriesIndex 值 "none" 对应于不参与索引方案的中性颜色的实线。
手动设置颜色、线型或标记如何覆盖 SeriesIndex 行为
要手动控制颜色、线型和标记，请设置 Line 对象的 Color、LineStyle 和 Marker 属性。
当您手动设置一个对象的这些属性时，MATLAB 会禁用该对象的颜色、线型和标记的自动选择，并允许您的选择保持不变，而不管 SeriesIndex 属性的值如何。ColorMode、LineStyleMode 和 MarkerMode 属性指示颜色、线型和标记是由您手动设置的还是自动设置的。对于这些模式属性中的每个属性，值 "manual" 表示手动选择，值 "auto" 表示自动选择。
要再次启用自动选择，请将 ColorMode、LineStyleMode、MarkerMode 或所有这三个属性设置为 "auto"，并将 SeriesIndex 属性设置为一个正整数。
在某些情况下，MATLAB 会将 SeriesIndex 属性设置为 0，这也会禁用自动选择。
标记
全部展开
笛卡尔坐标数据
全部展开
XData — x 值
向量
x 值，指定为向量。
对于二维线图，如果不指定 x 值，则 MATLAB 将
YData的索引用作该绘图的 x 值。XData和YData的长度必须相同。对于三维线图，如果不指定 x 值，则 MATLAB 将
ZData的索引用作该绘图的 x 值。XDataYData和ZData的长度必须相同。
示例: [1:10]
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
XDataMode — 控制如何设置 XData
'auto' | 'manual'
控制如何设置 XData 属性，指定为下列值之一：
'auto'- MATLAB 控制XData属性的值。XData值可以为：YData中的值的索引。表变量中的值。
SourceTable属性指定表，XVariable属性指定变量。如果SourceTable或XVariable属性为空，则使用YData索引。
'manual'- 直接设置XData属性，而且它不会自动更新。当您绘制向量或坐标矩阵时就会出现这种情况。
YData — y 值
向量
y 值，指定为向量。对于二维线图，XData 和 YData 的长度必须相同。对于三维线图，XDataYData 和 ZData 的长度必须相同。
示例: [1:10]
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
YDataMode — 控制如何设置 YData
'auto' | 'manual'
控制如何设置 YData 属性，指定为下列值之一：
'auto'-YData属性根据SourceTable和YVariable属性自动更新。将表传递给绘图函数时就会出现这种情况。'manual'- 直接设置YData属性，而且它不会自动更新。当您绘制向量或坐标矩阵时就会出现这种情况。
ZData — z 值
向量
三维线图的 z 值，指定为向量。XData、YData 和 ZData 必须具有相同的长度。
示例: [1:10]
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
ZDataMode — 控制如何设置 ZData
'auto' | 'manual'
控制如何设置 ZData 属性，指定为下列值之一：
'auto'-ZData属性根据SourceTable和ZVariable属性自动更新。将表传递给绘图函数时就会出现这种情况。'manual'- 直接设置ZData属性，而且它不会自动更新。当您绘制向量或坐标矩阵时就会出现这种情况。
AffectAutoLimits — 在坐标区范围中包括数据范围
"on" (默认) | on/off 逻辑值
自 R2023a 起
在坐标区范围的自动选择中包括 Line 对象的数据范围，指定为 "on"、"off"、逻辑值 1 (true) 或 0 (false)。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
默认情况下，坐标区范围会自动更改以包括您在坐标区中创建的每个后续线条的数据范围。设置此属性使您能够重点关注一部分线条的范围。要在自动选择中排除某个线条的数据范围，请将其 AffectAutoLimits 属性设置为 "off"。
两个线条都采用 AffectAutoLimits="on" | 细红色线条采用 AffectAutoLimits="off" |
|---|---|
|
|
极坐标数据
全部展开
ThetaData — 角度值
向量
角度值，指定为向量。ThetaData 和 RData 必须是长度相等的向量。
此属性仅适用于极坐标区中的线条。
ThetaDataMode — 控制如何设置 ThetaData
'auto' | 'manual'
控制如何设置 ThetaData 属性，指定为下列值之一：
'auto'- MATLAB 控制ThetaData属性的值。值可以为：RData中的值的索引。表变量中的值。
SourceTable属性指定表，ThetaVariable属性指定变量。如果SourceTable或ThetaVariable属性为空，则使用RData索引。
'manual'- 直接设置ThetaData属性，而且它不会自动更新。当您将坐标值作为向量或矩阵传递给绘图函数（如polarplot）时，就会出现这种情况。
此属性仅适用于极坐标区中的线条。
ThetaDataSource — 链接到 ThetaData 的变量
'' (默认) | 包含 MATLAB 工作区变量名称的字符向量
链接到 ThetaData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量。MATLAB 通过计算基础工作区中的变量来生成 RData。
默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 ThetaData 值。若要强制更新数据值，需要使用 refreshdata 函数。
注意
如果您将一个数据源属性更改为包含不同维度数据的变量，则可能会导致函数生成警告，且在将所有数据源属性更改为适当值之前将无法显示图形。
此属性仅适用于极坐标区中的线条。
RData — 半径值
向量
半径值，指定为向量。ThetaData 和 RData 必须是长度相等的向量。
此属性仅适用于极坐标区中的线条。
RDataMode — 控制如何设置 RData
'auto' | 'manual'
控制如何设置 RData 属性，指定为下列值之一：
'auto'-RData属性根据SourceTable和RVariable属性自动更新。当您将表传递给绘图函数（如polarplot）时，就会出现这种情况。'manual'- 直接设置RData属性，而且它不会自动更新。当您将坐标值作为向量或矩阵传递给绘图函数（如polarplot）时，就会出现这种情况。此属性仅适用于极坐标区中的线条。
RDataSource — 链接到 RData 的变量
'' (默认) | 包含 MATLAB 工作区变量名称的字符向量
链接到 RData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量。MATLAB 通过计算基础工作区中的变量来生成 RData。
默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 RData 值。若要强制更新数据值，需要使用 refreshdata 函数。
注意
如果您将一个数据源属性更改为包含不同维度数据的变量，则可能会导致函数生成警告，且在将所有数据源属性更改为适当值之前将无法显示图形。
此属性仅适用于极坐标区中的线条。
地理坐标数据
全部展开
LatitudeData — 纬度值
向量
纬度值，指定为向量。LatitudeData 和 LongitudeData 必须是长度相等的向量。
此属性仅适用于地理坐标区中的线条。
LatitudeDataMode — 控制如何设置 LatitudeData
'auto' | 'manual'
控制如何设置 LatitudeData 属性，指定为下列值之一：
'auto'-LatitudeData属性根据SourceTable和LatitudeVariable属性自动更新。将表传递给绘图函数时就会出现这种情况。'manual'- 直接设置LatitudeData属性，而且它不会自动更新。当您将坐标值作为向量或矩阵传递给绘图函数时，就会出现这种情况。
此属性仅应用于地理坐标区。
LatitudeDataSource — 链接到 LatitudeData 的变量
'' (默认) | 包含 MATLAB 工作区变量名称的字符向量
链接到 LatitudeData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量。MATLAB 通过计算基础工作区中的变量来生成 LatitudeData。
默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 LatitudeData 值。若要强制更新数据值，需要使用 refreshdata 函数。
注意
如果您将一个数据源属性更改为包含不同维度数据的变量，则可能会导致函数生成警告，且在将所有数据源属性更改为适当值之前将无法显示图形。
此属性仅适用于地理坐标区中的线条。
LongitudeData — 经度值
向量
经度值，指定为向量。LongitudeData 和 LatitudeData 必须是长度相等的向量。
此属性仅适用于地理坐标区中的线条。
LongitudeDataMode — 控制如何设置 LongitudeData
'auto' | 'manual'
控制如何设置 LongitudeData 属性，指定为下列值之一：
'auto'-LongitudeData属性根据SourceTable和LongitudeVariable属性自动更新。将表传递给绘图函数时就会出现这种情况。'manual'- 直接设置LongitudeData属性，而且它不会自动更新。当您将坐标值作为向量或矩阵传递给绘图函数时，就会出现这种情况。
此属性仅应用于地理坐标区。
LongitudeDataSource — 链接到 LongitudeData 的变量
'' (默认) | 包含 MATLAB 工作区变量名称的字符向量
链接到 LongitudeData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量。MATLAB 通过计算基础工作区中的变量来生成 LongitudeData。
默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 LongitudeData 值。若要强制更新数据值，需要使用 refreshdata 函数。
注意
如果您将一个数据源属性更改为包含不同维度数据的变量，则可能会导致函数生成警告，且在将所有数据源属性更改为适当值之前将无法显示图形。
此属性仅适用于地理坐标区中的线条。
表数据（自 R2022a 开始）
全部展开
SourceTable — 源表
表 | 时间表
包含要绘制的数据的源表。将此属性指定为表或时间表。
XVariable — 包含 x 坐标的表变量
字符串标量 | 字符向量 | 模式 | 数值标量 | 逻辑向量 | vartype()
包含 x 坐标的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含数值、分类、日期时间或持续时间值。当您设置此属性时，MATLAB 会更新 XData 属性。
下表列出了可用于指定表变量的不同索引方案。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
YVariable — 包含 y 坐标的表变量
字符串标量 | 字符向量 | 模式 | 数值标量 | 逻辑向量 | vartype()
包含 y 坐标的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含数值、分类、日期时间或持续时间值。当您设置此属性时，MATLAB 会更新 YData 属性。
下表列出了可用于指定表变量的不同索引方案。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
ZVariable — 包含 z 坐标的表变量
字符串标量 | 字符向量 | 模式 | 数值标量 | 逻辑向量 | vartype()
包含 z 坐标的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含数值、分类、日期时间或持续时间值。当您设置此属性时，MATLAB 会更新 ZData 属性。
下表列出了可用于指定表变量的不同索引方案。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
RVariable — 包含半径值的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype()
包含极坐标图半径值的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含任何类型的数值。当您设置此属性时，MATLAB 会更新 RData 属性。此属性仅适用于极坐标区。
以下是可用于指定表变量的不同索引方案的列表。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
ThetaVariable — 包含角度值的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype()
包含极坐标图角度值的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含任何类型的数值。当您设置此属性时，MATLAB 会更新 ThetaData 属性。此属性仅适用于极坐标区。
以下是可用于指定表变量的不同索引方案的列表。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
LatitudeVariable — 包含纬度值的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype()
包含地理图纬度值的表变量，使用下表中的索引方案之一指定。当您设置此属性时，MATLAB 会更新 LatitudeData 属性。此属性仅应用于地理坐标区。
以下是可用于指定表变量的不同索引方案的列表。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
LongitudeVariable — 包含经度值的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype()
包含地理图经度值的表变量，使用下表中的索引方案之一指定。当您设置此属性时，MATLAB 会更新 LongitudeData 属性。此属性仅应用于地理坐标区。
以下是可用于指定表变量的不同索引方案的列表。
| 索引方案 | 示例 |
|---|---|
变量名称：
|
|
变量索引：
|
|
变量类型：
|
|
图例
全部展开
交互性
全部展开
DataTipTemplate — 数据提示内容
DataTipTemplate 对象
数据提示内容，指定为 DataTipTemplate 对象。您可以通过修改底层 DataTipTemplate 对象的属性来控制数据提示中显示的内容。有关属性列表，请参阅 DataTipTemplate 属性。
有关修改数据提示的示例，请参阅创建自定义数据提示。
注意
findobj 或 findall 不返回 DataTipTemplate 对象，copyobj 也不复制该对象。
回调
全部展开
回调执行控件
全部展开
父级/子级
全部展开
Parent — 父级
Axes 对象 | PolarAxes 对象 | Group 对象 | Transform 对象
父级，指定为 Axes、PolarAxes、Group 或 Transform 对象。
标识符
全部展开
Type — 图形对象的类型
'line'
此 属性 为只读。
图形对象的类型，以 'line' 形式返回。使用该属性在绘制层次结构中查找指定类型的所有对象，例如，使用 findobj 搜索该类型。
版本历史记录
在 R2006a 之前推出
全部展开
R2023b: 使用 SeriesIndex="none" 退出颜色和线型的自动选择
通过将 SeriesIndex 属性设置为 "none"，退出 Line 对象的颜色和线型的自动选择。当您指定 "none" 时，Line 对象具有不带标记的实线线型和中性颜色。
要再次启用自动选择，请将 SeriesIndex 属性设置为正整数。
R2023a: 使用 AffectsAutoLimits 属性控制线条是否影响坐标区范围的自动计算
通过设置 AffectsAutoLimits 属性，指定特定线条是否会影响自动选择的坐标区范围。默认情况下，坐标区范围会发生变化，以包含您创建的每个后续线条的数据范围。设置此属性使您能够重点关注坐标区中一部分线条的范围。
R2022a: 使用 SourceTable、XVariable、YVariable 和 ZVariable 等属性修改从表创建的图
使用 SourceTable、XVariable、YVarlable 和 ZVariable 属性修改使用表数据创建的绘图。
对于极坐标图，您可以使用 RVariable 和 ThetaVariable 属性更新数据变量。
对于地理图，您可以使用 LatitudeVariable 和 LongitudeVariable 属性更新数据变量。
以下附加属性控制 MATLAB 如何管理您的数据：YDataMode、ZDataMode、RDataMode、LatitudeDataMode 和 LongitudeDataMode。
R2020a: 使用 SeriesIndex 属性控制颜色和线型的自动选择
设置任一 Line 对象的 SeriesIndex 属性，以控制对象的颜色、线型和标记符号的变化。当您要匹配坐标区中不同对象的颜色、线型和标记时，更改此属性的值非常有用。
R2020a: 不推荐使用 UIContextMenu 属性
不推荐设置或获取 UIContextMenu 属性。请改为使用 ContextMenu 属性，该属性接受相同类型的输入，其行为方式与 UIContextMenu 属性相同。
没有删除 UIContextMenu 属性的计划，但当您对 Line 对象调用 set、get 或 properties 函数时，该属性不再列出。
另请参阅
plot | polarplot | plot3 | semilogx | semilogy | loglog
主题
- 访问属性值
- 图形对象属性
