主要内容

栏属性

条形图的外观和行为

酒吧属性控制对象的外观和行为酒吧对象。通过更改属性值,可以修改条形图的某些方面。使用点表示法查询和设置属性。

B =酒吧(1:10);c = b.facecolor b.facecolor = [0 0.5 0.5];

色彩与造型

全部展开

填充颜​​色,指定为'平坦的'、RGB三元组、十六进制颜色代码、颜色名称或短名称。这'平坦的'选项使用CData资产价值酒吧物体给脸上色。

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红色、绿色和蓝色分量的强度。强度必须在范围内[0,1];例如,[0.4 0.6 0.7]

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# FF8800”“#ff8800”“# F80”,'#f80'它们是等价的。

或者,您可以通过名称指定一些常用颜色。此表列出了命名颜色选项、等效RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB三重态 十六进制颜色代码 外貌
'红色的' 'r' (1 0 0) '#ff0000'

“绿色” ‘g’ (0 1 0) '#00ff00'

“蓝” “b” (0 0 1) #0000FF"

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “是的” [1 1 0] '#ffff00'

“黑” “k” (0 0 0) # 000000的

'白色的' “w” [1 1] "FFFFFF"

“没有” 不适用 不适用 不适用 没有颜色

这里是RGB三联体和十六进制颜色代码的默认颜色MATLAB®用于许多类型的情节。

RGB三重态 十六进制颜色代码 外貌
[0 0.4470 0.7410] “# 0072 bd”

[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] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) "A2142F"

从R2017b开始,默认值是从ColorOrder轴的性质。在以前的版本中,默认值是'平坦的'这些颜色都是基于颜色图的。

例子:b = bar(1:10“FaceColor”,“红”)

例子:b、 FaceColor=[0.50.5];

例子:b.FaceColor =“平”;

例子:b、 FaceColor='#D2F9A7';

控制如何FaceColor已设置属性,指定为其中一个值:

  • '汽车'- MATLAB控制的值FaceColor属性中选择一个颜色ColorOrder轴的性质。

  • “手动”-您控制的值FaceColor通过在调用创建对象的图表函数时指定颜色,或通过设置FaceColor创建它后对象的属性。

如果你改变FaceColor物业手动,Matlab更改了FaceColorMode.财产“手动”

轮廓颜色,指定为'平坦的'、RGB三元组、十六进制颜色代码、颜色名称或短名称。如果有150条或更少,则默认值是(0 0 0),对应黑色。如果相邻栏数超过150条,则默认值为“没有”

从R2017b开始'平坦的'选项使用CData值为边缘着色。在以前的版本中'平坦的'选项使用颜色地图的颜色给边缘着色。

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红色、绿色和蓝色分量的强度。强度必须在范围内[0,1];例如,[0.4 0.6 0.7]

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# FF8800”“#ff8800”“# F80”,'#f80'它们是等价的。

或者,您可以通过名称指定一些常用颜色。此表列出了命名颜色选项、等效RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB三重态 十六进制颜色代码 外貌
'红色的' 'r' (1 0 0) '#ff0000'

“绿色” ‘g’ (0 1 0) '#00ff00'

“蓝” “b” (0 0 1) #0000FF"

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “是的” [1 1 0] '#ffff00'

“黑” “k” (0 0 0) # 000000的

'白色的' “w” [1 1] "FFFFFF"

“没有” 不适用 不适用 不适用 没有颜色

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

RGB三重态 十六进制颜色代码 外貌
[0 0.4470 0.7410] “# 0072 bd”

[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] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) "A2142F"

例子:b=bar(1:10,'EdgeColor','red')

例子:b.EdgeColor = [0 0.5 0.5];

例子:B.edgecolor ='平';

例子:b.EdgeColor =“# D2F9A7”;

面透明度,指定为范围内的标量[0,1].值1是不透明的,0是完全透明的。0到1之间的值是半透明的。

例子:B =栏(1:10,'Facealpha',0.5)

例子:b、 面α=0.5;

边缘透明度,指定为范围内的标量[0,1].值1是不透明的,0是完全透明的。0到1之间的值是半透明的。

例子:b=巴(1:10,'EdgeAlpha',0.5)

例子:b.EdgeAlpha = 0.5;

线条样式,指定为此表中列出的选项之一。

线条风格 描述 产生的线
' - ' 实线

'--' 虚线

“:” 虚线

'-.' 划线

“没有” 没有线 没有线

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

例子:1.5

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

