ErrorBar 属性

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

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

控制如何设置 Color 属性，指定为下列值之一：

如果您手动更改 Color 属性的值，MATLAB 会将 ColorMode 属性的值更改为 "manual"。

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

控制如何设置 LineStyle 属性，指定为下列值之一：

如果您手动更改 LineStyle 属性的值，MATLAB 会将 LineStyleMode 属性的值更改为 "manual"。

线宽，指定为以磅为单位的正值，其中 1 磅 = 1/72 英寸。如果该线条具有标记，则线条宽度也会影响标记边。

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值，则线条显示为一个像素的宽度。

序列索引，指定为正整数或 "none"。此属性可用于重新分配 ErrorBar 对象的颜色、线型或标记，使它们与其他对象匹配。

默认情况下，SeriesIndex 属性是一个数字，对应于 ErrorBar 对象的创建顺序，从 1 开始。在您调用绘图函数时，MATLAB 使用该数字计算用于自动分配颜色、线型或标记的索引。索引引用存储在坐标区的 ColorOrder 和 LineStyleOrder 属性中的数组的行。坐标区中具有相同 SeriesIndex 编号的任何对象也都具有相同的颜色（以及线型和标记，如果适用）。

误差条末端的端盖长度，指定为以磅为单位的非负值。要从误差条中删除端盖，请将 CapSize 设置为 0。

示例: errorbar(x,y,err,'CapSize',10)

锐化垂直线和水平线，指定为 'on' 或 'off'，或指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

标记符号，指定为下表中列出的值之一。默认情况下，对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。

控制如何设置 Marker 属性，指定为下列值之一：

如果您手动更改 Marker 属性的值，MATLAB 会将 MarkerMode 属性的值更改为 "manual"。

标记大小，指定为以磅为单位的正值，其中 1 磅 = 1/72 英寸。

标记轮廓颜色，指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 "auto" 使用与 Color 属性相同的颜色。

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

标记填充颜色，指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"auto" 选项使用与父坐标区的 Color 属性相同的颜色。如果您指定 "auto"，并且坐标区图框不可见，则标记填充颜色为图窗的颜色。

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

x 值，指定为向量。errorbar 函数的输入参量 X 设置 x 值。如果您不指定 X，则 errorbar 会将 YData 的索引用作 x 的值。XData 和 YData 的长度必须相同。

示例: 1:10

XData 的选择模式，指定为下列值之一：

链接到 XData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 XData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 XData 值。若要强制更新数据值，需要使用 refreshdata 函数。

y 值，指定为向量。errorbar 函数的输入参量 Y 设置 y 的值。XData 和 YData 的长度必须相同。

链接到 YData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 YData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 YData 值。若要强制更新数据值，需要使用 refreshdata 函数。

数据点下方的垂直误差条长度，指定为与 YData 具有相同长度的向量，或指定为空数组 []。

误差条长度的数据类型必须与对应的绘图数据兼容。例如，如果绘制 datetime 值，这些值的误差条必须为 duration 值。

链接到 YNegativeDelta 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 对该变量进行计算以生成 YNegativeDelta 值。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。当您更改此属性的变量时，MATLAB 不会更新 YNegativeDelta 值。若要强制更新数据值，需要使用 refreshdata 函数。

数据点上方的垂直误差条长度，指定为与 YData 具有相同长度的向量，或指定为空数组 []。

误差条长度的数据类型必须与对应的绘图数据兼容。例如，如果绘制 datetime 值，这些值的误差条必须为 duration 值。

链接到 YPositiveDelta 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 对该变量进行计算以生成 YPositiveDelta 值。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。当您更改此属性的变量时，MATLAB 不会更新 YPositiveDelta 值。若要强制更新数据值，需要使用 refreshdata 函数。

数据点左侧的水平误差条长度，指定为与 YData 具有相同长度的向量，或指定为空数组 []。

误差条长度的数据类型必须与对应的绘图数据兼容。例如，如果绘制 datetime 值，这些值的误差条必须为 duration 值。

链接到 XNegativeDelta 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 对该变量进行计算以生成 XNegativeDelta 值。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。当您更改此属性的变量时，MATLAB 不会更新 XNegativeDelta 值。若要强制更新数据值，需要使用 refreshdata 函数。

数据点右侧的水平误差条长度，指定为与 YData 具有相同长度的向量，或指定为空数组 []。