系列索引,指定为大于或等于的整数0..此属性用于重新分配多个面颜色酒吧对象,以便它们彼此匹配。默认情况下系列A的财产酒吧对象是与其创建顺序相对应的数字,从1

当您调用绘图函数时,MATLAB使用这个数字来计算分配面部颜色的索引。索引指的是存储在ColorOrder轴的性质。

MATLAB自动更新对象的面颜色酒吧对象的系列,或者改变时ColorOrder轴上的属性。但是,以下条件必须满足才能使更改生效:

  • FaceColorMode.财产的酒吧对象设置为'汽车'

  • 系列财产的酒吧对象大于0.

  • nextseriesIndex.轴对象上的属性大于0.

条形图类型

全部展开

条的排列,指定为以下值之一:

  • “分组”-按行分组栏y,在那里y的输入参数是酒吧barh创建条形图的函数。

  • “堆叠的”-每一行显示一个栏y. 条形图高度是行中元素的总和。每个酒吧都是五颜六色的。颜色对应于不同的元素,并显示每个行元素对总和的相对贡献。

单个条的相对宽度,指定为范围内的标量值[0,1].使用此属性可控制组内的栏分隔。默认值为0.8,这意味着MATLAB将这些柱稍微分开。如果将此属性设置为1,然后相邻的棒子互相接触。

例子:0.5

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

水平条形图,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'相当于真正的,“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'—水平显示栏。如果你用barh,那么水平属性设置为'在'

  • “关闭”-垂直显示栏。如果您使用酒吧,那么水平属性设置为“关闭”

基线

全部展开

基线值,指定为数字标量值。

指定的基线值应用于X设在或y-axis取决于条形图方向。如果更改垂直到水平条形图的方向,反之亦然,基线值可能会发生变化。设定BaseValue设置后的财产水平财产。

基线可见性,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'相当于真正的,“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'-显示基线。

  • “关闭”—隐藏基线。

此属性是只读的。

基线对象。有关基准属性列表,请参阅基本属性

数据

全部展开

颜色数据,指定为以下值之一:

  • RGB三元组-单个RGB颜色值适用于所有条。

  • 三列矩阵-每栏一种颜色。矩阵中的每一行指定特定条的RGB三元组。

  • 标量-单一颜色适用于所有颜色条,其中的颜色来自颜色映射。

  • 向量-每条线有一种颜色。颜色来自彩色地图。

默认情况下,创建条形图时,CData属性包含一个三柱矩阵的RGB三联网。您可以通过更改矩阵中的相应行来更改特定栏的颜色。

该属性仅在FaceColorEdgeColor.属性设置为'平坦的'

实例

的颜色来改变一个特定的工具条的颜色FaceColor财产'平坦的'.,然后更改相应的行CData矩阵到新的RGB三元组。例如,更改第二个栏的颜色。

b =栏(1:10,“脸色”'平坦的');B.CDATA(2,:)= [0 0.8 0.8];

条位置,指定为没有重复值的向量。

  • 对于垂直条形图,值是沿着的条形位置X设在。

  • 对于水平条形图,值是沿着的条形位置y设在。

或者,使用输入参数指定工具条位置X酒吧barh功能。如果您未指定X,然后是其中值的索引YData确定栏位置。

扩展属性YData长度必须相等。

例子:1:10

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|期间

选择模式扩展属性,指定为其中一个值:

  • '汽车'-使用中值的索引YData(或者ZData三维图)。

  • “手动”-使用手动指定的值。要指定值,请设置扩展属性属性或指定输入参数X到绘图功能。

变量链接到扩展属性,指定为包含MATLAB工作区变量名的字符向量或字符串。MATLAB在基本工作空间中计算变量以生成扩展属性

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新扩展属性立即恢复价值。要强制更新数据值,请使用refreshdata.功能。

笔记

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“x”

条长度,指定为向量。或者,使用输入参数指定条形条长度y酒吧barh功能。

扩展属性YData长度必须相等。

例子:1:10

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|期间

变量链接到YData,指定为包含MATLAB工作区变量名的字符向量或字符串。MATLAB在基本工作空间中计算变量以生成YData

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新YData立即恢复价值。要强制更新数据值,请使用refreshdata.功能。

笔记

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“是的”

此属性是只读的。

X- 杆的尖端绕,作为向量返回。当您想要将文本,错误栏或其他对象添加到条形的提示时,这些坐标非常有用。例如,您可以将此属性的值传递给文本函数,当您想要向栏的提示添加文本时。

此属性是只读的。