误差条长度的数据类型必须与对应的绘图数据兼容。例如，如果绘制 datetime 值，这些值的误差条必须为 duration 值。

链接到 XPositiveDelta 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 对该变量进行计算以生成 XPositiveDelta 值。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。当您更改此属性的变量时，MATLAB 不会更新 XPositiveDelta 值。若要强制更新数据值，需要使用 refreshdata 函数。

数据点下方的误差条长度，指定为长度与 XData 和 YData 相同的向量。以数据单位指定这些值。

示例: 1:10

链接到 LData 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 对该变量进行计算以生成 LData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您更改该属性的变量，MATLAB 并不会更新 LData 的值。若要强制更新数据值，需要使用 refreshdata 函数。

数据点上方的误差条长度，指定为长度与 XData 和 YData 相同的向量。以数据单位指定这些值。

示例: 1:10

链接到 UData 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 对该变量进行计算以生成 UData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您更改该属性的变量，MATLAB 并不会更新 UData 的值。若要强制更新数据值，需要使用 refreshdata 函数。

图例标签，指定为字符向量或字符串标量。只有调用 legend 命令之后，才会显示图例。如果未指定文本，则 legend 使用 'dataN' 形式设置标签。

在图例中包含对象，指定为 Annotation 对象。将 Annotation 对象的基础 IconDisplayStyle 属性设置为以下值之一：

例如，要从图例中排除名为 obj 的 ErrorBar 对象，请将 IconDisplayStyle 属性设置为 "off"。

可见性状态，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

数据提示内容，指定为 DataTipTemplate 对象。您可以通过修改底层 DataTipTemplate 对象的属性来控制数据提示中显示的内容。有关属性列表，请参阅 DataTipTemplate 属性。

有关修改数据提示的示例，请参阅创建自定义数据提示。

上下文菜单，指定为 ContextMenu 对象。使用此属性在您右键点击对象时显示上下文菜单。使用 uicontextmenu 函数创建上下文菜单。

选择状态，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

选择时显示选择句柄，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

按照坐标区范围裁剪对象，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

必须将包含该对象的坐标区的 Clipping 属性设置为 'on'。否则，此属性不起作用。有关裁剪行为的详细信息，请参阅坐标区的 Clipping 属性。

鼠标点击回调，指定为下列值之一：

当您点击 ErrorBar 对象时，ButtonDownFcn 回调会执行。

对象创建函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组、字符串标量或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

对象删除函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组、字符串标量或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

回调中断，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

此属性确定是否可以中断运行中回调。有以下两种回调状态要考虑：

回调排队，指定为 "queue" 或 "cancel"。BusyAction 属性决定 MATLAB 如何处理中断回调的执行。有以下两种回调状态要考虑：

捕获鼠标点击的能力，指定为以下值之一：

对捕获的鼠标点击的响应，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

删除状态，以 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值形式返回。

当 DeleteFcn 回调开始执行时，MATLAB 会将 BeingDeleted 属性设置为 'on'。BeingDeleted 属性将一直保持 'on' 设置状态，直到组件对象不再存在为止。

父级，指定为 Axes、Group 或 Transform 对象。

子级，以空的 GraphicsPlaceholder 数组或 DataTip 对象数组形式返回。使用此属性来查看在图上绘制的数据提示的列表。

不能使用 Children 属性添加或删除子级。要向此列表中添加子级，请将 DataTip 对象的 Parent 属性设置为图对象。

父级的 Children 属性中对象句柄的可见性，指定为下列值之一：

图形对象的类型，以 'errorbar' 形式返回。使用该属性在绘制层次结构中查找指定类型的所有对象，例如，使用 findobj 搜索该类型。

对象标识符，指定为字符串标量或字符向量。您可以指定唯一的 Tag 值作为对象的标识符。如果需要访问您代码中其他位置的对象，可以使用 findobj 函数基于 Tag 值搜索该对象。

用户数据，指定为任何 MATLAB 数组。例如，您可以指定标量、向量、矩阵、元胞数组、字符数组、表或结构体。使用此属性存储对象上的任意数据。

如果您在 App 设计工具中工作，请在该 App 中创建公共或私有属性以共享数据，而不是使用 UserData 属性。有关详细信息，请参阅在单个使用 App 设计工具创建的 App 内共享数据。