y- 杆的尖端绕,作为向量返回。当您想要将文本,错误栏或其他对象添加到条形的提示时,这些坐标非常有用。例如,您可以将此属性的值传递给文本函数,当您想要向栏的提示添加文本时。

传说

全部展开

图例标号,指定为字符向量或字符串标量。图例不会显示,直到你调用传说命令。如果不指定文本,则传说使用表单设置标签“dataN”

此属性是只读的。

控件,用于从图例中包含或排除对象注释对象。设置底层IconDisplayStyle属性设置为以下值之一:

  • '在'-在图例中包含对象(默认)。

  • “关闭”-不要将对象包括在图例中。

例如,要排除一个图形对象,,从图例中设置IconDisplayStyle财产“关闭”

go.Annotation.LegendInformation.IconDisplayStyle =“关闭”

控件来控制图例中的项目传说作用将第一个输入参数指定为要包含的图形对象的向量。如果未在第一个输入参数中指定现有图形对象,则该对象不会显示在图例中。但是,创建图例后添加到轴的图形对象确实会显示在图例中。在创建所有的图以避免额外的项目后,考虑创建图例。

交互性

全部展开

可见性状态,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'相当于真正的,“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'—显示对象。

  • “关闭”- 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

数据提示内容,指定为数据模板对象。您可以通过修改底层的属性来控制出现在数据提示中的内容数据模板对象。有关属性列表,请参见DataTipTemplate属性

有关修改数据提示的示例,请参见创建自定义数据提示

笔记

数据模板对象不返回findobj找到所有,它没有复制copyobj

上下文菜单,指定为a快捷菜单对象。使用此属性可在右键单击对象时显示上下文菜单。控件创建上下文菜单uicontextmenu功能。

笔记

如果PickableParts属性设置为“没有”或者如果哈比特属性设置为“关闭”,则不会出现上下文菜单。

选择状态,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'等于true,那么“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'——选择。如果在绘图编辑模式下单击对象,则MATLAB将其设置为选择财产'在'.如果选择属性也设置为'在',然后MATLAB显示对象周围的选择手柄。

  • “关闭”——而不是选择。

选择句柄时的显示,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'等于true,那么“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'-当选择属性设置为'在'

  • “关闭”-永远不显示选择句柄,即使当选择属性设置为'在'

物体剪切到轴限制,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'等于true,那么“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • 价值'在'夹子部分在轴限制范围内的物体。

  • 价值“关闭”显示整个对象,即使它的部分出现在轴的限制之外。如果你创建一个plot, set,对象的部分可能会出现在坐标轴限制之外抓住,冻结轴缩放,然后创建对象,使其比原来的plot更大。

剪裁包含对象的轴的属性必须设置为'在'.否则,此属性不起作用。有关剪切行为的更多信息,请参见剪裁轴的性质。

回调

全部展开

鼠标单击回调,指定为其中一个值:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 有效MATLAB命令或函数的字符向量,在基本工作空间中进行评估(不推荐)

在单击对象时使用此属性执行代码。如果使用函数句柄指定此属性,则MATLAB在执行回调函数时传递两个参数:

  • 点击对象-从回调函数中访问点击对象的属性。

  • 事件数据-空参数。将其替换为波浪字符()在函数定义中,表示未使用此参数。

有关如何使用函数处理来定义回调函数的更多信息,请参阅回调函数定义

笔记

如果PickableParts属性设置为“没有”或者如果哈比特属性设置为“关闭”,则此回调不执行。

对象创建函数,指定为以下值之一:

  • 功能手柄。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定MATLAB创建对象时执行的回调函数。方法之前,MATLAB初始化所有属性值CreateFcn回调。如果您没有指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设置CreateFcn属性对现有组件没有影响。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo函数访问对象。

对象删除函数,指定为其中一个值:

  • 功能手柄。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定MATLAB删除对象时要执行的回调函数。Matlab执行了DeleteFcn销毁对象属性之前的回调。如果您没有指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问要删除的对象。否则,请使用gcbo函数访问对象。

回调执行控制

全部展开

回调中断,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'相当于真正的,“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

此属性确定是否可以中断运行回调。有两个回调状态需要考虑:

  • 运行Callback是当前正在执行的回调。

  • 打断Callback是一个试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调尝试中断正在运行的回调(如果存在的话)。这打断拥有运行回调的对象的属性确定是否允许中断。

  • 价值'在'允许其他回调来中断对象的回调。中断发生在MATLAB处理队列的下一个点,例如当有刷新屏幕数字uifiguregetframe等待,或暂停命令。

    • 如果运行回调包含其中一个命令,则Matlab在该点处停止执行回调并执行中断回调。MATLAB在中断回调完成时执行运行回调。

    • 如果正在运行的回调不包含这些命令中的任何一个,那么MATLAB将在不中断的情况下完成回调的执行。

  • 价值“关闭”阻止所有中断尝试。这忙碌拥有中断回调的对象的属性确定中断回调是被丢弃还是放入队列。

笔记

在这些情况下,回调中断和执行的行为是不同的:

  • 如果中断回调为DeleteFcnCloseRequestFcnSizeChangedFcn回调,则中断发生,而不考虑打断属性值。

  • 如果正在运行的回调函数正在执行等待函数,则不管打断属性值。

  • 计时器对象根据调度执行,而不管打断属性值。

当中断发生时,MATLAB不保存属性或显示的状态。方法返回的对象gcagcf当执行另一个回调时,命令可能会更改。

回调排队,指定为“队列”“取消”.这忙碌属性确定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的回调。

  • 打断Callback是一个试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调都会尝试中断正在运行的回调。这个打断属性决定是否允许中断。如果不允许中断,那么忙碌拥有中断回调的对象的属性确定它是被丢弃还是放入队列。这些是忙碌属性:

  • “队列”—将中断回调放入正在运行的回调执行完成后待处理的队列中。

  • “取消”—不执行中断回呼。

捕捉鼠标点击的能力,指定为以下值之一:

  • “可见”-捕捉鼠标点击时可见。这可见财产必须设置为'在'你必须点击其中的一部分酒吧具有已定义颜色的对象。不能单击将关联颜色属性设置为的部件“没有”.这哈比特属性决定酒吧对象对单击作出响应,如果是祖先则响应。

  • “没有”- 无法捕获鼠标点击。点击酒吧对象将单击传递给图形窗口当前视图中其下方的对象。这哈比特财产的酒吧对象没有效果。

对捕获的鼠标单击的响应,指定为'在'“关闭”,或数字或逻辑1真正的)或0.错误的).价值'在'等于true,那么“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

  • '在'- 触发ButtonDownFcn收回酒吧对象。如果你定义了快捷菜单属性,然后调用上下文菜单。

  • “关闭”- 触发最近的祖先的回调酒吧对象,该对象具有以下之一:

    • 哈比特物业设为'在'

    • PickableParts属性设置为允许祖先捕获鼠标单击的值

笔记

PickableParts属性决定酒吧对象可以捕获鼠标点击。如果不能,那么哈比特财产无效。

此属性是只读的。

删除状态,返回类型类型的开/关逻辑值matlab.lang.OnOffSwitchState

Matlab设置了BeingDeleted财产'在'DeleteFcn回调函数开始执行。这BeingDeleted属性仍设置为'在'直到组件对象不再存在。

检查该值BeingDeleted属性验证在查询或修改之前未删除对象是否即将删除。

父/子

全部展开

父,指定为集团,或使改变对象。

儿女,归为空图表持有者数组或一个数据提示对象数组。使用此属性可以查看绘制在图表上的数据提示列表。

不能使用添加或删除子项儿童财产。要将子列表添加到此列表,请设置财产的数据提示对象指向图表对象。

对象句柄的可见性儿童父级属性,指定为其中一个值:

  • '在'-对象句柄始终可见。

  • “关闭”对象句柄在任何时候都是不可见的。这个选项对于防止另一个函数的意外更改非常有用。设定HandleVisibility“关闭”在函数执行期间暂时隐藏句柄。

  • '打回来'-对象句柄在回调或由回调调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止对命令行对象的访问,但允许回调函数访问它。

属性中未列出的对象儿童父的属性,然后通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回它。这些功能的示例包括得到findobjgcagcfgcoempplot.claclf,关闭功能。

隐藏对象句柄仍然有效。设置根ShowHiddenHandles财产'在'列出所有对象句柄,而不管它们的HandleVisibility属性设置。

身份标识

全部展开

此属性是只读的。

图形对象类型,返回为“酒吧”.使用此属性可在绘图层次结构中查找给定类型的所有对象,例如使用findobj

对象标识符,指定为字符向量或字符串标量。你可以指定一个唯一的标签值作为对象的标识符。当您需要访问代码中的其他地方的对象时,可以使用findobj函数以基于标签价值。

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

如果你在应用程序设计器中工作,在应用程序中创建公共或私有属性来共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用程序设计器应用程序中共享数据

兼容性的考虑

全部展开

不建议在R2020a开始

之前介绍过的R2006a